0% found this document useful (0 votes)
10K views1,350 pages

ZEN 3.11 - Software Manual

Uploaded by

orellanamgab
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
10K views1,350 pages

ZEN 3.11 - Software Manual

Uploaded by

orellanamgab
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 1350

Software Manual

ZEISS ZEN 3.11


ZEISS ZEN 3.11

Original Manual

Carl Zeiss Microscopy GmbH


Carl-Zeiss-Promenade 10
07745 Jena
Germany
[email protected]
www.zeiss.com/microscopy

Carl Zeiss Microscopy GmbH


Carl-Zeiss-Promenade 10
07745 Jena
Germany

Document Name: Software Manual ZEISS ZEN 3.11


Revision: 1
Language: en-US
Effective from: 10/2024

© 2024 Without the prior written consent of ZEISS, this document or any part of it must neither be translated nor reproduced or
transmitted in any form or by any means - including electronic or mechanic methods, by photocopying, recording or by any in-
formation or filing system. The right to make backup-copies for archiving purposes shall remain unaffected thereby. Any viola-
tions may be prosecuted as copyright infringements.
The use of general descriptive names, registered names, trademarks, etc. in this document does not imply that such names are
exempt from the relevant intellectual property laws and regulations and therefore free for general use. This shall also apply if
this is not specifically referred to. Software programs shall entirely remain the property of ZEISS. No program or subsequent up-
grade thereof may be disclosed to any third party, copied or reproduced in any other form without the prior written consent of
ZEISS, even if these copies or reproductions are destined for internal use at the customer's only, the only exception being one
single back-up copy for archiving purposes.
Content​ ZEISS

Content
1 General Information....................................................................... 16

1.1 Welcome ................................................................................................... 16


1.2 Text Conventions and Link Types ............................................................... 16
1.3 Explanation of Warning Messages and Additional Information................... 16
1.4 Calling up the Help .................................................................................... 17
1.5 Intended Purpose....................................................................................... 18
1.6 Important Notes ........................................................................................ 19
1.7 Further Applicable Documents ................................................................... 19
1.8 Legal Notes................................................................................................ 19
1.9 Contact...................................................................................................... 20

2 First Steps...................................................................................... 22

2.1 Starting Software ....................................................................................... 22


2.2 Welcome Screen ........................................................................................ 23
2.2.1 Overview Area ............................................................................ 23
2.2.2 Start Buttons............................................................................... 24
2.3 User Interface ............................................................................................ 24
2.3.1 Title Bar ...................................................................................... 25
2.3.2 Workspace Configuration ........................................................... 25
2.3.3 Menu Bar.................................................................................... 25
2.3.4 Tool Bar ...................................................................................... 26
2.3.5 Left Tool Area ............................................................................. 26
2.3.6 Center Screen Area ..................................................................... 26
2.3.7 Right Tool Area........................................................................... 28
2.3.8 Document Bar............................................................................. 28
2.3.9 Status Bar ................................................................................... 28
2.4 Setting User Language ............................................................................... 30
2.5 Activating Show All Mode.......................................................................... 31
2.6 Configuring Microscope Components ........................................................ 31
2.7 Acquiring Camera Image............................................................................ 33
2.8 Adding Annotations................................................................................... 35
2.9 Adjusting Live Image Settings..................................................................... 35
2.10 Creating Manual Scaling ............................................................................ 36
2.11 Closing Software........................................................................................ 37

3 Basic Concepts............................................................................... 38

3.1 Image Acquisition ...................................................................................... 38


3.2 Image Processing ....................................................................................... 38
3.3 Image Analysis ........................................................................................... 38

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 3


Content​ ZEISS

3.4 File Format................................................................................................. 38


3.5 Extensions.................................................................................................. 39
3.6 Customizing the Application ...................................................................... 39
3.6.1 Selecting Screen Design .............................................................. 39
3.6.2 Customizing Toolbar ................................................................... 39
3.6.3 Adjusting Workspace Zoom ........................................................ 40
3.6.4 Showing/Hiding Workspace Areas .............................................. 40
3.6.5 Undocking/Docking Tool Windows ............................................. 40
3.6.6 Displaying and Adapting a Grid in the Image Area ...................... 41
3.7 User Management ..................................................................................... 42
3.7.1 Creating a New User................................................................... 43
3.7.2 Creating a new group ................................................................. 44
3.7.3 Adding Users to a Group ............................................................ 45
3.7.4 Managing Access Rights for User Groups.................................... 46
3.7.5 Managing Group Privileges ......................................................... 47
3.7.6 Setting Up the Login with Windows Credentials (Active Direc-
tory)............................................................................................ 48
3.7.7 Options....................................................................................... 49
3.7.8 Looking Up Active Directory Groups ........................................... 50
3.8 Image Acquisition ...................................................................................... 51
3.8.1 Setting Up a New Experiment ..................................................... 51
3.8.2 Acquiring Multi-Channel Images with Cameras ........................... 51
3.8.3 Using the Dye Editor ................................................................... 55
3.8.4 Setting an Experiment as Startup Default .................................... 59
3.8.5 Creating Default Experiments as Templates Automatically........... 60
3.8.6 Applying an Experiment Template............................................... 60
3.8.7 Adding Annotations to Images or Movies ................................... 61
3.8.8 Editing Annotations in Images or Movies .................................... 62
3.8.9 Using Denoising During Continuous Acquisition.......................... 62
3.9 Working with Focus Strategies ................................................................... 63
3.9.1 Introduction................................................................................ 63
3.9.2 Using Software Autofocus .......................................................... 63
3.9.3 Using Definite Focus in Time Series Experiments ......................... 64
3.9.4 Using Local or Global Focus Surfaces .......................................... 65
3.10 Import/Export............................................................................................. 66
3.10.1 Workflow Export/Import ............................................................. 66
3.10.2 Exporting Images ........................................................................ 66
3.10.3 Exporting Movies ........................................................................ 67
3.10.4 Exporting Multichannel Images ................................................... 67
3.10.5 Exporting Multiscene Images ...................................................... 68
3.10.6 Naming Convention for Image Export ......................................... 69
3.10.7 Importing Z-Stack Images ........................................................... 70
3.10.8 Downloading AI Models ............................................................. 71
3.10.9 Importing AI Models ................................................................... 72
3.11 Image Processing ....................................................................................... 72
3.11.1 Image Processing Workflow........................................................ 72
3.11.2 Extracting Individual Fluorescence Images of a Multichannel Im-
age ............................................................................................. 73
3.11.3 Applying Batch Processing .......................................................... 75

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 4


Content​ ZEISS

3.11.4 Cropping a ROI ........................................................................... 77


3.11.5 Creating an EDF Image ............................................................... 79
3.11.6 Creating Image Subset and Split Dimensions............................... 81
3.11.7 Using Analyze to Label Image ..................................................... 81
3.11.8 Image Processing Functions ........................................................ 83

4 Basic Functionality ......................................................................... 206

4.1 arivis Cloud (on-site)................................................................................... 206


4.1.1 Preliminary Work & Prerequisites................................................. 206
4.1.2 Creating and Entering an Access Token ...................................... 206
4.1.3 Setting Up the Remote Module Execution................................... 207
4.1.4 Creating a Path Mapping ............................................................ 208
4.1.5 Downloading an arivis Cloud Module.......................................... 208
4.1.6 Executing arivis Cloud Modules in ZEN ........................................ 209
4.1.7 Example for arivis Cloud (onsite) ................................................. 209
4.1.8 Module Manager Tool ................................................................ 211
4.1.9 Module Execution Tool ............................................................... 212
4.1.10 Executions Browser..................................................................... 212
4.2 Colocalization ............................................................................................ 214
4.2.1 Colocalization View .................................................................... 214
4.3 Direct Processing........................................................................................ 219
4.3.1 System Requirements.................................................................. 221
4.3.2 Overview Direct Processing ......................................................... 222
4.3.3 Connecting Acquisition Computer and Processing Computer ...... 222
4.3.4 Setting Up Your PC as Discovery Proxy........................................ 228
4.3.5 Defining Settings in the Auto Save Tool ...................................... 229
4.3.6 Using Direct Processing............................................................... 230
4.3.7 Using Direct Processing with Airyscan Processing........................ 231
4.3.8 Direct Processing Tool on Acquisition Tab ................................... 233
4.3.9 Direct Processing PCs Dialog ....................................................... 237
4.3.10 Direct Processing Tool on Applications Tab ................................. 237
4.3.11 Sharing a Folder for Direct Processing ......................................... 238
4.4 Extended Focus Processing......................................................................... 244
4.5 Manual Extended Focus ............................................................................. 244
4.5.1 Preparing a Manual EDF Acquisition............................................ 244
4.5.2 Acquiring EDF Images with Timer................................................ 245
4.5.3 Acquiring EDF Images with F12 Key ............................................ 245
4.5.4 Comparing Images Using Split Display ........................................ 246
4.5.5 Manual Extended Depth of Focus Tool........................................ 247
4.6 Measurement............................................................................................. 248
4.6.1 Using Interactive Measurements ................................................. 248
4.6.2 Interactive Measurement Tool..................................................... 249
4.7 Panorama .................................................................................................. 255
4.7.1 Prerequisites ............................................................................... 256
4.7.2 Acquiring a Reference Image ...................................................... 257
4.7.3 Settings for a Panorama Experiment ........................................... 257
4.7.4 Acquiring a Panorama Image ...................................................... 258
4.7.5 Acquiring a Panorama Image Automatically ................................ 260

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 5


Content​ ZEISS

4.7.6 Processing a Panorama Image .................................................... 263


4.7.7 Panorama Tool ........................................................................... 268
4.7.8 Panorama View .......................................................................... 268
4.7.9 Live Panorama Tool .................................................................... 269
4.8 Third Party Import ...................................................................................... 269
4.9 ZEN Data Storage Client............................................................................. 269
4.9.1 Setting up ZEN Data Storage Server ............................................ 269
4.9.2 Validating the ZEN Data Storage Settings.................................... 270
4.9.3 Saving an Image to ZEN Data Storage......................................... 270
4.9.4 Saving a ZEN Connect Project to ZEN Data Storage..................... 271
4.9.5 Exporting a ZEN Connect Project from ZEN Data Storage ............ 271
4.9.6 Uploading Images Automatically After Acquisition ...................... 272
4.9.7 Opening or Deleting an Image from ZEN Data Storage ............... 272
4.9.8 Opening or Deleting a ZEN Connect Project from ZEN Data Stor-
age ............................................................................................. 273
4.9.9 Configuring the Stored Documents Table.................................... 273
4.9.10 Filtering Connect Projects and Images in ZEN Data Storage......... 274
4.9.11 Adding and Deleting Tags for ZEN Data Storage Images ............. 274
4.9.12 Creating a Collection for Data..................................................... 274
4.9.13 Editing or Deleting a Data Collection........................................... 275
4.9.14 Adding Data to a Collection ........................................................ 276
4.9.15 Sharing Data Directly With Users and Groups.............................. 276
4.9.16 Adding an Active Directory User ................................................. 276
4.9.17 Stored Documents Dialog ........................................................... 277
4.9.18 Add to Collection Dialog ............................................................. 281
4.9.19 Share and Manage Access Dialog ............................................... 282
4.10 ImageJ ....................................................................................................... 282
4.10.1 Preparations ............................................................................... 283
4.10.2 Activate ImageJ Extension........................................................... 283
4.10.3 Sending and Retrieving Images ................................................... 283
4.10.4 Use ImageJ Methods................................................................... 284
4.10.5 Image Type Send/Retrieve Conventions....................................... 285

5 Acquisition Toolkits ....................................................................... 286

5.1 Experiment Designer .................................................................................. 286


5.1.1 Experiment Designer Tool ........................................................... 287
5.2 Experiment Feedback ................................................................................. 289
5.2.1 Workflow Experiment Feedback.................................................. 290
5.2.2 Experiment Feedback Tool .......................................................... 294
5.3 Guided Acquisition..................................................................................... 319
5.3.1 Preliminary Work to Guided Acquisition ...................................... 320
5.3.2 Performing a Guided Acquisition................................................. 321
5.3.3 Using Guided Acquisition settings ............................................... 323
5.3.4 Guided Acquisition Tool.............................................................. 324
5.4 HDR Confocal Basic.................................................................................... 327
5.5 Multi-Channel ............................................................................................ 327
5.6 Software Autofocus ................................................................................... 328

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 6


Content​ ZEISS

5.6.1 Terminology & Abbreviations ...................................................... 328


5.6.2 When is focus the "right" focus? ................................................. 332
5.6.3 Software Autofocus in ZEN ......................................................... 332
5.6.4 Software Autofocus Tool ............................................................ 333
5.6.5 Software Autofocus Using LSM Tracks ........................................ 336
5.7 Tiles & Positions ......................................................................................... 337
5.7.1 Licensing and Functionalities of Tiles & Positions......................... 338
5.7.2 General Preparations................................................................... 338
5.7.3 Setting Up a Simple Tiles Experiment Without the Tiles & Posi-
tions Module .............................................................................. 339
5.7.4 Setting Up a Simple Positions Experiment without the Tiles & Po-
sitions Module ............................................................................ 340
5.7.5 Adjusting Z-Values ...................................................................... 341
5.7.6 Exporting Tile Images.................................................................. 343
5.7.7 Calibrating the Stage and Selecting the Channel ......................... 343
5.7.8 Tiles & Positions with Advanced Setup ........................................ 344
5.7.9 Copying a Tile Region or Position................................................ 350
5.7.10 Local and Global Focus Surfaces ................................................. 351
5.7.11 Assigning Categories to Tile Regions and Positions ..................... 355
5.7.12 Using Sample Carriers ................................................................. 356
5.7.13 Tiles Tool .................................................................................... 359
5.7.14 Tiles Advanced Setup .................................................................. 372
5.7.15 Stage View ................................................................................. 373
5.7.16 Tiles Toolbars.............................................................................. 375
5.7.17 Tiles View Options ...................................................................... 382
5.7.18 Tiles Options ............................................................................... 384
5.7.19 Select Template Dialog ............................................................... 386
5.7.20 Edit Sample Carrier Template dialog............................................ 387
5.8 Time Series................................................................................................. 390
5.8.1 Acquiring Time Series Images...................................................... 390
5.8.2 Time Series Tool.......................................................................... 391
5.9 Z-Stack....................................................................................................... 394
5.9.1 Acquiring Z-Stack Images............................................................ 394
5.9.2 Z-Stack Tool................................................................................ 397

6 General Toolkits............................................................................. 402

6.1 Image Analysis ........................................................................................... 402


6.1.1 Creating a New Image Analysis Setting ....................................... 403
6.1.2 Measuring Fluorescence Intensity in a Multichannel Image ......... 404
6.1.3 Counting Number of Fluorescence Signals per Nuclei.................. 409
6.1.4 Measuring Mean Fluorescence Intensity on a Ring around the
Primary Object ............................................................................ 416
6.1.5 Counting the Number of Objects in a Ring around the Nucleus... 423
6.1.6 Creating a Measurement Data Table ........................................... 426
6.1.7 Creating an Image Analysis Setting from an Analyzed Image ...... 426
6.1.8 Performing an Interactive Analysis .............................................. 427
6.1.9 Creating Custom Features........................................................... 427
6.1.10 Creating Custom Statistical Features ........................................... 428
6.1.11 Creating an Image Analysis Setting From an AI Model ................ 429
6.1.12 Analysis View.............................................................................. 429

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 7


Content​ ZEISS

6.1.13 Copy Operations for Features...................................................... 433


6.1.14 Charts and Tables of the Analysis View ....................................... 434
6.1.15 Examples for Custom Features .................................................... 438
6.1.16 Examples for Custom Statistical Features..................................... 439
6.1.17 Measurement Features ............................................................... 440
6.2 Advanced Processing ................................................................................. 471
6.2.1 Edges.......................................................................................... 472
6.2.2 Arithmetics ................................................................................. 473
6.2.3 Binary ......................................................................................... 477
6.2.4 Morphology................................................................................ 481
6.2.5 Smooth....................................................................................... 482
6.2.6 Utilities ....................................................................................... 482
6.3 Intellesis..................................................................................................... 483
6.3.1 Fact Sheet................................................................................... 485
6.3.2 FAQ/Terminology........................................................................ 485
6.3.3 Operating Concept ..................................................................... 487
6.3.4 Workflow Overview .................................................................... 488
6.3.5 User Interface - Training.............................................................. 489
6.3.6 Intellesis Models ......................................................................... 493
6.3.7 Editing Classes ............................................................................ 499
6.3.8 Importing Labels from Binary Mask............................................. 500
6.3.9 Converting Segmentations to Labels ........................................... 500
6.3.10 Using Neural Networks for Intellesis............................................ 500
6.3.11 Using a Trained Model for Image Processing............................... 501
6.3.12 Using a Trained Model for Image Analysis................................... 502
6.3.13 Changing the Tile Border Size for Neural Networks ..................... 504
6.3.14 Using Intellesis within OAD ......................................................... 504
6.3.15 Remarks and Additional Information........................................... 505
6.3.16 Feature Extractors ....................................................................... 506
6.3.17 Image Processing Functions ........................................................ 508
6.3.18 Intellesis Trainable Segmentation Tool ........................................ 509
6.3.19 Change Border Size Dialog.......................................................... 510
6.4 Intellesis Denoising..................................................................................... 511
6.4.1 User Interface Training Intellesis Denoising ................................. 512
6.4.2 Creating and Training an Intellesis Denoising Model ................... 514
6.4.3 Importing a Denoising Model...................................................... 515
6.4.4 Exporting an Intellesis Denoising Model ...................................... 515
6.4.5 Using a Trained Model for Denoising .......................................... 516
6.4.6 Intellesis Denoising Tool.............................................................. 516
6.4.7 IP Function.................................................................................. 517
6.5 Intellesis Object Classification..................................................................... 517
6.5.1 Workflows Overview................................................................... 517
6.5.2 User Interface ............................................................................. 518
6.5.3 Creating and Training an Object Classification Model.................. 521
6.5.4 Importing an Object Classification Model.................................... 522
6.5.5 Exporting an Object Classification Model .................................... 523
6.5.6 Exporting an Object Classification Model with Images ................ 523
6.5.7 Using a Trained Model for Object Classification .......................... 523
6.5.8 Intellesis Trainable Object Classification Tool............................... 524
6.5.9 IP Function.................................................................................. 525

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 8


Content​ ZEISS

6.6 3D Image Analysis...................................................................................... 525


6.6.1 Creating a 3D Image Analysis Setting.......................................... 525
6.6.2 Performing and Saving a 3D Analysis .......................................... 527
6.6.3 Viewing and Exporting the Results of a 3D Analysis .................... 527
6.6.4 Analysis Tab................................................................................ 528
6.6.5 Analysis Objects Table................................................................. 528
6.7 3Dxl ........................................................................................................... 529
6.7.1 Animating the 3D Volume .......................................................... 529
6.7.2 3D View...................................................................................... 529
6.8 3Dxl Plus .................................................................................................... 545
6.8.1 Tomo3D View............................................................................. 545
6.9 Macro Environment ................................................................................... 549
6.9.1 Running an Existing Macro ......................................................... 550
6.9.2 Recording a Macro ..................................................................... 551
6.10 Physiology (Dynamics) ................................................................................ 551
6.10.1 Licensing and Functionalities of Physiology ................................. 551
6.10.2 Opening the MeanROI View ....................................................... 552
6.10.3 Workflow MeanROI View (Offline) .............................................. 552
6.10.4 Workflow Physiology (Dynamics) Experiments............................. 558
6.10.5 Sample Experiment Fura-2 with DG4/5 ....................................... 564
6.10.6 Mean ROI View........................................................................... 566
6.11 FRAP Efficiency Analysis ............................................................................. 574
6.11.1 FRAP View .................................................................................. 574
6.12 Automated Photomanipulation .................................................................. 577
6.12.1 Using Automated Photomanipulation Settings ............................ 577
6.12.2 Performing an Automated Photomanipulation Experiment.......... 578
6.12.3 Automated Photomanipulation Tool ........................................... 579
6.13 FRET........................................................................................................... 580
6.13.1 Acquisiton Prerequisites .............................................................. 581
6.13.2 Analysis Method for Acceptor Bleaching ..................................... 581
6.13.3 Analysis Methods for Sensitized Emission.................................... 581
6.13.4 Determining Donor Coefficient Values ........................................ 582
6.13.5 Determining Acceptor Coefficient Values .................................... 583
6.13.6 FRET View................................................................................... 583
6.14 Deconvolution............................................................................................ 588
6.14.1 Licensing and Functionalities of Deconvolution ........................... 589
6.14.2 Basics of Deconvolution .............................................................. 589
6.14.3 Deconvolution Methods in ZEN................................................... 590
6.14.4 Performing Deconvolution Using Default Values ......................... 593
6.14.5 Performing Configurable Deconvolution ..................................... 595
6.14.6 Creating Deconvolution Settings ................................................. 601
6.14.7 Creating a PSF - With Wizard and Without.................................. 602
6.14.8 Measuring the PSF Using Subresolution Beads ............................ 603
6.14.9 Using Deconvolution in Direct Processing.................................... 604
6.14.10 Image Types Suitable for Deconvolution ..................................... 605
6.14.11 Table of Default Parameter for Deconvolution ............................ 607
6.15 Apotome Plus ............................................................................................ 608

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 9


Content​ ZEISS

6.15.1 Apotome Plus (defaults) .............................................................. 608


6.15.2 Apotome Plus (adjustable) .......................................................... 609
6.15.3 Using Apotome Plus in Direct Processing .................................... 617
6.15.4 Creating Apotome Plus Settings.................................................. 619
6.16 ZEN Connect .............................................................................................. 619
6.16.1 Licensing and Functionalities of ZEN Connect.............................. 619
6.16.2 User Interface ............................................................................. 621
6.16.3 ZEN Connect 3D View................................................................. 621
6.16.4 Opening the Correlative Workspace............................................ 623
6.16.5 Opening Images in the ZEN Connect 3D View............................. 623
6.16.6 Non Image Data ......................................................................... 624
6.16.7 Raman Images ............................................................................ 624
6.16.8 Project and Image Management ................................................. 625
6.16.9 Import and Export....................................................................... 631
6.16.10 Alignment................................................................................... 635
6.16.11 Handling of Images and Data...................................................... 646
6.16.12 ZEN Connect Tool ....................................................................... 650
6.16.13 Select Template Dialog ............................................................... 656
6.16.14 Alignment Tab ............................................................................ 656
6.16.15 Measurement Tab....................................................................... 658
6.16.16 Button Bar below Image View .................................................... 659
6.16.17 ZEN Connect Single Image Export Wizard ................................... 659
6.16.18 Field of View Width Dialog ......................................................... 661
6.16.19 Pixel Size Dialog.......................................................................... 661
6.16.20 Video Export Wizard ................................................................... 661
6.16.21 Regions Tool............................................................................... 663
6.16.22 ZEN Connect Manual Alignment Wizard ..................................... 664
6.16.23 ZEN Connect Point Alignment Wizard ......................................... 665
6.16.24 ZEN Connect 3D Point Alignment Wizard.................................... 668
6.17 Shuttle & Find ............................................................................................ 671
6.17.1 Settings and Image Acquisition with the Light Microscope.......... 671
6.17.2 Shuttle & Find Sample Positions at the Electron Microscope........ 678
6.17.3 Correlating Two Loaded Images.................................................. 682
6.17.4 Correlation of Live Image and Loaded Image .............................. 684
6.17.5 Shuttle & Find with an EVO 10.................................................... 684
6.17.6 User Interface ............................................................................. 685
6.17.7 Shuttle & Find Tool ..................................................................... 686
6.17.8 Shuttle & Find View .................................................................... 687
6.17.9 Sample Holder Calibration Wizard............................................... 692
6.17.10 Correlative Sample Holders ......................................................... 695

7 Application Toolkits....................................................................... 699

7.1 Bio Apps .................................................................................................... 699


7.1.1 Available Bio Apps ...................................................................... 699
7.1.2 General Workflow ...................................................................... 700
7.1.3 Creating a General Bio Apps Setting ........................................... 700
7.1.4 Running Bio Apps ....................................................................... 700
7.1.5 Creating a Setting for Cell Counting............................................ 701
7.1.6 Creating a Setting for Confluency ............................................... 702
7.1.7 Creating a Setting for Gene- and Protein Expression ................... 703

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 10


Content​ ZEISS

7.1.8 Creating a Setting for Automated Spot Detection ....................... 705


7.1.9 Creating a Setting for Translocation ............................................ 706
7.1.10 Running Bio Apps in Batch Mode................................................ 707
7.1.11 Exporting Results of the Bio Apps Analysis .................................. 708
7.1.12 Bio Apps View ............................................................................ 708
7.1.13 Bio Apps Tool ............................................................................. 711
7.1.14 Bio Apps Wizard ......................................................................... 712

8 Special/Hardware Related Modules ............................................... 721

8.1 Airyscan RAW Data .................................................................................... 721


8.1.1 Saving Images in 32ch Airyscan Format ...................................... 721
8.1.2 Exporting Data in 1ch Sheppard Sum Format .............................. 721
8.2 Coded Microscope ..................................................................................... 722
8.3 Correlative Array Tomography (CAT) .......................................................... 722
8.3.1 Basics of Array Tomography........................................................ 722
8.3.2 Sample Preparation..................................................................... 723
8.3.3 Pre-Settings (Light Microscope)................................................... 723
8.3.4 Experiment Settings .................................................................... 723
8.3.5 CAT Workflow ............................................................................ 724
8.3.6 CAT Tool..................................................................................... 752
8.3.7 Sample Holder Calibration Wizard............................................... 753
8.3.8 Acquisition Wizard...................................................................... 756
8.3.9 Z-Stack Alignment Wizard........................................................... 763
8.3.10 Correlation Wizard...................................................................... 765
8.3.11 Correlative Sample Holders ......................................................... 767
8.4 Dynamics Profiler ....................................................................................... 770
8.4.1 Overview Supported Laser Lines.................................................. 771
8.4.2 Setting Up and Performing a Dynamics Profiler Acquisition ......... 771
8.4.3 Exporting Data From Tables ........................................................ 772
8.4.4 Exporting Data From Charts ........................................................ 773
8.4.5 Opening the Reference Image as Separate Image ....................... 773
8.4.6 Cutting Out a Data Region.......................................................... 773
8.4.7 Saving Dynamics Profiler Documents as Compressed CZI ............ 774
8.4.8 Creating a Custom ωr Calibration ............................................... 774
8.4.9 Using Custom ωr Calibration....................................................... 774
8.4.10 Dynamics Profiler Acquisition Wizard .......................................... 775
8.4.11 Correlation View ......................................................................... 778
8.4.12 Diffusion View ............................................................................ 782
8.4.13 Flow View................................................................................... 785
8.4.14 Parameter Table Context Menu................................................... 788
8.4.15 Dynamics Profiler Calculations..................................................... 788
8.5 EM Processing Toolbox .............................................................................. 793
8.5.1 Workflow Overview .................................................................... 793
8.5.2 Aligning Z-Planes Manually ......................................................... 794
8.5.3 Aligning Z-Planes Automatically (Based on a ROI)........................ 795
8.5.4 Replacing Z-Slices in a Z-Stack..................................................... 796
8.5.5 Cutting Out a Volume from a Z-Stack ......................................... 796
8.5.6 Importing SmartFIB Tiffs ............................................................. 797
8.6 Confocal Topography................................................................................. 798

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 11


Content​ ZEISS

8.6.1 Acquiring Topography Images .................................................... 798


8.6.2 Measuring Layer Thickness.......................................................... 802
8.6.3 Topography Tool ........................................................................ 806
8.6.4 Topography Measurement Wizard .............................................. 806
8.6.5 Layer Thickness Measurement Tool............................................. 808
8.6.6 Layer Thickness Measurement Wizard......................................... 808
8.6.7 Acquisition Mode........................................................................ 810
8.6.8 Channel ...................................................................................... 811
8.6.9 Tiles ............................................................................................ 812
8.6.10 Z-Stack ....................................................................................... 812

9 Reference....................................................................................... 814

9.1 Menus ....................................................................................................... 814


9.1.1 File Menu.................................................................................... 814
9.1.2 Edit Menu................................................................................... 818
9.1.3 View Menu ................................................................................. 820
9.1.4 Acquisition Menu........................................................................ 820
9.1.5 Graphics Menu ........................................................................... 822
9.1.6 Macro Menu............................................................................... 823
9.1.7 Tools Menu................................................................................. 828
9.1.8 Window Menu............................................................................ 854
9.1.9 Help Menu.................................................................................. 855
9.2 Main Tabs .................................................................................................. 855
9.2.1 Locate Tab.................................................................................. 855
9.2.2 Acquisition Tab ........................................................................... 859
9.2.3 Processing Tab............................................................................ 873
9.2.4 Analysis Tab................................................................................ 873
9.2.5 Applications Tab ......................................................................... 874
9.2.6 Extensions Tab............................................................................ 874
9.3 Tools.......................................................................................................... 874
9.3.1 Acquisition Mode Tool................................................................ 874
9.3.2 AI Model Store Tool.................................................................... 888
9.3.3 ApoTome Mode Tool.................................................................. 889
9.3.4 Auto Save Tool ........................................................................... 890
9.3.5 Automated Image Export Tool .................................................... 892
9.3.6 Automation Tool......................................................................... 893
9.3.7 Camera Tool ............................................................................... 894
9.3.8 Channels Tool ............................................................................. 914
9.3.9 Cryo Temperature Tool ............................................................... 923
9.3.10 Definite Focus Tool ..................................................................... 924
9.3.11 Dynamics Tool ............................................................................ 924
9.3.12 Experiment Information Tool ...................................................... 925
9.3.13 Experiment Regions Tool............................................................. 926
9.3.14 Focus Strategy Tool .................................................................... 928
9.3.15 Focus Tool .................................................................................. 938
9.3.16 Image Analysis Tool .................................................................... 940
9.3.17 Image Analysis Wizard ................................................................ 941
9.3.18 Images and Documents Tool....................................................... 966
9.3.19 Imaging Setup Tool..................................................................... 967
9.3.20 Incubation Tool........................................................................... 970

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 12


Content​ ZEISS

9.3.21 Input Tool................................................................................... 971


9.3.22 Interactive Bleaching Tool ........................................................... 972
9.3.23 Interactive Measurement Tool..................................................... 973
9.3.24 Macro Tool ................................................................................. 979
9.3.25 Microscope Control Tool............................................................. 980
9.3.26 Microscope Tool ......................................................................... 983
9.3.27 Movie Recorder Tool................................................................... 984
9.3.28 Output Tool ................................................................................ 984
9.3.29 Pipeline Tool ............................................................................... 985
9.3.30 Stage Tool .................................................................................. 985
9.3.31 Stage/Focus not Calibrated Dialog .............................................. 988
9.3.32 Timed Bleaching Tool.................................................................. 989
9.4 Image Views .............................................................................................. 990
9.4.1 General Image Views .................................................................. 990
9.4.2 Specific Image Views ..................................................................1016
9.4.3 General View Options .................................................................1029
9.4.4 Full Screen Mode ........................................................................1050
9.4.5 Exposé Mode..............................................................................1051
9.4.6 Splitter Mode..............................................................................1051
9.5 File Browser ...............................................................................................1053
9.5.1 Tools Tab....................................................................................1053

10 Systems & Components .................................................................1054

10.1 ApoTome.2................................................................................................1054
10.1.1 Introduction................................................................................1054
10.1.2 Principle of Imaging Using Fringe Projection ...............................1054
10.1.3 Optimum Acquisition Conditions.................................................1058
10.1.4 List of Recommended Objectives ................................................1059
10.1.5 Preparation: Phase Calibration ....................................................1062
10.1.6 Step 1: Define Channels Using Smart Setup ................................1062
10.1.7 Step 2: Grid Focus Calibration .....................................................1064
10.1.8 Step 3: Perform ApoTome Experiment ........................................1067
10.1.9 Step 4: Process the Resulting Image............................................1069
10.1.10 Step 5: Perform Z-Stack Acquisition ............................................1071
10.1.11 Step 6: Perform ApoTome Deconvolution ...................................1073
10.1.12 Reference ...................................................................................1076
10.2 Axio Observer ............................................................................................1077
10.2.1 Auto Immersion ..........................................................................1077
10.3 Axioscan ....................................................................................................1081
10.3.1 Introduction................................................................................1081
10.3.2 Working with ZEN slidescan........................................................1081
10.3.3 Ensuring Correct Focus ...............................................................1107
10.3.4 Reference ...................................................................................1117
10.4 Celldiscoverer 7..........................................................................................1155
10.4.1 Introduction................................................................................1155
10.4.2 Performing a Celldiscoverer Calibration .......................................1156
10.4.3 Using Customized Sample Carriers ..............................................1159
10.4.4 Shading References on Celldiscoverer .........................................1160

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 13


Content​ ZEISS

10.4.5 Running Looped Time Series Experiments on Multiple Samples ...1164


10.4.6 Auto Immersion ..........................................................................1165
10.4.7 Restarting the Microscope Remotely ...........................................1166
10.4.8 Calculating the Disparity Map for Mixed Mode Acquisition .........1167
10.4.9 Sample Tab (Interactive Mode)....................................................1171
10.4.10 Sample Tab (Automation mode)..................................................1173
10.4.11 Navigation View .........................................................................1177
10.4.12 Navigation Tab ...........................................................................1179
10.4.13 Magazine View ...........................................................................1179
10.4.14 Experiment Designer (Multi Carrier Mode)...................................1182
10.4.15 Celldiscoverer Tool......................................................................1183
10.4.16 Mixed Mode Settings..................................................................1184
10.4.17 Airyscan HS.................................................................................1189
10.4.18 Airyscan MPLX HS.......................................................................1190
10.4.19 Dispensing Tool ..........................................................................1191
10.4.20 Perfusion ....................................................................................1192
10.4.21 Celldiscoverer Options ................................................................1193
10.4.22 Smart Setup................................................................................1195
10.5 Lattice Lightsheet.......................................................................................1195
10.5.1 Starting the Software for Lattice Lightsheet ................................1195
10.5.2 Stage LLS Tool ............................................................................1196
10.5.3 Lattice Lightsheet Auto Immersion Tool ......................................1196
10.5.4 Lightsheet/Abberation Control Tool ............................................1197
10.5.5 Focus Alignment Sharpness Control Tool ....................................1197
10.5.6 Deskew.......................................................................................1198
10.5.7 Lattice Lightsheet........................................................................1198
10.6 Linkam Cryo Stage .....................................................................................1198
10.6.1 Exporting Temperature Data .......................................................1198
10.6.2 Adding Temperature Annotations to an Image ...........................1199
10.7 LSM 900/980 .............................................................................................1200
10.7.1 Confocal Image Acquisition (LSM)...............................................1200
10.7.2 Imaging Setup ............................................................................1221
10.7.3 Image Acquisition with the Near Infrared 730nm Laser...............1233
10.7.4 Fluorescence-Lifetime Imaging Microscopy .................................1236
10.7.5 FCS (Fluorescence Correlation Spectroscopy)...............................1240
10.7.6 Polarization Imaging ...................................................................1285
10.7.7 System Maintenance...................................................................1290
10.7.8 Lasers Tool..................................................................................1300
10.8 Lattice SIM Family ......................................................................................1302
10.8.1 Principles of Superresolution Microscopy ....................................1302
10.8.2 Principle of Structured Illumination Microscopy (SIM)..................1302
10.8.3 Principle of Photo Activated Localization Microscopy (SMLM) .....1303
10.8.4 Starting the Software for Lattice SIM ..........................................1304
10.8.5 Using SIM Processing in Direct Processing...................................1304
10.8.6 SIM Processing............................................................................1305
10.8.7 Localization Microscopy Processing.............................................1309
10.9 Viluma 9 ....................................................................................................1310
10.9.1 Controlling the Viluma 9 Light Source with the Microscope Tool
or Imaging Setup Tool ................................................................1310
10.9.2 Controlling the Viluma 9 Light Source with the Channels Tool ....1311

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 14


Content​ ZEISS

11 Maintenance ..................................................................................1312

11.1 Creating a Service Report ...........................................................................1312


11.2 Requirements for Docker Desktop..............................................................1313
11.2.1 Adapting the Resource Allocation for Docker Desktop Manually1314 .
11.2.2 Deactivating Experimental Docker Features.................................1314

12 FAQ ...............................................................................................1316

12.1 What can I do If my image is too dark? ......................................................1316


12.2 How can I balance my images color?..........................................................1316
12.3 How can it be that my image has dust or a shadow, although my speci-
men is clean? .............................................................................................1317
12.4 Why my image seems to look that something have burned in? (i.e. a
shadow of a previous specimen?)...............................................................1317
12.5 How can I fix a color gradient cast?............................................................1317
12.6 What can I do if my live image is of a low quality and looks pixelated? ......1317
12.7 What can I do if my live image is slow? ......................................................1317
12.8 What can I do if my live image is mostly red/blue? .....................................1318
12.9 What can I do if my live image is still black or white after setting the expo-
sure? ..........................................................................................................1318
12.10 Why my live image shows extreme colors in comparison to what I see in
the eyepieces?............................................................................................1318
12.11 Why is my image resolution lower than the given camera specification? ....1318
12.12 What can I do if I do not see a focused live image? ....................................1318
12.13 Why is my image color not the same that I see through the eye pieces?.....1318
12.14 What should I do to adjust parameters of a SWAF run prior to using it in
experiments?..............................................................................................1319
12.15 The SWAF returns an error message. What does this mean and how can I
correct this? ...............................................................................................1319
12.16 SWAF returns a failure after reaching a search boundary – what`s wrong?1319
.
12.17 When should I use the Full or Smart setting?..............................................1320
12.18 Can I change camera parameters in a SWAF run e.g. exposure time or bin-
ning?..........................................................................................................1320

Glossary .........................................................................................1321

Index..............................................................................................1332

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 15


1 General Information | 1.1 Welcome ZEISS

1 General Information
1.1 Welcome

About this Software


ZEN is a modular image acquisition, processing and analysis software for digital microscopy. The
abbreviation ZEN stands for ZEISS Efficient Navigation and points out that the software can be
used to control microscopes and imaging systems by ZEISS.
In addition to basic functionality for image acquisition, elementary image processing and annota-
tions and image analysis a lot of optional modules for specific microscopy tasks are available.
With ZEN lite the basic version of the software is available for free. Starting from a basic func-
tionality for image acquisition, simple image processing, image analysis and documentation a lot
of optional modules are available for ZEN lite as well. More detailed information is available in the
product brochure.

See also
2 Basic Concepts [} 38]
2 First Steps [} 22]

1.2 Text Conventions and Link Types

Explanation Example
Software controls and GUI elements. Click Tools in the menu bar.

Hardware controls and elements. Set the main switch to ON.

Key on the keyboard. Press Enter on the keyboard.

Press several keys on the keyboard simultane- Press Ctrl + Alt + Del.
ously.

Follow a path in the software. Select Tools > Options > Language.

Text to be entered by the user. Enter example.pdf in this field.

Anything typed in literally during program- Enter Integer in the console.


ming, for example macro codes and key-
words.

Link to further information within this docu- See: Text Conventions and Link Types
ment. [} 16].

Link to a website. https://www.zeiss.com

1.3 Explanation of Warning Messages and Additional Information

CAUTION, and NOTICE are standard signal words used to determine the levels of hazards and
risks of personal injury and property damage. Read all safety messages in the respective chapters
carefully. Failure to comply with these instructions and warnings can result in both possible per-
sonal injury and property damage and involve the loss of any claims for damages.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 16


1 General Information | 1.4 Calling up the Help ZEISS

The following warning messages indicating dangerous situations and hazards are used in this doc-
ument.

CAUTION
Type and source of danger
CAUTION indicates a potentially hazardous situation which, if not avoided, may result in minor
or moderate injury.

NOTICE
Type and source of danger
NOTICE indicates a potentially harmful situation which, if not avoided, may result in property
damage. In addition, NOTICE warns of data loss or corrupt data as well.

Info
Provides additional information or explanations to help the user better understand the con-
tents of this document.

1.4 Calling up the Help

To call up the documentation,

§ in the software open the menu Help > Contents....


§ in the software press F1.
§ in the software click in the top right, write your search term and press Enter.
§ in the Windows file browser go to \\Program Files\Carl Zeiss\ZEN 2\ZEN 2 (blue edition)
\Manuals.
Additionally click on the question mark symbol ? in the Title bar. The cursor then appears as a
question mark symbol. Then click on an area in the software which you want to get help for. If
there is a related help topic available, it will open directly.

ZEISS Help Viewer User Interface


The following screenshot indicates the main elements of the user interface:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 17


1 General Information | 1.5 Intended Purpose ZEISS

4 5 6

Fig. 1: Help Viewer User Interface

1 Index
List of keywords to help you find topics and content quickly.

2 Topics
Contains the structure tree with a list of all the topics.

3 Search
Search through the entire text.
It supports partial strings but not wildcards.

4 Structure tree
Enables you to navigate through topics sequentially. A > indicates a topic has subtopics.

5 Content panel

6 Print
Enables you to print the currently displayed topic.

1.5 Intended Purpose

ZEN is a microscope software for microscope control, image acquisition, image processing and
image analysis. The field of application of the software covers general tasks and applications in
microscopy or image acquisition in routine and research, among others in life sciences.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 18


1 General Information | 1.6 Important Notes ZEISS

The software is not intended to directly or indirectly produce medical diagnostic results.

1.6 Important Notes

To avoid possible data loss, corrupted data or incorrect measurements, check and observe the fol-
lowing:

§ Only trained persons are allowed to work with the software, e.g. performing measurements.
Each user must have been informed about the possible risks connected with work in the field
of microscopy and the relevant area of application.
§ Check if all hardware components are correctly configured in the MTB configuration software.
§ Check the accuracy of a generated scaling (pixel sizes) immediately after starting up the sys-
tem. When using manual microscopes, you must always check that the correct scaling has
been selected before the acquisition of each image, in order to avoid incorrect measurements.
The accuracy of all scalings generated should be checked at regular intervals.
§ Save all your data, such as images, measurement data, archives, reports, forms and docu-
ments at regular intervals on an external storage medium. Otherwise, this data may be lost as
a result of operational errors or hardware defects.

1.7 Further Applicable Documents

Instruction For detailed information on how to use the hardware (e.g. microscope or microscope system), re-
Manuals fer to its Instruction Manual or ask your ZEISS Sales & Service Partner.

System For more details on system requirements for the software, please refer to the corresponding
Requirements Installation Guide.

Local and Na- Observe local and national health and safety regulations for the location of installation and during
tional Health the use of the microscope.
and Safety Reg-
ulations Consult with your ZEISS Sales & Service Partner if these regulations are in conflict with the in-
stallation requirements of the microscope.
System and Information about the individual components, enhancements, and accessories can be obtained
Third-Party from your ZEISS Sales & Service Partner. Also refer to the documentation of third-party manu-
Components,
facturers.
Accessories

1.8 Legal Notes

ZEISS draws the user's attention to the fact that the information and references contained in this
documentation may be subject to technical modifications, in particular due to the continuous fur-
ther development of ZEISS products. The documentation enclosed does not contain any warranty
by ZEISS with regard to the technical processes described in the documentation or to certain re-
produced product characteristics. Furthermore, ZEISS shall not be held liable for any possible
printing errors or other inaccuracies in this documentation, unless proof can be furnished that any
such errors or inaccuracies are already known by ZEISS or that these are not known to ZEISS due
to gross negligence and that furthermore ZEISS has for these reasons refrained from eliminating
these errors or inaccuracies appropriately. ZEISS hereby explicitly draws the user's attention to the
fact that this documentation only contains a general description of the technical processes and in-
formation, the implementation of which in any individual case may not be appropriate in the form
described here. In cases of doubt, we recommend the user to consult ZEISS service and support.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 19


1 General Information | 1.9 Contact ZEISS

This documentation is protected by copyright. ZEISS has reserved all rights to this documentation.
It is prohibited to make copies, partial copies, or to translate this documentation into any other
language, except for personal use.
ZEISS explicitly draws attention to the fact that the information contained in this documentation
will be updated regularly in compliance with the technical modifications and supplements carried
out in the products and furthermore that this documentation only reflects the technical status of
ZEISS products at the time of printing.

Disclaimer
Note that this software contains an extension that enables you to connect it with the third party
software ImageJ. ImageJ is not a ZEISS product. Therefore, ZEISS undertakes no warranty con-
cerning ImageJ, makes no representation that ImageJ or derivatives such as Fiji or related macros
will work on your hardware and will not be liable for any damages caused by the use of this ex-
tension. By using the extension, you agree to this disclaimer.
Third Party If you use software or hardware from other manufacturers (third party) or perform software
Software/Hard- changes on the system computer, you must first check that the hardware or software or the soft-
ware ware changes are compatible with ZEISS software. Following the installation of software or hard-
ware from other manufacturers, you must always perform a thorough check to ensure that the
performance of all your ZEISS software components is unaffected.
Applicable Stan- This software and the corresponding documentation has been designed, created and tested in
dards & Regula- compliance with the following regulations and directives:
tions
§ Quality management system certified to DIN EN ISO 13485
§ Documentation and Safety Notes according to DIN EN 82079-1 (VDE 0039-1)

1.9 Contact

If you have any questions or problems, contact your local ZEISS Sales & Service Partner or one
of the following addresses:

Headquarters

Phone: +49 1803 33 63 34

Fax: +49 3641 64 3439

Email: [email protected]

Microscopy Courses, Training, and Education


For information on microscopy courses, training, and education visit ZEISS Academy Microscopy.

ZEISS Portal
The ZEISS Portal (https://portal.zeiss.com/) offers various services that simplify the daily work with
your ZEISS systems (machines and software).

Service Germany

Phone: +49 7364 20 3800

Fax: +49 7364 20 3226

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 20


1 General Information | 1.9 Contact ZEISS

Email: [email protected]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 21


2 First Steps | 2.1 Starting Software ZEISS

2 First Steps
2.1 Starting Software

Info
Using pre-recorded Images
For using pre-recorded images when starting the software, in the menu Tools > Options >
Startup, the Reload Last Used Documents checkbox must be activated.

Prerequisite ü Microscope and hardware components are switched on and are ready for operation.
ü ZEN software is installed on your computer.
1. Double-click on the program icon on your desktop.

2. Alternatively click Start > Carl Zeiss Microscopy > ZEN.


à The software starts and displays a loading screen. After a while you see the smart profile
selection screen. The application automatically detects your microscope based on your
hardware, MTB configuration and licenses.
3. Click on the ZEN profile you want to work with. Alternatively, click Go to Manual Profile
Selection to manually select a specific software profile.
à The software starts. During the program start, the hardware settings are initialized.
à The Welcome Screen opens, see Welcome Screen [} 23].

4. To open a recently opened file, click on the respective entry.


à The Welcome Screen closes, and the file is opened in ZEN.
5. To create a new ZEN Connect project, click Create New Project.
6. To acquire a completely new image, click Acquire New Image.
à The Welcome Screen closes and allows you to set up a new image acquisition experi-
ment.
7. To open an existing file, click Open Existing.
à A file browser opens.
8. Select the file and click Open.
à The Welcome Screen and file browser close and the file is opened in ZEN.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 22


2 First Steps | 2.2 Welcome Screen ZEISS

See also
2 Creating a ZEN Connect Project [} 625]

2.2 Welcome Screen

Info
Reopening
After you have exited this screen, you can reopen it by clicking File > Show Welcome
Screen, if necessary.

1 2

1 Overview Area
In this area you can get a general overview for ZEN, see Overview Area [} 23].

2 Recently Opened List


Here you have list with recently opened data. Clicking an entry opens the respective file
in ZEN and closes this window.

3 Start Buttons
With these buttons you can start by opening existing documents or create new ones, see
Start Buttons [} 24].

2.2.1 Overview Area

Parameter Description
What's new Opens the browser to show you what is new in this version of ZEN.

Learn & Support Opens the browser to display the site with support and learning mate-
rial for ZEN.

Do not show this Activated: The Welcome Screen is not displayed on startup anymore.
at startup
You can also change this setting in Tools > Options >Startup/Shut-
down > Welcome Screen.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 23


2 First Steps | 2.3 User Interface ZEISS

2.2.2 Start Buttons

Parameter Description
Open Existing Opens a file browser to select an already existing file you want to
open in ZEN.

Acquire New Im- Only visible if you have started a profile with acquisition.
age Closes the Welcome Screen to allow the setup of a new acquisition.

Create New Opens the New Document dialog to create a new ZEN Connect
Project project.

See also
2 Creating a ZEN Connect Project [} 625]
2 New Document Dialog [} 817]

2.3 User Interface

The software user interface is divided into three main areas.


1 2 3

Fig. 2: User interface

1 Left Tool Area


With the tabs you can access all the main tools for microscope control (Locate tab), ac-
quisition (Acquisition tab), image processing (Processing tab), image analysis (Analysis
tab), and applications (Applications tab).

2 Center Screen Area


This area is used to display your images with several image views available.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 24


2 First Steps | 2.3 User Interface ZEISS

3 Right Tool Area


Here you find the Images and Documents tool and hardware controls e.g. for stage and
focus. Additionally, system specific tools are available here (e.g. Definite Focus and ZEN
Connect controls).

2.3.1 Title Bar

Parameter Description
Help icon Activates the "drag & drop“ help function. A question mark ap-
pears beside the mouse pointer. Move the mouse pointer to a
place in the software where you need help. Left-click on the de-
sired location. The online help opens.

Minimize Minimizes the program window.

Maximize Over 2 Maximizes the program window across 2 screens if available.


Screens This option is only possible if you are working with 2 screens
with the same resolution.

Maximize Maximizes the program window to the main screen.

Restore Down Reduces the program window to any selected size.

Close Closes the program window.

2.3.2 Workspace Configuration

Fig. 3: Workspace Configuration


Here you find settings to adjust your workspace. Select Light/Dark Design of the user interface
or enlarge the screen with Workspace Zoom slider. You can also save and reload all personal
settings in a workspace configuration, the name must have at least one character. With the Dock
all tool windows button in the top right corner you can easily dock all undocked tools with
one click.

2.3.3 Menu Bar

Fig. 4: Menu bar


The menu bar contains all the menus you need for managing, editing, and viewing your projects.

See also
2 File Menu [} 814]
2 Edit Menu [} 818]
2 View Menu [} 820]
2 Acquisition Menu [} 820]
2 Graphics Menu [} 822]
2 Macro Menu [} 823]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 25


2 First Steps | 2.3 User Interface ZEISS

2 Tools Menu [} 828]


2 Window Menu [} 854]
2 Help Menu [} 855]

2.3.4 Tool Bar

Fig. 5: Tool Bar


Here you gain quick access to important functions, e.g. saving or opening files. Further right you
find more workspace settings, e.g. Design and Workspace selection. Read how to customize the
Tool bar in chapter Customizing Toolbar [} 39].

2.3.5 Left Tool Area

This area contains the main tabs for microscope and camera settings (Locate tab), image acquisi-
tion (Acquisition tab), image processing (Processing tab), and image analysis (Analysis tab). The
main tabs are organized in an order which follows the typical workflow of experiments in bio-
science or material science.

Fig. 6: Left Tool Area

See also
2 Locate Tab [} 855]
2 Acquisition Tab [} 859]
2 Processing Tab [} 873]
2 Analysis Tab [} 873]
2 Extensions Tab [} 874]

2.3.6 Center Screen Area

The Center Screen Area is structured in 4 areas.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 26


2 First Steps | 2.3 User Interface ZEISS

1 2 3 4

Fig. 7: Center Screen Area


1 Document Bar
Here you can switch between all your opened documents. For more information, see
Document Bar [} 28].

2 Image Views
Area where you can switch between different image views by selecting the correspond-
ing tab in the list.

3 View Options
Area for general and specific view options.

4 Image Area
Area where images, reports, and tables are displayed.

See also
2 Image Views [} 990]
2 General View Options [} 1029]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 27


2 First Steps | 2.3 User Interface ZEISS

2.3.7 Right Tool Area

This area contains mainly the tools for image and file handling (e.g. Image Gallery) and hardware
control (e.g. Stage/Focus tool). Depending on your system configuration, other tools can be
available. The tools are described in the corresponding chapters of the online help.

See also
2 ZEN Connect Tool [} 650]
2 Stage Tool [} 985]
2 Focus Tool [} 938]
2 Incubation Tool [} 970]
2 Microscope Tool [} 983]
2 Images and Documents Tool [} 966]
2 Macro Tool [} 979]

2.3.8 Document Bar

Here you see tabs of all open documents. Click on a tab to view the image/document. On the
right end of document bar, you find buttons to switch view mode from Exposé to Splitter mode
and further view options (View menu).

Info
An asterisk (*) next to an image/document title indicates that changes have been made to this
document which are not yet saved. Save your pictures/documents from time to time in order
to avoid data loss.

Parameter Description
Opens the exposé view mode.

Exposé Mode

Opens the splitter view mode.

Splitter Mode

Displays the options of the view menu.


Options

See also
2 Exposé Mode [} 1051]
2 Splitter Mode [} 1051]
2 View Menu [} 820]

2.3.9 Status Bar

The status bar shows important information on the system status:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 28


2 First Steps | 2.3 User Interface ZEISS

Parameter Description
Scaling Displays which lateral scaling is currently being used. If you click on
the arrow, the Scaling dialog [} 831] will be opened. There you have
access to advanced scaling settings and the scaling wizard.

System Informa- Always shows the latest, currently active process that the system is
tion performing.

Progress bar Displays the progress of the currently active process. Each new
process added supersedes older still active processes. If you click on
the arrow button, a window opens with a list of all processes in
chronological order. You can stop a process that is running using the
Stop button.

Performance indi- In this group you will see an overview of the performance of individ-
cators ual computer components:
§ Free RAM indicates how much physical memory is still available.
§ Free HD indicates how much space is still available on the hard
drive onto which the next image is to be acquired (see Tools > Op-
tions > Saving).
§ CPU indicates the usage of the Central Processing Unit.
§ The small status bar provides an overall assessment of the system
usage.
§ GPU indicates the usage of the Graphics Processing Unit by ZEN
and ZEN related services. It is also visualized by a small status bar
on its right.
Note: This GPU indicator is only visible if you your computer has
Microsoft Windows 10 version 1709 or higher.

Info: Double-clicking in the Performance Indicators area opens the


Windows Task Manager.

Frame Rate Indicates the current frame rate in frames per second (fps) used by the
active camera for producing new images. Please note in most cases
that at speeds greater than 100 frames per second, this value cannot
always be accurately determined.

Pixel Value Displays the gray value to the image at the current position of the
mouse pointer. In the case of multichannel images, the gray value/
channel is displayed for up to 4 channels.

Position Displays the X/Y position (in pixel coordinates) of the mouse pointer in
the image.

Information (i) If you click on the icon, a window opens with System Messages
[} 30].

Storage Folder Displays the location where new images are automatically saved. This
path can be changed in the menu Tools > Options > Saving.

Optional If you click on the arrow the Alignment Tool window opens.
Status: Airyscan
Detector Align-
ment

User Shows the Windows user name of the logged in user.

Time Shows the current Windows system time.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 29


2 First Steps | 2.4 Setting User Language ZEISS

See also
2 Airyscan Detector Adjustment [} 1294]

2.3.9.1 System Messages

If you right-click on a system message the Copy button will appear. Left-click on Copy button to
copy the message to clipboard. Then paste it into a text file or an E-Mail. The idea behind is that
you can easily send error messages to your support team for example. This copy/paste function
works for all upcoming system messages or error messages within the application as well.

Parameter Description
System information that arises during normal operation. This system
information does not lead to an interruption of the workflow. The in-
formation window is not displayed automatically.
Information

Information that requires input from the user, e.g. a prompt to


change a manual microscope component. This information leads to
the information window being shown briefly. However, it closes again
Warnings after a few seconds.

Error messages indicate a malfunction by the system. In this case the


information window opens and remains open. The system requires in-
put from the user in order to continue.
Errors

Info
Hundreds of messages can accumulate in the course of a session. A maximum of 300 mes-
sages are displayed. To display messages for a certain category, activate or deactivate the cor-
responding checkboxes.

2.4 Setting User Language

Info
If the Select Automatically checkbox is activated, the software uses the language which is
set in the system settings of your computer. This is the default setting.

Prerequisite ü You have started the application.


1. Go to Tools > Options dialog.
à In the group Software the entry General is selected.
2. Deactivate the Select Automatically checkbox to select the language manually.
3. Select the user language from the Fixed Language drop-down list.
à A message appears to restart the application.
à Note that the availability of additional languages can differ between software versions.
4. Click OK.
à The Options dialog closes.
5. Exit and restart software.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 30


2 First Steps | 2.5 Activating Show All Mode ZEISS

2.5 Activating Show All Mode

1. With the Show All mode deactivated (default setting), only the basic functions of tool win-
dows or view options are shown.

2. To show the advanced settings or expert functions of tool windows or view options, click
Show All.

2.6 Configuring Microscope Components

This chapter refers to the manual configuration of the microscope components in ZEN lite. All mi-
croscope components definitions will be stored in the meta data of the acquired image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 31


2 First Steps | 2.6 Configuring Microscope Components ZEISS

Prerequisite ü You have selected the Camera tab.

1. Click Microscope Components.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 32


2 First Steps | 2.7 Acquiring Camera Image ZEISS

à The tool will open. Consider that the button Show all is activated.

2. For Objective select that objective you will use for your acquisitions.
3. Select all other microscope components you will use (i.e. Optovar, Reflector, etc.).
You have successfully configured your microscope components.

Info
If you have activated the Select automatically button in the status bar under Scaling (stan-
dard settings), the scaling will be calculated on the basis of your definitions. If you want to
perform a manual scaling, read the chapter Creating Manual Scaling [} 36].

2.7 Acquiring Camera Image

This topic guides you through acquiring your first camera image with the software.

Prerequisite ü You have connected and configured a microscope camera (i.e. Axiocam 305 color/mono) to
your system.
ü You have started the software.
ü You have configured the microscope components (e.g. objective, camera adapter) and you
are using the automatic or manual scaling.
ü You are on the Camera (ZEN lite only) or Locate tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 33


2 First Steps | 2.7 Acquiring Camera Image ZEISS

ü You see your microscope camera available in the Active Camera section. If not, select the
camera from the list.

1. Position your sample on the microscope and adjust the microscope to see a focused image
through the eyepieces.
2. Adjust the tube slider of the microscope to divert the image to the camera (e.g. 50% cam-
era and 50% eyepieces).
3. Click Live.
à The Live Mode will be activated. In the Center Screen Area you will see the camera
live image. By default, the live image shows a crosshair helping to navigate on the speci-
men. In the chapter Adjusting Live Image Settings [} 35] you will learn how to opti-
mize live image display.

4. Click Set Exposure.


à The exposure time will be automatically determined and set.
5. Click Snap.
You successfully acquired your first image. Save the image in the file system via the File menu >
Save as.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 34


2 First Steps | 2.8 Adding Annotations ZEISS

Info
If you do not see a focused image, please refocus the specimen on the microscope. You may
activate the focus bar as an additional aid. Right-click in the Center Screen Area to open the
context menu. Select the entry Focus Bar. The focus bar will be shown.

See also
2 Document Bar [} 28]

2.8 Adding Annotations

Annotations are the generic term for all the graphics (e.g. rectangle, arrow, scale), measurements,
texts or other metadata (e.g. recording time) that you can add to your image.

Prerequisite ü You have loaded an image.


1. Select Graphics.

2. Click Scale Bar.


à The scale bar will appear directly in the image.
à To edit an annotation (e.g. color, line width) you can right-click on the annotation in the
image and select Format Graphical Elements from the context menu.
3. Click Draw Arrow.
à You can now draw an arrow into the image.

See also
2 Adding Annotations to Images or Movies [} 61]

2.9 Adjusting Live Image Settings

Prerequisite ü You have started the Live mode via the Live button and see the camera’s live image in the
Center Screen Area.
ü Under the image area you see the general view options on Dimensions tab, Graphics tab
and Display tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 35


2 First Steps | 2.10 Creating Manual Scaling ZEISS

1. In the Dimensions tab activate the Range Indicator checkbox. This will mark overexposed
(too bright) areas in the live image in red and underexposed (too dark) areas in blue.
2. On the Display tab click 0.45. The display curve will be adapted to a gamma value of 0.45.
This will set the optimum color presentation. If you do not see this button, activate the
Show all mode.
3. Move the controls under the display curve left and right in order to directly adjust the val-
ues for Contrast (Black) 1 , Gamma 2 , and Brightness (White) 3 in the live
image.

1 2 3

Info
With the settings above the display of the live image will be adapted. These settings will also
be transferred to your acquired image. This will not change the camera settings.

2.10 Creating Manual Scaling

Info
Availability of Created Scaling
If you create a manual scaling, this data is by default user specific, i.e. the scaling is not glob-
ally available for all users of the PC. The scaling is saved in C:\Users\Username\Docu-
ments\Carl Zeiss\ZEN\Documents\Scalings.
4 If you create a scaling that should be available to all users on the PC, you have to place the
file into C:\Program Files\Carl Zeiss\ZEN 2\ZEN 2 (blue edition)\ZEN\en\Docu-
ments\Scalings.

Prerequisite ü You have an object micrometer oriented horizontally on the microscope stage.
ü You have defined all your microscope settings correctly with the Microscope Control tool, or
the Microscope Components tool (ZEN lite only). In our example we use an objective with a
10x magnification.
1. Acquire an image of the scale in your object micrometer using the objective to be scaled
manually, see also Acquiring Camera Image [} 33].
à The image is displayed in ZEN.
2. In the bottom status bar click the small arrow in the Scaling section.
à The Scaling dialog opens.
3. In the dialog, deactivate Select Automatically.
4. In the Create new scaling section, click Interactive Calibration....
à The calibration window opens in the image area.
5. Click Single Reference Line (selected by default) and activate Automatic Line Detection.
6. Draw in the reference line along the scale.
7. Enter the true distance between both scale lines in the calibration window. In our example
this is 500 micrometers.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 36


2 First Steps | 2.11 Closing Software ZEISS

8. Enter a name for the scaling (i.e. Obj 10x) and click Save Scaling.
You performed a manual scaling for your objective. Repeat this sequence for all objectives you
need a manual scaling for. Always ensure that you select the correct objective in the Microscope
Control tool (or the Microscope Components tool in ZEN lite), as well as the matching per-
formed scaling in the status bar.

Info
4 The function Automatic Line Detection calculates the theoretical maximum of the refer-
ence line‘s both end points to the closest scale lines in the image. Thus, the distance will
be calculated with sub-pixel accuracy.
4 If you have defined a manual scaling for an objective and activate the checkbox Select
Automatically, the software will use the measured scaling instead of the theoretic one.
You will recognize this via the label Measured instead of Theoretic beside the pixel size.

2.11 Closing Software

1. Click File > Exit. Alternatively, you can use the shortcut Alt+F4 or click Close in the pro-
gram bar.

Info
If you have not saved your files, the Save Documents dialog opens before the software
closes. Select the files you want to save or the files you want to discard. If you are connected
to ZEN Data Storage, you can also select to save and upload the files to the server.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 37


3 Basic Concepts | 3.1 Image Acquisition ZEISS

3 Basic Concepts
3.1 Image Acquisition

The software completes all microscopes, microscope systems like LSM, and cameras from ZEISS to
efficient and tailor-made imaging systems. With little training you will interactively control the en-
tire workflow from image acquisition, processing and analysis.
Depending on the system you can capture single images, multi-channel fluorescence images or
video sequences with up to 16-bit per channel image information. The software contains the so
called "Smart Setup" which automatically delivers several proposals for the optimal dye and wave-
length combinations for an experiment.
A wide range of different cameras can be used, starting from simple consumer cameras through
to high-resolution and high-sensitivity microscope cameras. The seamless integration of cameras
into the software allows you to acquire complex images and image sequences by one mouse
click. For best results we recommend to use ZEISS Axiocam microscope cameras.

3.2 Image Processing

After acquiring an image, it is immediately displayed on your screen. It can then be optimized us-
ing a wide range of techniques:

§ Contrast, brightness and color adjustment


§ Noise suppression, smoothing and contour enhancement
§ Sharpness enhancement/emphasizing of details
§ Correction of illumination influences and white balance
The software can also be used to add any annotations that you may require to the images. All ele-
ments, from scale bars and colored markings through to text and graphics, have been integrated
into the program.

3.3 Image Analysis

Even with ZEN lite, you are able to perform simple interactive measurements. The measured val-
ues (e.g. lengths, areas, and perimeters) are made available in a data table and can be processed
further using spreadsheet programs.
With the optional modules Image Analysis and Measurement, you can perform professional
analysis tasks like generating automatic measurement procedures or measuring microscopic struc-
tures interactively.

3.4 File Format

For the ZEN software we developed a special file format called *.czi (Carl Zeiss Image). Besides the
image data itself, the image format saves a lot of additional data, for example the date of acquisi-
tion, microscope settings, exposure values, size and scale details, contrast procedures which were
used. Also, all annotations and measured values are saved with the file.
To learn more about the ZEISS image file format we recommend to visit the ZEISS Microscopy
Community forum in the internet (http://forums.zeiss.com/microscopy/community/forum.php).
There you can join interesting discussions or download the detailed documentation of the file for-
mat.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 38


3 Basic Concepts | 3.5 Extensions ZEISS

Fig. 8: CZI file format

3.5 Extensions

The extensions concept allows you to extend ZEN dynamically in its functionality. From a technical
point of view the concept is comparable with plug-in`s or add-on`s. For the extensions we re-
served a special area (Extensions tab [} 874]) within the software so that you can find all loaded
extensions at a glance.

3.6 Customizing the Application

3.6.1 Selecting Screen Design

In the upper right corner of the program window under Design, you can select a Light or Dark
screen layout. Optionally, you can change the design with the shortcut Ctrl+D.

3.6.2 Customizing Toolbar

Prerequisite ü You are in the Tools menu > Customize Application dialog.
ü The Toolbar tab is selected by default.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 39


3 Basic Concepts | 3.6 Customizing the Application ZEISS

1. Click on an entry in the Available Toolbar Items list.


à You will see a list of all available items in this group.
2. Double-click on an item.
à The item will be added to the Selected Toolbar Items list and does appear in the Tool-
bar within the application. Alternatively, you can add the items per Drag&Drop.
3. In order to change the order of symbols in the toolbar use the Up/Down buttons.
4. If you want to delete an Icon from the toolbar, click on the Delete button.
5. Click on Close button to close the dialog. The changes will be effective right now.
You have successfully customized the Toolbar.

3.6.3 Adjusting Workspace Zoom

To enlarge the workspace, move the slider left or right. Click Reset to come back to the default
setting.

3.6.4 Showing/Hiding Workspace Areas

1. Click Show/Hide to show or hide screen areas.

3.6.5 Undocking/Docking Tool Windows

This function allows you to undock/dock a tool window. An undocked tool window can be posi-
tioned anywhere on the screen.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 40


3 Basic Concepts | 3.6 Customizing the Application ZEISS

1. Click Undock to undock a tool window. Once undocked, the tool window can be moved
around by clicking and dragging it on the blue bar.

2. Click Dock to dock a tool window back to its place in the left tool area.

Info
With the dock all tools function in the Workspace Configuration [} 25] you can globally at-
tach all undocked tool windows back to their initial position.

3.6.6 Displaying and Adapting a Grid in the Image Area

Info
Persistence of the Grid
If you add the grid during a Live or Continuous acquisition, the grid setting is persisted for all
future acquisitions. To deactivate the grid, it has to be deactivated in the same mode as it had
been activated, i.e. during Live or Continuous acquisition.

Prerequisite ü You have opened an image in which you want to display a grid, or you have started a Live or
Continuous acquisition.
1. Right-click into the image and select Grid. Alternatively, click Graphics > Grid in the menu
bar.
à The grid is displayed in the image.

2. Right-click precisely on a grid line and select Format Graphical Elements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 41


3 Basic Concepts | 3.7 User Management ZEISS

à The Format Grid dialog is displayed.

3. Use the available options to adapt the grid to your needs.


à The changes are displayed in the image.
4. Activate Synchronize. This function means that any changes made, e.g. to the number of
columns, are adopted simultaneously for the number of rows. The grid therefore remains
square.
5. To set a higher number of columns, use the Columns or enter a value in the input field.
6. Click to save the grid settings.
à The Windows file browser opens.
7. Enter a name and click Save.
8. Click Close to exit the Format Grid dialog.
You have inserted a grid into your image, edited the grid and saved your grid settings.

3.7 User Management

The software can be used with or without user management.

Without user management


User management is disabled by default. This means that every user has the same rights. No user-
name or password is required and there are no user roles within the software (i.e. the user can
perform any action).

With user management


If user management is enabled, each user has an account which is used to log into the software.
Each user account is assigned to one or more user groups. User groups define the privileges (ac-
tions the user can perform in the software) for the users assigned to the group. Groups typically
correspond to the roles in the software (e.g. Administrator, User). However, you can also create
new user groups if required. Typically, one user is assigned to one group, but can also be assigned
to multiple user groups if required. Users have the sum of all permissions of the groups to which
they are assigned.
When you start the application with user management, you have to enter your username and
password on the login screen. Additionally, to the general login, the last three logged in users on
this machine are displayed on the login screen.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 42


3 Basic Concepts | 3.7 User Management ZEISS

You can also configure a login with your Windows account. In this case an additional login button
with the for Windows accounts (USERNAME@DOMAIN) is displayed on the login screen.

ZEN Data Storage


If you use the ZEN Data Storage and user management, the users are the data storage specific
ones.

Default user and password


If you have enabled the user management and not assigned/changed a password, the password
for the default user is zeiss. If you are using ZEN Data Storage, the default users and passwords
can be found in the installation guide of ZEN Data Storage.

3.7.1 Creating a New User

1. Click Tools > Users and Groups....


à The User and Group Management dialog opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 43


3 Basic Concepts | 3.7 User Management ZEISS

2. Activate Enable User Management checkbox if it is not already activated and restart the
software.
à User management is active.

3. In the Users tab, click .


à The New User dialog opens.

4. Enter a Name for the new user. Optionally, enter a Description and/or enter and confirm a
Password for the new user.
5. Click OK.
You have successfully created a new user. All settings are effective with the next start of the soft-
ware. Make sure that you remember password, username, etc. Now you can add the user to a
specific user group, see Adding Users to a Group [} 45].

3.7.2 Creating a new group

Prerequisite ü You are in the User And Group Management dialog (Tools > Users and Groups...).
ü Enable User Management is activated.
1. Click Groups.
à The tab displays all currently configured user groups.

2. Click .
à The New Group dialog opens.
3. Select the Type of group.
4. Enter a Name for the new group. Note: Do not use a backslash (\) in the group name, ex-
cept for an Active Directory group.
5. Enter a Description for the group. This step is optional.
6. Click OK to close the New Group dialog.
à The respective group is added to the tab.
7. Click OK to close the User and Group Management dialog.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 44


3 Basic Concepts | 3.7 User Management ZEISS

You have created a new group. You can now add users to this group (see Adding Users to a
Group [} 45]).

See also
2 Managing Group Privileges [} 47]
2 Managing Access Rights for User Groups [} 46]

3.7.3 Adding Users to a Group

Prerequisite ü You are in the User and Group Management dialog (Tools > Users and Groups...).
ü Enable User Management is activated.
1. Click Groups.
à All available groups are displayed. By default, you have an Administrators group. To
manage access rights for user groups, see Managing Access Rights for User Groups
[} 46].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 45


3 Basic Concepts | 3.7 User Management ZEISS

2. Select the group you want to add a user to, e.g. Administrators.
3. Click .
à The group properties dialog opens. Under Data > Members, all the members of the
group are displayed.
4. In the Members list, click .
à The Select User dialog opens.
5. Select the user you want to add to the group and click OK.
6. Click OK to close the properties dialog of the group.
You have successfully added a user to the group.

3.7.4 Managing Access Rights for User Groups

You can restrict the access for user groups to certain functionalities of the software. If you use
ZEN Data Storage, you can also assign privileges to user groups, see Managing Group Privileges
[} 47].

Prerequisite ü You are in the User and Group Management dialog (Tools > Users and Groups...).
ü Enable User Management is activated.
1. Open the Groups tab.
à All available groups are displayed.
2. Select the group you want to manage access rights for.
3. Click .
à The Group Properties dialog opens. In the left column, under Access Rights, all areas
for which you can configure access rights (e.g. Menu, Processing) are displayed.
4. Under Access Rights, select the area where you want to restrict access rights, e.g. Left
Tool Area.
à A list of elements is displayed for which you can restrict the access.
5. Click on the Check mark button in front of the respective entry.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 46


3 Basic Concepts | 3.7 User Management ZEISS

à The button changes to a Minus. In the example the selected group is denied the access
right for the Processing tab in the Left Tool Area:

6. Click OK to close the dialog.


7. Restart the software for the changes to be effective.
You have successfully changed access rights for a user group.

3.7.5 Managing Group Privileges

If you use ZEN with ZEN Data Storage, privileges are assigned to user groups. They specify what
actions members of the group can perform in the software.
The software contains various pre-defined roles, each with different sets of privileges. Typically,
the software contains one user group for each role. However, you can create any number of user
groups with arbitrary privileges.

Prerequisite ü You are logged in as an administrator.


ü Enable User Management is activated.
1. Got to Tools > Users and Groups.
2. Click on Groups.
3. Select the desired user group and click on .
4. Click on Privileges.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 47


3 Basic Concepts | 3.7 User Management ZEISS

à The privileges for the ZEN Data Storage groups are displayed. Each privilege is displayed
with its Name, a Description, and the Application Name. Here you can see which
privilege is designated for groups in ZEN, ZEN core, or the ZEN Storage Processing
Server. If the field Application Name is empty, the respective privilege is generally
available.
5. Select the privileges for the user group.
à You can click on one of the pre-defined Privilege sets or activate individual checkboxes
to create a custom set of privileges.
6. Click on OK.
You have now set/changed the privileges for this group.

3.7.6 Setting Up the Login with Windows Credentials (Active Directory)

You have the possibility to configure your user management to allow to log in with Windows user
and password.

Info
Active Directory with ZEN Data Storage
If you are using Active Directory login with ZEN Data Storage, some special points need to be
observed:
4 During the installation of ZEN Data Storage, on the Settings tab of the installer, you have
set the parameter Enable Active Directory to True. For more information, also refer to
the installation guide for ZEN Data Storage.
4 The ZEN Data Storage server must be part of the same Windows domain from where the
software tries to login with its Windows credentials.

Prerequisite ü ZEN is open with active user management, and you are signed in as administrator.
1. Go to Tools > Users and Groups.
à The User and Group Management dialog opens.
2. Click Groups.
à The tab displays all currently configured user groups.

3. Click .
à The New Group dialog opens.
4. For Type, select Active Directory.
5. For Name, click .
à The Select Group dialog opens.
à The fields for object type and location are filled with a default. To change them, click Ob-
ject Types or Locations to open another dialog to select the respective Object Types
or Locations.
6. In the text field below, enter the name of the group you want to select. If you are not sure
if your name is correct, click Check Names to open a dialog and select the suitable entry.
For information on looking up the groups your own account belongs to, refer to the instal-
lation guide.
7. Click OK.
à The name is displayed in the New Group dialog.
8. Enter a Description for the group. This step is optional.
9. Click OK to close the New Group dialog.
à The respective Active Directory is added to the groups.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 48


3 Basic Concepts | 3.7 User Management ZEISS

10. Click OK to close the User and Group Management dialog.


You have configured an Active Directory group. You can now log into ZEN with your Windows
credentials. An additional login button with the current Windows account (USERNAME@DO-
MAIN) is displayed on the login screen if at least one Active Directory group is configured. You
can use this default entry but also edit the USERNAME@DOMAIN field to log in as another user
than the current Windows account.

See also
2 ZEN Data Storage Client [} 269]
2 Adding Users to a Group [} 45]
2 Managing Access Rights for User Groups [} 46]

3.7.7 Options

The options apply to all users, regardless of the user groups to which the user is assigned.

Parameter Description
Check the follow- Here you can specify certain rules or criteria for a password that is
ing rules for a created. If the checkbox is activated, the rules must be fulfilled when
password a new password is created.
The following rules can be adjusted:

– Min. number Sets the minimal number of lower case letters a password must have.
of lower case For example, if you set 2, the password must contain at least two
characters lower case characters, like e and f.

– Min. number Sets the minimal number of upper case letters a password must have.
of upper case For example, if you set 2, the password must contain at least two up-
characters per case characters, like C and G.

– Min. number Sets the minimal number of digits a password must have. For exam-
of digit char- ple, if you set 3, the password must contain at least three digits from
acters 0 - 9, like 5, 6 and 7.

– Min. number Sets the minimal number of special characters a password must have.
of special For example, if you set 1, the password must contain at least one spe-
characters cial character, like &.

– Minimum Sets the minimal length a password must have. For example, if you
length set 9, the password must contain at least nine characters (any from
above).

Do not allow user If activated, it is not allowed to use an existing user name as pass-
name as password word for the software.

Disable the reuse Activated: Disables the reuse of a specified number of last pass-
of last used pass- words.
words

– Number Sets the number of passwords which cannot be reused after each
other. For example, if you enter the number 3, you have to assign 3
different passwords one after another before you can use (reuse) an
old password.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 49


3 Basic Concepts | 3.7 User Management ZEISS

Parameter Description
Disable the use of If activated, you can create and edit a list which contains passwords
common pass- which you can lock for usage.
words

– Edit Opens an editor to edit the list of common passwords. For example, if
you add the entry "123456789Password" this password cannot be as-
signed from a user.

Force users to Activated: The user must change his password after the specified pe-
change password riod of time elapses.
after period of
Deactivated: The password never expires.
time

– Days before Specifies the number of days after which the password expires.
expiry

Lock user after Activated: Locks the user after a number of wrong password entries.
wrong password
entries

– Maximum Sets the number of attempts the user has if he enters a wrong pass-
number of word. For example, if you enter 3, the user can enter a wrong pass-
wrong entries word three times before his user account is locked.

Lock screen after Activated: After a period of inactivity, the screen is locked and the
certain time span user must enter his/her password to continue working.
Deactivated: The password never expires.

– Minutes until Specifies the time span after which the screen is locked.
screen lock

Enable Auto-Login Activated: No password is required. The user is logged in automati-


cally based on the Windows username.
Create a user group in the software that is based on Windows Active
Directory (Type = AD) and ensure that all relevant Windows users are
present in the group and that the group has sufficient privileges in the
software.
Deactivated: Each user has to log in with their own password.

Export/Import user Not available for ZEN Data Storage.


database Enables you to export or import the user database, including all user
groups and privilege sets, for example to exchange it with another
system.

– Export... Specify the location on the file system where the database should be
exported.

– Import... Select the database location on the file system.

3.7.8 Looking Up Active Directory Groups

If you want to set up the user management with Active Directory so that you can log in with your
Windows credentials, it is useful to know the Active Directory groups to which your account be-
longs.

1. In the Windows search, enter cmd.


à Search results are displayed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 50


3 Basic Concepts | 3.8 Image Acquisition ZEISS

2. Click the entry for Command Prompt.


à The command prompt window opens.
3. Enter net user username /domain with your username in the window and press Enter,
e.g. net user MyUserName /domain.
à Information about your user account is displayed.
4. You can now look for the information Local Group Memberships and Global Group
Memberships to find the Active Directory groups you are a part of.

3.8 Image Acquisition

3.8.1 Setting Up a New Experiment

Info
With a very high number of experiments saved in the Experiment Manager (more than 500),
moving from the Locate to the Acquisition tab takes a considerably long time. Delete redun-
dant or no longer used experiments to avoid this lag time.

Prerequisite ü You have switched on and configured your microscope system and all components.
ü You have successfully started the software.
1. In the Left Tool Area, open the Acquisition tab.
2. In the Experiment Manager, click and select New from the dropdown.
à A new experiment is created.
3. Enter a name for the experiment, e.g. "3-channel_experiment".

4. To save the experiment, click .


You have created a new, blank experiment. All other settings are now stored in this experiment. If
you make changes to the experiment, an asterisk (*) after the file name appears. This means that
the experiment was modified and not saved. Save your experiments from time to time to ensure
that your settings are not lost.

3.8.2 Acquiring Multi-Channel Images with Cameras

In the following chapters you will learn how to set-up and run multi-channel experiments quick
and easy.

Info
MicroToolBox (MTB)
Make sure that you work with a fully motorized microscope system. In advance all microscope
components (e.g. objectives, filters, etc.) must be configured correctly in the MicroToolBox
(MTB) software.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 51


3 Basic Concepts | 3.8 Image Acquisition ZEISS

There are two variants for setting up multi-channel experiments. The first variant uses Smart
Setup, while the second variant uses the Channels tool. Both variants have similarities and differ-
ences, which are presented in the following overview:

Commonalities
§ Fluorescent dyes and transmitted light techniques can be selected from a database.
§ Hardware settings for motorized microscopes, which take the properties of the selected dye
and the available microscope hardware into account, can be created automatically.
§ Bases for experiments can be created using both variants and experienced users can optimize
settings further.

Differences

Smart Setup Channels tool

A maximum of 4 camera channels, 8 confocal No restriction on the number and type of


channels and transmitted light channels are channels
available

Offers up to 3 proposals of variants of the ex- -


periment (depending on the selected combi-
nation of dyes and available hardware)

Offers more optimization of experiment set- -


tings by using the Motif buttons

Graphic overview of the expected signal -


strength for the selected dyes

Graphic overview of the expected spectral -


crosstalk with the selected dye combinations

Display of the excitation and emission spectra -


of the selected dyes

- Channels can be configured for dyes that are


not supported (or not supported sufficiently
well) by the available hardware

3.8.2.1 Variant 1: Smart Setup

Info
If you see the error message Smart Setup calculation failed, it was not possible for Smart
Setup to calculate any proposal. This may be because the filters and light sources available on
the system do not allow an image of the dye to be acquired with a good signal strength or
with little crosstalk. The channel for this dye or the contrast method cannot therefore be cre-
ated. In this case, try selecting another, similar dye.
Should the error message be displayed for all dyes that you select, this may be due to one of
the following causes:
- no light source has been configured or the light source is switched off.
- no camera has been configured on the system, the camera is not connected or (on some
models) has been switched off.

1. Click on the Smart Setup button on the Acquisition tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 52


3 Basic Concepts | 3.8 Image Acquisition ZEISS

à The Smart Setup dialog opens.


2. Select the WF button on top of the dialog.
3. To add a channel, click on the Add button in the Configure your Experiment sec-
tion.
à The Add Dye or Contrasting Method dialog opens.
4. Select the desired dye or contrast method.
5. Click on the Add button. Alternatively, you can double-click on the entry in the dye data-
base. The dye is then adopted directly into the experiment.
à You have added a channel to your experiment. To add further channels, repeat the last 2
steps.
6. To return to Smart Setup, click on the Close button.
à You will now see a graphic overview in the Proposals section. This displays the spectra
of the dyes, the expected signal strengths per dye and the spectral crosstalk schemati-
cally.

à Depending on which dye you have selected and the microscope hardware available, up
to three different proposals (Best Signal, Fastest, Best Compromise) are displayed. These
differ in terms of signal strength, crosstalk and speed. Select the proposal that best
meets the needs of your experiment.
7. To select a proposal (if there is more than one), for all active configured channels, activate
the proposal.
8. To optimize experiment settings additionally, click on a Motif button.
The Automatic button is set as default.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 53


3 Basic Concepts | 3.8 Image Acquisition ZEISS

à By the Motif buttons you can optimize acquisition parameters and camera settings auto-
matically either for a high quality (Quality button) image or a faster acquisition but re-
duced image quality (Speed button). Find a more detailed description of Motif buttons
in Smart Setup dialog.
9. To optimize experiment settings, adopt the suggestion and leave Smart Setup, click on the
OK button.
à The added channels are adopted automatically into the Channels tool.
10. Click on the Set Exposure button in the Action buttons bar on top of the Acquisition tab.
à The exposure time is now measured for all three channels one after the other. This is
adopted into the settings for the channels. Following the measurement of the exposure
time, the multi-channel image is acquired automatically and displayed in the Center
Screen Area.
11. To save the experiment together with all the settings, click in the Experiment Manager on
the Options button.
12. In the Experiment Manager click on the Save entry in the drop-down list.
You have set up the multichannel experiment using Smart Setup, executed it and then saved the
configuration. This means that you can repeat the experiment as often as you like using the same
settings.

3.8.2.2 Variant 2: Channels Tool

Info
This workflow does not work with LSM systems.

1. Open the Channels tool in the Acquisition Parameter group.

2. From the drop-down list, select the channel.


à The Add Dye or Contrast Method dialog opens.
3. Select the desired dye or contrast method. You can search for a dye by entering its name
(or starting letter) in the Search input field.
4. Click on the Add button at the bottom of the dialog or simply double click on an entry.
à The channel will be added to your experiment. To add more channels, repeat the last 2
steps.
5. Click on the Close button.
à You will see the added channels in the Channels tool.
6. Click on the Set Exposure button in the main buttons bar on top of the Acquisition tab.
à The exposure time is now measured for all active configured channels one after the
other. It will be also adopted into the settings for the channels. To set the exposure time
channel specific, use the Set Exposure button in the channel settings of the channels
tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 54


3 Basic Concepts | 3.8 Image Acquisition ZEISS

7. To save the experiment together with all the settings, click in the Experiment Manager on
the Options button.
8. Click on the Save entry in the drop-down list.
You have set up the multichannel experiment using the Channels tool, executed it and then
saved the configuration. This means that you can repeat the experiment as often as you like using
the same settings.

3.8.3 Using the Dye Editor

The software is delivered with a large number of preset dyes. Dyes and its parameter are stored in
the dye database. In case you have created a custom made filter cube, you may need additional
dyes. You can create new dyes and a custom dye database with the Dye Editor in the Tools
menu.

3.8.3.1 Dye Editor Dialog

1 2 3 4

Fig. 9: Dye Editor Dialog


1 Menu
Here you can create new data sets and import available dye databases. A detailed de-
scription can be found under Dye Editor Menus [} 56].

2 Dye search & database


In this list you see the dyes that are available in the open database. You can search for
dyes and see which dyes you edited last.

3 Dye information area


Here you see all the additional information about a selected dye.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 55


3 Basic Concepts | 3.8 Image Acquisition ZEISS

4 Dye spectra
Here you see the available dye spectra. Click on the relevant tabs to display the emis-
sion, excitation, or extinction spectra. On the Overview tab you can see all spectra at
a glance.

See also
2 Creating a Custom Dye [} 57]

3.8.3.1.1 Dye Editor Menus

File menu

Menu item Description Shortcut


New Creates a new ExEml file in which you can create dye
data sets.

Open file... Opens a single ExEml file.

Open folder... Opens several ExEml files that have been saved to- Ctrl + S
gether in the same folder.

Import file... Imports an ExEml file.

Save... Saves the open ExEml file.

Save As... Saves the open ExEml file under a new name.

Save As Folder... Saves all open ExEml files in a folder.

Close Closes the Dye Editor. Ctrl + F4

Dataset menu

Menu item Description Shortcut


Add new.. Creates a new, empty data set.

Copy Copies the selected data set to the clipboard. Ctrl + C,


Ctrl + Ins

Cut Cuts the selected data set and copies it to the clip- Ctrl + X,
board. Shift +
Del

Delete Deletes the selected data set.

Paste Pastes a data set from the clipboard. Ctrl + V,


Shift + Ins

Paste Part Pastes a range of a data set from the clipboard.

Tools menu

Menu item Description


Generate short Creates abbreviations for names of dyes. This helps to avoid duplica-
names... tion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 56


3 Basic Concepts | 3.8 Image Acquisition ZEISS

Menu item Description


Update max. Calculates the main emission wavelength of the selected dye from
wavelength ermit- spectral data that has either been copied or entered manually.
ter properties

3.8.3.2 Creating a Custom Dye

If none of the preset dyes matches your requirements, you can create a new custom dye.

1. Open the Dye Editor via Tools > Dye Editor....


à The Dye Editor dialog [} 55] opens.
2. In the File menu, click the Save As Folder... entry.
3. In the Windows dialog, create a new folder to save your custom dye database,
e.g. C:/User/Documents/Carl Zeiss/ZEN/Documents/New Folder.
Name the new folder, e.g. New Dyes.
à You have created a custom dye database to which all new dyes are stored.
4. Click on the New Dye entry in the Exeml Collection list.
à The properties section opens.

5. In the Names section, click in the Name input field to change the name of the custom dye.
à The name enables you to find your custom dye in the Smart Setup or Channels tool.
6. Fill in other known parameters in the following sections, e.g. Providers, Properties, Ref-
erences.
7. Change to the Emission tab.
8. To fill in Wavelength (nm) and Spectrum value to the table on the right, you have 3 op-
tions:

§ Type in data manually. [} 57]


§ Copy and paste data from e.g. an Excel sheet. [} 58]
§ Copy and paste data from a preset dye. [} 58]

3.8.3.2.1 Type in Data Manually

Prerequisite ü You have created a new dye in the Dye Editor dialog.
ü You are on the Emission tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 57


3 Basic Concepts | 3.8 Image Acquisition ZEISS

1. In the Wavelength (nm) > Spectrum value table, click on the Plus icon.
Add 10 rows, by pressing Shift and the Plus icon.
Add 100 rows, by pressing Alt + Shift and the Plus icon.

2. Type in the corresponding Spectrum Value in the input fields.


à The emission graph is displayed next to table.
3. Save the dye via File > Save....
You have saved a new dye in your custom database.
You can use the new dye in the Smart Setup or in the Channels tool.

3.8.3.2.2 Copy Data from an Other Source

If you have recorded Wavelength (nm) and Spectrum value of your custom dye in another
source, e.g. an Excel sheet, you can copy the data and paste it directly into the Dye Editor dialog.

Prerequisite ü You have created a new dye in the Dye Editor dialog.
ü You have opened your source, e.g. an Excel sheet with the emission data.
1. Arrange the data in two columns like on the Emission tab.
2. Mark the data and copy it via Ctrl + C. Alternatively, right-click on the marked area to open
the shortcut menu and select Copy.
3. Change to the Dye Editor dialog.
4. On the Emission tab, click in the first row of the Wavelength (nm) > Spectrum value ta-
ble and press Ctrl + V. Alternatively, right-click in the first row to open the shortcut menu
and select Paste.
à The emission data is inserted in the table and the emission graph is displayed next to the
table.
5. Save the dye via File > Save...
You have saved a new dye in your custom database.
You can use the new dye in the Smart Setup or in the Channels tool.

3.8.3.2.3 Copy Data from a Preset Dye

If the data of a preset dye, e.g. the emission data of the DAPI dye resembles your custom dye, you
can copy the data from the preset dye into a new custom dye.

NOTICE
Do not edit preset dyes
Editing preset dyes leads to irreversible data loss.
Note that you should therefore only copy the data set of a preset dye.

Prerequisite ü You have created a new dye in the Dye Editor dialog.
1. Open a second Dye Editor dialog via Tools > Dye Editor....
2. Confirm the occurring dialog with Yes.
Perform the following steps to open the ZEN Dye Database in the second Dye Editor dia-
log:
3. In the File menu, click on the Open folder... entry.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 58


3 Basic Concepts | 3.8 Image Acquisition ZEISS

4. In the Windows dialog, open the DyeDataBase with all preset dyes by following the file
path:
C:/Program Files/Carl Zeiss/ZEN/ZEN 2 (blue edition)/ZEN/Resources/DyeDataBase
à All preset dyes are displayed in the second Dye Editor dialog.
5. Use the Search input field, to quickly find a preset dye with similar values, e.g. DAPI.
6. Select the desired dye.
7. Click on the Copy the current dataset as XML button.

Alternatively, click Dataset > Copy.


à The emission data is copied to the clipboard.
8. Change to the first Dye Editor dialog, to edit your custom dye.
9. In the Dataset menu select Paste Part > Spectra > Emission > Data.
à The emission data from the preset dye is copied into your custom dye.
10. Edit the custom dye emission data, until it matches your requirements.
à The emission graph is displayed next to the table.
11. Save the dye via File > Save.....
You have saved a new dye in your custom database.
You can use the new dye in the Smart Setup or in the Channels tool.

Info
You can paste other properties of preset dyes just as the emission data, e.g. All Spectra data
or Emitter Properties.

3.8.3.3 Adding a New Dye to the Data Set

Prerequisite ü You have successfully created a first custom dye and a custom dye database, see Creating a
Custom Dye [} 57].
ü You have opened the Dye Editor dialog.
1. In the Dataset menu select New....
à The Create new dataset dialog opens.
2. Enter an ID for your new dye, e.g. DyeC2 and confirm with OK.
à The entry Unnamed other dye appears in the Exeml Collection list.
3. Add a name for the new dye by clicking on the Plus icon in the Names section.

4. Enter a name in the Name input field.


5. Edit the properties of the new dye, see
Type in Data Manually [} 57] or
Copy Data from an Other Source [} 58] or
Copy Data from a Preset Dye [} 58].

3.8.4 Setting an Experiment as Startup Default

Any experiment can be set as a startup default indicated by a symbol.


If you want to set an experiment as startup default, the following steps are necessary.

1. In the menu bar click on Tools > Options....


2. Click on Startup/Shutdown.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 59


3 Basic Concepts | 3.8 Image Acquisition ZEISS

3. In the Experiment section, select Load Default Experiment from the drop-down list.
4. Click on OK.
à The Options dialog closes.
5. Configure your experiment for startup default or select an existing experiment.
6. Click on Options and select Set As Start up Default.

The active experiment is set as startup default now and marked with the symbol.
This experiment is loaded when starting the ZEN software.

3.8.5 Creating Default Experiments as Templates Automatically

It is possible to generate an experiment template. This cannot be modified but used as a starting
point for your acquisition.
If you want to generate an experiment template, the following steps are necessary.

1. Create an experiment.
2. In the menu bar, click on Help > About ZEN...
à The About ZEN dialog appears.
3. Click on Show ZEN Information.
à The Application Information dialog appears.
4. Open the Folders tab, scroll to the Experiment Templates entry, and double-click on it.
à The folder Experiment Setups will open.
5. Export the experiment generated before into the Carl Zeiss\ZEN\Templates\Experiment
Setups folder.
6. Create a descriptive name for the experiment template.
You have successfully created an experiment template.
It is possible to generate and save multiple templates.
To apply an experiment template, see chapter Applying an Experiment Template [} 60].

3.8.6 Applying an Experiment Template

If you want to apply an experiment template as a starting point for your acquisition, the following
steps are necessary.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 60


3 Basic Concepts | 3.8 Image Acquisition ZEISS

Prerequisite ü The experiment template to be used has been created before, see chapter Creating Default
Experiments as Templates Automatically [} 60].

1. On the acquisition tab, click on the options button and select New from Template.
à The available experiment templates will be shown on the right side.
2. Click on the name of the appropriate template.
The selected experiment template will be loaded as starting point for the acquisition.

3.8.7 Adding Annotations to Images or Movies

Using annotations you can highlight specific regions, add metadata or specific measurement in-
formation to images and movies. You can use the annotations within several workflows and func-
tionality:

§ For your own information, you can display metadata within images and movies.
§ When working with Mean ROI view, you use the annotation functions to draw regions into
the image.
§ When analyzing images manually, you can record measurement results in the image.
§ When exporting images or movies, you can add annotations that are visible in the export for-
mat of your images and movies.
The annotation tools are accessed via the Graphics tab or the Graphics Menu [} 822].

Prerequisite ü You have acquired or loaded an image or a movie.


1. In the Center Screen Area select the Graphics tab.

2. Select an annotation or a measurement and add it to the image.

Remove Annotations
1. Select the annotation in the image or in the Annotations/Measurements table, and press
the Del key. Alternatively, right-click the annotation and select Delete.
Additionally, the annotations can be edited, rearranged, and formatted. For more information,
see Editing Annotations in Images or Movies [} 62].

See also

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 61


3 Basic Concepts | 3.8 Image Acquisition ZEISS

2 Graphics Tab [} 1036]


2 Custom Graphics Tab [} 1042]

3.8.8 Editing Annotations in Images or Movies

You can edit, rearrange and format annotations in an image or movie.

Edit Annotations
You can change the annotations type or the unit of the time or of the measurement.

1. To edit text in a textbox, double-click the textbox and change the text.
2. In the image, select the annotation and right-click to open the context menu. Select For-
mat Graphical Elements.
à The Format graphical elements dialog opens.
3. Edit the annotation and click Close to save.

Rearrange Annotations
1. Select the annotation with the left mouse button and drag and drop the annotation to an-
other position.

Format Annotations
1. In the image, select the annotation and right-click to open the context menu. Select For-
mat Graphical Elements.
à The Format graphical elements dialog opens.
2. Format the annotation and click Close to save.

See also
2 Format Graphical Elements Dialog [} 1040]
2 Adding Annotations to Images or Movies [} 61]

3.8.9 Using Denoising During Continuous Acquisition

ZEN offers the functionality to use a machine learning model trained for denoising directly during
a continuous acquisition. Note that currently only models trained with ZEN are supported.

Prerequisite ü You have a trained denoising model available in ZEN. For more information, also refer to In-
tellesis Denoising [} 511]. Note that in order to be able to train a model, you need the li-
cense for the AI Toolkit.
1. On the Acquisition tab, set up your acquisition with the respective tools, e.g. Imaging
Setup, Channels and Acquisition Mode tool. Note that the Acquisition ROI must have a
frame size of at least 1024x1024 pixel! Depending on the chip size of your camera you
have to check image size and binning to ensure that the frame size meets this requirement.
à Your acquisition is set up.
2. In the Channels tool, activate Live Denoising.
à The dropdown is activated.
3. In the dropdown, select the denoising model you want to use.
à Denoising is now activated for your acquisition. Note that for widefield systems with a
dual camera, only the first model will be applied to both channels.
4. Click Continuous.
You have started a continuous acquisition with simultaneous denoising.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 62


3 Basic Concepts | 3.9 Working with Focus Strategies ZEISS

See also
2 Creating and Training an Intellesis Denoising Model [} 514]

3.9 Working with Focus Strategies

3.9.1 Introduction

If you want to work with focus strategies, you have to use the Focus Strategy tool. There you
can select the suitable strategy and adjust the corresponding settings, e.g. defining Z-positions
manually or automatically, and update these during the experiment. Note that the availability of
certain focus strategies depends on your system and available components (e.g. Definite Focus.2).

General Preparations

Prerequisite ü To use focus strategies, you will need a motorized focus drive/Z-drive.
ü You are in the Left Tool Area on the Acquisition tab.
ü You have created a new experiment [} 51], defined at least one channel [} 51] and ad-
justed the focus and exposure time.
1. Activate the acquisition dimensions (e. g. Tiles, Time Series) you want to use for your ex-
periment.
2. Open the Focus Strategy tool.

à The available focus strategies are displayed in the drop-down list.


à The number of focus strategies available depends on the activated acquisition dimensions
(e.g. tiles, time series), the available hardware devices (e.g. definite focus) present, and
software license (e.g. Software Autofocus and Tiles module allow additional focus
strategies).
3. Decide which strategy is best suited to your experiment. In case of a Tiles experiment, the
software will automatically select the most appropriate focus strategy if you have not previ-
ously selected one. For a detailed description of all strategies, read the chapter Focus Strat-
egy Tool [} 928].
You have successfully completed the general preparations. Now follow one of the following sets
of instructions for specific focus strategies.

3.9.2 Using Software Autofocus

Select this focus strategy to automate the focusing of your specimen before and during acquisi-
tion with the help of the Software Autofocus. This is particularly useful for Time Series or Tiles
experiments.

Prerequisite ü To use the Software Autofocus focus strategy, you will need the module.
For LSM systems, the Autofocus module is part of the system license.
ü You have completed the general preparations [} 63] for using focus strategies (experiment
created, at least one channel defined, acquisition dimensions activated).
ü You are on the Acquisition tab in the Focus Strategy tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 63


3 Basic Concepts | 3.9 Working with Focus Strategies ZEISS

1. Select the Software Autofocus entry from the drop-down list. Note that the Z values de-
fined by Tiles Setup are ignored.

2. In the Reference Channel section, select the channel that you want to use for the focus
action from the list. Expand the section if you do not see it in full. Note that the reference
channel does not necessarily have to be an acquisition channel. Not all acquisition modes
can be used as reference. For LSM 980 LSM Lambda tracks and Online Fingerprinting can-
not be selected as reference channels. Also, Airyscan SR and MPLX tracks might fail when
using such tracks as reference for reflex autofocus function.
3. Click on the Set as Reference Channel button.
4. In the Time Series Loop and/or Tiles Loop sections of the Focus Strategy tool you can
define when focus actions should be performed during the course of the experiment.
5. Open the Software Autofocus tool.
6. Adjust the autofocus settings (e.g. Quality, Sampling, etc.) to your experiment conditions
or use the default settings first.
7. Set up your tile and/or time series experiment.
8. To start the experiment, click on the Start Experiment button.
You have successfully used the Software Autofocus to bring images into focus automatically dur-
ing the experiment.

3.9.3 Using Definite Focus in Time Series Experiments

Select this focus strategy to use the definite focus device to stabilize the focus in the event of tem-
perature fluctuations during your Time Series experiments.

Prerequisite ü To use the Definite Focus focus strategy, you will need the Definite Focus hardware device.
ü You have completed the general preparations [} 63] for using focus strategies.
ü You are on the Acquisition tab in the Focus Strategy tool.
1. Select Definite Focus as focus strategy from the dropdown list. Note that Z values defined
by Tiles Setup are ignored.
2. In the Stabilization Event Repetitions and Frequency section select Standard mode.
This mode will use our recommend default settings for stabilization. When selecting the Ex-
pert mode, you can adjust all settings according to your needs.
3. Set up a Time Series experiment, see Acquiring Time Series Images [} 390].
4. Use the Live mode to set the focus position using the focus drive.
5. To start the experiment, click on Start Experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 64


3 Basic Concepts | 3.9 Working with Focus Strategies ZEISS

à Definite Focus is initialized at the start of the experiment at the current focus position.
The focus is then stabilized in accordance with your settings during the time series exper-
iment. You will be reminded to set the focus accordingly prior to the experiment starting.
You can do this by navigating to a suitable location (position or Tile region) and starting
live or continuous. You can then continue with the experiment or cancel it.
You have successfully used the Definite Focus to stabilize the focus during a Time Series experi-
ment.

3.9.4 Using Local or Global Focus Surfaces

For Local or Global Focus Surfaces you need to select the focus strategy Use Z-Values/Focus
Surface defined in Tiles Setup. This strategy is selected by default, if you have licensed the
Tiles module. Then you can acquire tiles images along local or global focus surfaces (tile region
specific/position specific) and use the focus strategy for optimal image results.
A local/global focus surface ensures that all tiles are in focus on tilted or irregular specimens. Local
focus surfaces for tile regions are interpolated on the basis of the focus positions of support
points. Positions automatically have a horizontal focus area with the Z-value of the position.
The following guide explains how to use the focus strategy for local focus surfaces.

Prerequisite ü To use the Use Z-Values/Focus Surface defined in Tiles Setup focus strategy, you need a
license for the Tiles module.
ü You have read the introduction for using focus strategies (experiment created, at least one
channel defined, acquisition dimensions activated), see Introduction [} 63].
ü You are on the Acquisition tab in the Focus Strategy tool.
1. Select the Use Z-Values/Focus Surface defined in Tiles Setup entry from the drop-
down list (if not selected by default).
2. If you want to set up the entire focus strategy, you can click Optimize this Focus Strat-
egy to use the Focus Strategy wizard, see Focus Strategy Wizard [} 933].
3. In the Z-Values/Focus Surface section, select Local (per Region/Position).
4. Under Initial Definition for Z-Values/Focus Surface, select the By Tiles Setup entry
from the drop-down list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 65


3 Basic Concepts | 3.10 Import/Export ZEISS

à Alternatively, select the options By Software Autofocus or By Definite Focus: Recall


Focus if you have licensed the Software Autofocus module and/or use Definite Fo-
cus.2 hardware device. This allows you to specify that the z-positions of the support
points should be updated by the software autofocus and/or Definite Focus.2 immediately
before acquisition.
5. Set up a Tiles experiment.
6. Create a local focus surface for the tile regions.
7. To start the experiment, click Start Experiment.
The tiles of tile regions and positions are acquired using the local focus surfaces.
If you are performing a Time Series experiment, we recommend to use the Adapt Z-Values/Fo-
cus Surface functions. By these you can correct the focus for small drifts that occur in long multi-
dimensional time series experiments with living cells, for example.

See also
2 Tiles & Positions with Advanced Setup [} 344]
2 Creating a Local Focus Surface [} 351]
2 Focus Strategy Tool [} 928]

3.10 Import/Export

3.10.1 Workflow Export/Import

This example describes the workflow for the Image Export. The typical workflow is the same for
both export and import of images.

Prerequisite ü You are on the Processing tab.


1. In the Method tool, open the Export/Import group and select Image Export.
2. In the Input tool, select the image you want to export. To do this, click on the small pre-
view image within the tool. You see a preview of all the open images. To select an image,
click on the image that you want to use. This is only necessary if you have several images
open simultaneously. By default, the image currently selected is always used as the input
image.
3. In the Parameters tool, set the desired export settings, e.g. file type, quality, export folder,
etc.
4. At the top part of the Processing tab, click Apply.
You have successfully exported the selected image.

3.10.2 Exporting Images

Using the Quick Export function, you can export images automatically with a single click of the
mouse, without setting the processing function parameters.

Prerequisite ü You have acquired or opened an image.


1. In the Right Tool Area, in the Images and Documents tool, select the image and click
. Alternatively, click File > Export/Import > Quick Export.
The selected image is automatically exported with the default settings of the Image Export pro-
cessing function (JPEG, quality 95%, size 100%). The image is placed in the folder that is currently
set in the Image Export processing function.
All images have 300 dpi.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 66


3 Basic Concepts | 3.10 Import/Export ZEISS

Info
If you export a time series or z-stack image using the Quick Export function, a movie is auto-
matically generated using the default values of the Movie Export method.

See also
2 Image Export [} 120]

3.10.3 Exporting Movies

Using the Quick Export function, you can export movies automatically with a single click of the
mouse, without setting the processing function parameters.

Prerequisite ü You have acquired or opened an image from a time series or a z-stack image.

1. In the Right Tool Area, in the Images and Documents tool, click . Alternatively, click
File > Export/Import > Quick Export.
The selected image is automatically exported with the default settings of the Movie Export pro-
cessing function (AVI, original size). The movie is placed in the folder that is currently set in the
Movie Export processing function.

See also
2 Movie Export [} 127]

3.10.4 Exporting Multichannel Images

To export multichannel images, see the following description. Not all the parameters are used in
this example. For a description of all available export parameters, see Image Export [} 120].

Prerequisite ü You have acquired or opened a multichannel image.


1. On the Processing tab, select the function Image Export. Alternatively, click File > Ex-
port/Import > Export or press Ctrl+6.
à The export options are displayed in the Parameters tool. Make sure that Show All is ac-
tivated to see all options.
à Merged Channels Image is activated by default. This means that the pseudo color im-
age (mixed color image from all channels) is also exported as an individual image.
2. In the File Type section, define the format for your image to be exported.
à Based on your selection, the displayed options might change.
3. Activate Individual Channels Image to export an image from each channel.
4. To change the folder where to save the images, for Export To click .
à A file browser opens.
5. Navigate to the folder and click OK.
à You have changed folder for saving.
6. Activate Generate zip File to generate zip files.
7. Activate Create Folder to create a subfolder with the name of the prefix.
8. Define a Prefix for naming your exported images. The default prefix is the name of your
image. For information on naming conventions, see Naming Convention for Image Export
[} 69].
9. Click Apply at the top of the Processing tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 67


3 Basic Concepts | 3.10 Import/Export ZEISS

You have exported images of the individual channels and a pseudo color image of your multi-
channel image and automatically saved them (as a ZIP archive) in the defined folder.

3.10.5 Exporting Multiscene Images

Info
File Size Limitation
The export of images to most file formats is subject to limits of the file size that can be created
(typically ca. 2 GB). For this reason, we recommend to use the Big TIFF-format. If this is not
possible because the Big TIFF-format does not fit your needs, check if the image size does not
exceed the resources of your computer when exporting your preferred format. A message will
inform you, when the size exceeds your resources. You have the following options to work
around:
4 Resize the resolution to scale the image down with the Resize slider.
4 Activate Original Data and deactivate Apply Display Curve and Channel Color.
4 With a rectangle, select a region of interest to minimize the image itself.
4 Activate Crop to Selection and Generate New Tiles to cut the image again into tiles us-
ing the row and column options.

To export multiscene images, see the following description. Not all the parameters are used in this
example. For a description of all available export parameters, see Image Export [} 120].

Prerequisite ü You have loaded a multiscene image.


1. On the Processing tab, select the function Image Export. Alternatively, click File > Ex-
port/Import > Export or press Ctrl+6.
à The export options are displayed in the Parameters tool. Make sure that Show All is ac-
tivated to see all options.
2. In the File Type section, define the format for your image to be exported.
à Based on your selection, the displayed options might change.
3. If you have selected Big TIFF, activate Merge All Scenes to combine all scenes of your
ROI in one image. Deactivate the checkbox to export single files per scene.
4. Activate Define Subset.
à The Scene, the Region and the Tiles sections are displayed.
5. In the Scene section, from the drop-down menu, select which parts of the input image you
want to use for the resulting image.
6. In the Region section, from the drop-down menu, select if you want to export the full im-
age or a rectangle region.
7. If you select Rectangle Region, you can draw a rectangle in the image according to your
needs.
8. To change the folder where to save the images, for Export To click .
à A file browser opens.
9. Navigate to the folder and click OK.
à You have changed folder for saving.
10. Define a Prefix for naming your exported images. The default prefix is the name of your
image. For information on naming conventions, see Naming Convention for Image Export
[} 69].
11. Click Apply at the top of the Processing tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 68


3 Basic Concepts | 3.10 Import/Export ZEISS

3.10.6 Naming Convention for Image Export

For the image export, you can define how the exported files should be named. The naming con-
vention for exported images used by ZEN is described here. For the naming convention of the xml
files created by the image export, see Naming of xml Files for Exported Images [} 70].

Short Naming Format


For ZEN, this is the default naming convention and always applied when Short Format is acti-
vated.
The name of the exported file follows a convention: <Prefix>_<Suffix>.<File Format>.
Example: TMA1_m1.tif
If there are no dimensions, the image name does not contain a suffix. Example: TMA1.tif.

Image name of ex- Description of the exported image


ported file
<Prefix>_m<no.> Contains re-tiled data. The count starts from top left to right and in
the next row again from left to right.

<Prefix>_c<no.> Contains channels. Note that if you have activated Use Channel
Names the actual names of the channels are written into the file
name of the exported image.

<Prefix>_t<no.> Contains time series.

<Prefix>_z<no.> Contains z-stacks.

<Prefix>_ORG Contains original data.

The prefix is the image name you entered in the Prefix field. Per default, the prefix field contains
the image name. The suffix contains all image information. Example: If you export an z-stack with
channel 1 and channel 2, and activate Crop to Selection and Generate New Tiles, the image
name of one exported image could be: TMA1_z02c1+2m1.tif

Long Naming Format


The long naming format contains all the information of the short format and additionally the size
of the image in x and y in pixel as well as the start positions of x and z for the export.

Parameter Description
<Prefix>_x<no1- Displays the x position and size. The first number (no.1) indicates the
no2> start of the (subset) image in relation to the coordinate system of the
original image, the second number (no.2) indicates the total width of
the exported (subset) image in pixel.

<Prefix>_y<no1- Displays the y position and size. The first number (no.1) indicates the
no2> start of the (subset) image in relation to the coordinate system of the
original image, the second number (no.2) indicates the total height of
the exported (subset) image in pixel.

Example 1: If you export your entire image which has a width and height of 1024 pixel, the
name of the exported image could be: TMA1_z02c1x0-1024y0-1024.tif.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 69


3 Basic Concepts | 3.10 Import/Export ZEISS

Example 2: If you only export a subset with a rectangle drawn into the image, the name of the
exported image could be: TMA1_z02c1x241-692y49-448.tif.
This means, the exported subset image starts at the x value 241 of the original image and has a
width of 692 pixel.

3.10.6.1 Naming of xml Files for Exported Images

If you select to also create a xml file, the image export generates two files, one contains general
information about the image, the second contains the image metadata. Both xml files have a dis-
tinct naming, depending on which format you have selected in the export.
The long format naming for the xml files includes the file type suffix in the xml titles as well as
metadata for the metadata xml, the short format naming for the xml files excludes the file type
suffix from the xml titles as well as shortens metadata to meta for the metadata xml. See the fol-
lowing example:

Exported Image Short Format xml Long Format xml


StainedNuclei.jpg StainedNuclei_info.xml StainedNuclei.jpg_info.xml
StainedNuclei_meta.xml StainedNuclei.jpg_metadata.xml

3.10.7 Importing Z-Stack Images

Prerequisite ü You have saved the individual images of a Z-stack in a folder on your computer. The images
have been named systematically, e.g. Image_Z0, Image_Z01, etc.
1. On the Processing tab, open the parameters for Image Import (or via the File > Export/
Import > Import).
à You will see the default settings of the parameters for Image Import.
2. Activate the Z-stack checkbox. Deactivate all the other dimensions.
3. Enter the interval for the Z-stack. The number of planes is set automatically if the images
have been named systematically.
4. In the Import from section, select the folder that contains the individual images of your Z-
stack image.
à The individual images are displayed automatically in the list under the import directory.
5. Click on the Check Consistency button. This allows you to check whether the images can
be imported correctly.
à A check mark appears after each file name in the list. You can import the individual im-
ages.
6. Click on the Apply button at the top of the Processing tab.
The individual images are imported and combined to form a Z-stack image. You have successfully
imported a Z-stack image from individual images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 70


3 Basic Concepts | 3.10 Import/Export ZEISS

3.10.8 Downloading AI Models

Info
Powerful GPU
For AI models requiring a GPU for execution, the GPU needs to fulfil certain criteria, i.e. be
powerful enough. For the use of AI models, the recommended hardware configuration is 8GB
GPU. Only Nvidia GPUs and the CPU are supported. For further reference, also refer to the re-
quirements of the Intellesis functionality, see Remarks and Additional Information [} 505].

In ZEN, you can download AI models from arivis Cloud, e.g. for instance segmentation. These
models are packaged as Docker containers and therefore need the Docker Desktop software to
work.

Prerequisite ü Docker Desktop is installed and running on your computer. For more information about
Docker Desktop, see Requirements for Docker Desktop [} 1313].
ü You have the model you want to download available on arivis Cloud and your PC is con-
nected to the internet.
ü You have created an access token and entered it in ZEN, see Creating and Entering an Ac-
cess Token [} 206].
1. Go to the Applications, open the AI Model Store tool and click Open AI Model Store.
à The AI Model Store dialog opens to display all available AI models.
2. On the left side, click Download from arivis Cloud.
à The model list is updated and displays all models on arivis Cloud that you have available.
3. Select the model you want to download in the list.
à The Properties section on the right displays more detailed information about your se-
lected model.
4. In the Properties section, select the model version you want to download and click Down-
load Model.
à The download of the model starts and the progress is displayed in the status bar. You
have the possibility to cancel the download with the button next to the progress bar.
After a successful download, the model is displayed in the AI Model Store tool. It is now avail-
able in ZEN, even without an active internet connection.
You can now use the model, e.g. in the Automatic Segmentation step of the image analysis.

See also
2 AI Model Store Tool [} 888]
2 Creating an Image Analysis Setting From an AI Model [} 429]
2 Importing AI Models [} 72]
2 Creating a New Image Analysis Setting [} 403]
2 Automatic Segmentation [} 944]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 71


3 Basic Concepts | 3.11 Image Processing ZEISS

3.10.9 Importing AI Models

Info
Powerful GPU
For AI models requiring a GPU for execution, the GPU needs to fulfil certain criteria, i.e. be
powerful enough. For the use of AI models, the recommended hardware configuration is 8GB
GPU. Only Nvidia GPUs and the CPU are supported. For further reference, also refer to the re-
quirements of the Intellesis functionality, see Remarks and Additional Information [} 505].

In ZEN, you can import existing AI models, e.g. for instance segmentation, that you have exported
from another application. These models are packaged as Docker containers and therefore need
the Docker Desktop software to work.

Prerequisite ü Docker Desktop is installed and running on your computer. For more information about
Docker Desktop, see Requirements for Docker Desktop [} 1313].
ü You have the model you want to import available on your PC.
1. On the Applications tab, open the AI Model Store tool and click Open AI Model Store.
à The AI Model Store dialog opens to display all available AI models.

2. Click .
à A file browser opens.
3. Select the model you want to import, and click Open.
After a successful import, the model is displayed in the AI Model Store tool. You can now use
the model, e.g. in the Automatic Segmentation step of the image analysis.

See also
2 AI Model Store Tool [} 888]
2 Creating an Image Analysis Setting From an AI Model [} 429]
2 Downloading AI Models [} 71]
2 Creating a New Image Analysis Setting [} 403]
2 Automatic Segmentation [} 944]

3.11 Image Processing

3.11.1 Image Processing Workflow

On the Processing tab you can apply image processing functions (IP functions) to acquired or
loaded images. The basic workflow is quite simple:

§ Acquire or open an image that you want to process.


§ Open the Processing tab.
When you open the tab, the last active image (e.g. from Acquisition tab) will be used as the
input image for the processing function.
If you want to select another input, load the new image under Image Parameters > Input.
Note that the image must be opened in ZEN before.
§ Select the desired processing mode (Single/Batch). Per default, single processing mode is se-
lected. Batch processing allows to apply a specific processing function automatically to a
batch of images. Images processed with Batch mode are by default saved with a lossless
compression. The compression setting can be changed in Tools > Options > Processing.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 72


3 Basic Concepts | 3.11 Image Processing ZEISS

§ Select the desired processing function under Method, e.g. Color Balance.
You can search for processing functions in the Search field. Therefore, just enter the initials
of the functions you want to search.
§ Set the parameters of the function under Parameters.
If you need help for a specific function and its parameters press F1 on your keyboard. You
will find detailed descriptions for each functions in the online help.
§ To see how the functions works you can click on the Preview button under Image Parame-
ters > Output.
§ Click on the Apply button to apply the processing functions to the image.
This will create a new image in a new image container. The original image will not be
changed.

See also
2 Processing Tab [} 873]

3.11.2 Extracting Individual Fluorescence Images of a Multichannel Image

In this topic we will show you how to extract individual fluorescence channel images of a multi-
channel image.

Prerequisite ü You have acquired or opened a multichannel image.

1. Select the Processing tab. Open the Method tool and select under Utilities the entry Cre-
ate Image Subset.
2. In the section Image Parameters, open the Input tool and select the multichannel image
as Input image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 73


3 Basic Concepts | 3.11 Image Processing ZEISS

3. In the section Method Parameters, open the Parameter tool and the select the entry
Channels. Deactivate the channels you do not want in the extracted image (e.g. the red
and the blue fluorescence channel).

4. Click on the Apply button.


In the example image, you have extracted the green fluorescence channel image of the multi-
channel image. Activate the corresponding channel and deactivate the other channels to extract
further individual fluorescence images. You can now save the extracted sub images as separate
files.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 74


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.3 Applying Batch Processing

Info
Activating Images for Processing
When you activate multiple images for processing in ZEN, make sure to exactly click on the re-
spective checkbox for the entry. If you click outside the checkbox, all activated images are des-
elected and only the last clicked entry is activated.

Batch processing in ZEN allows to apply a specific processing function automatically to a batch of
images. For each image you can use identical or different export settings.

Prerequisite ü You have a folder with CZI-images you want to process.


1. Go to the Processing tab and click Batch.
à The Batch Processing view opens.
2. Open the Batch Method tool and select the function you want to use.
3. In the Method Parameters section, open the Parameters tool.
4. In the Batch Processing view in the Center Screen Area, click + Add.
à A file explorer opens.
5. Select the folder, mark all images to be processed, and click Open.

à The list of images is displayed in the Batch Processing view.


6. Activate Use Input Folder as Output Folder to save the processed images in the folder of
the original images. Alternatively, deactivate the option and select an output folder for each
of your images by selecting them and clicking .
7. Click on one image in the list and define the settings in the Parameters tool. This setting is
only valid for the selected image, but can be copied to further images in the list.
8. Click Copy Parameters. Select the image with identical dimensions in the list and click
Paste Parameters.
9. Continue with the other images of the list. Use Copy Parameters and Paste Parameters,
or define the export settings for each image individually in the Parameters tool. You can
also use different functions for each of the individual images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 75


3 Basic Concepts | 3.11 Image Processing ZEISS

10. Click Check All. All images in the list will be tagged with a green marker, if they have a
suitable setting.

11. Activate the checkbox for each image you want to have processed and click Apply.
All selected images in the list are processed and put into the defined output folder.

3.11.3.1 Example: Applying Image Export in Batch Processing

Info
Activating Images for Processing
When you activate multiple images for processing in ZEN, make sure to exactly click on the re-
spective checkbox for the entry. If you click outside the checkbox, all activated images are des-
elected and only the last clicked entry is activated.

This topic shows you how to export all images of a folder as batch. For each image you can use
identical or different export settings.

Prerequisite ü You have a folder with several CZI-images to be exported in a new image type (i.e. TIFF, BMP,
JPEG). For example, two 2channel time series images, one 2channel-Z-stack image, one
3Channel image.
1. Go to the Processing tab and click Batch.
à The Batch Processing opens.
2. Open the Batch Method tool and select Image Export.
3. In the Method Parameters section, open the Parameters tool.
4. In the Batch Processing view in the Center Screen Area, click + Add.
à A file explorer opens.
5. Select the folder, mark all images to be exported, and click Open.

à The list of images is displayed in the Batch Processing view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 76


3 Basic Concepts | 3.11 Image Processing ZEISS

6. Activate Use Input Folder as Output Folder to save the exported images in the folder of
the original images.
7. Click on one image in the list and set the export settings in the Parameters tool. In the ex-
ample the TIFF format is used for all time points and channels. This setting is only valid for
the selected image, but can be copied to further images in the list with identical dimen-
sions.
8. Click Copy Parameters. Select the image with identical dimensions in the list and click
Paste Parameters.
9. Continue with the other images of the list. Use Copy Parameters and Paste Parameters,
or define the export settings for each image individually in the Parameters tool.
10. Click Check All. All images in the list will be tagged with a green marker, if they have the
correct setting.

11. Activate the checkbox for each image you want to have exported and click Apply.
All images in the list are checked and exported in separate folders in the Input folder.

3.11.4 Cropping a ROI

In this topic we will show you how to crop a region of interest (ROI) of an image.

Prerequisite ü You have acquired or opened a multichannel image.


1. On the Processing tab, open the Method tool and under Utilities select the entry Create
Image Subset.
2. In the Image Parameters section, open the Input tool and select the image.
3. In the Method Parameters section, open the Parameters tool.
4. Open the Z-position dimension setting and select Extract Range of the drop-down list.
Set the start position and the end position using the slider or the input field.
5. Open the Region setting and select Rectangular Region of the drop-down list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 77


3 Basic Concepts | 3.11 Image Processing ZEISS

6. Click in the image on the start position of the ROI and draw a rectangular region.

à You have marked the ROI which should be cropped.


7. Click on the Apply button.
The marked ROI with the defined dimensions is extracted of the image. You can now save or
process this image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 78


3 Basic Concepts | 3.11 Image Processing ZEISS

Fig. 10: Cropped ROI with the dimensions All channels and the Z-Position 11-20.

3.11.5 Creating an EDF Image

In this topic we will show you how to create an extended depth of focus (EDF) image of a Z-Stack
image. The focus planes of all the z-positions will be calculated to one EDF image.

Prerequisite ü You have acquired or opened a z-stack image.


1. On the Processing tab, open the Method tool and select under Sharpen the entry Ex-
tended Depth of Focus.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 79


3 Basic Concepts | 3.11 Image Processing ZEISS

2. In the Image Parameters section, open the Input tool and select the Z-Stack image as in-
put image.

3. In the Method Parameters section, open the Parameters tool.


4. Select Wavelets of the Method drop-down list.
5. Select High of the Z-Stack Alignment drop-down list.
6. Click on the Apply button.
All focus planes of the Z-Stack image are now calculated to one EDF image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 80


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.6 Creating Image Subset and Split Dimensions

Depending on your loaded image, you can split certain dimensions, e.g. channels or timepoints,
and save them to separate images. First, you select the method, and in the Parameters tools, you
specify the dimension. Each of the dimensions is only visible if the corresponding dimension is
present in the input image.
Create Image Subset and Split opens the resulting images in the ZEN document area. There-
fore, for this image processing function, Split Dimension is limited to a maximum of 20, e.g. time-
points, tiles, or slices. To split images along a dimension with more than 20 elements, use Create
Image Subset and Split (Write files), which creates image files in the specified folder.

Prerequisite ü You have loaded an image with more than one channel and not more than 20 timepoints.
1. Select Processing tab > Method tool, and select under Utilities the entry Create Image
Subset and Split or Create Image Subset and Split (Write files). When using the first
option, you can specify the output in the Output tool.
2. To create a subset from the available dimensions, make your settings in the sections Chan-
nels and Time.
3. In the Parameters tool, in the Split Dimension section, select the dimension along which
you want to split the image, e.g. Channel or Time.
In the Channels list, all channels of the loaded image are listed. Unselect channels you
want to exclude.
In the Time section, select the subset of timepoints which you want to include. If you have
an image with more than 20 timepoints, and you limit the range to below 20 elements,
Time will appear in Split Dimension allowing you to split the data set along this dimen-
sion (for Create Image Subset and Split).
In the Region section, select the region which you want to extract from the image, e.g.
Full or Rectangle Region.
Select Rectangle Region and draw a rectangle in the 2D view to specify the region you
want to extract.
When you use Create Image subset and Split (Write files), you also need to specify the
output folder for the images.
4. In the Input tool, specify whether you want to set the input automatically and which image
you want to display after processing. Check the according options.
5. In the Output tool, specify how to proceed with the new image. Select if you want to over-
write an existing image with the same name or if you want to create a new output. The
output tool is only available, if you selected the Create Image Subset and Split method.
6. Click the Apply button.
The new images are created according to your specifications, see Create Image Subset and Split
[} 194] or Create Image Subset and Split (Write files) [} 196].

3.11.7 Using Analyze to Label Image

The image processing functions Analyze to Label Image and Analyze to Label Image Batch
label images based on an existing image analysis setting and the parameters which you select
from the function. For general information about the image processing, see Image Processing
Workflow [} 72]. For a description of all the parameters of Analyze to Label Image, see Ana-
lyze to Label Image [} 155] and for Analyze to Label Image Batch, see Analyze to Label Im-
age Batch [} 157].
The image analysis with these functions offers a wide variety of parameter options and the out-
come completely depends on the combination of them. Therefore, this chapter can only give an
example to illustrate the use and outcome of the function. In general, the labeling is possible as
regions, contours, and double contours. For all three the same options are given in Label Mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 81


3 Basic Concepts | 3.11 Image Processing ZEISS

As an example, the following two channel image and image analysis setting with three classes are
used to illustrate the functions:

Example: Applying One channel and One channel per class


With these options, you can initialize your output image either as an image with one labeled
channel or as an image where the labels for each class have a separate channel.
Labeling regions with the maximum pixel type as an 8 bit black and white image generates the
following output for the first class:

Labelling the other two classes with the option One channel per class additionally creates the
output for the other two classes:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 82


3 Basic Concepts | 3.11 Image Processing ZEISS

If you want the regions to have the same color as defined in the image analysis setting, you can,
for example, choose the option Region - Region Class Color and 24 Bit RGB as Pixel Type:

As stated before, you can choose the same options (labeling with pixel type maximum and region
class color) for contours or double contours as well.

3.11.8 Image Processing Functions

3.11.8.1 General Settings

Parameter Description
Settings In the Settings section at the top of the Parameter tool you are able
to save and reload the adjusted settings.
If you have adjusted the parameters for a function, simply click on
Options > New to save your setting under a new name.

– New Creates a new setting.

– New from Creates a new setting based on an existing template.


Template

– Rename Renames the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name.

– Import Imports an existing setting.

– Export Exports the current setting.

– Delete Deletes the current setting.

Third Dimension Only visible, if there is a third dimension in the input image and/or
Show all mode is activated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 83


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Here you can select how you want the function to work in the case of
multidimensional images.

- 2D Slices The function is used in a 2-dimensional fashion only for multidimen-


sional images such as time lapse or z-stacks.

- Z, T, C or X Here you can select to which additional dimension the functions


should be applied to. If you select the C (channel) dimension, the Ad-
just per Channel checkbox is not available. The X dimension is only
available for Lattice Lightsheet, as their x-stacks are acquired.

Adjust per Channel Only available for images with multiple channels and if C is not se-
lected as Third Dimension.
Activated: Opens a list with the channels to allow an individual ad-
justment of each channel. For every channel you have the following
options:

– Process Chan- Processes this channel according to the input.


nel

– Skip Channel Skips this channel when processing. This channel will not be in the
output image.

– Copy Channel This channel is copied into the output image without a reduction of
noise.

Reset Settings to You can reset the settings for a function to default by clicking on the
Default Defaults button.

3.11.8.2 Adjust

3.11.8.2.1 Background Subtraction

With this function you remove smooth background or correct uneven illumination. The implemen-
tation is adapted from the corresponding function in ImageJ and based on the “rolling ball” algo-
rithm (S. Sternberg, “Biomedical Image Processing”, IEEE Computer, January 1983).

Parameters

Parameter Description
Radius Here you adjust the radius of the rolling ball in pixels. This value
should be at least as large as the radius of the largest object in the im-
age that is not part of the background. Larger values will also work
unless the background of the image is too uneven.

Create Background If activated, an image which contains the detected background only is
only created. Use this image to subsequently perform manual corrections
of the image background, e.g. using the image calculator function.

Do smoothing be- If activated, a 3 x 3 pixel averaging is performed before analyzing the


forehand background. Use this option to ensure that the image data after sub-
traction will not be below the background.

Light Background Use this option if your image contains bright background and dark
objects.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 84


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.2.2 Brightness/Contrast/Gamma

This method allows you to adjust the brightness, contrast, and gamma value of an image.

Info
Unlike the adjustments that can be made on the Display tab, here the pixel values of the im-
age are changed.

Parameters

Parameter Description
Brightness Adjust the desired brightness using the slider or input field.
Changing the brightness means that each gray or color value is in-
creased or decreased by the same value. The difference between the
biggest and smallest gray or color value in the image remains the
same, however.

Contrast Adjust the desired contrast using the slider or input field.
Changing the contrast means that the gray or color values are multi-
plied by a factor. The difference between the biggest and smallest
gray or color value changes.

Gamma Adjust the desired gamma value using the slider or input field.
Changing the gamma value means that the gray or color values are
multiplied by individual factors.

3.11.8.2.3 Color Balance

This method allows you to adjust the weighting of the individual color channels of a true color im-
age.

Parameters

Parameter Description
Range to Adjust Here you can select the adjustment range for the color balance. There
are 3 ranges available:

- Shadows The settings relate to tones in the dark color range.

- Midtones The settings relate to tones in the mid color range.

- Lights The settings relate to tones in the light color range.

Cyan - Red Adjust the desired color balance using the slider or input field.

Yellow - Blue Adjust the desired color balance using the slider or input field.

Magenta - Green Adjust the desired color balance using the slider or input field.

3.11.8.2.4 Color Temperature

This method allows you to adjust the color temperature of a true color image. Therefore, use the
Temperature Delta slider. A description of the slider can be found under White Balance [} 90].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 85


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.2.5 Histogram Equalization

This function enhances the contrast by linearizing the histogram of the image to equal area frac-
tions in the histogram. The areas (pixel count multiplied by gray value range) of all gray values in
the histogram of the result image are the same.

Parameter Description
All Z If activated, the function is applied to all Z planes.

All T If activated, the function is applied to all time points.

High Threshold The fraction of pixels that will be mapped to the highest gray value of
the output image.

Lower Threshold The fraction of pixels that will be mapped to gray value 0.

3.11.8.2.6 Hue/Saturation/Lightness

This method allows you to adjust the hue, saturation, and brightness of a true color image.

Parameters

Parameter Description
Hue The value of the shift represents an angle on the color wheel. The val-
ues -180 and +180 therefore have an identical effect. Negative angles
shift the color tone towards blue and positive ones shift it towards
red.
Adjust the desired shift in the color tone using the slider or input field.

Saturation Saturation describes how intense the color of a pixel is. "Chromatic" is
the maximum saturation, while "achromatic" describes colors that do
not leave a color impression.
Adjust the desired saturation using the slider or input field.

Lightness Lightness describes how light or dark a pixel appears. The greatest
difference is between black and white or between violet and yellow.
Adjust the desired brightness using the slider or input field.

3.11.8.2.7 Rolling Ball

Rolling ball performs a background correction based on the work of Sternberg, Stanley R. “Bio-
medical image processing.” Computer 1 (1983): 22-34. It determines the background in an image
locally which allows this to be used on unevenly illuminated images as opposed to using a global
background value. The size of the ball should be at least as large or exceed the size of the largest
object, which is not part of the background.

Parameter Description
Radius Sets the radius of the rolling ball creating the background in pixels.

Background Only Activated: Only creates a background, but does not subtract it.

Smooth Activated: Smoothes the image before creating the background.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 86


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
The following parameters are only visible, if you have a CUDA capable GPU.

GPU Activated: Uses the GPU to perform the rolling ball background cor-
rection.

Subsampling Activated: Applies subsampling to reduce resource consumption of


the GPU.

3.11.8.2.8 Shading Correction

This method allows you to improve images in which the quality has been impaired by uneven illu-
mination or vignetting.
If you want to perform shading correction before an experiment (recommended), you have to use
the shading correction function in the Camera tool, in the Post-Processing section [} 882].

Parameter Description
Shading Mode Selects which shading correction should be applied.

- Channel Spe- For multichannel references, the information from each channel is ap-
cific plied individually to the input image. The number and type of chan-
nels must be the same between input image and shading reference
image. This is the correct setting when using a reference image which
was created by the Shading Reference for Processing function
(e.g. for Axioscan images).

- Averaged For multichannel references, an average over all channels is calculated


and then applied equally to each tile of each channel. This should en-
sure that a good result can still be achieved with an unequal number
of channels or different channel characteristics.

- Tile Specific In case a shading reference has more than one tile, the tiles of the ref-
erence and the tiles of the image that should be corrected are
mapped to each other. The tiles must be identical in number and XY
position. This can be the case, for example, when using an Axiozoom
where shading is primarily determined by the sample mounting situa-
tion rather than the optical system.

Automatic Activated: The function automatically calculates the reference image


for shading correction from the input image.

Shading Reference Only available in Batch mode and if Global Shading is selected, or
Camera Shading is selected and Automatic is deactivated.
Enables you to select a reference image for the shading correction.

Display Mode

- Additive In this mode the normalized reference image is subtracted from each
camera frame. This influences the brightness of the image.

- Multiplicative In this mode each camera frame is divided by the normalized refer-
ence image. This influences the contrast of the image. This is the de-
fault setting.
The simulated/auto reference image is created by averaging up to 20
camera frames in the input image and running a lowpass filter on
them.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 87


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Offset Adjust the gray value that will be added on to the newly calculated
gray values using the slider or input field. If this results in negative val-
ues, these are set to 0. Values that exceed the maximum gray value
are set to the maximum gray value.

See also
2 General Settings [} 83]

3.11.8.2.9 Shading Reference for Acquisition

With this method you can create shading reference images for multi-channel tile images. It col-
lects the intensity information from many tiles and creates an averaged image representing the
shading influences of the system on the image. Note: Z-stack and time series images cannot be
processed with this function! Best results are achieved for images containing more than 200 tiles
per channel. The software creates the shading reference image and stores it directly to the Cali-
bration Manager (Shading Reference).

Parameters Description
All Scenes Only available for multi-scene images.
Selects all scenes for processing.

Selected Scene Only available for multi-scene images and if All Scenes is deactivated.
Selects the scene used for processing.

Merge Channels Creates a single multi-channel-reference-image (with the same chan-


nel order) in one step.

Adjust per Channel Only available for images with multiple channels.
Activated: You can adjust the settings for every channel separately.
To use a channel, select Process Channel or select Skip Channel if
you do not want a channel to be processed.
The settings Save directly as Shading Reference and Channel-spe-
cific are applied separately for each channel. If you want to use the
same settings for all channels, deactivate the checkbox.

Channel-specific Activated: The software performs channel-specific shading correc-


tion. In this case the fluorescence filter used during image acquisition
is saved with the shading file. The following components will be in-
cluded in the shading reference and checked before applying shading
correction:
Contrasting method and condenser, fluorescence filter, magnification:
Objective and Optovar; camera bit depth and RGB/BW mode, camera
type and port position.
Deactivated: The system creates an All Channel calibration and per-
form an objective specific shading correction. The following compo-
nents will be included in the shading reference and checked before
applying shading correction:
Magnification (Objective and Optovar); Camera bit depth and RGB/
BW mode, and camera type and port position.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 88


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameters Description
Auto Adjust Inten- Activated: Automatically calculates the multiplication factor based on
sity the gray values of the image and the needed gray values for using it
in the shading reference calibration manager.
If activated, the setting for Multiply Factor has no influence anymore
on the image generation.

Multiply Factor Only available if is Auto Adjust Intensity deactivated. Sets a multipli-
cation factor, i.e. the software will multiply the pixel intensity for each
pixel of the shading reference image by this value.
If you use an own sample, it is mostly the case that the images are
very dim and the intensity does not reach the value needed to be
used within the shading reference calibration manager, thus it will be
rejected.

Apply Gaussian Fil- Activated: A Gaussian filter is applied after the averaging of the field
ter of views from a tiled image is done. This enables to smooth the shad-
ing reference image.
Use this filter and the Sigma factor very carefully as it could remove
also features which are real shading structures. This feature could be
recommended if the number of tiles in the scanned image is low and
cannot be increased for certain reasons.

Sigma Only available if Apply Gaussian Filter is activated.


Defines the strength of the smoothing.

3.11.8.2.10 Shading Reference for Processing

With this method you can create shading reference images for multi-channel tile images. It col-
lects the intensity information from many tiles and creates an averaged image representing the
shading influences of the system on the image. Note: Z-stack and time series images cannot be
processed with this function! Best results are achieved for images containing more than 200 tiles
per channel.

Parameters Description
All Scenes Only available for multi-scene images.
Selects all scenes for processing.

Selected Scene Only available for multi-scene images and if All Scenes is deactivated.
Selects the scene used for processing.

Merge Channels Creates a single multi-channel-reference-image (with the same chan-


nel order) in one step.

Adjust per Channel Only available for images with multiple channels.
Activated: You can adjust the settings for every channel separately.
To use a channel, select Process Channel or select Skip Channel if
you do not want a channel to be processed.
The settings Save directly as Shading Reference and Channel-spe-
cific are applied separately for each channel. If you want to use the
same settings for all channels, deactivate the checkbox.

Channel-specific Activated: The software performs channel-specific shading correc-


tion. In this case the fluorescence filter used during image acquisition
is saved with the shading file. The following components will be in-
cluded in the shading reference and checked before applying shading

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 89


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameters Description
correction:
Contrasting method and condenser, fluorescence filter, magnification:
Objective and Optovar; camera bit depth and RGB/BW mode, camera
type and port position.
Deactivated: The system creates an All Channel calibration and per-
form an objective specific shading correction. The following compo-
nents will be included in the shading reference and checked before
applying shading correction:
Magnification (Objective and Optovar); Camera bit depth and RGB/
BW mode, and camera type and port position.

Autoadjust Inten- Activated: Automatically calculates the multiplication factor based on


sity the gray values of the image and the needed gray values for using it
in the shading reference calibration manager.
If activated, the setting for Multiply Factor has no influence anymore
on the image generation.

Multiply Factor Only available if is Auto Adjust Intensity deactivated. Sets a multipli-
cation factor, i.e. the software will multiply the pixel intensity for each
pixel of the shading reference image by this value.

Apply Gaussian Fil- Activated: A Gaussian filter is applied after the averaging of the field
ter of views from a tiled image is done. This enables to smooth the shad-
ing reference image.
Use this filter and the Sigma factor very carefully as it could remove
also features which are real shading structures. This feature could be
recommended if the number of tiles in the scanned image is low and
cannot be increased for certain reasons.

Sigma Only available if Apply Gaussian Filter is activated.


Defines the strength of the smoothing.

3.11.8.2.11 Stack Correction

This method allows you to improve the quality of z-stack images that have been affected by
bleaching effects during acquisition. Under Correction, you can select the desired correction
mode or a combination of the modes.

Parameter Description
Decay This mode compensates the bleaching effect.

Flicker This mode compensates the flicker of the lamp voltage.

Background This mode reduces background noise.

Bad Pixels This mode compensates for hot pixels.

See also
2 General Settings [} 83]

3.11.8.2.12 White Balance

This method allows you to adjust the white balance of an image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 90


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameters

Parameter Description
Automatic Activated: The white spot is calculated automatically from the image
data.

White Spot Only visible if the Automatic checkbox is deactivated.

Define the white spot by clicking on the Pick.. button. The


mouse pointer then changes to a pipette symbol. Use it to click on a
white region of your input image. The coordinates and color values of
the selected white spot are displayed next to the button.

Temperature Delta Adjust the delta that will be added on to the newly calculated color
values. Negative values reduce the color temperature, while positive
values increase it. A value of 1 corresponds to 10 Kelvin.

3.11.8.3 Batch Processing Functions

3.11.8.3.1 Attach PSF (Point Spread Function)

This method is only available for batch processing.


This method attaches a previously created PSF to the image file.

Parameter Description
Channel Selects the channel where the PSF should be attached.

PSF File Selects the PSF-file created by the image processing function Cre-
ate PSF.

3.11.8.3.2 Change Scaling

This method is only available for batch processing.

Parameter Description
X Scaling Changes the scaling of the image in X-direction.
The following units are
possible:

- m/px Changes the unit (length per pixel).

- cm/px

- mm/px

- µm/px

- nm/px

- pm/px

- i/px

- mil/px

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 91


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Y Scaling Changes the scaling of the image in Y-direction.
The following units are
possible:

- m/px Changes the unit (length per pixel).

- cm/px

- mm/px

- µm/px

- nm/px

- pm/px

- i/px

- mil/px

Z Scaling Changes the scaling of the image in Z-direction.


The following units are
possible:

- m/px Changes the unit (length per pixel).

- cm/px

- mm/px

- µm/px

- nm/px

- pm/px

- i/px

- mil/px

Pick scaling from file Applies the scaling from another czi-file.

3.11.8.3.3 Draw Scale Bar Annotation

This method is only available for batch processing.

Parameter Description
Distance from docu- Sets the distance of the Scale Bar from the bounds of the image
ment bounds (in pixel).

Alignment Sets the alignment of the Scale Bar.

- Top Left

- Top Center

- Top Right

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 92


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Middle Left

- Middle Center

- Middle Right

- Bottom Left

- Bottom Center

- Bottom Right

Orientation Sets the orientation of the Scale Bar.

- Horizontal

- Vertical

3.11.8.3.4 Split Multiblock Image (for Images until ZEN 2.1)

Parameter Description
Split Mode Chooses the mode how to split the multiblock image (in pixel).

- Homogeneous Splits the multiblock image into the single dimensions. The
groups blocks will remain.

- Single blocks Splits the multiblock image into single blocks.

Target Folder Specifies the folder where the split images are stored. The path
of the destination folder is displayed automatically in the display
field. To change the folder, click on the button to the right of the
display field.

Defaults Restores the default values for the batch method.

3.11.8.3.5 Undo Stitching

This method is only available for batch processing.


Undoes a previously applied stitching of the image.
No method parameters necessary.

3.11.8.4 Deconvolution

3.11.8.4.1 Airyscan Joint Deconvolution

The Airyscan Joint Deconvolution method provides an alternative processing of Airyscan SR data
for even higher resolution. An unprocessed Airyscan SR file needs to be selected as an input file.
Airyscan Joint Deconvolution enables you to adjust the strength of the processing by defining the
number of iterations. Note that overdoing the processing strength can result in artificially small
structures, or splitting of solid structures.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 93


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Start with Last Re- Activated: Keeps the iteration result and adds additional iterations in-
sult stead of starting the processing from the beginning again.

Sample Structure Sets the default value for typical sample types.

– Sparse Sets the default value for a sample with small structures and lots of
black background (e.g. beads).

– Standard Sets the default value for a standard sample.

– Dense Sets the default value for a sample with lots of structures and little
background.

Maximum Itera- Sets the number of maximum iterations. This input is connected to
tions the Quality Threshold parameter. If the Quality Threshold is set to
0, the number of iterations are processed as set here. If a threshold
greater 0 is defined, the set number of iterations will not always be
used, but processing stops if a certain resolution quality is achieved.
The number of actual iterations is documented in the image Info
view.

Quality Threshold Sets the threshold for quality. This input is connected to the Maxi-
mum Iterations parameter.

See also
2 Using Direct Processing [} 230]

3.11.8.4.2 Deblurring

Deblurring is a 2D background removal function based on the nearest neighbor algorithm. In the
nearest neighbor method, the input is a 3D image where an in-focus slice is enhanced by sub-
tracting its convolved neighbor(s). In computational clearing, the input is a 2D image. The neigh-
bor is approximated using the 2D out-of-focus PSF from the microscope. It is then subtracted
from the 2D input image the same way as the nearest neighbor algorithm.

Parameter Description
Normalization Here you can select how the gray/color values that exceed or fall
short of the value range should be dealt with. If you use this method
with Direct Processing, only the Clip method is available and prese-
lected.

– Automatic Automatically sets the gray levels that exceed or fall short of the pre-
defined gray value range to the lowest or highest gray value (black or
white). The effect corresponds to underexposure or overexposure. In
certain circumstances some information may therefore be lost.

– Clip Normalizes the gray values automatically by clipping them to the


available gray value range, for example values greater than the maxi-
mum grey value (e.g. 256 for 8 bit) are clipped to that value.

Strength Sets the strength of the out of focus neighbor that is being sub-
tracted. A higher value results in less background.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 94


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Sharpness Sets the sharpness which is inversely related to the regularization
strength. A higher value results in a sharper image. This parameter is
only valid for the final deconvolution that is done for further refine-
ment of the subtracted image.

Blur Radius Sets the PSF radius in pixels. The value of radius is proportional to the
focal distance. A bigger radius results in less background.

See also
2 Using Direct Processing [} 230]
2 General Settings [} 83]

3.11.8.4.3 Deconvolution (adjustable)

Deconvolution can be done either by using the computers CPU or by using a graphics card. Using
a graphics card can speed up deconvolution processing quite dramatically. A NVIDIA graphics
card is required which supports the CUDA processing library. Contact your sales representative for
further details about supported graphic card models.
For a detailed overview of all deconvolution methods (and its combinations), see Deconvolution
Methods in ZEN [} 590]. This method allows you to use and individually configure 4 different al-
gorithms for deconvolution (short DCV). Two tabs are available for detailed configuration:

§ On the Deconvolution tab, you can select the desired algorithm and define the precise set-
tings for it, see Deconvolution Tab [} 95].
§ On the PSF Settings tab, you can see and change all key parameters for either generating a
theoretically calculated PSF, or selecting an experimentally measured PSF, see PSF Settings
Tab [} 99].

See also
2 Performing Configurable Deconvolution [} 595]

3.11.8.4.3.1 Deconvolution Tab

Info
Expert knowledge is required for some of the settings. If you are in doubt, leave the settings
unchanged.

Parameter Description
Algorithm Select the deconvolution algorithm. The following algorithms are
available:

§ Nearest Neighbor
§ Regularized Inverse Filter
§ Fast Iterative
§ Constrained Iterative

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 95


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Enable Channel Se- Activated: Applies the settings on a channel specific basis. This al-
lection lows you to set parameters for each channel individually. A separate,
colored tab for each of the channels is displayed.
Deactivated: Applies the same settings to all channels of a multi-
channel image.

Normalization Specifies how the data of the resulting image is handled if the gray/
color levels exceed or fall short of the value range.

– Clip Clips the values that exceed or fall short of the value range. Sets neg-
ative values to 0 (black). If the values exceed the maximum possible
gray value of 65636 when the calculation is performed, they are lim-
ited to 65636 (pixel is 100% white).
Results from different input images can be quantitatively compared
with each other.

– Automatic Normalizes the output image automatically. In this case the lowest
value is 0 and the highest value is the maximum possible gray value in
the image (gray value of 65636). The maximum available gray value
range is always utilized fully in the resulting image.
Results from different input images cannot directly be compared
quantitatively with each other.

– Factor Only visible if Clip is selected.


Defines a scaling factor for normalization. A factor above 1 stretches
the histogram to show the full dynamic range of the data (showing
complete information of the given data). A factor >1 makes sense to
scale up values with a float number with decimal places. A factor be-
low 1 squeezes the histogram, data that is above the pixel maximum
would be lost.

Set Strength Man- For the Nearest Neighbor and the Fast Iterative algorithm, the
ually checkbox is always activated.
Activated: Sets the desired degree of restoration with the slider. To
achieve strong restoration and best contrast, move the slider towards
Strong. To achieve lower restoration but smoother results, move the
slider towards Weak. If the setting is too strong, image noise may be
intensified and other artifacts, such as "ringing", may appear.
Deactivated: Determines the restoration strength for optimum image
quality automatically. This is recommended for widefield and confocal
images and is therefore deactivated by default.
The restoration strength is inversely proportional to the strength of
so-called regularization. This is determined automatically with the
help of Generalized Cross Validation (GCV).

Convergence His- Visible for Fast Iterative or Constrained Iterative algorithms.


tory
Displays the progress of the calculation as line graph. Several quality
parameters are measured for each iteration and once either an opti-
mum or the maximum allowed number of iterations is reached, the
processing is stopped. This display allows you to observe directly how
the iterative method affects the available data. It also shows how
many iterations have been used and how much time is being used per
iterations.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 96


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Corrections
To display parameters for image correction, click .

– Background Activated: Analyzes the background component in the image and re-
moves it before the deconvolution calculation. This can prevent back-
ground noise being intensified during deconvolution.

– Bad Pixel Cor- Activated: Employs a fully automatic detection and removal of spuri-
rection ous or hot pixels (also known as stuck pixels) in an image stack which
might interfere with the deconvolution result.
It is based on the analysis of the gray level variance in the neighbor-
hood of each pixel in the image. It is recommended to use this param-
eter only, if stuck pixels are observed in the input image.

– Fluorescent Activated: Corrects bleaching of the sample during acquisition of the


Decay z-stack.
This function should only be activated for widefield images. Use it if
your sample undergoes strong bleaching during acquisition.

Execution Options Only visible if Enable Channel Selection is activated. Enables you to
select how the respective channel is handled during processing.

– Execute Processes this channel according to the set parameters.

– Copy This channel is copied into the output image without processing.

– Skip Skips the channel when processing. The respective channel will not be
in the output image.

3.11.8.4.3.1.1 Advanced Settings

This section is only visible if you have selected the Regularized Inverse Filter, Fast Iterative or
Constrained Iterative algorithm. To display advanced settings, click .

Parameter Description
Likelihood Visible for Fast Iterative and Constrained Iterative algorithms.
Selects which likelihood calculation you want to work with.

– Poisson Only visible for the Fast Iterative algorithm.


(Meinel) The calculation according to Meinel works with one convolution per
iteration and converges very fast, normally in 4-5 iterations. This
method can also produce artifacts, however.

– Poisson Only visible for the Fast Iterative algorithm.


(Richardson- Accelerated version of Richardson-Lucy, based on a Poisson likelihood
Lucy) and Biggs acceleration (https://doi.org/10.1364/AO.36.001766), al-
lowing for fast and artifact free reconstructions.

– Poisson Only visible for the Constrained Iterative algorithm.


Computation assuming a Poisson noise distribution, this is normally
the correct noise model for microscopic images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 97


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Gauss Only visible for the Constrained Iterative algorithm.
Computation assuming a Gaussian noise distribution. If detector
noise is dominant over sample noise, using a Gaussian noise model
can be advantageous, however, this is rarely the case with modern
microscopy systems.

Regularization Selects which frequencies in the image are taken into account during
regularization.

– None Only visible for the Fast Iterative and Constrained Iterative algo-
rithms.
No regularization is performed.

– Zero Order Regularization based on G-difference, modeled on Tikhonov, but ac-


celerated.

– First Order Only visible for the Regularized Inverse Filter and Constrained It-
erative algorithms.
Regularization based on Good's roughness. Under certain circum-
stances, more details are extracted from noisy data. It may be better
suited to the processing of confocal data sets.

– Second Order Only visible for the Constrained Iterative algorithm.


Regularization according to Tikhonov-Miller. Here higher frequencies
are penalized more than in the case of Good's roughness. Results
have a tendency to become overly smoothed.

– Total Varia- Only visible for the Fast Iterative algorithm.


tion Total Variation regularization denoises the input data but protects the
edges of structures. This can improve results for noisy data but in-
creases the computation time quite significantly.

Optimization Visible for Fast Iterative and Constrained Iterative algorithms.

– Analytical Only visible for the Constrained Iterative algorithm.


(Newton Here an attempt is made to optimize the iterations analytically. It is an
Raphson) optimization method to find the step size in each of the Constrained
Iterative iterations. This option is usually faster but may also be some-
what less precise.

– Line Search Only visible for the Constrained Iterative algorithm.


Searches rigorously and comprehensively for the minimum. It is there-
fore more robust, but the calculation takes longer. It is an optimiza-
tion method to find the step size in each of the Constrained Iterative
iterations. Line search is recommended for confocal data sets, espe-
cially if they are noisy as this can enforce convergence even for noisy
and sparsely sampled data.

– Numerical Only visible for the Fast Iterative algorithm.


Gradient If selected, an attempt is made to determine the trend of the itera-
tions in advance and extrapolate this to the entire calculation. This
can significantly speed up the calculation.

First Estimate Visible for Fast Iterative and Constrained Iterative algorithms.

– Input Image The input image is used as the first estimate of the target structure
(default).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 98


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Last Result The result of the last calculation is used to estimate the next calcula-
Image tion. This can speed up a calculation that is repeated using slightly dif-
ferent parameters.

– Mean of Input No estimate is made, the mean gray level of the input image is being
used. This is the most rigid application of deconvolution. It should be
chosen for confocal images, where the data sampling can be quite
sparse. The computation time will increase, but missing information
can be recovered from the PSF.

– Zero Values Only visible for the Constrained Iterative algorithm.

Maximum Itera- Visible for Fast Iterative and Constrained Iterative algorithms.
tions Sets the maximum permitted number of desired iterations. In the case
of Richardson-Lucy, you should allow significantly more iterations
here.

Quality Threshold Only visible for the Fast Iterative and Constrained Iterative algo-
rithms.
Defines the quality level at which you want the calculation to be
stopped. The percentage describes the difference in enhancement be-
tween the last and next-to-last iteration compared with the greatest
difference since the start of the calculation. 1% is the default value.
Lowering this can bring about small improvements in quality.

GPU Acceleration Only visible if a suitable (NVIDIA, CUDA based) graphics card is in-
stalled in your PC. The checkbox is then activated by default.
Activated: Uses GPU processing.
Deactivated: Uses CPU processing.

GPU Tiling Only available for very large images that exceed the available graphic
card memory.
Activated: With this function the image is split up in smaller portions
which fit into the memory of the graphic card. The function automati-
cally determines into how many tiles the image must be split to allow
maximum usage of the graphics card. The resulting tiles are automati-
cally stitched together for the final output result.
Deactivated: No tiling is performed, however, in this case only cer-
tain sub-functions of deconvolution can run on the graphics card and
the speed increase compared to CPU processing will be lower. The
image quality might be higher than with tiling because there is no
need for stitching.

3.11.8.4.3.2 PSF Settings Tab

All key parameters for generating a theoretically calculated Point Spread Function (PSF) are dis-
played on this tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 99


3 Basic Concepts | 3.11 Image Processing ZEISS

Info
Usually, images (with file type *.czi) that have been acquired with ZEN automatically contain
all microscope parameters, meaning that you do not have to configure any settings on this
tab. Therefore, most parameters are grayed out in the display. It is possible, however, that as a
result of an incorrect microscope configuration values may not be present or may be incorrect.
You can change them here. The correction of spherical aberration can also be set here.

3.11.8.4.3.2.1 Microscope Parameters Section

The most important microscope parameters for PSF generation that are not channel-specific are
displayed in this section.

Info
If you enter incorrect values, this can lead to incorrect calculations. If the values here are obvi-
ously wrong or values are missing, check the configuration of your microscope system.

Parameter Description
Microscope Displays which type of microscope has been used. There are two main
options: conventional microscope (also known as a widefield micro-
scope) and confocal microscope, for which the additional pinhole di-
ameter parameter applies.

NA Objective Displays the numerical aperture of the objective.

Immersion Displays the refractive index of the immersion medium. Note that this
can never be smaller than the numerical aperture of the objective.
You can make a selection from typical immersion media in the drop-
down list next to the input field.

Scale Lateral Displays the geometric scaling in the X/Y direction.

Scale Axial Displays the geometric scaling in the Z direction.

Override To change the input fields that are normally grayed out, click on the
button. The input fields and drop-down lists are now active. The text
on the button changes to Reset. To restore the original values saved
in the image, click Reset.

Master Reset Resets the metadata to the values which were originally stored in the
image at time of acquisition. It reverts any changes made by clicking
Override.

3.11.8.4.3.2.2 Advanced Section

Only visible if the Show All mode is activated.

Parameter Description
Phase Ring If you have acquired a fluorescence image using a phase contrast ob-
jective, the phase ring present in the objective is entered here. This
setting has significant effects on the theoretical Point Spread Func-
tion (PSF).

PSF Generation Selects the model for calculating the PSF.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 100


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Scalar Theory The wave vectors of the light are interpreted as electrical field = inten-
sity and simply added. This method is fast and is sufficient in most
cases (default setting).

– Vectorial The- The wave vectors are added geometrically. However, the calculation
ory takes considerably longer.

Z-Stack This field can only be changed if it was not possible to define this pa-
rameter during acquisition, e.g. because the microscope type was un-
known. It describes the direction in which the z-stack was acquired.
Note that this setting is only relevant, if you are using the spherical
aberration correction.

– Descending The z-stack descends away from the objective.

– Ascending The z-stack ascends towards the objective.

3.11.8.4.3.2.3 Aberration Correction Section

Only visible if the Show All mode is activated.


Here you can select whether you want spherical aberration to be taken into account and cor-
rected during the calculation of the PSF. As with the other PSF parameters, most values are ex-
tracted automatically from the information about the microscope that is saved with the image
during acquisition. The input option is therefore inactive.

Parameter Description
Enable Correction Activated: Uses the correction function. All options are active and
can be edited.

Embedding Select the used embedding medium.


Medium

Refractive Index Displays the refractive index of the selected embedding medium. En-
ter the appropriate refractive index if you are using a different embed-
ding medium.

Manufacturer Displays the manufacturer, if known.

Depth Variance When Aberration correction is activated, it is also possible to enable


the creation of depth variant PSFs. This method allows for dramatic
improvements in image restoration of thicker samples by creating axi-
ally variant theoretical PSFs as a function of the distance to the cover-
slip and the refractive index of the mounting medium.
Activated: Uses depth variant aberration correction. In the spin box
edit field you can define how many PSFs should be generated. The
more PSFs you create, the better the results, but selecting many PSFs
increases the processing time. You should choose at least 3 PSFs.
In the dropdown list you can choose between the PCA method (Pri-
mary Component Analysis, M. Arigovindan et al., 2005, IEEE Transac-
tions on Image Processing 14. nr. 4 p.450ff) which is best suited for
constrained iterative and fast iterative method and the Strata method
(Myneni and Preza, Frontiers in Optics 2009, Optical Society of Amer-
ica, paper CThC4.), which is best for regularized inverse filter and
Richardson Lucy iterative deconvolution.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 101


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Distance to Cover Displays the distance of the acquired structure from the side of the
Slip cover slip facing the embedding medium. Half the height of the z-
stack is assumed as the initial value for the distance from the cover
slip. The value can be corrected if this distance is known. If possible,
this distance should be measured.
Note: Use Ortho View and the Distance Measurement option to
define the distance of the sample to the coverslip. It is also important
to estimate the position of the glass/embedding medium interface as
precise as possible. If the z-stack extends into the coverslip, the deter-
mined range of the stack which reaches into the glass should be en-
tered as a negative value. Example: Z-stack is 26 µm thick, glass/
medium interface is positioned at 9 µm distance from the first plane
of the stack. Resulting value for Distance to cover slip: - 9.0 µm.

Cover Slip Type Commercially available cover slips are divided into different groups
depending on their thickness (0, 1, 1.5 and 2), which you can select
from the dropdown list. Cover slips of the 1.5 type have an average
thickness of 170 µm. In some cases, however, the actual values can
vary greatly depending on the manufacturer. For best results the use
of cover slips with a guaranteed thickness of 170 µm is recom-
mended. Values that deviate from this can be entered directly in the
input field.

Cover Slip Ref. In- Selects the material that the cover slip is made of. The corresponding
dex refractive index is displayed in the input field next to it.

Working Distance Displays the working distance of the objective (i.e. the distance be-
tween the front lens and the side of the cover slip facing the objec-
tive). The working distance of the objective is determined automati-
cally from the objective information, provided that the objective was
selected correctly in the MTB 2011 Configuration program. You can,
however, also enter the value manually.

Override Only active if Enable Correction is activated.


Overrides the value. To reset the values, click Reset.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 102


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.4.3.2.4 Channel Specific Section

In this section you find all settings that are channel specific. This means that they can be config-
ured differently for each channel.

Parameter Description
Use External PSF Activated: Uses an external measured PSF. You find an additional in-
put window under Image Parameters > Input where you can select
the external PSF file. The software checks if the PSF's microscope pa-
rameters match with the input image. Deviations (10nm deviation in
wavelength will be accepted) make the software use a theoretical
PSF.

Attach to Input If an external PSF was selected, you can attach the file to the input
image. The saved input image then contains the correct measured
PSF. Usage of a theoretical PSF is possible as well for such an image.
Just deactivate the Use External PSF.

Illumination Displays the excitation wavelength for the channel dye [in nm] by us-
ing the peak value of the emission spectrum. The color field corre-
sponds to the wavelength (as far as possible).

Detection Displays the peak value of the emission wavelength for the channel
dye. The color corresponds to the wavelength (as far as possible).

Sampling Lateral Depends on the geometric pixel scaling in the X/Y direction and dis-
plays the extent of the oversampling according to the Nyquist crite-
rion. The value should be close to 2 or greater in order to achieve
good results during DCV. As, in the case of widefield microscopes,
this value is generally determined by the objective, the camera
adapter used and the camera itself, it can only be influenced by the
use of an Optovar. With confocal systems, the zoom can be set to
match this criterion.

Sampling Axial Depends on the geometric pixel scaling in the Z direction and displays
the extent of the oversampling according to the Nyquist criterion.
The value should be at least 2 or greater in order to achieve good re-
sults during DCV. This value is determined by the increment of the fo-
cus drive during acquisition of Z-stacks and can therefore be changed
easily.

Pinhole Only available if a confocal microscope has been entered under the
microscope parameters.
Displays the size of the confocal pinhole in Airy units (AU).

NA Cond. Only visible if the microscope is a Conventional Microscope and


Transmitted Light has been selected as the illumination type.
Displays the numerical aperture of the condenser with which trans-
mitted-light acquisition was performed.

3.11.8.4.3.2.4.1 Microscope Info Section

Displays advanced microscope information that influences the form of the PSF in a channel-de-
pendent way:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 103


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Illumination Selects the illumination method with which the data set has been ac-
quired. In the event that a Conventional Microscope has been en-
tered under the microscope parameters, the following options are
available here: Epifluorescence, Multiphoton Excitation and
Transmitted Light. In the case of confocal microscopes, Epifluores-
cence is the only option.

Image Formation Displays whether the imaging was incoherent (Conventional Micro-
scope) or coherent (Laser Scanning Microscope).

Lateral Resolution Displays the lateral resolution of the calculated PSF.

Axial FWHM Displays the FWHM (Full Width Half Maximum) as a measure of the
axial resolution of the PSF.

3.11.8.4.3.2.4.2 PSF View Section

This section shows you the PSF that is calculated for a channel based on the current settings. If
you select the Auto Update checkbox, all changes made to the PSF parameters are applied im-
mediately to the PSF view. This makes it possible to check quickly whether the settings made
meet your expectations. You can extract the PSF from the image via right-click menu (PSF Snap-
shot) which opens the resulting new PSF document in the center screen area.

3.11.8.4.4 Deconvolution (Defaults)

This method allows you to use four different algorithms for deconvolution, without any further
settings. The following algorithms are provided in the Parameter tool:

Parameter Description
Simple, very fast (Near- Only available, if a z-stack is selected as input image.
est Neighbor) Executes the fast Nearest Neighbor method using default pa-
rameters.

Better, fast (Regular- Executes the Regularized Inverse Filter algorithm for image en-
ized Inverse Filter) hancement.

Good, medium speed Executes the Fast Iterative restoration method.


(Fast Iterative)

Excellent, slow (Con- Only available if you have licensed the Deconvolution function-
strained Iterative) ality.
Executes the Constrained Iterative quantitative restoration
method.

See also
2 Performing Deconvolution Using Default Values [} 593]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 104


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.4.5 PSF Wizard

Parameter Description
Use Wizard Activated: Opens the Measured PSF Wizard when applying the
function to create a PSF.

Bad Pixel Correc- Employs a fully automatic detection and removal of spurious or hot
tion pixels (also known as stuck pixels) in an image stack which might in-
terfere with the PSF extraction procedure. It is based on the analysis
of the gray level variance in the neighborhood of each pixel in the im-
age. It is usually recommended to leave this parameter active.

Bead Proximity Only visible if Use Wizard is deactivated.


Defines the distance between two neighboring beads in μm. A bead is
excluded from the averaging if the distance to a neighboring bead is
greater than the minimum distance set. A smaller value leads to the
detection off fewer beads, albeit ones that are further apart, while a
larger value leads to the detection of more beads, but with the risk
that beads will partially overlap. Range between 2.1 and 20 µm.

Detection Sensitiv- Only visible if Use Wizard is deactivated.


ity Determines the sensitivity with which beads are being detected.
Range is between -5 to 5. Smaller Values lower the sensitivity exclud-
ing beads with weaker staining and lower signal to noise ratio, higher
values include also beads with weaker staining.

Average Beads Only visible if Use Wizard is deactivated.


Activated: Produces an image of an individual, averaged bead.
Deactivated: Produces an image in which each found bead is cen-
tered, but saved in the R dimension. A slider for Rotation (R dimen-
sion) is displayed on the Dimensions tab.

See also
2 Creating a PSF - With Wizard and Without [} 602]

3.11.8.5 EM Processing

This group lists image processing functions that are designed for processing FIB-SEM images.
Some of the functions can also be found in other groups of image processing functions. This
group is only visible if you have the license for EM Processing Toolbox.

See also
2 EM Processing Toolbox [} 793]

3.11.8.5.1 Change Pixel Type

This method allows you to change the pixel type of an image. This can be useful if you want to
compare or combine images that have different pixel types.

Parameters

Parameter Description
Pixel Format Select the desired pixel format from the dropdown list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 105


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- 8 Bit B/W The output image is a monochrome image, the whole-number gray
values of which can lie in the range from 0 to 255.

- 16 Bit B/W The output image is a monochrome image, the whole-number gray
values of which can lie in the range from 0 to 65535.

- 32 Bit B/W Float The output image is a monochrome image with real numbers as pixel
values.

- 2x32 Bit Com- The output image is a monochrome image with complex numbers
plex (real part and imaginary part) as pixel values. Such images are gener-
ally created by means of transformation into the Fourier space.

- 24 Bit RGB The output image is a color image, the whole-number color values of
which in the red, green, and blue channels can lie in the range from 0
to 255.

- 48 Bit RGB The output image is a color image, the whole-number color values of
which in the red, green, and blue channels can lie in the range from 0
to 65535.

- 2x32 Bit RGB The output image is a color image with real numbers as color values
Float in the red, green and blue channels.

- 3x64 Bit RGB The output image is a color image with complex numbers (real part
Complex and imaginary part) in the red, green and blue channels. Such images
are generally created by means of transformation into the Fourier
space.

3.11.8.5.2 Coarse Z-Stack Alignment

This function enables you to align planes of z-stacks manually.

Parameter Description
Z-Alignment Setup The Setup button opens the Coarse Z-Stack Alignment setup to
manually align your z-stack.

Shift List Displays a list with all the shifts that have been made in the Coarse Z-
Stack Alignment setup.

See also
2 Aligning Z-Planes Manually [} 794]

3.11.8.5.2.1 Coarse Z-Stack Alignment Setup

With this setup you can manually align the planes of a z-stack. If you have imported your z-stack
and there are bigger shifts between individual planes of the stack, this setup helps you to make a
coarse alignment of your z-stack before an automated alignment, e.g. via Z-Stack Alignment
with ROI.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 106


3 Basic Concepts | 3.11 Image Processing ZEISS

1 2

1 Alignment Controls Section


Here you have your controls to align the z-planes in the stack manually. For more infor-
mation, see Alignment Controls Section [} 107].

2 Image View
Displays your selected z-plane and the following plane with different colors. The current
plane is displayed in cyan and the following z-plane is displayed in red.

3 View Options
Here you have your standard view options (Dimensions Tab [} 1029] and Display Tab
[} 1043]).

See also
2 Aligning Z-Planes Manually [} 794]

3.11.8.5.2.1.1 Alignment Controls Section

This section of the Coarse Z-Stack Alignment setup contains the main controls to align the z-
planes of your stack manually.

Parameter Description
Speed Selects the speed/ number of pixels by which the z-planes are shifted
per click.

– Shifts the z-planes by 1 pixel per click.

– Shifts the z-planes by 10 pixels per click.

– Shifts the z-planes by 100 pixels per click.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 107


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Shifts the z-planes by 1000 pixels per click.

Arrow Buttons Shifts the next and all following z-planes in the corresponding direc-
tion.

Visibility Weight Changes the color intensity of the current plane and the following z-
slider planes in the Image View. In extreme slider positions, only the cur-
rent z-plane or only the following z-planes are displayed.

Channels Only available for images with multiple channels.


Selects the channel that is displayed in the Image View. The same
shift is applied to all channels of the image.

Shift List Displays a list with all the shifts in x and y direction that you defined in
the setup.

3.11.8.5.3 Create Image Subset

This method allows you to extract parts from one image and use these to create a new image.
You can select these parts freely from the individual dimensions of the image. Each of the param-
eter sections is only visible if the corresponding dimension is present in the input image.

Info
Image Analysis Results
Note that if your image contains analysis results, the analysis results are deleted when you exe-
cute this function.

Parameter Description
Channels Selects which channels of the input image are used. All channels are
selected by default. To deselect a channel, click on the respective
channel button.

Z-Position, Time, Here you can select which parts of the input image you want to use
Block, Scene for the resulting image.

- Extract All If selected, all parts of the corresponding image are extracted.

- Extract Single If selected, you can select a single image to be extracted.

- Extract Range If selected, you can select a certain range of images to be extracted.

- Extract Multi- If selected, you can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 108


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section 10, followed by sections 14 to 18, as well as
sections 20 and 23.

- Get current Adopts the position from the current display in the image area.
position

- Interval Activated: Interval mode is active. The Interval spin box/input field
appears.
Enter the desired interval here. E.g. if you enter the value 2 only every
2nd value from the range is considered.

Region Here you can select if you want to use the entire image or just a re-
gion (ROI) of the input image.

- Full Select this option to use the full image for the new image.

- Rectangle re- Select this option to draw in a rectangle region of interest, which will
gion (ROI) be used for creating a new image.
If a rectangle region was drawn in, you can see and change its coordi-
nates by editing the X/Y/W/H input fields.

- Keep tiles Only has an effect, if a region (ROI) is defined.


Activated: Extracts the drawn in region including the complete tiles.
This setting is recommended when you want to apply DCV processing
functions on the resulting image.

3.11.8.5.4 Cut Out Regions

This function allows you to define a region of interest in your z-stack and cut it out of the stack as
a separate volume.

Parameter Description
Define Regions Opens the Define Regions setup [} 110] to define the region of inter-
est to be cut out of your z-stack.

See also
2 Cutting Out a Volume from a Z-Stack [} 796]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 109


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.5.4.1 Define Regions Setup

1 2

1 Region Edit Section


Here you have the controls to draw and edit the support regions. For detailed informa-
tion, see Region Edit Section [} 110].

2 Image View
Here you can draw your support regions into the current z-plane and edit them if
needed.

3 View Options
Here you have some standard view options as well as the Support Regions Tab [} 111].

See also
2 Cutting Out a Volume from a Z-Stack [} 796]

3.11.8.5.4.1.1 Region Edit Section

With this tools you can draw regions into your image and edit them.

Parameter Description
Draw Draws a new region into the image.

Erase Using this button, you can erase parts of a region. Holding down the
left mouse button, outline the parts of the region that you want to
erase. Right-click to erase the parts.

Merge Use this button to connect regions. Holding down the left mouse but-
ton to extend the outline of an existing region or draw a connection
between the regions that you want to merge. Right-click to merge
them.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 110


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Fill Fills a hole. To fill a hole, left-click on the hole.

Remove Removes a region by clicking on it.

Remove All Removes all regions on the current z-slice.

Enables you to add a rectangular region.


Rectangle

Enables you to add a circular region.


Circle

Enables you to add a polygonal region.


Contour

Enables you to add a polygonal spline region.


Contour (Spline)

– Define Single In this mode you should only define a single region on each support
Region slice of the image. For the interpolation, the support regions on the
different slices do not necessarily have to overlap with one another.

– Define Multiple In this mode you can define multiple regions on each support slice of
Regions the image. Interpolation here is only possible, if the support regions
on each slice have some overlap with the respective regions on the
previous/next support slice.

Interpolate Interpolates regions in the slices between the drawn support regions
and displays the interpolated regions in the image.

Clear All Removes all regions (drawn support regions and interpolated ones) in
the entire stack.

Undo Undoes the last change made on the current slice.

Redo Restores the last undone change on the current slice.

See also
2 Cutting Out a Volume from a Z-Stack [} 796]

3.11.8.5.4.1.2 Support Regions Tab

Parameter Description
Show Objects Activated: Displays the regions in the Image View.
Deactivated: Hides the regions in the Image View.

Fill Activated: The region is filled with color.


Deactivated: Displays only the outlines of the regions.

Opacity Sets the opacity for the regions.

Refresh Support Updates the list below with the drawn support regions.
Slice List

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 111


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Support Slice List Displays a list with information on the Position(s) where support re-
gions have been drawn and the number of regions and holes on the
respective slice.
This list is only updated when you click on Refresh Support Slice
List.

3.11.8.5.5 Denoise

This method removes noise from images using wavelet transformations or total variation. The
process of denoising an image with wavelet transformations can be broken down into the follow-
ing three parts:

§ Calculate the wavelet transform of the noisy image.


The wavelet transformation can be calculated by the method Real Wavelets and Complex
Wavelets.
§ Modify the noisy wavelet coefficients.
This is done by using bivariate shrinkage with local variance estimation (thresholding). [Bivari-
ate Shrinkage with Local Variance Estimator, Levent Sendur and Ivan W. Selesnick, IEEE Signal
Processing Letters, Vol. 9, No. 12, December 2002]
§ Compute the inverse transform using the threshold coefficients.

Parameter Description
Method

- Complex The Dual Tree Complex Wavelet transform provides better results due
wavelets to the fact that it is nearly direction invariant and makes more direc-
tional sub bands available. The results will be less prone to block-arte-
facts. However, this method is computationally more intense and
therefore takes longer.

- Real wavelets The real wavelet transform only considers three sides (XYZ) and is
therefore faster. However, the result can show block artefacts.

- Total variation An algorithm based on A. Chambolle, "An Algorithm for Total Varia-
tion Minimization and Applications", J. Math. Imaging and Vision 20
(1-2): 89-97, 2004.
It uses the L1 norm for optimization. Typically, total variation gener-
ates small plateaus with constant gray values. The size of each of the
small plateaus depends on the Strength setting.

Strength Here you adjust the strength with which the function is applied.

See also
2 Using Direct Processing [} 230]

3.11.8.5.6 Enhance Local Contrast

With this function you can improve the contrast of your image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 112


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Clip Limit (%) Defines the value at which the histogram is clipped. It is used to avoid
oversaturation of the image in homogeneous areas. It is determined
by the normalized histogram of the local region. The higher the value
is set, the higher the contrast will be.

Region Size (%) Defines the size of every single region or tile where the local his-
togram is calculated as percentage of the image size. For example, a
region size of 50% has the size of half the image.
A small region size increases the contrast but takes more calculation
time.

Bins Defines the number of histogram bins that is used to create the con-
trast enhancing transformation. A higher number of bins covers a
greater dynamic range but increases calculation time.

Process Tiles Sepa- Only visible for tile images.


rately
Activated: Processes each tile region separately.

Info
Difference between Result and Preview
The actual result of the function and the preview you see in the preview window can be differ-
ent. This is caused by the parameter Region Size (%) and the different size of the preview
and original image. The function splits the image into small regions and processes them indi-
vidually based on the histogram of every single region. The histogram is usually related to the
absolute region size. For the preview only the visible part of the image in the view is pro-
cessed.

3.11.8.5.7 Gauss

This method allows you to reduce noise in an image. Each pixel is replaced by a weighted average
of its neighbors. The neighboring pixels are weighted in accordance with a two-dimensional
Gauss bell curve.

Parameter Description
Sigma Here you can adjust the sigma value. If the Show All mode is acti-
vated, you can adjust the values in each dimension individually.

3.11.8.5.8 Highpass

This method performs high-pass filtering. The high pass filter is defined as the difference between
the original image and the low-pass filtered original.

Parameter Description
Normalization Depending on the image processing function you have selected not
all choices are available in the list.

- Clip Gray levels that exceed or fall below the specified gray value range
are automatically set to the lowest/highest gray value (black or white).
The effect corresponds to underexposure or overexposure. This means
that in some cases information is lost.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 113


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Automatic Automatic normalization of gray values to the available gray value
range.

- Wrap If the result is greater than the maximum gray value of the image, the
value maximum gray value +1 is subtracted from it.

- Shift Normalizes the output to the value gray value + max. gray value/2.

- Absolute Values are used positive only.

Count Here you set the number of repetitions. I.e. the number of times the
function is applied sequentially to the respective result of the filtering.
The effect is increased correspondingly.

Kernel Size You can set the filter size in the x-, y- and z-direction, symmetrically
around the subject pixel. This should be the size of the transition re-
gion between objects and background match.

3.11.8.5.9 Import SmartFIB TIFFs

This function allows you to import SmartFIB stacks of Crossbeam microscopes into ZEN.

Parameter Description
Select Files Opens a file browser to select the images for import.

Z-Spacing Sets the slice distance in z. Per default, Auto is activated, and the dis-
tance is calculated automatically with information from the image
metadata of the first and last selected image.
Deactivate Auto to enter a value manually.

XY-Scaling Sets the scaling in x and y. Per default, Auto is activated, and the
scaling is automatically taken from the image metadata of the first se-
lected image.
Deactivate Auto to enter a value manually, e.g. if you import images
without scaling information in the metadata.

Sample Angle Sets the angle of the sample. Per default, Auto is activated, and the
sample angle is automatically calculated from the image metadata or
set to the default of 54 degree and the image is rendered with a 90
degree tilt (if no information is available in the metadata). In this case
the SmartFIB stack will be displayed perpendicular to the images ac-
quired on a light microscope.
Deactivate Auto to enter a value manually, e.g. if you know the origi-
nal sample angle as set in the SmartFIB software and import images
without using the information in the metadata.

Read XY Offsets Activated: Reads the xy offset of the individual slices from the meta-
data. Note that this can lead to a slanted z-stack depending on the
sample orientation during imaging and the metadata.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 114


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.5.10 Median

This method allows you to reduce noise in an image. Each pixel is replaced by the median of its
neighbors. The size of the area of the neighboring pixels considered is defined by a quadratic filter
matrix. The modified pixel is the central pixel of the filter matrix. The median is the middle value
of the gray values of the pixel and its neighbors sorted in ascending order.

Parameter Description
Kernel Size Here you can adjust the size of the filter matrix. If the Show All mode
is activated, you can adjust the values in X, Y and Z direction individu-
ally.

3.11.8.5.11 Not

This function performs a binary "not" operation on all bits of the binary representation of an input
pixel's gray value. A 0-bit in the input pixel results in an 1-bit in the corresponding output pixel, an
1-bit in the input gets a 0-bit in the output. For integral image types, the resulting output gray
value is the difference of the maximum possible gray value minus the input gray value, but for
float image type the results are strange due to the inhomogeneous float format.

3.11.8.5.12 Remove Stripes

This function allows you to remove stripe artifacts from your image. It is recommended to use the
output preview to determine the suitable values for your parameters. You can display the output
preview window by clicking on Preview in the Output tool [} 984].

Parameter Description
Method Selects the method you want to use for the removing the striping arti-
facts in your image.

– GPU VSNR Only available if you have a NVIDIA GPU in your machine.
Uses a special GPU-based VSNR algorithm.

– GPU Only available if you have a NVIDIA GPU in your machine.


Uses a GPU optimized algorithm to remove the stripe artifacts from
the image. This calculation produces the same results as the CPU ver-
sion when using the same parameter values.

– CPU Uses a CPU optimized algorithm to remove artifacts from the image.

Iterations Sets the number of iterations after which the calculation is ended.

First Filter Displays the settings of the first filter to remove vertical or horizontal
stripes in your image.

– Noise Level Sets the intensity level of the stripes in your image.

– Width The calculation for the removal of stripes in the image is based on a
Gaussian curve. This parameter sets the width of the curve.

– Height The calculation for the removal of stripes in the image is based on a
Gaussian curve. This parameter sets the elongation of the curve.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 115


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Angle Sets the angle for stripes in your image. An angle of 0 corresponds to
vertical stripes. An angle of 90 (or -90) corresponds to horizontal
stripes.

Second Filter To remove a second set of stripes (e.g. if you have both vertical and
horizontal stripes in your image), you can activate a second filter. For
information about the parameters, see the descriptions above.

– Enabled Activated: Displays the settings for a second filter to remove striping
artifacts in the image.
Deactivated: Hides the settings for a second filter and only the first
filter is applied.

3.11.8.5.13 Shading Correction

This method allows you to improve images in which the quality has been impaired by uneven illu-
mination or vignetting.
If you want to perform shading correction before an experiment (recommended), you have to use
the shading correction function in the Camera tool, in the Post-Processing section [} 882].

Parameter Description
Shading Mode Selects which shading correction should be applied.

- Channel Spe- For multichannel references, the information from each channel is ap-
cific plied individually to the input image. The number and type of chan-
nels must be the same between input image and shading reference
image. This is the correct setting when using a reference image which
was created by the Shading Reference for Processing function
(e.g. for Axioscan images).

- Averaged For multichannel references, an average over all channels is calculated


and then applied equally to each tile of each channel. This should en-
sure that a good result can still be achieved with an unequal number
of channels or different channel characteristics.

- Tile Specific In case a shading reference has more than one tile, the tiles of the ref-
erence and the tiles of the image that should be corrected are
mapped to each other. The tiles must be identical in number and XY
position. This can be the case, for example, when using an Axiozoom
where shading is primarily determined by the sample mounting situa-
tion rather than the optical system.

Automatic Activated: The function automatically calculates the reference image


for shading correction from the input image.

Shading Reference Only available in Batch mode and if Global Shading is selected, or
Camera Shading is selected and Automatic is deactivated.
Enables you to select a reference image for the shading correction.

Display Mode

- Additive In this mode the normalized reference image is subtracted from each
camera frame. This influences the brightness of the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 116


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Multiplicative In this mode each camera frame is divided by the normalized refer-
ence image. This influences the contrast of the image. This is the de-
fault setting.
The simulated/auto reference image is created by averaging up to 20
camera frames in the input image and running a lowpass filter on
them.

Offset Adjust the gray value that will be added on to the newly calculated
gray values using the slider or input field. If this results in negative val-
ues, these are set to 0. Values that exceed the maximum gray value
are set to the maximum gray value.

See also
2 General Settings [} 83]

3.11.8.5.14 Slices Replacement

With this function you can replace one or more z-slices of a stack with the respective previous or
following slice.

Parameter Description
Replace with Next Replaces the currently selected z-slice with the following one.

Replace with pre- Replaces the currently selected z-slice with the previous one.
vious

Undo Reverses the last replacement(s).

Redo Restores the last undone change(s) for the replacement.

Replacement Table Only visible if at least one replacement has been set.
Displays information about the slice replacement and which Z is re-
placed.

– Z Displays the index of the z-slice that gets replaced.

– Source Displays the index of the z-slice which replaces Z.

– Replacement Displays the type of replacement (Next or Previous).


Type

See also
2 Replacing Z-Slices in a Z-Stack [} 796]

3.11.8.5.15 Sort SmartFIB Tiffs

This function allows you to select a folder with FIB-SEM tiffs and sort these files in separate sub-
folders according to channel name, number of pixels, image size, and spacing of the images, cor-
responding to slice thickness. The files are sorted into subfolders of the output folder according to
their metadata. This means that each time one of the above mentioned metadata changes from
one image to the subsequent image, a new sub folder is created. Thus, subfolders with homoge-
neous metadata with respect to xyz-scaling and image size are created.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 117


3 Basic Concepts | 3.11 Image Processing ZEISS

Note that this function only works if the tiff files have their default names assigned by the micro-
scope (e.g. channel0_slice_0001.tiff or slice_0001.tiff)! All tiff files with other names are ignored
by the function.

Parameter Description
Input Folder Selects the folder where the tiff files which should be sorted are
saved. Click on to open a file browser and navigate to the respec-
tive folder. Note that this function does not include images from sub-
folders, all images that you want to be sorted have to be in this input
folder!

Output Folder Selects the folder where the subfolders with the sorted tiff files are
placed. Click on to open a file browser and navigate to the re-
spective folder. The function automatically creates subfolders in this
folder.

File Operation

– Copy Copies the images into the output folder. Your data is duplicated and
remains unchanged in the input folder.

– Move Moves the images from your input folder into the output directory.

– Hard Link Creates links in the output folder to each image file in the input
folder, i.e. the space occupied by the images on the hard disk remains
unchanged.

3.11.8.5.16 Z-Stack Alignment with ROI

This function allows you to automatically align the individual planes of a z-stack image if they are
not positioned precisely above each other.

Parameter Description
Quality Selects the quality level that you want the function to work with. The
calculation of the alignment is based on a so-called image pyramid.
The higher the selected quality, the more levels of the image pyramid
are used to calculate the alignment and the more precise the align-
ment will be. However, the higher the selected quality is, the slower
the calculation of the alignment will get.

– Low This is the most imprecise but also the fastest calculation of the align-
ment. It uses a low number of levels (2) of the image pyramid for the
alignment calculation.

– Medium This is a more precise but also a slower calculation of the alignment
than the one before. It uses a medium number of levels (3) of the im-
age pyramid for the alignment calculation.

– High This is a more precise but also a slower calculation of the alignment
than the two before. It uses a high number of levels (4) of the image
pyramid for the alignment calculation.

– Highest This is the most precise but also the slowest calculation of the align-
ment. It uses the highest number of levels of the image pyramid for
the alignment calculation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 118


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Registration Selects the method which is used to align the images.
Method

– Translation The neighboring sections of the z-stack are shifted in relation to each
other in the X and Y direction.

– Rotation The neighboring sections of the z-stack are rotated in relation to each
other.

– Translation + The neighboring sections of the z-stack are translated and rotated in
Rotation relation to each other.

Interpolation Selects how the interpolation is performed if a pixel is calculated from


several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Region Selects which parts of the image should be considered for the calcula-
tion of the transformation matrix.

- Full Considers the entire image for alignment.

- Rectangle Re- Allows you to draw a region of interest into the image. Only the im-
gion age information of this region is then considered for the calculation of
the transformation matrix for alignment. The resulting transformation
matrix will be applied to the full image.
After you have drawn a rectangle region into the image, you can see
and change its coordinates with the X/Y/W/H input fields.

Crop Output Not visible if the Third Dimension (if available) is set to a particular
dimension instead of 2D Slices.
Activated: The image is cropped and only keeps the section which is
covered by the entire dimension, i.e. by all z-slices. The output image
can be of different size than the input image.
Deactivated: The output image is not cropped and keeps the size of
the input image. The image borders might get filled with a default
pixel value.

Single Component Activated: Displays the image channels. Selects one of the image
channels which will be used to calculate the alignment transformation
matrix, which then is also applied to the other channel(s).
Deactivated: Calculates an alignment transformation matrix for each
individual channel.

See also
2 Aligning Z-Planes Automatically (Based on a ROI) [} 795]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 119


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.5.17 Z-Stack Equalization

This function equalizes the gray values throughout an entire image stack. It scales the intensities
of all slices to a common mean intensity value and standard deviation. The goal is a harmoniza-
tion of the gray value distribution within a z-stack. With this process, brighter image slices will get
darker and darker slices will get brighter.

3.11.8.6 Export/Import

3.11.8.6.1 Convert TXM Files to CZI

This function converts txm images to czi.

Parameter Description
Selects the folder with txm images that should be converted to czi.
After the conversion, the images will again be stored in this folder.
Directory

Recursive Converts also files in subfolders of the selected folder.

Overwrite Overwrites already converted files.

Preview Only Displays a preview of the images in the folder, but does not convert
them.

3.11.8.6.2 Image Export

This method allows you to export single images into various file types so that you can continue to
use them in other programs. Multidimensional images (e.g. multichannel, z-stack, tile images) are
exported as individual images.

3.11.8.6.2.1 File Type Section

Name Function
File Type Select the desired file type from the dropdown list:
§ JPEG File Interchange Format (JPEG)
§ Windows Bitmap (BMP)
§ Tagged Image File Format (TIFF)
§ Tiff Format (64 bit) (Big TIFF)
§ Portable Network Graphics (PNG)
§ JPEG XR (WDP)
§ DigitalSurf SUR (SUR)

Note that different options are available depending on the file type
you have selected.

Quality Only available for the file types JPEG and JPEG XR.
Enter the image quality using the slider or input field to influence the
size of the file. Although low values result in very small files, image
quality may be considerably reduced.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 120


3 Basic Concepts | 3.11 Image Processing ZEISS

Name Function
Resize Adjust the image size in percent using the slider or input field. The re-
sizing uses an algorithm for point-sampling from the nearest pyramid
tile (the nearest pyramid tile which has higher resolution, so there is
only sub-sampling and no up-sampling). Online pyramid is sub-sam-
pling by a factor of 2, using a 5x5 Gaussian kernel, and offline pyra-
mid is sub-sampling by a factor of 3, using a binomial kernel.

Convert to 8 Bit Only available for the file types TIFF, BigTIFF, PNG and JPEG XR.
Activated: Converts a 16 bit gray level image into an 8 bit gray level
image, or a 48 bit color image into a 24 bit color image.

Compression Only available for the file type TIFF and BigTIFF.
Selects the compression method for reducing the data size.

- None Retains the data size of the original image. No compression is per-
formed.

- LZW Only available for the file type TIFF.


Performs lossless compression in accordance with the Lempel-Ziv-
Welch algorithm (LZW).

- ZIP Only available for the file type TIFF.


Performs lossless compression in accordance with the ZIP method.

- Lossless Only available for the file type BigTIFF.


Performs lossless compression in accordance with the Lempel-Ziv-
Welch algorithm (LZW).

- Lossy Only available for the file type BigTIFF.


Performs lossy compression in accordance with the JPEG XR (ex-
tended range) method.

BigTIFF Only available for the file type BigTIFF.


Activated: Generates a BigTIFF image. The maximum image size is
larger than 4GByte.
Deactivated: Generates a TIFF image with maximum size of 4GByte.

TIFF Tiles Only available for the file type BigTIFF.


Activated: Generates new rectangle tiles for internal data handling.
Deactivated: Combines tiles as stripes for internal data handling.

Pyramid Only available for the file type BigTIFF.


Activated: Calculates an image pyramid.

Merge All Scenes Only available for the file type BigTIFF.
Activated: Generates one image including all scenes.
Deactivated: Generates single scene images.

3.11.8.6.2.2 Image Data Section

Parameter Description
Original Data Activated: Exports the image with the original channel colors and the
original display characteristic curve.

– Shift Pixel Activated: The pixel are shifted to 16 bit before converting to 8 bit.
For example, a 14 bit image is first transformed to a 16 bit image,
which is then converted to an 8 bit image. The 14 bit range is

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 121


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
mapped to the whole 8 bit range.
Deactivated: No shift takes place. A 14 bit image is treated as a 16
bit image and therefore the transformation to 8 bit covers only a re-
duced range.

Apply Display Activated: Exports the image with the changed channel color and
Curve and Channel display characteristic curve settings. These settings are applied to the
Color pixel values of the exported images. They are particularly important if
you want to use dark images with a dynamic range of more than 8
bits in other programs.

– Burn-in Anno- Activated: Burns the graphical elements into the image. The pixels
tations under the graphical element (e.g. scale bars) are overwritten. The
burnt-in graphical elements cannot be modified.

– Burn-in Analy- Only available if Burn-in Annotations is activated.


sis Results Activated: If the image contains analysis results, the masks of the re-
sults are burned into the image.

– Zoom Only available if Burn-in Annotations is activated.


Sets the zoom of graphic elements for export. Note that this is only
applied to regions for which Zoom with Image is deactivated in the
Format Graphical Elements dialog, see Format Graphical Elements
Dialog [} 1040].
The default is 100%, which means that the graphical elements are
rendered as they would if the viewer zoom was 100%. When the
zoom increases, the graphical elements are rendered larger (e.g. with
zoom 200, graphical elements are rendered twice as large, but it cor-
responds to the size they would have if the viewer zoom was 50%).

– Only available if Burn-in Annotations is activated.


Gets the current zoom factor of the graphical elements in the 2D
Get Zoom
view.
from Viewer

– Merged Chan- Only visible for multichannel images.


nels Image Activated: Exports the pseudo color image of all selected channels.

– Individual Only visible for multichannel images.


Channels Im- Activated: Exports the individual colored image of all selected chan-
age nels.

Short Format Selects which type of naming convention is used for the exported im-
age, see Naming Convention for Image Export [} 69].
Activated: Uses the short format naming convention. This is the de-
fault setting.
Deactivated: Uses the long format naming convention.

– Use Channel Only visible for multichannel images.


Names Activated: Integrates the channel name in the name of the exported
image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 122


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.6.2.3 Dimensions Section

Parameter Description
Use Full Set of Di- Select this option if you want to export all dimensions without chang-
mensions ing them.

Define Subset Select this option if you only want to export individual dimensions or
subsets of individual dimensions.

Info
Each of the sections described below is only visible if the corresponding dimension is present in
the input image.

Parameter Description
Channels Here you can select which channels of the input image you want to
be used. All channels are selected by default. To deselect a channel,
click on the relevant channel button.

Z-Position, Time, Here you can select which parts of the input image you want to use
Block, Scene for the resulting image.

- Extract All If selected, all parts of the corresponding image are extracted.

- Extract Single If selected, you can select a single image to be extracted.

- Extract Range If selected, you can select a certain range of images to be extracted.

- Extract Multi- If selected, you can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section 10, followed by sections 14 to 18, as well as
sections 20 and 23.

- Get current Adopts the position from the current display in the image area.
position

- Interval Activated: Interval mode is active. The Interval spin box/input field
appears.
Enter the desired interval here. E.g. if you enter the value 2 only every
2nd value from the range is considered.

Region Here you can select if you want to use the entire image or just a re-
gion (ROI) of the input image. Note that in combination with image
dimensions, the rectangle is only drawn into one and only this is con-
sidered for export. For example, in an image with multiple scenes, the
image export only considers the ROI that is always drawn into the cur-
rently displayed scene defined by the Dimensions view options tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 123


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Full If selected this option, the full image is used for the new image.

- Rectangle Re- If selected this option, you can draw in a rectangle region of interest
gion (ROI) which is used for creating a new image.
If a rectangle region is drawn in, you can see and change its coordi-
nates by editing the input fields for X, Y, W, and/or H.

Tiles Not available for the OME TIFF Export.

- Export Se- Exports the tiles according to the selected original image.
lected Tiles

- Crop to Selec- Creates new tiles according to your entries in the fields Columns/
tion and Gen- Rows and Overlap.
erate New
Tiles

- Columns/Rows Only available if Crop to Selection and Generate New Tiles is acti-
vated.
Defines, with how many rows and columns the re-tiling is performed.

- Overlap Only available if Crop to Selection and Generate New Tiles is acti-
vated.
Defines the overlap of the re-tiled tiles in %.

3.11.8.6.2.4 Export To Section

Parameter Description
Export To Sets path to the folder where images are exported to.

Create Folder Creates a folder for your exported data.

Generate xml File Creates xml files, containing general information and metadata infor-
mation for the exported image(s).

– Long Format Activated: Selects the long format naming for the xml files, which in-
cludes the file type suffix in the xml titles as well as metadata for the
metadata xml, see Naming of xml Files for Exported Images [} 70].

– Short Format Activated: Selects the short format naming for the xml files, which
excludes the file type suffix from the xml titles as well as shortens
metadata to meta for the metadata xml, see Naming of xml Files for
Exported Images [} 70].

Generate zip File Exports the image as a .zip file.

Prefix Adds the specified name as a prefix to the exported data. By default,
this is the name of the original image data. For information on nam-
ing conventions, see Naming Convention for Image Export [} 69].

Defaults Sets the settings back to default.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 124


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.6.3 Image Import

Using the Image Import function you can create a multidimensional image (multichannel, Z-
stack, time lapse, tile, position image) from individual images. The individual images may be in any
of the external formats supported by ZEN (see below). The resulting image can then be saved in
CZI format and processed further using the functions available in ZEN.
Supported file types

§ JPG images
§ BMP
§ TIFF
§ PNG
§ GIF
§ DeltaVision images
§ MetaFluor images
§ Multi page images

Parameters

Parameter Description
Multichannel Activated: Activates the settings to import multichannel images.
Adjust the settings for the multichannel image to be imported in the
list below.

- Use Channel Activated: Uses the name specified in the Name column to identify
Name as Iden- the channel. The channel name will appear in the Preview display
tifier field in the Specify the Identifiers section.
Deactivated: Activates the Identifier, Start Index and Interval col-
umns in the Specify the Identifiers section.

Z-Stack Activated: Activates the settings to import Z-Stack images.


Adjust the settings for the Z-stack image to be imported in the list be-
low.

- Interval Here you enter the value in µm for the distance between the individ-
ual slices. The total height of the Z-stack is calculated automatically
from this value and the number of slices.

- Slices Here you enter the number of slices of the Z-Stack image.

- Range Here you enter the total height (range) of the Z-stack in µm.
The distance between the individual Z-stacks is calculated automati-
cally from this value and the number of slices and displayed in the In-
terval display field.

- Extended Mi- Activates additional parameters that are necessary for further process-
croscope Pa- ing of the imported image (e.g. for deconvolution), like:
rameters
§ Magnification:
Select the objective magnification that was used for acquisition
here.
§ Aperture:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 125


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Here you can enter the value of the numerical aperture of the ob-
jective that was used for acquisition.
§ Immersion:
Select the immersion medium that was used for acquisition here.

Time Series Activated: Activates the settings to import time series images.

- Interval Here you enter the value for the interval between the individual time
points. Select the unit of time from the dropdown list to the right of
the input field.

- Cycles Here you enter the cycles of the time series. The entered value will af-
fect the duration/the interval depending on which value you have se-
lected.

- Duration Here you can enter the value for the duration of the entire time series.
Select the unit of time from the dropdown list to the right of the input
field. Enter the number of time points in the Time Points input field.

Tiles Activated: Activates the settings to import tile images.

- Columns Here you can enter the number of columns of the tile image.

- Overlap Here you can enter the percentage by which the tiles do overlap.

- Rows Here you can enter the number of rows of the tile image.

- Meander Select this option, if the images to be imported were acquired in the
Meander acquisition/travel mode.

- Comb Select this option if the images to be imported were acquired in the
Comb acquisition/travel mode.

Positions Activated: Activates the settings to import images of individual posi-


tions.

Scalings To show the section in full, click on the arrow button .

- Use Current Uses the geometric scaling currently selected and displays the values
Scaling for Scale (X) and Scale (Y) with the corresponding unit in the rele-
vant display field.

- Define scaling Enter the desired values in the Scale (X) input field and in the Scale
(Y) spin box/input field. Select the unit for the scaling value from the
dropdown list to the right of each input field.

Automatic If selected, all images that are available in an import folder are im-
ported automatically.

- Import From Here you can select the import folder.

To select a folder, click on the folder button to the right of the


display field. The names of the images are displayed in the File Name
list below the display field.

Sequential If selected, an image sequence in a certain order (e.g. image dimen-


sions that are encoded by means of numbers in the image name) can
be imported.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 126


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Import From Here you can import images according to a File List or a Multi page
image.

Click on the folder button to the right of the display field. The
names of the images are displayed in the File Name list below the
display field.

Specify the Identi- Here you can enter and check all the settings you need to identify
fiers your images.

3.11.8.6.4 Import TXM

This function imports a txm file to ZEN.

Parameter Description
Input Selects a txm file for import.

3.11.8.6.5 Movie Export

Using this function you can export multidimensional images (e.g. Time Series or Z-Stack images)
into various file types in the form of film sequences so that you can continue to use them in other
programs.

Info
If you want to export MOV files (H264 or MPEG4 codec) successfully, download the latest re-
lease version of application FFmpeg, Windows 64-bit, Static (e.g. on https://www.ffm-
peg.org/download.html). Copy ffmpeg.exe into the same folder where ZEN.exe is located
(for example C:\Program Files\Carl Zeiss\ZEN 2\ZEN 2 (blue edition)).

See also
2 Exporting Movies [} 67]

3.11.8.6.5.1 File Type Section

Info
AVI (MS-Video1) mode is available for 32-bit Windows operating systems only.

Parameter Description
Format Select the desired mode here. The following formats are available for
the movie export.
§ AVI (M-JPEG compression)
§ AVI (uncompressed)
§ AVI (DV)
§ WMF (WindowsMedia)
§ MOV (H.264)
§ MOV (MPEG4)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 127


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
§ AVI (MS-Video1)

Size/Rate Select the desired format here.

- Original Size Not available for the file types AVI (DV) and AVI (MS-Video1).
Uses the height and width of the input image and sets the frame rate
to 5 frames per second.

- User-Defined Not available for the file types AVI (DV) and AVI (MS-Video1).
Enter the values in the Width, Height, and Frame Rate input fields.

- 720x576/25fps Uses the PAL (Phase Alternating Line) video resolution with 25 frames
(PAL 576p/25) per second.

- 720x480/29.97f Uses the NTSC (National Television Systems Committee) video resolu-
ps (NTSC) tion with 29.97 frames per second.

- 1280x720/50fp Not available for the file types AVI (DV) and AVI (MS-Video1).
s (HD 720p/50)
Uses the HD (High Definition 720) video resolution with 25 frames per
second.

- 1920x1080/25f Not available for the file types AVI (DV) and AVI (MS-Video1).
ps (HD 1080p/
Uses the HD (High Definition 1080) video resolution with 25 frames
25)
per second.

- 1920x1080/29. Not available for the file types AVI (DV) and AVI (MS-Video1).
97fps (HD
Uses the HD (High Definition 1080) video resolution with 29.97
1080p/29.97)
frames per second.

Width Only active if you have selected User-Defined in the Format drop-
down list.
Here you can enter the width of the image in pixels (px).

Height Only active if you have selected User-Defined in the Format drop-
down list.
Here you can enter the height of the image in pixels (px).

Frame Rate Only active if you have selected User Defined in the Format drop-
down list.
Here you can enter the frame rate in frames per second (fps).

Quality Only visible if you have selected AVI (M-JPEG compression) or MOV
in the Mode dropdown list.
Here you can set the image quality using the slider or spin box/input
field. This influences the size of the file. Although low values result in
very small files, image quality may be considerably reduced.

3.11.8.6.5.2 Image Data Section

The following functions are only visible if the Show All mode is activated:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 128


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Apply Display Set-
tings and Channel
Color

– Burn-in Anno- Activated: Burns the graphic elements into the image. The pixels un-
tations der the graphic element (e.g. scale bars) are overwritten. The burnt-in
graphic elements cannot be subsequently modified.

– Zoom Only available if Burn-in Annotations is activated.


Sets the zoom of graphic elements for export.
The default is 100%, which means that the graphical elements are
rendered as they would if the viewer zoom was 100%. When the
zoom increases, the graphical elements are rendered larger (e.g. with
zoom 200, graphical elements are rendered twice as large, but it cor-
responds to the size they would have if the viewer zoom was 50%).

– Get Zoom Only available if Burn-in Annotations is activated.


from Viewer
Gets the current zoom factor of the graphical elements in the 2D
view.

– Burn-in Analy- Only available if Burn-in Annotations is activated.


sis Results Activated: If the image contains analysis results, the masks of the re-
sults are burned into the image.

– Merged Chan- Only visible for multi-channel images.


nels Image
Activated: Exports the pseudo color image of all selected channels.

– Individual Only visible for multi-channel images.


Channels Im-
Activated: Exports the individual colored image of all selected chan-
age
nels.

Use channel names Only visible for multi-channel images.


Activated: Integrates the channel name in the name of the exported
image.

Use Full Set of Di- Activated: Includes all dimensions of the original file.
mensions

Define Subset Activated: Creates a subset of the data, depends on the dimensions
available in the image, e.g. Channels, Region, Tiles.

Info
At least one of the three checkboxes must be activated. If the Merged Channels Image and
Individual Channel Image checkboxes are activated, you can export the individual colored
images and the pseudo color images in a single step.

3.11.8.6.5.3 Fitting Section

The following functions are only visible if the Show All mode is activated:

Parameter Description
Fitting Select the desired type of fitting here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 129


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Fit All (Uni- Fits the image to the selected resolution. The original aspect ratio is
form) retained.

- Fit and Crop Fits the image to the selected resolution and clips it. The original as-
(Uniform to pect ratio is not retained.
Fill)

- Fit and Stretch Stretches the image to the selected resolution. The original aspect ra-
(Fill) tio is not retained.

- Crop (None) Crops the image to the selected resolution. The original aspect ratio is
retained.

3.11.8.6.5.4 Sequence Section

The following functions are only visible if the Show All mode is activated:
Change the sequence of the dimensions in which you want the movie to be created.

button
Shifts the selected dimension up a line.

button
Shifts the selected dimension down a line.

3.11.8.6.5.5 Mapping Section

Parameter Description
Mapping Select how you want the images to be assigned.

- Fixed Duration Enter the time per image in seconds using the spin box/input field.
The total length is displayed in the Final Movie Length display field.

- 1 Frame per Assigns one frame per image.


Image

Image count Indicates the number of images in the input image.

Final Movie Length Indicates the total length of the resulting movie, depending on the se-
lected image sequence and the time.

3.11.8.6.5.6 Dimensions Section

Parameter Description
Use Full Set of Di- Select this option if you want to export all dimensions without chang-
mensions ing them.

Define Subset Select this option if you only want to export individual dimensions or
subsets of individual dimensions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 130


3 Basic Concepts | 3.11 Image Processing ZEISS

Info
Each of the sections described below is only visible if the corresponding dimension is present in
the input image.

Parameter Description
Channels Here you can select which channels of the input image you want to
be used. All channels are selected by default. To deselect a channel,
click on the relevant channel button.

Z-Position, Time, Here you can select which parts of the input image you want to use
Block, Scene for the resulting image.

- Extract All If selected, all parts of the corresponding image are extracted.

- Extract Single If selected, you can select a single image to be extracted.

- Extract Range If selected, you can select a certain range of images to be extracted.

- Extract Multi- If selected, you can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section 10, followed by sections 14 to 18, as well as
sections 20 and 23.

- Get current Adopts the position from the current display in the image area.
position

- Interval Activated: Interval mode is active. The Interval spin box/input field
appears.
Enter the desired interval here. E.g. if you enter the value 2 only every
2nd value from the range is considered.

Region Here you can select if you want to use the entire image or just a re-
gion (ROI) of the input image. Note that in combination with image
dimensions, the rectangle is only drawn into one and only this is con-
sidered for export. For example, in an image with multiple scenes, the
image export only considers the ROI that is always drawn into the cur-
rently displayed scene defined by the Dimensions view options tab.

- Full If selected this option, the full image is used for the new image.

- Rectangle Re- If selected this option, you can draw in a rectangle region of interest
gion (ROI) which is used for creating a new image.
If a rectangle region is drawn in, you can see and change its coordi-
nates by editing the input fields for X, Y, W, and/or H.

Tiles Not available for the OME TIFF Export.

- Export Se- Exports the tiles according to the selected original image.
lected Tiles

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 131


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Crop to Selec- Creates new tiles according to your entries in the fields Columns/
tion and Gen- Rows and Overlap.
erate New
Tiles

- Columns/Rows Only available if Crop to Selection and Generate New Tiles is acti-
vated.
Defines, with how many rows and columns the re-tiling is performed.

- Overlap Only available if Crop to Selection and Generate New Tiles is acti-
vated.
Defines the overlap of the re-tiled tiles in %.

3.11.8.6.5.7 Export to Section

Parameter Description
Export to The path of the export folder is displayed automatically in the display
field.
To change the file path, click on the button to the right of the
display field.

Parameter Description
Prefix Here you can edit the prefix specified or enter a new name. The name
of the original image is specified by default.

3.11.8.6.6 OME TIFF Export

Using the OME TIFF Export function you can export your images into OME (Open Microscopy
Environment) TIFF format so that you can continue to use them in other programs. The images
are then available as a multipage TIFF file.

3.11.8.6.6.1 Image Format Section

Parameter Description
Resize Adjust the image size in percent using the slider or spin box/input
field.

The following parameters are only visible, if Show All is activated.

BigTIFF Activated: Creates a BigTIFF image that can be bigger than 4 giga-
bytes and uses 64-bit offset format.

Compress Activated: Performs internal tif compression.

Use Tiles Activated: Performs an internal tiling.


Note that this option is recommend for large images as some tif read-
ers do not support large images.

Shift Pixel Activated: Shifts the grey value of a 10-bit or 12-bit image to 16-bit.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 132


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Merge All Scenes Activated: Generates one image including all scenes. Single scene im-
ages will be generated, if the checkbox is deactivated.

3.11.8.6.6.2 Image Data Section

The following functions are only visible if the Show All mode is activated:

Parameter Description
Original Data Activated: Exports the image with the original channel colors and the
original display characteristic curve.

– Convert to 8 Activated: The pixels are shifted to 16 bit before converting to 8 bit.
Bit For example, a 14 bit image is first transformed to a 16 bit image
which is then converted to an 8 bit image. The 14 bit range is
mapped to the whole 8 bit range.
Deactivated: No shift takes place. A 14 bit image is treated as a 16
bit image and therefore the transformation to 8 bit covers only a re-
duced range.

Apply Display Activated: Exports the image with the changed channel color and
Curve and Channel display characteristic curve settings. These settings are applied to the
Color pixel values of the exported images. They are particularly important if
you want to use dark images with a dynamic range of more than 8
bits in other programs.

– Burn-in Anno- Activated: Burns the graphical elements into the image. The pixels
tations under the graphical element (e.g. scale bars) are overwritten. The
burnt-in graphical elements cannot be modified.

– Zoom Only available if Burn-in Annotations is activated.


Sets the zoom of graphic elements for export. Note that this is only
applied to regions for which Zoom with Image is deactivated in the
Format Graphical Elements dialog.
The default is 100%, which means that the graphical elements are
rendered as they would if the viewer zoom was 100%. When the
zoom increases, the graphical elements are rendered larger (e.g. with
zoom 200, graphical elements are rendered twice as large, but it cor-
responds to the size they would have if the viewer zoom was 50%).

– Only available if Burn-in Annotations is activated.


Gets the current zoom factor of the graphical elements in the 2D
Get Zoom
view.
from Viewer

– Burn-in Analy- Only available if Burn-in Annotations is activated.


sis Results Activated: If the image contains analysis results, the masks of the re-
sults are burned into the image.

OME-XML Schema Selects the OME-XML schema.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 133


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.6.6.3 Dimensions Section

Parameter Description
Use Full Set of Di- Select this option if you want to export all dimensions without chang-
mensions ing them.

Define Subset Select this option if you only want to export individual dimensions or
subsets of individual dimensions.

Info
Each of the sections described below is only visible if the corresponding dimension is present in
the input image.

Parameter Description
Channels Here you can select which channels of the input image you want to
be used. All channels are selected by default. To deselect a channel,
click on the relevant channel button.

Z-Position, Time, Here you can select which parts of the input image you want to use
Block, Scene for the resulting image.

- Extract All If selected, all parts of the corresponding image are extracted.

- Extract Single If selected, you can select a single image to be extracted.

- Extract Range If selected, you can select a certain range of images to be extracted.

- Extract Multi- If selected, you can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section 10, followed by sections 14 to 18, as well as
sections 20 and 23.

- Get current Adopts the position from the current display in the image area.
position

- Interval Activated: Interval mode is active. The Interval spin box/input field
appears.
Enter the desired interval here. E.g. if you enter the value 2 only every
2nd value from the range is considered.

Region Here you can select if you want to use the entire image or just a re-
gion (ROI) of the input image. Note that in combination with image
dimensions, the rectangle is only drawn into one and only this is con-
sidered for export. For example, in an image with multiple scenes, the
image export only considers the ROI that is always drawn into the cur-
rently displayed scene defined by the Dimensions view options tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 134


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Full If selected this option, the full image is used for the new image.

- Rectangle Re- If selected this option, you can draw in a rectangle region of interest
gion (ROI) which is used for creating a new image.
If a rectangle region is drawn in, you can see and change its coordi-
nates by editing the input fields for X, Y, W, and/or H.

Tiles Not available for the OME TIFF Export.

- Export Se- Exports the tiles according to the selected original image.
lected Tiles

- Crop to Selec- Creates new tiles according to your entries in the fields Columns/
tion and Gen- Rows and Overlap.
erate New
Tiles

- Columns/Rows Only available if Crop to Selection and Generate New Tiles is acti-
vated.
Defines, with how many rows and columns the re-tiling is performed.

- Overlap Only available if Crop to Selection and Generate New Tiles is acti-
vated.
Defines the overlap of the re-tiled tiles in %.

3.11.8.6.6.4 Export to Section

Parameter Description
Export to The path of the export folder is displayed automatically in the display
field.
To change the file path, click on the button to the right of the
display field.

Parameter Description
Prefix Here you can edit the prefix specified or enter a new name. The name
of the original image is specified by default.

3.11.8.6.7 ZVI Export

Using the ZVI Export function, you can export your images into ZVI format so that you can con-
tinue to use them in AxioVision.

3.11.8.6.7.1 Export to Section

Parameter Description
Export to The path of the export folder is displayed automatically in the display
field.
To change the file path, click on the button to the right of the
display field.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 135


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Prefix Here you can edit the prefix specified or enter a new name. The name
of the original image is specified by default.

3.11.8.7 Geometric

3.11.8.7.1 Change Orientation

With this function you can easily change the image orientation.

Parameters

Parameter Description
Orientation

- Flip Horizon- Flips the image horizontally.


tally

- Flip Vertically Flips the image vertically.

- Rotate 90 CW Rotates the image by 45 degrees clockwise (CW).

- Rotate 90 Rotates the image by 45 degrees counterclockwise (CCW).


CCW

- Rotate 180 Rotates the image by 180 degrees.

- Mirror at +45 Mirrors the image at +45 degrees diagonal.


Diagonal

- Mirror at -45 Mirrors the image at -45 degrees diagonal.


Diagonal

3.11.8.7.2 Channel Alignment

Info
No Alignment of Mixed Mode Images
The alignment does not work for mixed mode images, i.e. you cannot align a widefield chan-
nel to an LSM channel.

This method allows you to automatically align the individual channels of a multi-channel image
correctly to one another.

Parameter Description
Registration Only visible if Load Transformation is deactivated.
Method Selects the method or a combination of methods which is used to
align the images.

- Translation The neighboring sections of the image are shifted in relation to each
other in the X and Y direction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 136


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Rotation The neighboring sections of the image are rotated in relation to each
other.

- Iso Scaling The magnification is adjusted from section to section.

- Skew Scaling The neighboring sections of the image are corrected for skewness/
shearing.

- Affine The neighboring sections of the image are shifted in X and Y direc-
tion, rotated and the magnification is adjusted from section to sec-
tion.

Quality Only visible if Show All is activated and if Load Transformation is


deactivated.
Selects the quality level that you want the function to work with. The
calculation of the alignment is based on a so-called image pyramid.
The higher the selected quality, the more levels of the image pyramid
are used to calculate the alignment and the more precise the align-
ment will be. However, the higher the selected quality is, the slower
the calculation of the alignment will get.

– Low This is the most imprecise but also the fastest calculation of the align-
ment. It uses a low number of levels (2) of the image pyramid for the
alignment calculation.

– Medium This is a more precise but also a slower calculation of the alignment
than the one before. It uses a medium number of levels (3) of the im-
age pyramid for the alignment calculation.

– High This is a more precise but also a slower calculation of the alignment
than the two before. It uses a high number of levels (4) of the image
pyramid for the alignment calculation.

– Highest This is the most precise but also the slowest calculation of the align-
ment. It uses the highest number of levels of the image pyramid for
the alignment calculation.

Interpolation Only visible if Show All is activated.


Selects how the interpolation should be performed if a pixel is calcu-
lated from several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Crop Output Only visible if your image does not contain multiple tiles or scenes.
Activated: The image is cropped and only keeps the section which is
covered by the entire dimension (e.g. by all z-slices or time points).
The output image can be of different size than the input image.
Deactivated: The output image is not cropped and keeps the size of
the input image. The image borders might get filled with a default
pixel value.

Reference Channel Selects the channel that serves as reference for the alignment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 137


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Target Channel Selects the channel that is targeted for alignment.

Single Component Only visible if you have selected an input image which contains di-
mensional components (e.g. scenes, z-planes, time points) and if this
component is not selected as Third Dimension.
Activated: Displays a control to select the dimensional component
that is used to calculate the alignment transformation matrix.
Deactivated: Calculates an alignment transformation matrix for each
individual component (e.g. for each individual scene).

– Scene Compo- Only visible for images with multiple scenes.


nent Selects the scene that is used to calculate the alignment transforma-
tion matrix.

– Phase Compo- Only visible for images with multiple phases.


nent Selects the phase that is used to calculate the alignment transforma-
tion matrix.

– Z Slice Com- Only visible for z-stack images.


ponent Selects the z-slice that is used to calculate the alignment transforma-
tion matrix.

– Time Compo- Only visible for time series images.


nent Selects the time point that is used to calculate the alignment transfor-
mation matrix.

Single Tile Only visible for images with multiple tiles and if Single Component is
activated.
Activated: Displays the Tile Component control.

– Tile Compo- Selects the tile component that is used to calculate the alignment
nent transformation matrix.

See also
2 General Settings [} 83]

3.11.8.7.3 Channel Alignment (Extended)

Info
No Alignment of Mixed Mode Images
The alignment does not work for mixed mode images, i.e. you cannot align a widefield chan-
nel to an LSM channel.

This method allows you to automatically align the individual channels of a multi-channel image
correctly to one another.

Parameter Description
Load Transforma- Activated: Allows you to load the result of a previous transformation.
tion

– Transforma- Allows you to select the respective *.xml file with the previously used
tion file transformation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 138


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Save Transforma- Only visible if Load Transformation is deactivated.
tion Activated: Saves the result of the transformation process in an *.xml
file for later use.

Preprocessing Selects which method should be used for preprocessing.

– No Prepro- Uses no preprocessing.


cessing

– Sobel Uses the Sobel method for preprocessing, see Sobel [} 473].

– Laplace Uses the Laplace method for preprocessing, see Laplace [} 472].

– Roberts Uses the Roberts method for preprocessing, see Roberts [} 473].

– Enhance Con- Uses the Enhance Contour method for preprocessing, see Enhance
tour Contour [} 174].

– Maximum Uses the Maximum Gradient method for preprocessing, see Gradient
Gradient Max [} 472].

– Delineation Uses the Delineation method for preprocessing, see Delineate


[} 174].

Registration Only visible if Load Transformation is deactivated.


Method Selects the method or a combination of methods which is used to
align the images.

- Translation The neighboring sections of the image are shifted in relation to each
other in the X and Y direction.

- Rotation The neighboring sections of the image are rotated in relation to each
other.

- Iso Scaling The magnification is adjusted from section to section.

- Skew Scaling The neighboring sections of the image are corrected for skewness/
shearing.

- Affine The neighboring sections of the image are shifted in X and Y direc-
tion, rotated and the magnification is adjusted from section to sec-
tion.

Quality Only visible if Show All is activated and if Load Transformation is


deactivated.
Selects the quality level that you want the function to work with. The
calculation of the alignment is based on a so-called image pyramid.
The higher the selected quality, the more levels of the image pyramid
are used to calculate the alignment and the more precise the align-
ment will be. However, the higher the selected quality is, the slower
the calculation of the alignment will get.

– Low This is the most imprecise but also the fastest calculation of the align-
ment. It uses a low number of levels (2) of the image pyramid for the
alignment calculation.

– Medium This is a more precise but also a slower calculation of the alignment
than the one before. It uses a medium number of levels (3) of the im-
age pyramid for the alignment calculation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 139


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– High This is a more precise but also a slower calculation of the alignment
than the two before. It uses a high number of levels (4) of the image
pyramid for the alignment calculation.

– Highest This is the most precise but also the slowest calculation of the align-
ment. It uses the highest number of levels of the image pyramid for
the alignment calculation.

Interpolation Only visible if Show All is activated.


Selects how the interpolation should be performed if a pixel is calcu-
lated from several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Single Component Only visible if you have selected an input image which contains di-
mensional components (e.g. scenes, z-planes, time points) and if this
component is not selected as Third Dimension.
Activated: Displays a control to select the dimensional component
that is used to calculate the alignment transformation matrix.
Deactivated: Calculates an alignment transformation matrix for each
individual component (e.g. for each individual scene).

– Scene Compo- Only visible for images with multiple scenes.


nent Selects the scene that is used to calculate the alignment transforma-
tion matrix.

– Phase Compo- Only visible for images with multiple phases.


nent Selects the phase that is used to calculate the alignment transforma-
tion matrix.

– Z Slice Com- Only visible for z-stack images.


ponent Selects the z-slice that is used to calculate the alignment transforma-
tion matrix.

– Time Compo- Only visible for time series images.


nent Selects the time point that is used to calculate the alignment transfor-
mation matrix.

Single Tile Only visible for images with multiple tiles and if Single Component is
activated.
Activated: Displays the Tile Component control.

– Tile Compo- Selects the tile component that is used to calculate the alignment
nent transformation matrix.

See also
2 General Settings [} 83]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 140


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.7.4 Color-coded Projection

The Color-coded projection function generates a maximum intensity projection image along the
z-, or time-dimension of a multidimensional data set. Instead of using the colors assigned to the
channels, it displays the position in z or in time with a color gradient.

Parameters

Parameter Description
Palette Sets the color-pattern for the projection.

ROI Specifies the range of the dimension (chosen below) which will be
used for the projection.

Dimension Selects whether to perform the projection along the time (T) or along
the z-axis (Z). Only dimensions which are available in your data set are
shown.

Quantitative Activated: Uses a quantitative method which first creates a maxi-


mum intensity projection and then determines at which plane a pixel
was located. After that it attributes a color of the LUT to the pixel.
This method can sometimes produce abrupt transitions, but the pixel
color representing depth or time corresponds correctly to the colors in
the annotation.
Deactivated: This method attributes a color of the LUT to each plane
and then separates the result into RGB channels. Subsequently, it cre-
ates a maximum intensity projection of each RGB channel and then
combines the results into one image. Note that while this might result
in a more pleasantly looking image, the method can produce colors
which do not correspond to colors in the annotation!

3.11.8.7.5 Image Overlay

With this function you can align (or overlay) two images that are displaced in relation to each
other. It is also possible to make the individual planes of a z-stack image congruent, in the event
that they are not lying exactly on top of one another.
You can define 3 related points (Input Pixel) in both the input image and in the reference image
(Reference Pixel) that is displaced in relation to it. Therefore, click interactively on conspicuous
points, which are present in both images. If you click Apply, the function calculates the Output
image, in which the new fitting points have the same coordinates as in the Input image.

Parameters

Parameter Description
Input Pixel 1 - 3 If you click on the corresponding buttons, you can define the 3 input
pixel points.
The selected point is shown in the graphics plane. This serves as an
aid to orientation when you are clicking on the reference points.

Reference Pixel 1 - If you click on the corresponding buttons, you can define the 3 refer-
3 ence pixel points.

Interpolation Here you can specify how the rotation influences the neighboring pix-
els.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 141


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Linear The rotated pixel is given the gray value calculated from the linear
combination of the gray values of the pixel closest to it and this pixel’s
nearest neighbor.

- Cubic The rotated pixel is given the gray value resulting from a polynomial
function of the pixel that is closest to it.

3.11.8.7.6 Mirror

This method allows you to flip an image horizontally or vertically. In the case of multidimensional
images, such as Z-stack or time lapse images, you can also use the mirror method to reverse the
sequence of the relevant dimension.

Parameters

Parameter Description
Display Mode

- Horizontal Flips the image horizontal.

- Vertical Flips the image vertical.

- T/Z Only visible if input image is a multichannel image.


Reverses sequence of the sections (Z) or time points (T).

See also
2 Image Processing Workflow [} 72]

3.11.8.7.7 Orthogonal Projection

With this method you can extract specific parts of the image of three-dimensional images. This is
accomplished with three alternative projection planes, frontal in the XY direction, sagittal in YZ di-
rection or transverse in XZ direction as seen from the observer of the image. You can choose be-
tween different projection methods. All methods have in common is that the pixels are analyzed
by the observer along an imaginary projection beam. You can also determine the thickness of the
projection planes, and thus the projection depth.

Parameters

Parameter Description
Projection Plane Here you choose the type of the projection plane (Frontal (X/Y), Trans-
verse (X/Z), Sagittal (Y/Z)).

Method

- Maximum Uses the brightest pixel along the projection beam.

- Minimum Uses the darkest pixel along the projection beam.

- Average Calculates the average of all pixels along the projection beam.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 142


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Weighted av- This method is related to the calculation of the extended depth of fo-
erage cus. It prefers structures with more lateral sharpness along the projec-
tion beam. The output image contains more significant details.

- Standard devi- Calculates the standard deviation of pixel grey values along the pro-
ation jection beam.

Start position Here you adjust the starting position of the project plane (in pixel
units or z-stack positions depending on the chosen projection plane).
The maximum range results automatically of the size of the input im-
age.

Thickness Here you adjust the thickness of the cutting plane (in pixel or z-stacks
depending on the chosen projection plane). The maximum range re-
sults automatically of the size of the input image.

3.11.8.7.8 Resample

This method allows you to change the size of an image in every dimension. You can either enlarge
or reduce the image size.

Parameters

Parameter Description
Third Dimension Only visible, if there is a third dimension in the input image and/or
Show all mode is activated.
Here you can select how you want the function to work in the case of
multidimensional images.

- 2D Slices The function is used in a 2-dimensional fashion only for multidimen-


sional images such as time lapse or z-stacks.

- Z, T or C Here you can select to which additional dimension the functions


should be applied to.

Adapt sizes Activated: The size of the output image is adjusted in accordance
with the settings for the scaling.
Deactivated: The output image has the same size as the input image.
Depending on the image size and rotation angle, partial areas of the
input image may not be visible in the output image.

Adjust per Channel Only visible if your input image is a multi-channel image.
Activated: You can adjust the parameters for each channel individu-
ally.

Interpolation Here you can select how you want interpolation to be performed if a
pixel is calculated from several individual pixels.

- Nearest Neigh- The output pixel is given the gray value of the input pixel that is clos-
bor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 143


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Controls

Parameter Description
Scaling in X Adjust the desired scaling for X using the slider or input field.

Scaling in Y Adjust the desired scaling for Y using the slider or input field.

Scaling in Z Adjust the desired scaling for Z using the slider or input field.

The following parameters are only visible if the Adapt sizes checkbox is deactivated:

Shift in X Enter the shift in the X direction using the slider or input field.

Shift in Y Enter the shift in the Y direction using the slider or input field.

Shift in Z Enter the shift in the Z direction using the slider or input field.

3.11.8.7.9 Rotate

With this method you can rotate images by defined angles. This function was especially devel-
oped for rotating complex (multi-dimensional) images in the available image dimensions. There-
fore, the function can be a little bit slower but offers more settings for the rotation. For simple, 2-
dimensional rotations we recommend to use the Rotate 2D function which is usually a lot faster.

Parameter

Parameter Description
Third Dimension Only visible, if there is a third dimension in the input image and/or
Show all mode is activated.
Here you can select how you want the function to work in the case of
multidimensional images.

- 2D Slices The function is used in a 2-dimensional fashion only for multidimen-


sional images such as time lapse or z-stacks.

- Z, T or C Here you can select to which additional dimension the functions


should be applied to.

Adapt sizes Activated: The size of the output image is adjusted in accordance
with the settings for the scaling.
Deactivated: The output image has the same size as the input image.
Depending on the image size and rotation angle, partial areas of the
input image may not be visible in the output image.

Adjust per Channel Only visible if your input image is a multi-channel image.
Activated: You can adjust the parameters for each channel individu-
ally.

Interpolation Here you can select how you want interpolation to be performed if a
pixel is calculated from several individual pixels.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 144


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Nearest Neigh- The output pixel is given the gray value of the input pixel that is clos-
bor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Parameter Description
Angle Enter the angle by which you want the input image to be rotated
around using the slider or input field. Positive angles rotate the im-
ages clockwise.

Angle X Enter the angle by which you want the input image to be rotated on
the X axis using the slider or input field.

Angle Y Enter the angle by which you want the input image to be rotated on
the Y axis using the slider or input field.

Angle Z Enter the angle by which you want the input image to be rotated on
the Z axis using the slider or input field.

The following parameters are only visible if the Adapt sizes checkbox is deactivated:

Center X Enter the X coordinate of the center of the rotation using the slider or
spin box/input field.
The value 0 means that the image is rotated around its center point.
Negative values mean that the center of the rotation in the image is
shifted to the left in relation to the image's center point. Positive val-
ues shift the center to the right.

Center Y Enter the Y coordinate of the center of the rotation using the slider or
spin box/input field.
The value 0 means that the image is rotated around its center point.
Negative values mean that the center of the rotation in the image is
shifted downwards in relation to the image's center point. Positive
values shift the center upwards.

Center Z Enter the Z coordinate of the center of the rotation using the slider or
spin box/input field.
The value 0 means that the image is rotated around its center point.
Negative values mean that the center of the rotation in the image is
shifted forwards in relation to the image's center point. Positive val-
ues shift the center backwards.

3.11.8.7.10 Rotate 2D

With this method, you can easily rotate an image clockwise around its center axis. Simply set the
desired angle with the slider. Of course, you can enter the angle value in the input field directly.
To perform the rotation, click on the Apply button on top of the Processing tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 145


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Angle Enter the angle by which you want the input image to be rotated
around using the slider or input field. Positive angles rotate the im-
ages clockwise.

Interpolation

- Nearest Neigh- The output pixel is given the gray value of the input pixel that is clos-
bor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Edge Smoothing Activated: Performs edge smoothing.

PaveWholePlane Activated: Paves the whole resulting plane with tiles; there might be
empty tiles.
Inactivated: Creates only tiles which contain also parts of the image.

ProcessMask Activated: Rotates also the mask of valid/invalid pixels.


Inactivated: Ignores the mask of valid/invalid pixels. Pixels previously
marked as invalid will have an intensity of zero after rotation but are
not marked as invalid.

IncludeGraphic El- Activated: Rotates also the graphical elements together with the im-
ements age.
Inactivated: Rotates only the image, but not the graphical elements.

3.11.8.7.11 Sample Down

With this function, you can reduce the size of an image in a flexible way. The reduction is per-
formed along with an averaging of the respective dimension. If the parameters are set to 1, the
corresponding dimension is not modified.

Parameter Description
Average Pixels X Adjusts how many pixels are averaged in the lateral X dimension to
calculate the output image. The size of the output will be smaller by
this factor.

Average Pixels Y Adjusts how many pixels are averaged in the lateral Y dimension to
calculate the output image. The size of the output will be smaller by
this factor.

Average Pix. 3rd Only visible, if a third dimension other than 2D Slices is selected be-
Dimension low.
Adjusts how many pixels are averaged in the lateral third dimension
selected below. The size of the output will be smaller by this factor.

Third Dimension If your input image has a third dimension you can select it here for re-
sampling.
§ Z (sections of a Z-Stack)
§ C (Channels)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 146


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
§ If 2D Slices is selected, the third dimension will not be re-sampled.

3.11.8.7.12 Shift

This method allows you to shift the content of an image in the direction of the 3 axes X, Y and Z.
To adjust the shift, use the respective sliders or input fields under Parameters.

Parameter Description
Third Dimension Only available if Show All is activated and if the acquired image is
three dimensional.
Selects the third dimensional shift.

– 2D Slices The third dimension is shifted by 0 which means the image is only
shifted in X/Y direction.

– Z The shift is in Z direction.

– C Shifts the channel.


If you have a 32 channel image, the first 30 channels are copied and/
or interpolated into the last ones (for an 32 channel lambda image
this would result in a shift to the red spectrum).
When selected, the checkbox Adjust per channel is not available.

Adjust per Channel Only available for images with multiple channels.
Opens a list with the channels to allow an individual adjustment of
each channel.

– Process Chan- Shifts this channel according to the input.


nel

– Skip Channel Skips this channel when processing. This channel will not be in the
output image.

– Copy Channel This channel is copied into the output image without a shift.

Shift in X Selects the shift of the content in X direction.

Shift in Y Selects the shift of the content in Y direction.

Shift in Z Selects the shift of the content in Z direction.

3.11.8.7.13 Shift Z

This method allows you to shift the content of an image in z direction.

Parameter Description
Shift in Z Selects the shift of the content in z direction.

See also
2 General Settings [} 83]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 147


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.7.14 Stage Alignment

The images are registered by using the stage calibration points from the meta data.

Parameter Description
Interpolation Here you can select how you want interpolation to be performed.

- Nearest The output pixel is given the value of the input pixel that is closest to
Neighbor it.

- Linear The output pixel is given the value resulting from the linear combina-
tion of the input pixels closest to it.

- Cubic The output pixel is given the value resulting from a polynomial func-
tion of the input pixels closest to it.

3.11.8.7.15 Stitching

This method allows you to automatically align the individual tiles of a tile image with one another.
When acquiring a tile image, the stage movement is not precise down to the pixel level of the
camera sensor. To bypass this technical limitation and to have a margin to compensate for this in-
accuracy, tiles are usually overlapped by a few percent. To align them, the overlaps between
neighboring tiles are analyzed. The tiles are then shifted and rotated against each other to make
the transitions between them as seamless as possible.

Info
Direct Processing
When you use Stitching in Direct Processing, not all the parameters are available (e.g. Fuse
Tiles or Correct Shading). Some functionality is not available because there is no image avail-
able yet during the setup of Direct Processing. This means that taking reference settings from
the 2D view or processing dimensions Reference only is not possible. For experiments con-
taining multiple scenes, each scene is thus processed separately. Direct Processing also always
keeps both the acquired and processed image, so an inplace stitching is not available.

Parameter Description
Inplace The stitching is directly applied to the original image.

New Output A new image is generated as a result of the stitching process. The
original image is not modified.

Fuse Tiles Only visible if New Output is selected.


Activated: Blends all adjacent tiles into each other to compensate for
shading and other continuity errors. The image remains a tile image,
this option does not generate an image without tiles. The tiles created
after stitching are of a different size and serve as basis for building an
image pyramid. Note that this can cause problems if you want to
open the stitched image in another application (e.g. Fiji).

Correct Shading Only visible if New Output is selected.


Activated: Applies a shading correction to each image prior to stitch-
ing to correct uneven exposure. The dropdown list selects the refer-
ence that should be used for shading correction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 148


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Automatic The function automatically calculates a reference image from the in-
put image.

- Reference The function uses an existing reference image. This must be selected
in addition to the input image in the Input tool of the image parame-
ters section.

Select Reference Only visible in Batch mode and if Reference is selected as shading
Image correction.
Selects a reference image for the shading correction.

Select dimension Only visible for multidimensional input images.


references for Selects a reference dimension (one channel, z-position, time point or
stitching scene) from your multidimensional data set. This reference dimension
is either stitched exclusively (no other planes of the dimensions are
stitched) or serves as reference when stitching all planes of the dimen-
sions.

- Get all dimen- Selects the reference dimensions based on the current planes from
sions from 2d
the 2D view by clicking .
view

- All by refer- Uses only the reference image plane for calculating the stitching of
ence this dimension. All other planes are stitched accordingly and appear in
the output image.

- Reference Uses only the selected reference image plane of this dimension. No
only other planes appear in the output image, e.g. the result of stitching a
z-stack with Reference only would be a normal 2D image.

- All individually All planes of this dimension are stitched individually and appear in the
output image.

- Channels
Selects the channel that serves as reference. Clicking takes the
current channels from the 2D view.

- Z-Position
Selects the z-position that serves as reference. Clicking takes the
current z-position from the 2D view.

- Time
Selects the time point that serves as reference. Clicking takes the
current time point from the 2D view.

- Scene
Selects the scene that serves as reference. Clicking takes the cur-
rent scene from the 2D view.

- Illumination Only visible for dual side illuminated images.


Selects an illumination side that serves as reference.

- View Only visible for multi view images.


Selects a view that serves as reference.

Edge Detector

- Yes Applies an edge detection algorithm to improve analysis of the over-


laps between neighboring tiles. This can improve the alignment of the
tiles and thus the stitching result.

- No No edge detector is applied.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 149


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Minimal Overlap Sets the minimal amount of overlap between neighboring tiles that
should be evaluated by the stitching function. The overlap is sets as %
of the single tile dimensions (height and width).

Maximal Shift Specifies the maximal extent of shift that can be applied to an individ-
ual tile during stitching. The shift is sets as % of the single tile dimen-
sions (height and width).

Comparer Selects a method for comparing the tile overlaps to find similarities for
alignment.

- Basic Selects a basic (faster) comparison which uses phase correlation to


find similarities.

- Best Selects an elaborate comparison which uses cross-correlation to find


similarities.

- Optimized Selects an optimized comparison which uses cross-correlation imple-


mented with the Intel Performance Primitives. This comparison is
faster than the Best method.

Global Optimizer Selects which tile overlaps are evaluated.

- Basic Only the overlaps (except diagonal overlaps) with the strongest con-
trasts in each tile are taken into account for stitching. The contrast is
determined with a Sobel filter.

- Best All overlaps (except diagonal overlaps) of a tile are taken into account
for stitching.

Defaults Resets all parameters to their default values.

Undo Resets the stitching changes done to the image.

Redo Repeats the last undone change to the image.

See also
2 Using Direct Processing [} 230]
2 Shading Correction [} 116]

3.11.8.7.16 Z-Stack Alignment

This method allows you to bring the individual planes of a z-stack image into line if these are not
positioned precisely one above the other. This is the case, for example, when you acquire z-stacks
at an oblique angle using a stereo microscope.

Parameter Description
Registration Only visible if Load Transformation is deactivated.
Method Selects the method or a combination of methods which is used to
align the images.

- Translation The neighboring sections of the image are shifted in relation to each
other in the X and Y direction.

- Rotation The neighboring sections of the image are rotated in relation to each
other.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 150


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Iso Scaling The magnification is adjusted from section to section.

- Skew Scaling The neighboring sections of the image are corrected for skewness/
shearing.

- Affine The neighboring sections of the image are shifted in X and Y direc-
tion, rotated and the magnification is adjusted from section to sec-
tion.

Quality Only visible if Show All is activated and if Load Transformation is


deactivated.
Selects the quality level that you want the function to work with. The
calculation of the alignment is based on a so-called image pyramid.
The higher the selected quality, the more levels of the image pyramid
are used to calculate the alignment and the more precise the align-
ment will be. However, the higher the selected quality is, the slower
the calculation of the alignment will get.

– Low This is the most imprecise but also the fastest calculation of the align-
ment. It uses a low number of levels (2) of the image pyramid for the
alignment calculation.

– Medium This is a more precise but also a slower calculation of the alignment
than the one before. It uses a medium number of levels (3) of the im-
age pyramid for the alignment calculation.

– High This is a more precise but also a slower calculation of the alignment
than the two before. It uses a high number of levels (4) of the image
pyramid for the alignment calculation.

– Highest This is the most precise but also the slowest calculation of the align-
ment. It uses the highest number of levels of the image pyramid for
the alignment calculation.

Interpolation Only visible if Show All is activated.


Selects how the interpolation should be performed if a pixel is calcu-
lated from several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Crop Output Only visible if your image does not contain multiple tiles or scenes.
Activated: The image is cropped and only keeps the section which is
covered by the entire dimension (e.g. by all z-slices or time points).
The output image can be of different size than the input image.
Deactivated: The output image is not cropped and keeps the size of
the input image. The image borders might get filled with a default
pixel value.

Single Component Only visible if you have selected an input image which contains di-
mensional components (e.g. scenes, z-planes, time points) and if this
component is not selected as Third Dimension.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 151


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Activated: Displays a control to select the dimensional component
that is used to calculate the alignment transformation matrix.
Deactivated: Calculates an alignment transformation matrix for each
individual component (e.g. for each individual scene).

– Scene Compo- Only visible for images with multiple scenes.


nent Selects the scene that is used to calculate the alignment transforma-
tion matrix.

– Phase Compo- Only visible for images with multiple phases.


nent Selects the phase that is used to calculate the alignment transforma-
tion matrix.

– Channel Com- Only visible for images with multiple channels.


ponent Selects the channel that is used to calculate the alignment transforma-
tion matrix.

– Time Compo- Only visible for time series images.


nent Selects the time point that is used to calculate the alignment transfor-
mation matrix.

Single Tile Only visible for images with multiple tiles and if Single Component is
activated.
Activated: Displays the Tile Component control.

– Tile Compo- Selects the tile component that is used to calculate the alignment
nent transformation matrix.

See also
2 General Settings [} 83]

3.11.8.7.17 Z-Stack Alignment with ROI

This function allows you to automatically align the individual planes of a z-stack image if they are
not positioned precisely above each other.

Parameter Description
Quality Selects the quality level that you want the function to work with. The
calculation of the alignment is based on a so-called image pyramid.
The higher the selected quality, the more levels of the image pyramid
are used to calculate the alignment and the more precise the align-
ment will be. However, the higher the selected quality is, the slower
the calculation of the alignment will get.

– Low This is the most imprecise but also the fastest calculation of the align-
ment. It uses a low number of levels (2) of the image pyramid for the
alignment calculation.

– Medium This is a more precise but also a slower calculation of the alignment
than the one before. It uses a medium number of levels (3) of the im-
age pyramid for the alignment calculation.

– High This is a more precise but also a slower calculation of the alignment
than the two before. It uses a high number of levels (4) of the image
pyramid for the alignment calculation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 152


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Highest This is the most precise but also the slowest calculation of the align-
ment. It uses the highest number of levels of the image pyramid for
the alignment calculation.

Registration Selects the method which is used to align the images.


Method

– Translation The neighboring sections of the z-stack are shifted in relation to each
other in the X and Y direction.

– Rotation The neighboring sections of the z-stack are rotated in relation to each
other.

– Translation + The neighboring sections of the z-stack are translated and rotated in
Rotation relation to each other.

Interpolation Selects how the interpolation is performed if a pixel is calculated from


several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Region Selects which parts of the image should be considered for the calcula-
tion of the transformation matrix.

- Full Considers the entire image for alignment.

- Rectangle Re- Allows you to draw a region of interest into the image. Only the im-
gion age information of this region is then considered for the calculation of
the transformation matrix for alignment. The resulting transformation
matrix will be applied to the full image.
After you have drawn a rectangle region into the image, you can see
and change its coordinates with the X/Y/W/H input fields.

Crop Output Not visible if the Third Dimension (if available) is set to a particular
dimension instead of 2D Slices.
Activated: The image is cropped and only keeps the section which is
covered by the entire dimension, i.e. by all z-slices. The output image
can be of different size than the input image.
Deactivated: The output image is not cropped and keeps the size of
the input image. The image borders might get filled with a default
pixel value.

Single Component Activated: Displays the image channels. Selects one of the image
channels which will be used to calculate the alignment transformation
matrix, which then is also applied to the other channel(s).
Deactivated: Calculates an alignment transformation matrix for each
individual channel.

See also
2 Aligning Z-Planes Automatically (Based on a ROI) [} 795]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 153


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.8 Image Analysis

The group Image Analysis provides different options to analyze images in single or batch mode.
The measurement data can be embedded in the image, saved in a *csv-datalist, or saved as label
image.

3.11.8.8.1 Analyze

This function is applicable only for one image: This must be selected in the Input tool. The mea-
surement data are embedded in the image.

3.11.8.8.2 Analyze to File

This function is applicable only for one image: This must be selected in the Input tool. The mea-
surement data is stored in a *csv list and is not embedded into the image.
The following file types are supported:

§ CZI
§ ZVI
§ BMP
§ TIF
§ JPG

Parameter Description
Data Folder Folder where the *csv-data lists will be stored.

Base Name Name of the data list.

3.11.8.8.3 Analyze Batch

This function allows the analysis of all images in a folder.


The function Analyze Batch can only be applied to images with the file type *czi.
The measured data are embedded in each original image.

Parameter Description
Image Folder Folder of the *czi images to be measured.

3.11.8.8.4 Analyze Batch to File

This function allows an analysis of all images in a folder. The measured data are stored in a *csv
list and not embedded into the image.
The following file types are supported:

§ CZI
§ ZVI
§ BMP
§ TIF
§ JPG

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 154


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Image Folder Folder of the images to be measured.

Data Folder Folder where the *csv-data lists will be stored.

Base Name Name of the data list.

Append Data Activated: For each class, an accumulated csv-data list is stored with
the measurement data of all images.
Deactivated: For each image, one data list is stored per class.

3.11.8.8.5 Analyze to Label Image

The image processing functions Analyze to Label Image labels images based on an existing im-
age analysis setting and the parameters which you select in the Parameters section.

Parameter Description
Setting Displays image analysis settings in the drop-down list.

Initialization Initializes the output image.

– One channel Creates a one channel output image.

– One channel Creates a one channel output image and copies the content of the
and copy first first channel.

– One channel Creates an output image with one channel per region class.
per class

– One channel Creates an output image with one channel per region class and copies
per class and the content of the original channels of each class.
copy

– All referenced Creates all channels referenced in the image analysis setting.
channels

– All referenced Creates all channels referenced in the image analysis setting and
channels and copies the content of the original image.
copy

– Copy all Chan- Creates an output image containing each channel of the input image
nels and Label and overlays each channel the masks of all classes defined in the im-
all age analysis setting.

Label Mode Selects the mode of labels applied to the image.

– Region - Pixel Labels the region with the maximum value of the pixel type.
Type Maxi-
mum

– Region - Label Labels the region with the value specified by the Label Value slider/
Value input field.

– Region - Re- Labels the region with the region ID.


gion ID

– Region - Re- Labels the region with the region ID color.


gion ID Color

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 155


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Region - Re- Labels the region with the region class ID.
gion Class ID

– Region - Re- Labels the region with the region class color.
gion Class
Color

– Contour - Draws a contour with the maximum value of the pixel type.
Pixel Type
Maximum

– Contour - La- Draws a contour with the value specified by the Label Value slider/
bel Value input field.

– Contour - Re- Draws a contour with the color defined by the region ID.
gion ID

– Contour - Re- Draws a contour with the color defined by the region ID color.
gion ID Color

– Contour - Re- Draws a contour with the color defined by the region class ID.
gion Class ID

– Contour - Re- Draws a contour with the color defined by the region class color.
gion Class
Color

– Contour2 - Draws a double contour with the value defined by the maximum
Pixel Type value of the pixel type.
Maximum

– Contour2 - La- Draws a double contour with the value specified by the Label Value
bel Value slider/ input field.

– Contour2 - Re- Draws a double contour with the color defined by the region ID.
gion ID

– Contour2 - Re- Draws a double contour with the color defined by the region ID color.
gion ID Color

– Contour2 - Re- Draws a double contour with the color defined by the region class ID.
gion Class ID

– Contour2 - Re- Draws a double contour with the color defined by the region class
gion Class color.
Color

Pixel Type Selects the pixel type for the output image.

– 8 Bit B/W Creates an 8 bit black and white output image.

– 16 Bit B/W Creates a 16 bit black and white output image.

– 24 Bit RGB Creates a 24 bit colored output image.

– 48 Bit RGB Creates a 48 bit colored output image.

– 32 Bit B/W Creates a 32 bit black and white image.


Float

Label Value Selects the label value.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 156


3 Basic Concepts | 3.11 Image Processing ZEISS

See also
2 Using Analyze to Label Image [} 81]

3.11.8.8.6 Analyze to Label Image Batch

The image processing functions Analyze to Image Batch labels images based on an existing im-
age analysis setting and the parameters which you select in the Parameters section.

Parameter Description
Setting Displays image analysis settings in the drop-down list.

Image Folder Selects the folder of the images.

Initialization Initializes the output image.

– One channel Creates a one channel output image.

– One channel Creates a one channel output image and copies the content of the
and copy first first channel.

– One channel Creates an output image with one channel per region class.
per class

– One channel Creates an output image with one channel per region class and copies
per class and the content of the original channels of each class.
copy

– All referenced Creates all channels referenced in the image analysis setting.
channels

– All referenced Creates all channels referenced in the image analysis setting and
channels and copies the content of the original image.
copy

– Copy all Chan- Creates an output image containing each channel of the input image
nels and Label and overlays each channel the masks of all classes defined in the im-
all age analysis setting.

Label Mode Selects the mode of labels applied to the image.

– Region - Pixel Labels the region with the maximum value of the pixel type.
Type Maxi-
mum

– Region - Label Labels the region with the value specified by the Label Value slider/
Value input field.

– Region - Re- Labels the region with the region ID.


gion ID

– Region - Re- Labels the region with the region ID color.


gion ID Color

– Region - Re- Labels the region with the region class ID.
gion Class ID

– Region - Re- Labels the region with the region class color.
gion Class
Color

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 157


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Contour - Draws a contour with the maximum value of the pixel type.
Pixel Type
Maximum

– Contour - La- Draws a contour with the value specified by the Label Value slider/
bel Value input field.

– Contour - Re- Draws a contour with the color defined by the region ID.
gion ID

– Contour - Re- Draws a contour with the color defined by the region ID color.
gion ID Color

– Contour - Re- Draws a contour with the color defined by the region class ID.
gion Class ID

– Contour - Re- Draws a contour with the color defined by the region class color.
gion Class
Color

– Contour2 - Draws a double contour with the value defined by the maximum
Pixel Type value of the pixel type.
Maximum

– Contour2 - La- Draws a double contour with the value specified by the Label Value
bel Value slider/ input field.

– Contour2 - Re- Draws a double contour with the color defined by the region ID.
gion ID

– Contour2 - Re- Draws a double contour with the color defined by the region ID color.
gion ID Color

– Contour2 - Re- Draws a double contour with the color defined by the region class ID.
gion Class ID

– Contour2 - Re- Draws a double contour with the color defined by the region class
gion Class color.
Color

Pixel Type Selects the pixel type for the output image.

– 8 Bit B/W Creates an 8 bit black and white output image.

– 16 Bit B/W Creates a 16 bit black and white output image.

– 24 Bit RGB Creates a 24 bit colored output image.

– 48 Bit RGB Creates a 48 bit colored output image.

– 32 Bit B/W Creates a 32 bit black and white image.


Float

Label Value Selects the label value.

Format Selects the format of the output image. You can save your image(s)
as:
§ czi
§ png

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 158


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
§ czi and png

See also
2 Using Analyze to Label Image [} 81]

3.11.8.8.7 Analyze Interactive Batch

This function allows the interactive analysis of all images in a folder. If steps of the image analysis
are marked as interactive in the image analysis setting, this function opens the Image Analysis
Wizard [} 941] with these steps. You can then adjust your analysis for each of the images. If you
deselect one of the interactive steps during the process, this step will not be shown for the analy-
sis of the following images. The image analysis setting remains unchanged by the changes made
during Analyze Interactive Batch.
The measured data are embedded in each original image.

Parameter Description
Image Folder Folder of the *czi images to be measured.

3.11.8.9 Lightsheet

This group of processing functions allows you to analyze multiview dual side illuminated Light-
sheet images. The following functions are available:

§ Dual Side Fusion [} 159]


§ Lightsheet Convert Dimensions [} 160]
§ Lightsheet Processing [} 161]
§ Maximum Intensity Projection [} 170]

3.11.8.9.1 Dual Side Fusion

This function merges the image done with the lightsheet from the right side with the image of the
left side. It can be used for the following datasets acquired with Dual Side illumination:

§ Image (Snap function)


§ Time Series
§ Z-Stacks
§ Combinations of time series and z-stacks
§ Multiview experiments in combination with time series

Parameter Description
Settings Allows handling predefined settings (templates). See also General Set-
tings [} 83].

– New Creates a new setting. Enter a name for the setting.

– New from Creates a new setting based on an existing template.


Template

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 159


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Rename Renames the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name.

– Import Imports an existing setting.

– Export Exports the current setting.

– Delete Deletes the current setting.

Mean The average intensity for each pixel is calculated using the values of
both illumination sides of the fusion.

DFT Discrete Fourier Transform fusion according to publication. Fine


structures and details are more visible after the fusion, which might
be worsened when using Mean Fusion. However, this process can
create noticeable artifacts in the resulting image.

Maximum The intensity of each pixel of both illumination images is compared


and the value with the higher intensity is used for the resulting image
of the fusion.

Fusion Subset in X Only available for Mean or Maximum fusion.


Selects which area of the left and the right illumination image should
be used for fusion.

– Current View Displays the selected view of a Multiview image in the 2D tab which
is used for fusion subset in x.
Note: The position of the sliders Left and Right as well as the Blend-
ing value have to be defined for each view individually.

– Left Selects the area of the left illumination side which is used for fusion.
The spin box shows the cut-off x pixel value. The cutoff is shown in
the 2D view with a red line.
Note: It is best to set the illumination slider of the Dimensions view
control to 1 to see the left-side illuminated image.

– Right Selects the area of the right illumination side which is used for fusion.
The spin box shows the cut-off pixel value of the y axis. The cutoff is
shown in the 2D view with a blue line.
Note: It is best to set the illumination slider of the Dimensions view
control to 2 to see the right-side illuminated image.

– Blending Defines the number of pixels used within an existing overlap between
left and right illumination to crossfade both illuminations sides.
Note: To avoid a visible change in intensity along the two cut off lines
for Mean Fusion with Fusion Subset in X, an overlap of both illumi-
nation sides should remain in the center of the image.

3.11.8.9.2 Lightsheet Convert Dimensions

This function allows you to convert some dimensions into channels.


The following dimensions are available:

§ View (from Multiview)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 160


3 Basic Concepts | 3.11 Image Processing ZEISS

§ Illumination (from Dual side)


The following dimensions are unavailable:

§ Time (from Time series)


§ Z (from Z-Stack)
§ Tile (from Tiling)
§ Position (from Positions)

Parameter Description
Settings Allows handling predefined settings (templates). See also General Set-
tings [} 83].

– New Creates a new setting. Enter a name for the setting.

– New from Creates a new setting based on an existing template.


Template

– Rename Renames the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name.

– Import Imports an existing setting.

– Export Exports the current setting.

– Delete Deletes the current setting.

View to channel Converts views from a Multiview data set into channels.

Illumination to Converts illuminations from a Dual Side data set into channels.
channel

3.11.8.9.3 Lightsheet Processing

Lightsheet processing allows you to deconvolve, register, and fuse Multiview images.

Parameter Description
Settings Allows handling predefined settings (templates). See also General Set-
tings [} 83].

– New Creates a new setting. Enter a name for the setting.

– New from Creates a new setting based on an existing template.


Template

– Rename Renames the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name.

– Import Imports an existing setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 161


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Export Exports the current setting.

– Delete Deletes the current setting.

Deconvolution Activated: Allows to deconvolve Lightsheet data (single views) of the


following formats:
§ Multiview experiments before registration and fusion (single or dual
side illumination):
Deconvolution is performed for each frame from all z-stacks and all
views. The process uses a point spread function (PSF) valid for sin-
gle view images.
§ Multiview experiments after registration and fusion:
Deconvolution is performed on the fused dataset, hence only one
z-stack needs to be processed. It uses a star-like point spread func-
tion (PSF) computed from the fused Multiview image.

For more information, see Deconvolution (adjustable) [} 95].

Multiview Activated: Allows registration, fusion, and deconvolution of Multi-


view images.

– Registration Allows to select the alignment method:


options
§ Landmark Based Alignment [} 162]
§ Intensity Based Alignment [} 164]
§ Use Registration from File [} 166]
§ Interactive Registration [} 168]

The following datasets can be processed with this function:


§ Multiview datasets, single side illumination
§ Multiview datasets, dual side illumination, Dual Side without Fusion
§ Multiview datasets, dual side illumination, Dual Side with Fusion
§ Multiview datasets with Deconvolution
§ Multiview datasets without Deconvolution

The Registration generates the transformation matrices so that all


views are matched to overlay. As a result, a dataset is provided in
which all z-stacks of all views should already largely overlay. The refer-
ence at which registrations starts is always View 1 of the dataset. This
image can be used for control. If one or more views do not have the
same alignment, registration was not successful, and the parameters
need to be adjusted. The Registration must always be done before
the Fusion of the data.

3.11.8.9.3.1 Landmark Based Alignment

Registration is done based on structural information within the image content.

Parameter Description
Parameter Settings Setting of alignment parameters.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 162


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Registration Selects the registration channel. Use a channel with fiducials to which
Channel other channels will be registered to.
Note: A selection of more than one channel for the registration
process is possible. For each selected channel an individual registra-
tion will be performed and, therefore, it is advisable to use one chan-
nel for the final registration. To test which channel will lead to the
best results, all channels can be selected for later comparison of the
results.

– Threshold Selects thresholds for the brightness of fiducials (beads).

– Size Selects thresholds for the size of fiducials (beads).

– Size Variations Selects thresholds for the variation in size difference.

– Dual side fu- This operation merges the image done with the light sheet from the
sion right side with the image of the left side. See also Dual Side Fusion
[} 159].

– Fusion Subset Activated: Selects which area of the left and the right illumination
in X image should be used for fusion. Only available for Mean or Maxi-
mum fusion. See also the description in Dual Side Fusion [} 159].

– Ignore Sample Activated: Uses a function to find incorrectly labeled fiducials and
eliminate them for registration.

– Expand to Activated: The volume of the resulting data set after registration and
maximum fusion is determined and additional black pixels (x,y) and z-slices are
value added to the views during registration. This prevents loss of data for
later fusion.

– Scaling X=Y=Z Activated: The dimensions are downsized to the smallest to have the
same size. If the scaling in Deconvolution or PSF settings is changed,
the latter overrides the scaling settings here.

– Individual Activated: Each time point generates a transformation matrix, and


Registration each time point is registered individually.
for every Time The time necessary for registration is multiplied by the number of time
Point points and can increase substantially. However, if the motorized
movement of the sample by the system has changed (e.g. due to ther-
mic effects on the system: not fully warmed up at start, incubation, air
conditioning of the room), the Individual Registration For Every
Time Point option is necessary.
Deactivated: One transformation matrix is generated for all the fol-
lowing time points based on the first time point. As a result, process-
ing for registration has only to be done once which reduces process-
ing time.

Parameter Description
Input settings A subset of a present time series can be selected for the Registration
and Fusion processing.

– Processing Sub- Truncates time points.


set Time

– Processing Sub- Defines time-to-time point step size.


set Steps

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 163


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Scaling correc- Sets the geometric scaling between X/Y and Z.
tion (µm)

Fusion Fuses registered views in one z-stack or one z-stack over time.

– None No fusion is performed after Registration and Dual Side Fusion.

– Mean Fusion The pixel in the fused image is determined by averaging the intensity
level of the pixels for the involved views.

– Mean Fusion + Only available if the dataset has not undergone deconvolution before.
Multiview DCV The pixel in the fused image is determined by averaging the intensity
level of the pixels of the involved views. After fusion, a deconvolution
is performed. The Deconvolution [} 95] interface is displayed if se-
lected.

– Blending Controls the amount of Blending (smoothing) by fading the borders of


all z-stacks in order to prevent visible edge effects.
Note: The value for Blending should be as low as possible with typical
values from 20 to 80. This needs to be tested for every dataset.

– Fusion Subset Activated: Defines which portion of the z-stacks of the contributing
in Z views of the experiment are used for the fusion process.

– Current View Selects the current view. For each view, the z-range can be set via
slider, spin boxes, or mouse click in the image. Registration will not be
affected by the z-range settings.
Note that for later deconvolution the calculated point spread function
(PSF) of a Multiview experiment assumes that all views equally con-
tribute to all areas of the image. This is not the case when using Sub-
set Z and might result in artefacts of the deconvolution result.

– Save unfused Activated: Saves the registered image in addition to the fused image.
data

See also
2 Deconvolution (adjustable) [} 95]

3.11.8.9.3.2 Intensity Based Alignment

Parameter Description
Parameter Settings Setting of alignment parameters.

– Registration Selects the registration channel. Use a channel with fiducials to which
Channel other channels will be registered to.
Note: A selection of more than one channel for the registration
process is possible. For each selected channel an individual registra-
tion will be performed and, therefore, it is advisable to use one chan-
nel for the final registration. To test which channel will lead to the
best results, all channels can be selected for later comparison of the
results.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 164


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Preregistra- Preregistration performs the process in a 2D maximum intensity pro-
tion jection of the z-stacks.
It is advisable to first perform a Pre-Registration to move similar
structures, which might facilitate the Registration, already into close
proximity.

– None No Preregistration is performed.

– Hardware Ro- The views are rotated solely based on the information from the rota-
tation tion positioning of the sample holder which is saved in the metadata.

– Trans Hard- The views are rotated solely based on the information from the rota-
ware Rotation tion positioning of the sample holder which is saved in the metadata.
Additionally, the x, y, and z axis are moved to match the views.

– Correlation The views are rotated solely based on the information from the rota-
Hardware Ro- tion positioning of the sample holder which is saved in the metadata.
tation Additionally, the x, y, and z axis are moved to match the views. Cross-
correlation is used to determine the translation in x, y, and z.

– Registration Registration uses the complete 3D information of the z-stacks.


Method

– Use Pre Regis- No Registration process is performed and only the result of the Pre-
ter Only Registration is used.

– Translation The registration only corrects along the x, y, and z axis.

– Trans Rota- The registration corrects along the x, y, and z axis and also the rota-
tion tion along x and y.

– Dual side fu- Merges the image done with the lightsheet from the right side with
sion the image of the left side. See also Dual Side Fusion [} 159].

– Fusion Subset Activated: Selects which area of the left and the right illumination
in X image should be used for fusion. Only available for Mean or Maxi-
mum fusion. See also the description in Dual Side Fusion [} 159].

– Ignore Sample Activated: Uses a function to find incorrectly labeled fiducials and
eliminate them for registration.

– Expand to Activated: The volume of the resulting dataset after registration and
maximum fusion is determined and additional black pixels (x,y) and z-slices are
value added to the views during registration. This prevents loss of data for
later fusion.

– Scaling X=Y=Z Activated: The dimensions are downsized to the smallest to have the
same size. If the scaling in Deconvolution or PSF settings is changed,
the latter overrides the scaling settings here.

– Individual Activated: Each time point generates a transformation matrix, and


Registration each time point is registered individually.
for every Time The time necessary for registration is multiplied by the number of time
Point points and can increase substantially. However, if the motorized
movement of the sample by the system has changed (e.g. due to ther-
mic effects on the system: not fully warmed up at start, incubation, air
conditioning of the room), the Individual Registration For Every
Time Point option is necessary.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 165


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Deactivated: One transformation matrix is generated for all the fol-
lowing time points based on the first time point. As a result, process-
ing for registration has only to be done once which reduces process-
ing time.

Parameter Description
Input settings A subset of a present time series can be selected for the Registration
and Fusion processing.

– Processing Sub- Truncates time points.


set Time

– Processing Sub- Defines time-to-time point step size.


set Steps

– Scaling correc- Sets the geometric scaling between X/Y and Z.


tion (µm)

Fusion Fuses registered views in one z-stack or one z-stack over time.

– None No fusion is performed after Registration and Dual Side Fusion.

– Mean Fusion The pixel in the fused image is determined by averaging the intensity
level of the pixels for the involved views.

– Mean Fusion + Only available if the dataset has not undergone deconvolution before.
Multiview DCV The pixel in the fused image is determined by averaging the intensity
level of the pixels of the involved views. After fusion, a deconvolution
is performed. The Deconvolution [} 95] interface is displayed if se-
lected.

– Blending Controls the amount of Blending (smoothing) by fading the borders of


all z-stacks in order to prevent visible edge effects.
Note: The value for Blending should be as low as possible with typical
values from 20 to 80. This needs to be tested for every dataset.

– Fusion Subset Activated: Defines which portion of the z-stacks of the contributing
in Z views of the experiment are used for the fusion process.

– Current View Selects the current view. For each view, the z-range can be set via
slider, spin boxes, or mouse click in the image. Registration will not be
affected by the z-range settings.
Note that for later deconvolution the calculated point spread function
(PSF) of a Multiview experiment assumes that all views equally con-
tribute to all areas of the image. This is not the case when using Sub-
set Z and might result in artefacts of the deconvolution result.

– Save unfused Activated: Saves the registered image in addition to the fused image.
data

3.11.8.9.3.3 Use Registration from File

When the registration for the data set is already determined and the transformation matrix is
saved as an .xml file (Filename.czi.xml), this option can be selected.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 166


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Parameter Settings Setting of alignment parameters.

– Select a regis- Opens the Windows File Explorer to select a file.


tration file […]

– Dual side fu- Merges the image done with the light sheet from the right side with
sion the left side image. See also Dual Side Fusion [} 159].

– Fusion Subset Activated: Selects which area of the left and the right illumination
in X image should be used for fusion. Only available for Mean or Maxi-
mum fusion. See also the description in Dual Side Fusion [} 159].

– Expand to Activated: The volume of the resulting data set after registration and
maximum fusion is determined and additional black pixels (x,y) and z-slices are
value added to the views during registration. This prevents loss of data for
later fusion.

Parameter Description
Input settings A subset of a present time series can be selected for the Registration
and Fusion processing.

– Processing Sub- Truncates time points.


set Time

– Processing Sub- Defines time-to-time point step size.


set Steps

– Scaling correc- Sets the geometric scaling between X/Y and Z.


tion (µm)

Fusion Fuses registered views in one z-stack or one z-stack over time.

– None No fusion is performed after Registration and Dual Side Fusion.

– Mean Fusion The pixel in the fused image is determined by averaging the intensity
level of the pixels for the involved views.

– Mean Fusion + Only available if the dataset has not undergone deconvolution before.
Multiview DCV The pixel in the fused image is determined by averaging the intensity
level of the pixels of the involved views. After fusion, a deconvolution
is performed. The Deconvolution [} 95] interface is displayed if se-
lected.

– Blending Controls the amount of Blending (smoothing) by fading the borders of


all z-stacks in order to prevent visible edge effects.
Note: The value for Blending should be as low as possible with typical
values from 20 to 80. This needs to be tested for every dataset.

– Fusion Subset Activated: Defines which portion of the z-stacks of the contributing
in Z views of the experiment are used for the fusion process.

– Current View Selects the current view. For each view, the z-range can be set via
slider, spin boxes, or mouse click in the image. Registration will not be
affected by the z-range settings.
Note that for later deconvolution the calculated point spread function
(PSF) of a Multiview experiment assumes that all views equally con-
tribute to all areas of the image. This is not the case when using Sub-
set Z and might result in artefacts of the deconvolution result.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 167


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Save unfused Activated: Saves the registered image in addition to the fused image.
data

3.11.8.9.3.4 Interactive Registration

The recorded views of an experiment are registered manually. The views of one channel at one
time point of the experiment are the basis for the procedure. The z-stacks of the individual views
are rotated based on the rotation information of the files metadata and transformed into chan-
nels, resulting in one maximum intensity projection image. Within this newly generated image,
the views, now behaving as channels, can be moved in x, y, z and rotated to overlay each other.
When all views are laid on top of each other, the Apply button uses the adjusted parameters to
register, and when required to fuse, the views for all time points of the experiment. An .xml file is
created which can be used for the Use registration from file option. This .xml file can be found
along with the processed data in the result folder.

Parameter Description
Parameter Settings Setting of alignment parameters.

– Registration Selects the registration channel that should be used to manually over-
Channel lay all views of the image.
Note: Only one channel can be used for this procedure, all other
channels will not be displayed.

– Current Time Indicates the selected time point of a time series as set with the time
Point slider in the Dimensions tab.

– Front View Converts views into channels and generates a maximum intensity pro-
jection along the z-axis of channels displaying the x- (horizontal) and
y- (vertical) axis of channels representing.
Note: It is advisable to assign different colors to the channel to ease
up alignment process. Channels can be turned on/off in the Dimen-
sions tab.

– Side View Converts views into channels and generates a maximum intensity pro-
jection along the x-axis displaying the z- (horizontal) and y- (vertical)
axis of channels representing.
Note: It is advisable to assign different colors to the channel to ease
up alignment process. Channels can be turned on/off in the Dimen-
sions tab.

– View # Selects the view to be aligned to View 1.


View 1 is the master view and the reference channel and cannot be
selected or moved. View # can be moved by translation and rotation
against View 1. It does not matter if alignment is started with Front
View or Side View. Three iterations between Front View and Side
View alignment are recommended.

– Alignment X Shifts the selected view against View 1 in X. Not available for Side
View.

– Alignment Y Shifts the selected view against View 1 in Y.

– Alignment Z Shifts the selected view against View 1 in Z. Not available for Front
View.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 168


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Rotation Rotates the selected view around the position of the red cross overlay
within the image of the 2D tab.

– Reset Moves all views back to the position where the maximum intensity
projection was generated.

– Preview Produces a new image of the channel and the time point which is reg-
istered with the provided settings. The image will contain fused views
when Mean Fusion is selected for Fusion.

– Dual side fu- Merges the image done with the lightsheet from the right side with
sion the image of the left side. See also Dual Side Fusion [} 159].

– Fusion Subset Activated: Selects which area of the left and the right illumination
in X image is used for fusion. Only available for Mean or Maximum fu-
sion. See also the description in Dual Side Fusion [} 159].

– Expand to Activated: The volume of the resulting dataset after registration and
maximum fusion is determined and additional black pixels (x,y) and z-slices are
value added to the views during registration. This prevents loss of data for
later fusion.

– Scaling X=Y=Z Activated: The dimensions are downsized to the smallest to have the
same size. If the scaling in Deconvolution, PSF settings is changed, the
latter will override the scaling settings here.

Parameter Description
Input settings A subset of a present time series can be selected for the Registration
and Fusion processing.

– Processing Sub- Truncates time points.


set Time

– Processing Sub- Defines time-to-time point step size.


set Steps

– Scaling correc- Sets the geometric scaling between X/Y and Z.


tion (µm)

Fusion Fuses registered views in one z-stack or one z-stack over time.

– None No fusion is performed after Registration and Dual Side Fusion.

– Mean Fusion The pixel in the fused image is determined by averaging the intensity
level of the pixels for the involved views.

– Mean Fusion + Only available if the dataset has not undergone deconvolution before.
Multiview DCV The pixel in the fused image is determined by averaging the intensity
level of the pixels of the involved views. After fusion, a deconvolution
is performed. The Deconvolution [} 95] interface is displayed if se-
lected.

– Blending Controls the amount of Blending (smoothing) by fading the borders of


all z-stacks in order to prevent visible edge effects.
Note: The value for Blending should be as low as possible with typical
values from 20 to 80. This needs to be tested for every dataset.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 169


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
– Fusion Subset Activated: Defines which portion of the z-stacks of the contributing
in Z views of the experiment are used for the fusion process.

– Current View Selects the current view. For each view, the z-range can be set via
slider, spin boxes, or mouse click in the image. Registration will not be
affected by the z-range settings.
Note that for later deconvolution the calculated point spread function
(PSF) of a Multiview experiment assumes that all views equally con-
tribute to all areas of the image. This is not the case when using Sub-
set Z and might result in artefacts of the deconvolution result.

– Save unfused Activated: Saves the registered image in addition to the fused image.
data

3.11.8.9.4 Maximum Intensity Projection

The function allows you to perform a Maximum Intensity Projection (MIP) for selected dimensions.

Parameter Description
Settings Allows handling predefined settings (templates). See also General Set-
tings [} 83].

– New Creates a new setting. Enter a name for the setting.

– New from Creates a new setting based on an existing template.


Template

– Rename Renames the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name.

– Import Imports an existing setting.

– Export Exports the current setting.

– Delete Deletes the current setting.

Online Batch Pro- Activated: Starts the online batch processing.


cessing

Coordinate Selects the coordinate for which the maximum intensity projection
(MIP) is performed.

– Z MIP of a z-stack.

– C MIP of channels.

– T MIP of a time series.

– I MIP of Illumination sides.

– V MIP of views.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 170


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Range Sets the range of the dimension to be used for the maximum intensity
projection. The range can be set with the two slider bars or the spin
boxes.

3.11.8.10 Segmentation

3.11.8.10.1 Canny

Canny detects edges in an image. This function detects relatively thick contours at the edge of
bright regions.

Parameter

Parameter Description
Sigma Degree of smoothing of input image before detection of edges. A
Gauss filter is used as a smoothing function. The smoothing factor
can be used to influence the sensitivity of recognition. If a low value is
set, lots of edges are detected. Fewer edges are detected with a high
value. If the value 0 is set, no smoothing is performed.

Threshold Steepness of the edges to be detected. Low values mean "flat" edges
with a wide transition area between two regions. In this case lots of
edges are detected. If high values are used, fewer edges are detected,
as only steep transition areas are interpreted as edges.

3.11.8.10.2 Marr

This method detects edges or regions in an image. In contrast to Valleys and Canny, here a
Laplace filter is calculated, followed by smoothing using a Gauss filter, and the edges (Display
Mode >Edges) or regions (Display Mode > Regions) are detected.

Parameter

Parameter Description
Sigma Degree of smoothing of input image before detection of edges or re-
gions. A Gauss filter is used as a smoothing function. The smoothing
factor can be used to influence the sensitivity of recognition. If a low
value is set, lots of edges are detected. Fewer edges are detected with
a high value. If the value 0 is set, no smoothing is performed.

Display Mode

- Edges Region edges are detected.

- Regions The regions, not just their edges, are detected.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 171


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.10.3 Threshold

This function performs a segmentation based on the definition of a brightness range (separated
according to color channels (red, green, blue)) for the regions to be segmented. All pixels whose
color values lie within the defined color range are marked as region pixels in the resulting image.
All the pixels whose color values lie outside the defined color range are marked as background
pixels (black).
In the resulting image, the color values of the region pixels can either be set permanently to white
or adopted unchanged. If you set the region pixels permanently to white, the result is a binary im-
age, which can then be used as a mask image for a subsequent automatic measurement.

Parameters

Parameter Description
Level Low Determines the lower brightness threshold for the regions to be seg-
mented. All the pixels whose gray values lie below this threshold value
are marked as background pixels (black).

Level High Determines the upper brightness threshold for the regions to be seg-
mented. All the pixels whose gray values lie above this threshold value
are marked as background pixels (black).

The following parameters are only visible if the Show All mode is activated:

Parameter Description
Create binary Activated: The resulting image is a binary image. Pixels within the
calculated gray level range are set to the maximum gray value (white),
whilst pixels outside it are set to the gray value 0.
Deactivated: The resulting image is of the same type as the input im-
age. Pixels within the calculated gray level range are set to the origi-
nal gray value. Pixels outside it are set to 0.

Invert result Activated: Inverts the effect of the function. The segmented regions
will be given the value 0, and all other pixels the gray value white or
the gray value/color of the input image.

3.11.8.10.4 Threshold (Auto)

This method performs an automatic gray value segmentation. The function calculates the two
minimums in the individual channels in the gray value histogram of the input image (Input) and
uses these for the segmentation.
The following parameters are only visible if the Show All mode is activated:

Parameter Description
Method

- Otsu For all possible threshold values, the Otsu method calculates the vari-
ance of intensities on each side of the respective threshold. It mini-
mizes the sum of the variances for the background and the fore-
ground.

- Maximum Separates background and foreground pixels at the maximum value


Peak of the histogram.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 172


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Iso Data The threshold value lies in the middle between two maximums in the
histogram.

- Triangle The threshold value is calculated from the sum of the average and
Threshold three times the sigma value of the histogram distribution.

- Three Sigma
Threshold

Parameters

Parameter Description
Create binary Activated: The resulting image is a binary image. Pixels within the
calculated gray level range are set to the maximum gray value (white),
whilst pixels outside it are set to the gray value 0.
Deactivated: The resulting image is of the same type as the input im-
age. Pixels within the calculated gray level range are set to the origi-
nal gray value. Pixels outside it are set to 0.

Invert result Activated: Inverts the effect of the function. The segmented regions
will be given the value 0, and all other pixels the gray value white or
the gray value/color of the input image.

3.11.8.10.5 Threshold (Dynamic)

This method performs an adaptive gray value segmentation. This procedure is particularly well
suited to the segmentation of small structures against a varying background.
The function initially applies a low pass filter and then subtracts this low-pass-filtered image from
the input image. The effect of this function mainly depends on the size of the filter matrix: Select
a low value for Size to segment small regions or regions with low gray value contrast from the
background. Select a higher value for Size to segment larger regions from the background.

Parameters

Parameter Description
Kernel Size Matrix size of the low pass filter in x- and y-direction symmetrically
around the pixel in question. Determines the extent of the smoothing
effect. As the affected pixel is at the center, the edge length of the fil-
ter matrix is always an odd number. If an even number is entered via
the keyboard, the value is always set to the next highest odd number.

Threshold This value defines the gray value difference between the regions to be
detected and the background. Segmented pixels are set to the maxi-
mum gray value (white), whilst other pixels are set to the gray value 0.

The following parameters are only visible if the Show All mode is activated:

Parameter Description
Create binary Activated: The resulting image is a binary image. Pixels within the
calculated gray level range are set to the maximum gray value (white),
whilst pixels outside it are set to the gray value 0.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 173


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Deactivated: The resulting image is of the same type as the input im-
age. Pixels within the calculated gray level range are set to the origi-
nal gray value. Pixels outside it are set to 0.

Invert result Activated: Inverts the effect of the function. The segmented regions
will be given the value 0, and all other pixels the gray value white or
the gray value/color of the input image.

3.11.8.10.6 Valleys

This method detects dark lines (gray value valleys) on a bright background and contours between
bright regions.

Parameter

Parameter Description
Sigma Degree of smoothing of input image before detection of valleys. The
smoothing factor can be used to influence the sensitivity of recogni-
tion. If a low value is set, lots of valleys are detected. Fewer valleys are
detected with a high value.

Threshold Curvature at the valley bottom high/low. Depending on the setting


made, weakly pronounced valleys are also detected, or only ones that
are strongly pronounced.

3.11.8.11 Sharpen

3.11.8.11.1 Delineate

This method enhances the edges of individual regions in an image. It corrects the halo effect and
only affects edges.

Parameters

Parameter Description
Threshold Enter the threshold value for edge detection using the slider or spin
box/input field. The threshold value should correspond roughly to the
gray value difference between objects and the background.

Size Enter the size of the edge detection filter using the slider or spin box/
input field. The value should correspond to the size of the transition
area between objects and the background.

3.11.8.11.2 Enhance Contour

This method allows you to enhance contours in an image and emphasize regions in which gray
values change. The function is suitable for visually emphasizing fine structures in an image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 174


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameters

Parameter Description
Strength Here you can adjust the factor for increasing edge enhancement.

Normalization Here you can select how the gray/color values that exceed or fall
short of the value range should be dealt with.

- Clip Automatically sets the gray levels that exceed or fall short of the pre-
defined gray value range to the lowest or highest gray value (black or
white). The effect corresponds to underexposure or overexposure. In
certain circumstances some information may therefore be lost.

- Automatic Normalizes the gray values automatically to the available gray value
range.

- Wrap If the result is larger than the maximum gray value of the image, the
maximum gray value + 1 is deducted from this value.

- Shift Normalizes the output to the value "gray value + maximum gray
value/2".

- Absolute Converts negative gray levels into positive values.

3.11.8.11.3 Extended Depth of Focus

With this method, you can combine the sharp regions from the individual sections of a z-stack im-
age to create a single sharp image. This enables you to display a considerably larger depth of field
than is possible on a microscope.

Parameter Description
Method

- Wavelets Uses a wavelet transformation to detect the sharpest areas in the im-
ages.

- Contrast For this method, the value is the difference between the brightest and
the darkest pixel value within the “Kernel”.

- Maximum Images with the brightest and darkest pixels are generated first. Of
Projection these images the image with the higher variance is used as the result-
ing image. Usually, best suited for fluorescence images.

- Variance Calculates the variance of the pixel values within the “Kernel”. Usu-
ally, best suited for bright field images.

- Fast EDF Uses a method for fast EDF to detect the sharpest areas in the images.

Z-Stack Alignment This parameter should not be used for processing whole slide image
scans. It is only required when processing images stemming from a
stereo microscope.
Not visible if you have selected Maximum Projection as Method.
Selects if the z-stack image should be aligned before the calculation
and with what quality level. If you acquire images with a stereo mi-
croscope, the images are displaced against each other. This displace-

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 175


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
ment can be corrected. The higher the selected quality of alignment,
the longer takes the calculation. Select No Alignment, if you acquire
images with a compound microscope.

- No Alignment The z-stack image is not aligned before the calculation. Select this set-
ting if the z-stack image has not been acquired using a stereo micro-
scope.

- Normal Uses an alignment with high speed for normal image quality.

- High Uses an alignment with lower speed for high image quality.

- Highest Uses an alignment with the lowest speed with best image quality.

Process Tiles Sepa- Only visible if you have selected Maximum Projection as Method.
rately Activated: Processes each tile region separately.

Contrast Length- Only visible if Contrast or Variance is selected as Method.


scale Sets the length scale (pixel units) at which the contrast for every slice
is calculated. For images with small and sharp structures, a small con-
trast length scale provides good results. For images with larger struc-
tures with smoother edges, a larger contrast length scale is required.

Smoothing Only visible if Contrast, Variance, or Fast EDF is selected as


Method.
Sets a value for smoothing. This parameter helps you to bridge
smaller regions with missing contrast information, i.e. image regions
with no structures.

Reconstruction Only visible if Contrast or Variance is selected as Method.


Defines the amount of image area with little contrast that needs to be
reconstructed by an algorithm. If an image contains larger regions
with little or no contrast information, the algorithm has to interpolate
image information at a larger extent.

Decay Flicker Cor- Only visible if Contrast or Variance is selected as Method.


rection Activated: Equalizes the brightness and intensity of pixels over the
entire z-stack. During the acquisition of fluorescence images, bleach-
ing can lead to a difference in pixel brightness, also called decay.
When acquiring an image with a lamp, flickering can lead to fluctua-
tions in pixel intensity. This option tries to correct both effects
through the equalization over the entire stack.

Pixelwise Iteration Only visible if Fast EDF is selected.


Larger values lead to a smoother heightmap. Use the slider to adjust
the desired value.
Default values (depending on the selected preset):
§ Preset = Default: 2
§ Preset = Small Structures: 2
§ Preset = Medium Structures: 3
§ Preset = Large Structures: 3

Depthwise Kernel Only visible if Fast EDF is selected.


Size Larger values lead to a more robust heightmap/image, especially for
areas with low contrast. Should only be used by small depth of focus
step sizes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 176


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Default values (depending on the selected preset):
§ Preset = Default: 1
§ Preset = Small Structures: 0
§ Preset = Medium Structures: 2
§ Preset = Large Structures: 2

Resize Ratio Only visible if Fast EDF is selected.


Sets the scaling factor. Typically, smaller values are faster.
Default Value: 0.25
§ 0.25
§ 0.5
§ 1.0

See also
2 Using Direct Processing [} 230]

3.11.8.11.4 Unsharp Mask

By using this method, you can increase the impression of sharpness in an image and consequently
obtain an image which shows structures with more contrast. The function enhances contrast es-
pecially for smaller structures.

Parameter Description
Strength Enter the strength of the Unsharp Masking using the slider or spin
box/input field. The higher the value selected, the greater the extent
to which small structures are enhanced.

Sigma Adjusts the sigma value derived from Gauss [} 179] filtering. Reduces
noise in an image. Each pixel is replaced by a weighted average of its
neighbors. The neighboring pixels are weighted in accordance with a
two-dimensional Gauss bell curve.

Color Mode Select the desired color mode from the drop-down list.

- RGB Calculates the sharpness for each color channel individually. The color
saturation and the color of structures may be changed, and color
noise may occur.

- Luminance Only calculates the sharpness on the basis of the brightness signal de-
tected. This mode does not show any color noise and changes the
color saturation accordingly.

Threshold Mode Here you can select a setting from the drop-down list for calculating
the boundary between the sharpened image regions.
It is only effective if the value for the Lower Threshold Value pa-
rameter is not equal to 0 or the value for the Upper Threshold
Value parameter is not equal to 100.

- None No adjustment takes place.

- Binary The transition follows the threshold values.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 177


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Linear Calculates a linear course.

Threshold Low Enter the lower threshold value using the slider or spin box/input field.
This determines the lower limit from which existing contrast structures
are changed.

Threshold High Enter the upper threshold value using the slider or spin box/input
field. This prevents structures in the image already featuring high con-
trast from being further enhanced unnecessarily.

Clip To Valid Bits Activated: The value range of the gray/color values of the output im-
age is adjusted to the value range of the input image.

See also
2 General Settings [} 83]
2 Using Direct Processing [} 230]

3.11.8.12 Smooth

3.11.8.12.1 Binomial Filter

This method allows you to reduce noise in an image. Each pixel is replaced by a weighted average
of its neighbors. The weighting factors are calculated from the binomial coefficients in accordance
with the filter size. The binomial filter is very similar to a Gaussian filter in its effect.

Parameter

Parameter Description
Kernel Size Here you can adjust the size of the filter matrix. If the Show All mode
is activated, you can adjust the values in X, Y and Z direction individu-
ally.

3.11.8.12.2 Denoise

This method removes noise from images using wavelet transformations or total variation. The
process of denoising an image with wavelet transformations can be broken down into the follow-
ing three parts:

§ Calculate the wavelet transform of the noisy image.


The wavelet transformation can be calculated by the method Real Wavelets and Complex
Wavelets.
§ Modify the noisy wavelet coefficients.
This is done by using bivariate shrinkage with local variance estimation (thresholding). [Bivari-
ate Shrinkage with Local Variance Estimator, Levent Sendur and Ivan W. Selesnick, IEEE Signal
Processing Letters, Vol. 9, No. 12, December 2002]
§ Compute the inverse transform using the threshold coefficients.

Parameter Description
Method

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 178


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Complex The Dual Tree Complex Wavelet transform provides better results due
wavelets to the fact that it is nearly direction invariant and makes more direc-
tional sub bands available. The results will be less prone to block-arte-
facts. However, this method is computationally more intense and
therefore takes longer.

- Real wavelets The real wavelet transform only considers three sides (XYZ) and is
therefore faster. However, the result can show block artefacts.

- Total variation An algorithm based on A. Chambolle, "An Algorithm for Total Varia-
tion Minimization and Applications", J. Math. Imaging and Vision 20
(1-2): 89-97, 2004.
It uses the L1 norm for optimization. Typically, total variation gener-
ates small plateaus with constant gray values. The size of each of the
small plateaus depends on the Strength setting.

Strength Here you adjust the strength with which the function is applied.

See also
2 Using Direct Processing [} 230]

3.11.8.12.3 Gauss

This method allows you to reduce noise in an image. Each pixel is replaced by a weighted average
of its neighbors. The neighboring pixels are weighted in accordance with a two-dimensional
Gauss bell curve.

Parameter Description
Sigma Here you can adjust the sigma value. If the Show All mode is acti-
vated, you can adjust the values in each dimension individually.

3.11.8.12.4 Lowpass

This method allows you to reduce noise in an image. Each pixel is replaced by the average of its
neighbors. The size of the area of the neighboring pixels considered is defined by a quadratic filter
matrix. The modified pixel is the central pixel of the filter matrix.

Parameter

Parameter Description
Count Enter the number of repetitions using the slider or input field. The
function can be applied several times in succession to the result of the
filtering. This intensifies the effect accordingly.

Parameter Description
Kernel Size Here you can adjust the size of the filter matrix. If the Show All mode
is activated, you can adjust the values in X, Y and Z direction individu-
ally.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 179


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.12.5 Median

This method allows you to reduce noise in an image. Each pixel is replaced by the median of its
neighbors. The size of the area of the neighboring pixels considered is defined by a quadratic filter
matrix. The modified pixel is the central pixel of the filter matrix. The median is the middle value
of the gray values of the pixel and its neighbors sorted in ascending order.

Parameter Description
Kernel Size Here you can adjust the size of the filter matrix. If the Show All mode
is activated, you can adjust the values in X, Y and Z direction individu-
ally.

3.11.8.12.6 Sigma

This method allows you to reduce noise in an image. Each pixel is replaced by the average of its
neighbors. The size of the area of the neighboring pixels considered is defined by a quadratic filter
matrix. The modified pixel is the central pixel of the filter matrix. To calculate the average, only
the gray values that lie within a defined range (+/- sigma) around the gray value of the central
pixel are taken into consideration. As a result, fine object structures are not blurred; only the gray
levels in image regions that belong together are adjusted.

Parameter

Parameter Description
Sigma Enter the sigma value using the slider or input field.

Parameter Description
Kernel Size Here you can adjust the size of the filter matrix. If the Show All mode
is activated, you can adjust the values in X, Y and Z direction individu-
ally.

3.11.8.12.7 Single Pixel Filter

With this function you can remove single pixel phenomena, such as those that occur in the case
of clocking induced charge with EMCCDs and as radio telegraph signal noise with CMOS sensors.
It is a filter which analyzes the input image and removes pixels, whose intensity value diverges
strongly from the median intensity of its neighboring pixels.
The filter analyzes the input image and removes pixels that are "much" larger than the median of
their neighbors. The algorithm works as follows:
1. Sort all 9 pixels in a 3 x 3 neighborhood.
2. Determine the median intensity value of the sorted pixels.
3. Multiply the median by the threshold factor to get the limit.
4. If the center pixel intensity is larger than the limit, replace the pixel with the median.
Larger values of the threshold factor increase the value of the intensity limit and decrease the
number of pixels that are replaced. The default value of 1.5 is arbitrary, but seems to remove
charge induced noise from images acquired using cameras with EM gain capabilities. This filter
can also be used to remove hot pixels from images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 180


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter

Parameter Description
Threshold Here you adjust the threshold value.

3.11.8.12.8 Whitening

Info
Prerequisite
This function is only available if you have installed the 3rd party Python Tools during the in-
stallation of ZEN software.

This method removes "correlated noise components" from an image, resulting in an image with
so-called "white noise", where the noise in every pixel is not correlated with the noise found in
neighboring pixels. Such an ideal noise is also called "White Noise". This function should be used
to pre-process image data that is later used to train an Noise2Void denoising model using the ZEN
Intellesis Denoising. Keep in mind that applying a model trained on "whitened" datasets should be
only applied to "whitened" images.

Parameter Description
Processing Direc- Sets the direction in which the data is processed.
tion

– Horizontal Processes the image in horizontal vectors only.

– Vertical Processes the image in vertical vectors only.

– All Processes the image in all directions.

See also
2 Creating and Training an Intellesis Denoising Model [} 514]
2 Using a Trained Model for Denoising [} 516]

3.11.8.13 Time Series

3.11.8.13.1 Gliding Average

With this function a smoothing effect can be achieved due to averaging out noise. It therefore
calculates the gliding average of a time series image, taking into account the defined number of
time points according to the following schematic:
Input Image: SizeT = 6
Averaging Length: AvL = 3
Output image: SizeT(output) = SizeT – AvL + 1 = 6 -3 +1 = 4

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 181


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter

Parameter Description
Average Length Specifies the number of images used to determine the mean value.
The maximum value correlates with the number of time points.

Scaling Factor The preset value is 1. Values > 1 can be applied for images with low
intensity. In this case all pixel values are multiplied by the specified
factor.

3.11.8.13.2 Kymograph

This method creates a Kymograph. The input image has to be a time series image containing a
line-like graphical element (a line, arrow, curve or polygon curve) which is not locked.

Parameter Description
Graphic Tool Selects the desired graphic tool from the list. All graphic tools that can
be used are visible in the dropdown. Note that the tool must be se-
lected in the image as well.

Width Adjusts the width of the graphic tool (in pixel). This determines which
pixels are used to calculate the average gray value along the width.

3.11.8.13.3 Time Alignment

This method allows you to automatically align individual time points in order to compensate for
shifts between time points.

Info
For the alignment function to work, the presence of immobile and clearly distinguishable ob-
ject structures in the time series is required. Also, when aligning z-stacks over time, you should
always use the z dimension from the Third Dimension drop-down list. Otherwise, each z-
plane would be aligned over time potentially leading to z-stack artefacts.

Parameter Description
Registration Only visible if Load Transformation is deactivated.
Method Selects the method or a combination of methods which is used to
align the images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 182


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Translation The neighboring sections of the image are shifted in relation to each
other in the X and Y direction.

- Rotation The neighboring sections of the image are rotated in relation to each
other.

- Iso Scaling The magnification is adjusted from section to section.

- Skew Scaling The neighboring sections of the image are corrected for skewness/
shearing.

- Affine The neighboring sections of the image are shifted in X and Y direc-
tion, rotated and the magnification is adjusted from section to sec-
tion.

Quality Only visible if Show All is activated and if Load Transformation is


deactivated.
Selects the quality level that you want the function to work with. The
calculation of the alignment is based on a so-called image pyramid.
The higher the selected quality, the more levels of the image pyramid
are used to calculate the alignment and the more precise the align-
ment will be. However, the higher the selected quality is, the slower
the calculation of the alignment will get.

– Low This is the most imprecise but also the fastest calculation of the align-
ment. It uses a low number of levels (2) of the image pyramid for the
alignment calculation.

– Medium This is a more precise but also a slower calculation of the alignment
than the one before. It uses a medium number of levels (3) of the im-
age pyramid for the alignment calculation.

– High This is a more precise but also a slower calculation of the alignment
than the two before. It uses a high number of levels (4) of the image
pyramid for the alignment calculation.

– Highest This is the most precise but also the slowest calculation of the align-
ment. It uses the highest number of levels of the image pyramid for
the alignment calculation.

Interpolation Only visible if Show All is activated.


Selects how the interpolation should be performed if a pixel is calcu-
lated from several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Crop Output Only visible if your image does not contain multiple tiles or scenes.
Activated: The image is cropped and only keeps the section which is
covered by the entire dimension (e.g. by all z-slices or time points).
The output image can be of different size than the input image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 183


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Deactivated: The output image is not cropped and keeps the size of
the input image. The image borders might get filled with a default
pixel value.

Single Component Only visible if you have selected an input image which contains di-
mensional components (e.g. scenes, z-planes, time points) and if this
component is not selected as Third Dimension.
Activated: Displays a control to select the dimensional component
that is used to calculate the alignment transformation matrix.
Deactivated: Calculates an alignment transformation matrix for each
individual component (e.g. for each individual scene).

– Scene Compo- Only visible for images with multiple scenes.


nent Selects the scene that is used to calculate the alignment transforma-
tion matrix.

– Phase Compo- Only visible for images with multiple phases.


nent Selects the phase that is used to calculate the alignment transforma-
tion matrix.

– Channel Com- Only visible for images with multiple channels.


ponent Selects the channel that is used to calculate the alignment transforma-
tion matrix.

– Z Slice Com- Only visible for z-stack images.


ponent Selects the z-slice that is used to calculate the alignment transforma-
tion matrix.

Single Tile Only visible for images with multiple tiles and if Single Component is
activated.
Activated: Displays the Tile Component control.

– Tile Compo- Selects the tile component that is used to calculate the alignment
nent transformation matrix.

See also
2 General Settings [} 83]

3.11.8.13.4 Time Concatenation

Info
If the input images have varying dimensions, the resulting image document can have gaps for
certain dimension coordinates.

This function joins two images to form a new time series image. The function offers an advanced
option for mapping the channels of the two images. This is useful for special situations that might
require manual channel mapping, e.g. if the same dye was used for different channels, or if the
dye name is missing in the image metadata.

Parameter Description
Sort Time Points Activated: Sorts the time points of the resulting image by acquisition
by Acquisition time.
Time Deactivated: Does not sort by acquisition time. Note that in case the

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 184


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
first input image was acquired after the second file, or if both images
overlap in acquisition time, the relative times of some time points in
the output image could be negative.

Define Channel Activated: Allows you to map the channels of the first input image to
Mapping the channels of the second image. If you do not want to map one
particular channel, you also have the option No Mapping. The result-
ing image will have all channels of the first image and all channels
from second image that do not have a mapping.

3.11.8.13.5 Time Differential

This function calculates the first and second order differential of a time lapse image according to
the following formula and schematic:
First Order Differential:
Output[t] = Input[t+1] – Input[t-1]
-> The difference between consecutive pixels is not calculated so that the output is not direc-
tional. The first order differential represents the Speed.
Second Order Differential:
Output[t] = Input[t-1] + Input[t+1] – 2 x Input[t]
-> Second order differential is also known as the "Laplacian" and represents the Acceleration. It
enhances the fine details in the image (including noise). The smoothing kernel helps reduce this
noise.

Parameter

Parameter Description
Derivative Here you can select whether to calculate the first (speed) or second
(acceleration) order differential.

Smoothing Indicates the iterative, binomial smoothing filter. This reduces noise in
the differential images, whilst retaining maximums and minimums.
Value range: 0 – 50

Normalization Defines what to do with negative values resulting from the calcula-
tion.
§ Clip: negative values are set to 0.
§ Absolute: negative values are used positively.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 185


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.13.6 Time Stitching

This function stitches heterogeneous CZI images together to create a new, single homogeneous
time series containing all dimensions and time points in their proper order. This differs from the
Time Concatenate function, which simply pastes one time lapse series to the end of another
without regard for the proper time order or channel content.
Missing images can either be filled with copies of the previous valid image in the series or filled
with black images.
When combining Z-stack time series with non-Z-stack time series a choice can be made between
either using only the center plane of the Z-stack or creating an extended focus projection of the Z-
stack before stitching the images together.

Parameter

Parameter Description
Fill Missing with

- Previous Fills a missing dimension index with a copy of the last existing image
from that index.

- Black Fills a missing dimension index with a black image.

Z-Stacks

- Collapse (EDF) Reduces a z-stack with an extended focus function to a single plane
image which is then added to the output.

- Collapse (Center Only uses the center plane from a z-stack for the output image.
Plane)

- Expand Copies the z-stack to the output unchanged, fills the missing indices
according to the setting in the Fill Missing with dropdown list.

3.11.8.14 Utilities

3.11.8.14.1 Add Channels

This method allows you to combine two input images that have different channels but otherwise
have the same dimension (Z-stack, tile, scene). An image is produced that contains all the chan-
nels of the input images.
If the two input images differ from one another in the dimensions Z-stack, time series, tiles or
scene, input image 1 and input image 2 are copied into the output image as two separate blocks.

3.11.8.14.2 Airyscan Processing

With this method you can access the super-resolution data in images acquired with Airyscan.

Info
Note that starting with ZEN 2.5 blue edition, the black border of the processed image is auto-
matically removed. Hence the resulting image will be smaller by 24 pixels in X and Y dimen-
sion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 186


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameters

Parameter Description
3D Processing This option is only available for images with 5 or more z-positions.
If activated, this option improves the resolution in axial and lateral di-
rection. The data set needs to have at least 5 z-sections acquired with
an optimal step size. 3D Processing is slower than 2D Processing. For
3D Processing, the whole z-stack (single channel and time point)
needs to fit into the physical memory.

2D SR Processing This function is available for 2D images only. It enhances the 2D reso-
lution.
Note this only results in increased superresolution when images are
acquired with optimal settings and sufficient signal.

Auto Filter If activated, a suitable Super Resolution parameter for the Airyscan
processing is automatically determined for the selected data set.
To manually adjust the Super Resolution parameter, deactivate the
checkbox. Then determine suitable values by using the corresponding
function in the Airyscan viewer in the Airyscan view. Note that the
preview is only suitable for 2D Airyscan processing. A preview for 3D
Airyscan processing is not available. For adjusting 3D processing pa-
rameters, you should first process your data set once using the Auto
Filter and then check the value that was actually applied by the
Airyscan processing function. This value is stored in the metadata of
the processed image and can be accessed using the Info view.
Note: High strength might look attractive at some images, Z planes
or color channels, but other filtering artefacts might occur which ap-
pear like small rings in the image. Also, the results will become very
sharp, but grainy. So carefully check your image data in order to avoid
such artefacts.

Adjust per Channel Only visible, when the Auto Filter is deactivated.
Only available for images with two or more Airyscan channels.
If activated, you can manually set channel-specific Airyscan processing
parameters.

Strength Use this option for an increased (high) or decreased (low) strength of
the automatically assigned filter value. This is especially useful for 3D
processing, as the 2D preview of the processing filter value in the
Airyscan viewer does not allow to conclude the result after a 3D data
processing.
The increment of this parameter is ± 0.4 compared to the standard
auto Airyscan processing. This setting is not available when manual
processing strength is selected.

3.11.8.14.3 ApoTome Deconvolution

This method accepts ApoTome raw data only.


It was derived from the Deconvolution module and is available in every licensed version of the
software. It contains settings and parameters which make sense for an ApoTome deconvolution
only.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 187


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter
Find the description of the parameters under: Deconvolution (adjustable) parameters. This method
is available for batch processing as well.

3.11.8.14.4 ApoTome RAW Convert

This method accepts ApoTome raw data only. The settings are similar to the ones on the Apo-
Tome tab (view option for ApoTome images). The function is also available for batch processing,
which makes it easy to convert a series of ApoTome RAW data images into deconvolved images.

Parameter Description
Display Mode ApoTome images are acquired as raw data. The Display Mode sets
how the image is calculated and displayed.

– Optical sec- The displayed output image is calculated/rendered by eliminating the


tioning excitation and emission light that originates in regions outside of the
focal plane.

– Conventional The displayed output image is calculated/rendered like a conventional


fluorescence fluorescence image.

– Raw data Displays the raw data as output image and disables all other parame-
ters of the function.

Correction Applies stripe artifact correction to the resulting image. It attempts to


remove stripe artifacts which may be caused by bleaching of the
sample during acquisition or by slight deviations in the grid phase po-
sition.

– No correction No correction is applied to the image.

– Local Bleach- Corrects the bleaching for each pixel individually (default setting). This
ing is usually the best method.

– Global Bleach- Corrects bleaching by means of global bleaching correction, which is


ing applied equally to the entire image.

– Phase Errors Corrects phase errors in the image without additional bleaching cor-
rection.

– Phase Errors Corrects phase errors in the image with additional global bleaching.
and Global
Bleaching

– Phase Errors Corrects phase errors in the image with additional local bleaching.
and Local
Bleaching

Fourier Filter The Fourier filter attempts to remove residual stripes.

– Off Uses no Fourier filter to remove stripes.

– Weak Uses a weak Fourier filter to remove stripes.

– Medium Uses a medium Fourier filter to remove stripes.

– Strong Uses a strong Fourier filter to remove stripes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 188


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Normalization Here you can select how the gray/color values that exceed or fall
short of the value range should be dealt with. If you use this method
with Direct Processing, only the Clip method is available and prese-
lected.

– Clip Automatically sets the gray levels that exceed or fall short of the pre-
defined gray value range to the lowest or highest gray value (black or
white). The effect corresponds to underexposure or overexposure. In
certain circumstances some information may therefore be lost.

– Automatic Normalizes the gray values automatically to the available gray value
range.

See also
2 Using Direct Processing [} 230]
2 Apotome Tab [} 1046]

3.11.8.14.5 Calculate Histogram

This method calculates a histogram distribution for selected measurement parameters of a mea-
surement data table.

Parameters

Parameter Description
Columns Define the measurement parameters for classification by entering the
column numbers freely, e.g. 1,3,5, or 1-6 or 1,3-7,8.
Clicking on the button to open the Select columns dialog. Here
the column names of the data can be activated or deactivated by
clicking on the relevant checkbox.

Class Boundaries Select here, how you want the class boundaries of the calculated his-
togram to be determined.

- >=,…,< A numerical value falls into the histogram class if it is greater than or
equal to the lower class boundary and less than the upper class
boundary.

- >,…,=< A numerical value falls into the histogram class if it is greater than the
lower class boundary and less than or equal to the upper class bound-
ary.

Automatic Classifi- Activated: The class boundaries are calculated automatically from the
cation data. The value range from the lowest to the highest data value is di-
vided into as many classes of equal width as you have set in the Class
Number input field.
Example:
Minimum value is 0
Maximum value is 10000
Range is 10000 units
Class Count is 4
Then the class boundaries are as follows:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 189


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Class 1: 0 .. 2500
Class 2: 2501 .. 5000
Class 3: 5001 .. 7500
Class 4: 7501 .. 10000

Logarithmic Only active, if the Automatic Classification checkbox is activated.


Activated: The class boundaries are scaled logarithmic.
Example:
Minimum value is 0
Maximum value is 10000
Range is 10000 units
Number of classes is 4
Then the class boundaries are as follows:
Class 1: 0 .. 10
Class 2: 11 .. 100
Class 3: 101 .. 1000
Class 4: 1001 .. 10000

Class Count Specifies the number of classes that shall be created.

Display Mode Select here, how you want the values of the histogram to be calcu-
lated.

- Count The histogram indicates how many data sets fall into the relevant
class, it contains the frequency of the values in the class concerned.

- Count Cumu- The histogram cumulates the counts of values in each class. Class 1
lative contains the number of values for class 1, class 2 contains the sum of
the values from class 1 and class 2, class 3 contains the sum of the
values from class 2 and class 3, etc.

- Percentage The histogram indicates what percentage of the data sets fall into the
relevant class, it therefore contains the percentage share of the values
in the class concerned.

- Percentage The histogram cumulates the percentage of the count of values in


Cumulative each class. Class 1 contains the percentage for class 1, class 2 con-
tains the sum of the percentages from class 1 and class 2, class 3 con-
tains the sum of the percentages from class 2 and class 3, etc.
The last class therefore contains 100%.

- Sum The histogram contains the sum of the numerical values of the data
sets that fall into the relevant class, the values of the data sets that fall
into the class concerned are therefore added together.

- Sum Cumula- The histogram cumulates the sums of the values in each class. Class 1
tive contains the sum of the numerical values from class 1, class 2 con-
tains the sum of the numerical values from class 1 and class 2, class 3
contains the sum of the numerical values from class 2 and class 3, etc.
The last class therefore contains the sum of all individual values.

- Percentage The histogram indicates the percentage share of the total numerical
Sum values in the relevant class.

- Percentage The histogram cumulates the percentage of the sums of values of all
Sum Cumula- data points which belong to the class. Class 1 contains the percentage
tive of the total numerical values from class 1, class 2 contains the sum of

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 190


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
the percentages of the total numerical values from class 1 and class 2,
class 3 contains the sum of the percentages of the total numerical val-
ues from class 2 and class 3, etc.
The last class therefore contains 100%.

3.11.8.14.6 Change Pixel Type

This method allows you to change the pixel type of an image. This can be useful if you want to
compare or combine images that have different pixel types.

Parameters

Parameter Description
Pixel Format Select the desired pixel format from the dropdown list.

- 8 Bit B/W The output image is a monochrome image, the whole-number gray
values of which can lie in the range from 0 to 255.

- 16 Bit B/W The output image is a monochrome image, the whole-number gray
values of which can lie in the range from 0 to 65535.

- 32 Bit B/W Float The output image is a monochrome image with real numbers as pixel
values.

- 2x32 Bit Com- The output image is a monochrome image with complex numbers
plex (real part and imaginary part) as pixel values. Such images are gener-
ally created by means of transformation into the Fourier space.

- 24 Bit RGB The output image is a color image, the whole-number color values of
which in the red, green, and blue channels can lie in the range from 0
to 255.

- 48 Bit RGB The output image is a color image, the whole-number color values of
which in the red, green, and blue channels can lie in the range from 0
to 65535.

- 2x32 Bit RGB The output image is a color image with real numbers as color values
Float in the red, green and blue channels.

- 3x64 Bit RGB The output image is a color image with complex numbers (real part
Complex and imaginary part) in the red, green and blue channels. Such images
are generally created by means of transformation into the Fourier
space.

3.11.8.14.7 Combine RGB

With this method a color image can be generated out of three input images of the single color ex-
tractions Red, Green and Blue.

Parameters

Parameter Description
Output Pixel type Here you choose the desired output image format, e.g. 24 Bit RGB.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 191


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.14.8 Convert To Lambda

With this function you can convert Lambda stacks which were acquired with LSM 800 into a file
with the same appearance as inside the Lambda view. In contrast to the generic raw data format
of the Lambda stacks, these files can be opened and analyzed normally in ZEN (black edition).

3.11.8.14.9 Copy Annotations

This method copies the annotations of one image into another image.

3.11.8.14.10 Copy Image

This method creates a copy of an image.

3.11.8.14.11 Correct Stage Jitter

This method automatically corrects the jitter of the stage which can occur during the acquisition
of a Z-stack image.

3.11.8.14.12 Correlation

With this function you can, in conjunction with confocal data sets, display the spatial or temporal
correlation of an image or image stack. You can select which kind of correlation you want to per-
form by activating the corresponding checkboxes.

Parameters

Parameter Description
Cross Correlation If activated, you can correlate two images with each other. Note that
the second input image needs to have the same dimensionality and
size.

X, Y Correlates the signal in the X or Y direction.

Z Correlates the signal in Z. Only available for data sets containing Z-


sections.

Time Correlates the signal in time. Only available for time series data sets.

3.11.8.14.13 Create Gray Scale Image

This method allows you to create a gray scale image.

Parameters

Parameter Description
Pattern Select the desired pattern for the gray scale image here.

- Uniform All pixels have an identical gray/color value.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 192


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- 2D Gray Scale The gray scale runs from top to bottom, starting with the gray value
Vertical selected in parameter Min. Gray Value.

- 2D Gray Scale The gray scale runs from left to right, starting with the gray value se-
Horizontal lected in parameter Min. Gray Value.

Width Set the desired width of the output image in pixels using the slider or
the input field.

Height Set the desired height of the output image in pixels using the slider or
the input field.

Min. Gray Value Set the minimum gray value of the gray scale using the slider or input
field.

Max. Gray Value Set the maximum gray value of the gray scale using the slider or input
field.

Pixel Type Select the desired pixel type here.

- 8 Bit B/W The output image is a monochrome image whose integer gray values
can be in the range of 0 to 255.

- 16 Bit B/W The output image is a monochrome image whose integer gray values
can be in the range of 0 to 65535.

- 24 Bit RGB The output image is a color image whose integer color values in the
channels Red, Green, Blue can be in the range of 0 to 255.

- 48 Bit RGB The output image is a color image, with integer color values in the
color channels Red, Green, Blue can be in the range of 0 to 65535.

3.11.8.14.14 Create Image Subset

This method allows you to extract parts from one image and use these to create a new image.
You can select these parts freely from the individual dimensions of the image. Each of the param-
eter sections is only visible if the corresponding dimension is present in the input image.

Info
Image Analysis Results
Note that if your image contains analysis results, the analysis results are deleted when you exe-
cute this function.

Parameter Description
Channels Selects which channels of the input image are used. All channels are
selected by default. To deselect a channel, click on the respective
channel button.

Z-Position, Time, Here you can select which parts of the input image you want to use
Block, Scene for the resulting image.

- Extract All If selected, all parts of the corresponding image are extracted.

- Extract Single If selected, you can select a single image to be extracted.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 193


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- Extract Range If selected, you can select a certain range of images to be extracted.

- Extract Multi- If selected, you can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section 10, followed by sections 14 to 18, as well as
sections 20 and 23.

- Get current Adopts the position from the current display in the image area.
position

- Interval Activated: Interval mode is active. The Interval spin box/input field
appears.
Enter the desired interval here. E.g. if you enter the value 2 only every
2nd value from the range is considered.

Region Here you can select if you want to use the entire image or just a re-
gion (ROI) of the input image.

- Full Select this option to use the full image for the new image.

- Rectangle re- Select this option to draw in a rectangle region of interest, which will
gion (ROI) be used for creating a new image.
If a rectangle region was drawn in, you can see and change its coordi-
nates by editing the X/Y/W/H input fields.

- Keep tiles Only has an effect, if a region (ROI) is defined.


Activated: Extracts the drawn in region including the complete tiles.
This setting is recommended when you want to apply DCV processing
functions on the resulting image.

3.11.8.14.15 Create Image Subset and Split

This method allows you to extract certain dimensions, e.g. channels, regions or time series from
one image and use these to create a new image.

Info
Each of the dimensions described below is only visible if the corresponding dimension is
present in the input image.

Method Parameters

Parameter Description
Split Dimension Depends on the loaded image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 194


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
- None The image is not split by any dimension. Only the ranges of the differ-
ent dimensions defined below will be extracted for the new image.

- Channels (or: Here you can select the dimension for splitting the data set. A new
Time, Scenes image document opens in ZEN for each element of the selected di-
etc.) mension. The available options depend on the selected image. If your
input image contains two channels, split dimension creates two out-
put images, for each channel one.

Channels Here you can select which channels of the input image you want to
be used. All channels are selected by default. To deselect a channel,
click on the respective channel button.

Time (or: Z-Posi-


tion, Rotation,
Scene, Illumina-
tion, Acquisition
block, Mosaic tile,
Phase, View)

- Extract All Activated: All elements of the corresponding dimension are ex-
tracted.

- Extract Single Activated: You can select a single element to be extracted.

- Extract Range Activated: You can select a certain range of elements to be ex-
tracted.

- Extract Multi- Activated: You can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section10, followed by sections 14 to 18, as well as
sections 20 and 23.

Region

- Full Takes the full region into account.

- Rectangle Re- Takes the rectangle into account that you can draw in the 2D view.
gion After drawing you can modify X, Y coordinates as well as width (W)
and height (H) manually.

Keep tiles Has only an effect, if a region (ROI) is defined.


Activated: Extracts the drawn in region including the complete tiles.
This setting is recommended when you want to apply DCV processing
functions on the resulting image.
Deactivated: Drawn ROI will cut through mosaic tiles.

Propagate ROI Has only an effect, if a region (ROI) is defined in multi-scene images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 195


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Activated: Applies the defined region (ROI) to all scenes.

For more information, see Creating Image Subset and Split Dimensions [} 81].

3.11.8.14.16 Create Image Subset and Split (Write files)

This method allows you to extract certain dimensions, e.g. channels, regions or time series from
one image and use these extracted dimensions to create a new image. The result file is saved in
your target folder.

Info
Each of the dimensions described below is only visible if the corresponding dimension is
present in the input image.

Method Parameters

Parameter Description
Split Dimension Depends on the loaded image.

- None The image is not split by any dimension. Only the ranges of the differ-
ent dimensions defined below will be extracted for the new image.

- Channels (or: Here you can select the dimension for splitting the data set. A new file
Time, Scenes, will be created in the target folder for each element of the selected di-
etc.) mension. The available options depend on the selected image. If your
input image contains two channels, split dimension creates two out-
put images for each channel.

Channels Here you can select which channels of the input image you want to
be used. All channels are selected by default. To deselect a channel,
click on the respective channel button.

Time (or: Z-Posi-


tion, Rotation,
Scene, Illumina-
tion, Acquisition
block, Mosaic tile,
Phase, View)

- Extract All Activated: All elements of the corresponding dimension are ex-
tracted.

- Extract Single Activated: You can select a single element to be extracted.

- Extract Range Activated: You can select a certain range of elements to be ex-
tracted.

- Extract Multi- Activated: You can select several continuous ranges and individual
ple sections.
Enter one or more sections that you want to select in the input field.
To do this, enter the first section, followed by a minus sign, and then
the last section. If you want to define an interval, after the last section
enter a colon and then the interval. The entry "2-10:2" means that ev-
ery second section is selected from section 2 to section 10.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 196


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Enter a comma after the first section if you want to define another
section. You can also select individual sections separated by commas.
By entering "2-10:2,14-18,20,23", you select every second section
from section 2 to section10, followed by sections 14 to 18, as well as
sections 20 and 23.

Region

- Full Takes the full region into account.

- Rectangle Re- Takes the rectangle into account that you can draw in the 2D view.
gion After drawing you can modify X, Y coordinates as well as width (W)
and height (H) manually.

Keep tiles Has only an effect, if a region (ROI) is defined.


Activated: Extracts the drawn in region including the complete tiles.
This setting is recommended when you want to apply DCV processing
functions on the resulting image.
Deactivated: Drawn ROI will cut through mosaic tiles.

Propagate ROI Has only an effect, if a region (ROI) is defined in multi-scene images.
Activated: Applies the defined region (ROI) to all scenes.

Target Folder Selects the folder on the disk where the images are to be saved.

Overwrite existing Overwrites image files.


files

Compression

- Original The output image has the same compression as the original image.

- Compression JPEG XR compression is applied to the output images.

Defaults Sets the values back to default, if they have been changed.

For more information, see Creating Image Subset and Split Dimensions [} 81].

3.11.8.14.17 Create PSF

For creating experimental point spread functions from a Z-stack of subresolution fluorescent
beads please use the function PSF Wizard which is available together with the Deconvolution
module and offers a guided procedure starting with a stack of many beads and includes the Cre-
ate PSF functionality.
Prerequisite for the Create PSF function here is, that bead averaging has already been done. It is
available only for legacy reasons.
This function creates a PSF (Point Spread Function) image from a Z-stack image of a bead ac-
quired for PSF measurement. Please observe the instructions for optimal acquisition here: Using
beads for PSF measurement.
The result is a so-called PSF image. For advanced settings and options, please use the specific con-
trol elements on the PSF Display [} 1049] tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 197


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameters

Parameter Description
Z-Stack Correction Activated: Performs background correction of the Z-stack before the
processing.

Circular Average Activated: Forces a PSF with lateral symmetry. This option should not
usually be activated as lateral asymmetries correspond better to the
real situation. Circular averaging is only recommended when a mea-
sured PSF is used with the Fast Iterative method.

Threshold Crop- Activated: The PSF is restricted to gray value ranges up to 0.25% of
ping the brightest voxel present. If the value is reduced or the option is de-
activated, the PSF may be larger. This increases the calculation time.
However, it is also possible to achieve slightly better results in this
case. This option is deactivated by default.

Threshold By using this slider and input field, you can set the percentage from
which the PSF is clipped if the Volume Clipping option has been se-
lected.

Iterative Restora- Activated: If Z-stack images of beads with diameters greater than the
tion microscope's resolution limit are used to generate the PSF, this option
must be selected. The bead diameter used can be entered using the
slider and input field.

3.11.8.14.18 Fuse Image Subset

This method allows you to insert an image subset back into the original image. Its contents are re-
placed by the contents of the image subset. Using this method, you can process a previously cre-
ated image subset using image processing functions and copy the result back into the original im-
age.

Parameter Description
In Place Activated: The changes are applied to the original image and no new
image document is opened as output.
Deactivated: The way the changes are applied is defined by the Out-
put tool.

Subset Contains the description of how the input image was created as a
subset.
Shows which areas have been selected in generating the subset im-
age for each dimension (channels, Z-stack, time series), as well as for
the defined image section.
Example:
The entry "Z (1-8: 2) | T (2-7)" means that the sub-image consists of
sections 1,3,5,7 at the intervals of 2 to 7 of the input image.

See also
2 Output Tool [} 984]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 198


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.14.19 Generate Image Pyramid

This method allows you create an image pyramid and to create a pixel mask for valid pixels in
multi scene tile images, especially pyramid tiles. The pixel mask provides information (per sub-
block) for each pixel whether it contains real data or not. If pyramid tiles cover areas which do not
overlay with the acquisition tiles, the pixels of these areas are classified as invalid. The creation of
such a pixel mask can prevent potentially false results for operations done to/with the tile images.
As an example, visual artifacts when viewing the tiles could be reduced or eliminated (invalid pix-
els rendered transparent in the image view) and the calculation of the histogram could be im-
proved. The pyramid calculation never changes the values of the acquisition tiles, so raw data re-
mains untouched.

Option Description
Background Specifies which value is assigned to invalid pixels. Note that this back-
ground color is not visible in the viewer such as the 2D view, it is
merely a value for the invalid pixels.

– Auto Sets the value for the invalid pixels automatically based on the docu-
ment type, i.e. white for brightfield images and black for fluorescence
images.

– Black Sets the value for the invalid pixels to black.

– White Sets the value for the invalid pixels to white.

Create Mask Activated: Creates a pixel mask for valid pixels.


Deactivated: Creates no pixel mask and there is no way to distin-
guish between valid and invalid pixels, i.e. pixels which contain real
data or not. Operations using the (pyramid) tiles could deliver erro-
neous results (such as visual artifacts in the viewer).

Downsampling Fil- Selects a filter which is applied when generating the pyramid steps.
ter

– None No filtering is applied.

– Blur Applies a 2x2 blur kernel before decimation (i.e. an average is calcu-
lated).

– Binomial 3x3 Applies a binomial 3x3 filter before decimation.

– Binomial 5x5 Applies a binomial 5x5 filter before decimation.

3.11.8.14.20 Image Calculator

This method allows you to apply arithmetic operations to images in the form of a calculator.
You can process a single image or combine two images.
All operations are performed pixel by pixel.

Parameters

Parameter Description
Channel Input 1 Here you can select whether you want to use an individual channel or
all channels of the first input image for the calculation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 199


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Channel Input 2 Here you can select whether you want to use an individual channel or
all channels of the second input image for the calculation.

First Images Activated: For the second input image uses only the first time points
of a time lapse image for the calculation. This allows you, for exam-
ple, to normalize a time lapse image to the intensity values of the first
time points.
Enter the number of images that you want to be used for the calcula-
tion using the input field.

Formula Enter the calculation formula here using the keyboard and numeric
keypad. Use "S1" as a placeholder for the first input image and "S2"
for the second input image.

Input 1 Inserts the placeholder for the first input image into the Formula in-
put field at the current cursor position.

Input 2 Inserts the placeholder for the second input image into the Formula
input field at the current cursor position.

Absolute Intensi- Activate this radio button if input image 1 and input image 2 have the
ties same pixel type.

Normalize Intensi- Activate this radio button if input image 1 and input image 2 have dif-
ties 0..1 ferent pixel types. To allow such images to be combined, the intensity
values of the two images are normalized to the value range from 0 to
1 before the calculation.

Operators... Opens a list of all available operators. Here you can select the opera-
tor that you want. If you double-click on a list entry, it is inserted into
the Formula input field at the current cursor position.

Delete Deletes the contents of the Formula input field.

Undo Undoes the last entry in the Formula input field.

3.11.8.14.21 Image Generator

This function creates a synthetic image where the dimensions can be defined.

Parameter Description
Width Width in x of the image.

Height Height in y of the image.

Z Slices Number of z slices of the image. If the value is > 1, it will become a Z-
stack image.

Channels Number of channels of the image, if value is > 1, it will become a


multi-channel image.

Time Slices Number of time slices, if value is > 1, it will become a time series im-
age.

Min. Gray Value Minimum Gray Value for generation.

Max Gray Value Maximum Gray Value for generation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 200


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Pixel Type Specifies the pixel type of the image.

Pattern

- Uniform All pixels of the image have identical Min. Gray Value.

- 2D Gray Scale The image shows a gray scale with values between Min. Gray Value
Vertical and Max. Gray Value from top to bottom.

- 2D Gray Scale The image shows a gray scale with values between Min. Gray Value
Horizontal and Max. Gray Value from left to right.

- Ramp The image shows a ramp with values between Min. Gray Value and
Max. Gray Value starting from each corner of the image to the cen-
ter.

- Gaussian The image shows a Gaussian shaped grayscale with values between
Min. Gray Value and Max. Gray Value starting from the borders of
the image to the center.

- Checkerboard The image shows a checkerboard where the “dark” fields have Min.
Gray Value and the “bright” fields have Max. Gray Value.

- Cosine Checker- The image shows a checkerboard where the “dark” fields have Min.
board Gray Value and the “bright” fields have Max. Gray Value overlaid
with a cosine modulation.

- Chirp Cosine The image shows a cosine pattern where the “dark” fields have Min.
Gray Value and the “bright” fields have Max. Gray Value overlaid
with a chirp modulation.

- Chirp Checker The image shows a checkerboard where the “dark” fields have Min.
Gray Value and the “bright” fields have Max. Gray Value overlaid
with a chirp modulation.

- Random a 3D (Z stack) image is created which contains Number of Spheres


Spheres spheres with Sphere Diameter diameter which are randomly distrib-
uted in the image.

- Sphere Array a 3D (Z stack) image is created which contains Number of Spheres


spheres with Sphere Diameter diameter which are equally distrib-
uted in the image.

- Single Sphere a 3D (Z stack) image is created which contains a single sphere with
Sphere Diameter diameter which is positioned in the center of the
image.

Sphere Diameter Diameter of the created spheres.

Number of Number of spheres which are generated in the 3D image.


Spheres

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 201


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.14.22 Linear Unmixing

Info
Linear Unmixing in Direct Processing
If you are using Linear Unmixing in Direct Processing, Automatic Component Extraction (ACE)
is not available as the image is not yet created when Direct Processing is set up. It offers only
the functionality to import and use reference spectra. You can import reference spectra (Im-
port from) and use the functionality to Calculate Residuals.

With this function you can extract the emission of single fluorescence dyes (e.g. GFP only, YFP
only etc.) from strongly overlapping multi-fluorescence data acquired in multi-channel images or
Lambda stacks (only available in LSM imaging mode). Note that the functions needs (at least) two
fluorescence channels in the input image.
With the knowledge of the spectral characteristic of individual dyes within a sample with multiple
dyes, even heavily overlapping individual dye spectra can be mathematically extracted. This
method is a pixel-by-pixel image analysis procedure. Ideally, fluorescence spectra of samples la-
beled with one dye only are acquired and stored in the spectra database as an external reference.
This can be done either by employing the spectral detector of a LSM system or by setting up a
multichannel experiment on filter based multichannel systems. Then a multi-channel image or
Lambda stack from the multi-labeled sample is acquired. The individual dye spectra are then
mathematically extracted using the information from the reference spectra. Up to ten different
reference signals can be used in the least-square-fit based algorithm to produce a 10-channel out-
put image without any partial overlap between the channels.
Avoid detector saturation of fluorescence signal in the data set to be unmixed. Saturation gener-
ates a high signal in the residual channel and will have a negative impact on the unmixing result.
If samples are not available labeled with individual dyes only, the references can be obtained by
the following methods:

§ Interactively by user-selection of regions in the image where only one fluorescence dye is
present (only available in the Unmixing view).
§ Automatically by Automatic Component Extraction (ACE). Here the software tries to identify
pixels in the acquired multichannel image whose intensity results from an individual dye only.
Note that ACE does not work in all cases and linear unmixing can then lead to wrong results. This
is especially the case when unmixing widefield multichannel fluorescence images, where there
might not be areas which have sufficiently pure single dye contribution. Here it is especially impor-
tant to acquire single-dye reference spectra first.

Parameter Description
Import Reference For the unmixing process previously generated emission spectra of
Spectra ideally pure dyes can be loaded and used for unmixing. This function
is mutually exclusive to the Automatic Component Extraction func-
tion.

– Import from Allows you to select and import reference spectra by clicking on
.

– Spectra List Displays the list of imported spectra with an ID, the File Name and
the Channel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 202


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Automatic Compo- Use this function if no reference spectra are available. Indicates the
nent Extraction number of components the system should be looking for in the im-
age. The number of components cannot be higher than the number
of channels. It will only work if each of the emission signals is present
in an area of the image without overlap of another emission signal.
Otherwise, ACE cannot produce a reliable result.

Components Adjust the number of spectrally distinguishable fluorescent compo-


nents within the imaged sample. The number of extractable compo-
nents cannot be higher than the number of acquired channels. The
maximum possible value is 10 components.

Weighted Unmix- If activated, spectral channels with high noise contribute less to the
ing unmixing result. This option includes a statistical analysis of the signal-
related (Poisson-) noise and weighs the respective contribution for the
fitting with the combination of reference spectra to the experimental
data.
Note: This option involves a more sophisticated unmixing algorithm
and therefore takes longer than the basic unmixing analysis.
Weighted unmixing generates improved unmixing results when acqui-
sition channels are not so well balanced but still have a good signal-
to-noise ratio.

Autoscale Activated: Balances the intensity of the unmixed channels to equal


levels.

Calculate Residuals Activated: Generates an additional channel in which the intensity val-
ues represent the difference between the acquired spectral data and
the fitted linear combination of the reference spectra. In essence, the
residual value is the biggest remaining "residual" from the least
square fit routine. The residuals are a general measure for how good
the fit of the algorithm has performed. The higher the intensity in this
additional channel, the worse is the fit of the spectra to the data set.

Widefield This option allows Unmixing to be performed on multichannel fluores-


Crosstalk Removal cence images created without a spectral detector. Typically, this
would be multichannel images acquired with a filter based multichan-
nel microscope system. In this case, the function will automatically
create the same number and type of channels present in the input im-
age for the output image of the Unmixing function.
Activated: Removes the crosstalk of widefield channels and ensures
that the channel information (emission and excitation wavelength)
and metadata of the input image are copied to the output image.
Note that the number of spectra must be equal to the number of
channels in the image. The function tries to automatically identify
which channel matches which spectrum. If this fails, the function as-
sumes that the order of spectra matches the sequence of the chan-
nels.

See also
2 Using Direct Processing [} 230]
2 General Settings [} 83]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 203


3 Basic Concepts | 3.11 Image Processing ZEISS

3.11.8.14.23 Split into RGB

This method generates the individual color extractions for red, green, and blue from the RGB in-
put image. The resulting images for red, green, and blue take the form of gray images.

Parameters

Parameter Description
Output Pixel type Here you choose the desired output image format, e.g. 8 Bit B/W.

3.11.8.14.24 Split Multiblock Image

This method saves the single blocks/dimensions (Tiles or Positions) of a multiblock image (i.e. im-
age of an inhomogeneous experiment) in a folder in .CZI format.

Parameter

Parameter Description
Split Mode Choose the mode how to split the multiblock image.

- Homogeneous Splits the multiblock image into the single dimensions. The blocks will
groups remain.

- Single blocks Splits the multiblock image into single blocks.

Display field The path of the destination folder is displayed automatically in the dis-
play field. To change the folder, click on the button to the right
of the display field.

3.11.8.14.25 Split Scenes

This method separates scenes from a tiles or positions image. The individual images are displayed
in the Center Screen Area. Note that the images in this method, in contrast to the method Split
Scenes (Write Files), are not automatically stored in a folder.

3.11.8.14.26 Split Scenes (Write files)

This method saves the single scenes (tiles or positions) of a multi-scene image as single images in
a folder in CZI format.

Parameter

Parameter Description
Output Folder Displays and sets the path of the output folder. To change the folder,
click on the right of the input field.

Include Scene In- Activated: Includes the scene information in the file name of the sep-
formation in Gen- arate image.
erated File Name

Overwrite existing Activated: All files in the target folder are deleted if the function is
files applied again.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 204


3 Basic Concepts | 3.11 Image Processing ZEISS

Parameter Description
Compression Selects the type of compression, e.g. Original (no compression) or
Compression (JPEG XR).

3.11.8.14.27 VivaTome RAW Convert

3.11.8.14.28 Airyscan Sheppard Sum

This method exports your Airyscan data in a 1ch Sheppard sum format. This export does not
change the Airyscan data format, but generates an additional data file with just one summed up
channel of the Airyscan. Since no filtering or deconvolution is performed, this data format is com-
patible with many third party or self programed deconvolution or machine learning super-resolu-
tion methods.

See also
2 Exporting Data in 1ch Sheppard Sum Format [} 721]
2 Airyscan RAW Data [} 721]

3.11.8.14.29 LSM Plus Processing

Parameter Description
Auto Filter Activated: A suitable Super Resolution parameter for the LSM Plus
processing is automatically determined for the selected data set.
Deactivated: Displays the Super Resolution slider and input field.

Super Resolution Only visible if Auto Filter is deactivated.


Sets the parameter for super resolution manually.

Strength Only visible if Auto Filter is activated.


Sets the strength of the automatically assigned filter value for super
resolution.

– Low Uses a decreased strength for the automatically determined value.

– Standard Uses the standard strength for the automatically determined value.

– High Uses an increased strength for the automatically determined value.

See also
2 Using Direct Processing [} 230]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 205


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

4 Basic Functionality
The following functionalities are included in the base software:

§ arivis Cloud (on-site) Basic [} 206]


§ arivis Cloud (on-site) Advanced [} 206]
§ Data Storage Client [} 269]
§ Direct Processing [} 219]
§ Manual Extended Focus [} 244]
§ Extended Focus Processing [} 244] (only for ZEN desk)
§ Measurement [} 248]
§ Panorama [} 255]
§ Colocalization [} 214]
§ Third Party Import [} 269] (only for ZEN desk)

4.1 arivis Cloud (on-site)

This module enables you to execute modules from arivis Cloud. arivis Cloud is an online platform
to create customized workflows for image processing tasks of your microscopy images, see
https://www.arivis.cloud/home/. The functionality provides the execution of certain demo mod-
ules as well as individual arivis Cloud modules.

4.1.1 Preliminary Work & Prerequisites

The following prerequisites need to be fulfilled to use arivis Cloud (on-site):

§ Create an arivis Cloud Account


In order to use the functionality and download the arivis Cloud modules, you need an account
on the platform. Go to https://www.arivis.cloud/home/ to sign up.
§ Install Docker
To be able to use your arivis Cloud modules locally on your machine, you have to install and
run the software called Docker Desktop. For more information, see Requirements for Docker
Desktop [} 1313].
§ Set up a remote Linux machine (Ubuntu)
If you want to execute the arivis Cloud modules on a remote computer, you have to set it up.
Currently only Ubuntu Linux machines running Docker are supported for the remote execu-
tion. For information on how to set up such a computer, ask your local IT administration/de-
partment.
§ Create a shared folder
If you want to execute the arivis Cloud modules on a remote computer, you additionally have
to create a folder to which both computers have access to over the network.

4.1.2 Creating and Entering an Access Token

To be able to connect ZEN with arivis Cloud, you need an access token. Take the following steps
to create the token and enter it in ZEN.

Prerequisite ü Your PC has a connection to the internet and you are signed in on arivis Cloud.
ü You have started ZEN.
1. Click Tools > Options > arivis Cloud.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 206


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

2. Click the link above the input field (https://www.arivis.cloud/app/user/client-keys).


à In your browser, the page for your personal access tokens opens.
3. Click New Access Token to create a new access token.
4. In the New Access Token window, enter a name, an expiration date, and select the de-
sired access scopes for the token.
5. Click Next.
à Your personal access token is created and displayed.
6. Copy your Personal token. Optionally, you can also consider storing the key in a secure lo-
cation in case it needs to be recovered.
7. Go back to ZEN to Tools > Options > arivis Cloud and paste the token into the input
field.
8. Under Default Execution Location, click .
9. Select a location where the module is executed on your computer and your results are
saved and click OK.
10. Click OK to apply the settings and close the dialog.
You have now created and entered an access token. You can now use arivis Cloud functionality in
ZEN.

See also
2 arivis Cloud Tab [} 846]

4.1.3 Setting Up the Remote Module Execution

Info
Ubuntu Distribution Required
If you want to execute your arivis cloud modules on a remote Linux machine, this remote ma-
chine needs to run an Ubuntu distribution.

If you want to execute the arivis Cloud modules on a remote Linux machine, you have to connect
ZEN to this computer.

Prerequisite ü Your PC is connected to the network with the remote computer.


ü You have set up a folder to which both PCs have access.
1. Go to Tools > Options > arivis Cloud.
2. In the Select Execution Mode dopdown, select Use Remote Docker Host.
3. For Remote Docker Host API Address enter the address and port number of the remote
computer.
4. Click Check Connection.
à ZEN contacts the remote computer with the given address and displays a green check-
marks if the connection was successful. Otherwise a red x is displayed and you have to
correct the address and/or port information for the remote computer.
5. If your remote computer requires an authentication, select it from the Select Authentica-
tion Mode dropdown and provide the required credentials (username and password or a
certificate, depending on the selected mode).
6. Map the folder path for the execution of the module and saving of results on your local
computer to the path of the same folder on the remote computer. For detailed information,
see Creating a Path Mapping [} 208].
7. If you want to save the settings, click Export Remote Settings, select the location in the
file browser, and click Save.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 207


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

8. Click OK to save the setup and close the dialog.


You have successfully set up the remote execution. Your modules are now executed on the se-
lected remote computer, see also Executing arivis Cloud Modules in ZEN [} 209].

See also
2 arivis Cloud Tab [} 846]

4.1.4 Creating a Path Mapping

To execute an arivis Cloud module on your remote computer, you have to have a folder to which
both PCs have access to. You then have to tell ZEN which folder it is and what the corresponding
directory for this very same folder looks like for the remote computer. Since currently only Linux
machines can be used for the remote task, the file systems on both PCs are different and the
folder paths need to be mapped to one another.

Prerequisite ü You have set up a folder to which both PCs have access.
ü You are in Tools > Options > arivis Cloud.
ü In the Select Execution Mode dropdown, Use Remote Docker Host is selected.

1. In the Local To Remote File System Mapping section, click .


à The Edit Mapping dialog opens.

2. For Local Computer Path, click .


à A file browser opens.
3. Select the shared folder to which both PCs have access to and click OK.
4. For Remote Computer Path, enter the path to the same folder on the remote computer.
If you do not know the directory path, contact your IT department or person who set up
the remote computer.
5. Click Check Mapping to see if the two directories are correctly pointing to the same
folder.
à ZEN contacts the remote computer with the given address and displays a green check-
marks and corresponding message if the connection was successful. Otherwise, a red x is
displayed and you have to correct the path mapping.
6. Click OK.
You have successfully mapped the folder path of your local computer to the one on the remote
computer. You can now (continue to) set up the remote execution, see Setting Up the Remote
Module Execution [} 207].

See also
2 Edit Mapping Dialog [} 848]

4.1.5 Downloading an arivis Cloud Module

Prerequisite ü You have done all the preliminary work and created an access token, see Creating and Enter-
ing an Access Token [} 206].
ü Your PC is connected to the internet and you have started ZEN.
ü Docker Desktop is installed and running on your machine, see Preliminary Work & Prerequi-
sites [} 206] and Requirements for Docker Desktop [} 1313].
1. On the Applications tab, open the Module Manager tool.
2. Click Download Modules from arivis Cloud.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 208


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

à A browser window opens.


3. In the browser window, select the module(s) you want to download and click OK.
à The download of the module(s) starts.
After a successful download, the module is displayed in the Module Manager tool. It can now
be used in ZEN.

See also
2 Module Manager Tool [} 211]
2 arivis Cloud (on-site) [} 206]

4.1.6 Executing arivis Cloud Modules in ZEN

Prerequisite ü You have downloaded an arivis Cloud module, see Downloading an arivis Cloud Module
[} 208].
ü Docker Desktop is installed and running on your machine, see Preliminary Work & Prerequi-
sites [} 206] and Requirements for Docker Desktop [} 1313].
ü If you execute the module on a remote computer, both PCs have to be connected via network
and have access to the defined shared folder, see Setting Up the Remote Module Execution
[} 207].
1. On the Applications tab, open the Module Execution tool.
2. For module, select the module you want to use locally from the dropdown list.
3. If applicable, you can select which Version of the module you want to use.
à The Module Parameters of the selected module are displayed.
4. Under Module Parameters, set your parameters.
5. If your module supports multiple inputs and you want to use the module on more than one
image, activate the checkbox Use Batch Mode.
6. Under Module Input, click on and select the input image(s) which should be pro-
cessed by the module.
7. Select the Execution Settings Location where the module is executed on your computer
and your results are saved.
8. Click Execute Module.
à Your selected arivis Cloud module is executed.
9. To check the status and see the last executed modules, click Browse Results to open the
executions browser.
You have successfully executed an arivis Cloud module.

See also
2 Executions Browser [} 212]
2 Module Manager Tool [} 211]
2 Module Execution Tool [} 212]

4.1.7 Example for arivis Cloud (onsite)

This chapter shows you how to download an arivis Cloud module and use it locally. For the pur-
pose of this example, the Auto Thresholding module is downloaded and used locally.

Prerequisite ü Your PC is connected to the internet.


ü You have started ZEN.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 209


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

ü You have created an access token and entered it in Tools > Options > arivis Cloud, see Cre-
ating and Entering an Access Token [} 206].
1. On the Applications tab, open the Module Manager tool.
2. Click Download Modules from arivis Cloud.
à A browser window opens.

3. Select Auto Thresholding and click OK.


à The download of the module starts.
à After a successful download, the module is displayed in the Module Manager tool.

4. On the Applications tab, open the Module Execution tool.


5. In the Module dropdown list, select Auto Thresholding.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 210


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

à The parameter of the module Auto Thresholding are now displayed in the tool.

6. If applicable, you can change the Version of the module.


7. If you want to use the module on multiple images, activate Use Batch Mode.
8. For input_image, click on and select your input image(s).
9. For Execution Settings Location, select a location where the module is executed on your
computer and your results are saved.
10. Click Execute Module.
You have now downloaded the arivis Cloud module Auto Thresholding and executed it with
ZEN.

4.1.8 Module Manager Tool

Parameter Description
Local Available Displays a list with all the downloaded and locally available arivis
Modules
Cloud modules. Click to display a short description of the respec-
tive module and to have the possibility to delete it by clicking .

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 211


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

Parameter Description
Download Mod- Opens a browser window to download arivis Cloud modules, see
ules from arivis Downloading an arivis Cloud Module [} 208].
Cloud

See also
2 arivis Cloud (on-site) [} 206]

4.1.9 Module Execution Tool

Parameter Description
Module Selects the module you want to execute locally. Displays all down-
loaded modules in a dropdown list.

Version Sets which version of the currently selected module should be exe-
cuted.

Module Parameter Displays and sets all the parameters of the currently selected module.

Module Input Selects the image(s) for which the module is executed.

– Use Batch Only available for modules that support multiple input images.
Mode
Activated: Enables the selection of multiple input images.
Deactivated: The input can only select one image.

– Batch Input Only available for modules that support multiple input images and if
Use Batch Mode is activated.
Selects the input for Batch execution.

input_image
Selects the input with a click on .

Execution Settings Sets the path where the execution is located and where the results
Location are saved.

Stop Batch execu- Only available for modules that support multiple input images and if
tion on error Use Batch Mode is activated.
Activated: Stops the Batch execution if an error occurs.

Execute Module Executes the selected module.

Browse Results Opens the executions browser.

See also
2 Executions Browser [} 212]
2 arivis Cloud (on-site) [} 206]
2 Executing arivis Cloud Modules in ZEN [} 209]

4.1.10 Executions Browser

This browser displays the last executed arivis Cloud modules with detailed information.

Parameter Description
Filter

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 212


4 Basic Functionality | 4.1 arivis Cloud (on-site) ZEISS

Parameter Description
– Client or User- Filters the executions that contain the characters entered in this field
name contains as part of the client and/or username.

– Status Filters the executions that have the status that is selected from this
dropdown list.

– Update Re- Updates the list of executions according to the filters.


sults

List of Executions

– Module Name Displays the name of the executed module.

– Start Displays the start date and time.

– Last Update Displays date and time of the last update.

– Status Displays the status of this execution.

– Client/User- Displays the name of the client and user that started the execution.
name

– Open Results Opens a file browser at the location the results are saved.

– Open Log Open the log file for this execution.

– Details Opens a dialog with more details.

4.1.10.1 Details for arivis Cloud Execution Dialog

Displays details for this arivis Cloud execution.

Parameter Description
Module Name Displays the name of the executed module.

Module Version Displays the version of the executed module.

Start Date Displays the start date and time.

Last Update Displays date and time of the last update.

Current Status Displays the current status of the execution.

Starting Client Displays the name of the client that started the execution.

Starting User Displays the name of the user that started the execution.

Results Directory Displays the directory where the results are saved.

Status History Displays the status history with date and time for each status the exe-
cution had.

Ok Closes the dialog.

Open Results Opens a file browser at the location the results are saved.

Open Log Open the log file for this execution.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 213


4 Basic Functionality | 4.2 Colocalization ZEISS

4.2 Colocalization

This module enables you to quantify colocalization in two channels. The gray value pixel distribu-
tion is displayed in two channels with the help of a scatter plot with four quadrants. You can
draw multiple regions into the image. The data table shows the measured values dynamically for
both the entire image and the individual regions. Additionally, 17 measured values in the data ta-
ble can be exported for further analysis.

4.2.1 Colocalization View

Only visible for multichannel fluorescence images.

Info
The channels that you are comparing with one another are displayed in the image area in the
form of a color overlay. The channel color of the image is used here. If the images have more
than 2 channels, you can add additional channels on the Dimensions tab. This temporary se-
lection is deactivated, however, when you select the channels for comparison on the Coloc.
Tools tab.

In the Colocal. (Colocalization) view, you can analyze the extent of colocalization quantitatively
in two fluorescence channels. The view consists of two main areas: the X/Y scatter plot on the left
and the actual image (2 channels are displayed) in the right image area. Using the Coloc. Tools
tab, you can also display the colocalization table in the lower image area.
The analysis is performed on regions drawn into the image. Once a region is drawn, it is automati-
cally treated as an active region. The scatter plot shows the pixel value frequencies for this region.
The Colocalization table displays the data for the entire image and for the selected region. To
select several regions, press the Ctrl key while clicking on the desired regions.
Apart from drawing regions into the image, you can also draw them into the X/Y scatter plot. If
you have used the function in the regions section of the Coloc. Tools tab, only those pixels that
are framed by a region in the scatter plot are taken into consideration. This means that you can
correlate interesting point clouds quickly with the corresponding pixels in the image.

4.2.1.1 X/Y Scatter Plot

The pixel intensities of two channels are plotted against one another in the diagram and each
pixel pair with the same X/Y image coordinates is displayed as a point. The frequency with which
pixels of a certain brightness occur is visualized with a color palette that is displayed at the bot-
tom of the diagram. The relative value range is between 0-255.
The vertical and horizontal axes show the gray value range of the relevant channel.
The diagram is overlaid with two lines that subdivide it into four quadrants, numbered from 1 to
4. Using the mouse, you can position the lines freely and adjust the threshold values to the data.
The quadrants have the following meanings:

§ 1: Non-colocalizing pixels from channel 1


§ 2: Non-colocalizing pixels from channel 2
§ 3: Colocalizing pixels
§ 4: Background

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 214


4 Basic Functionality | 4.2 Colocalization ZEISS

4.2.1.2 Coloc. Tools Tab

Here you find all control elements you need to perform a colocalization analysis.

Parameter Description
Tool Bar Only visible if Show All is activated.
Displays tools to draw regions for analysis into the image. For a de-
scription of the individual tools, see Graphics Tab [} 1036].

– ROI Only visible if you have drawn a region into the scatter plot.
As long as this button is activated (highlighted in blue), you can select,
move and change the regions in the scatter plot. If you want to
change the quadrant lines again, you need to deselect the button.

Channels Selects which channels of a multichannel image are compared with


one another. Select a channel for both the horizontal and vertical dia-
gram axis. The first and second channel are always selected by de-
fault. As soon as you have made a selection, all other channels are au-
tomatically removed from the image display. You can, however, add
other channels temporarily on the Dimensions tab.

Threshold Sets the threshold value (in gray levels) for both channels using the
two Threshold sliders and the two spin boxes/input fields.

Range Only visible if Show All is activated.


Defines the grey value range displayed by the axes of the scatter dia-
gram.. Auto is selected here by default, which means that the range
is automatically set to the brightest pixel in the image. You can, how-
ever, enter a fixed gray value range between 256 (8 bits) and 65535
(16 bits).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 215


4 Basic Functionality | 4.2 Colocalization ZEISS

Parameter Description
Dimension Selec- Only visible if at least one of the Range dropdown lists is set to Auto
tion and if the image is a z-stack or a time series. Defines whether the axis
of the scatter plot is based on the values of the current image plane
(2D), or on the entire z-stack (All Z)/time series (All T). In this way
you can easily determine a valid diagram setting for an entire time se-
ries, for example, without having to analyze each individual time
point.

Costes Calculates the optimal threshold value according to Costes et al.

Regions

– Channel but- Here you can mask pixels in the image according to which one of the
tons four quadrants they belong to. The numbers on the buttons corre-
spond to the numbering of the quadrants in the X/Y scatter plot.
The color selection window is accessed by clicking on the color field.

– Cut Mask Only active if a quadrant has been masked.


Creates a new image exclusively containing the masked pixels.

– Opacity Only visible if Show All is activated.


Define the degree of transparency of the masking.

Extract

– Scatter Plot Creates a new image document from the X/Y scatter plot. In the case
of time series or z-stacks, the dimensions are also created automati-
cally.

– Table Only visible if Show All is activated.


Creates a new table document. The document contains all measure-
ment data from the colocalization analysis. All dimensions, such as T
and Z, are also taken into account. This table can be saved as a *.csv
document for further processing in other programs.

– Table Only visible if Show All is activated.


Activated: Displays the colocalization table in the image area.

4.2.1.3 Colocalization Table

Only visible if the Table checkbox is activated on the Coloc. Tools tab.
For each quadrant of the scatter plot there is a corresponding row in the table. The table contains
columns for the different measured values with the Global row containing the values for the en-
tire image.

4.2.1.3.1 Region

Once a region has been selected it has a number assigned to it. This number appears in the image
and in the table.

4.2.1.3.2 Quadrant

Indicates the measured values for the four quadrants of the scatter plot.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 216


4 Basic Functionality | 4.2 Colocalization ZEISS

4.2.1.3.3 Pixel Number

Shows the total number of pixels of each quadrant. The sum of all pixels in this column for all 4
quadrants corresponds to the product of the height x width of the original image.

4.2.1.3.4 Area (µm²)

Area = number of pixels x scaling factor for X/Y


If there is no scaling for the original image, the following applies: 1 pixel = 1 µm.

4.2.1.3.5 Relative Area (%)

Relative area = area of quadrant/total area

4.2.1.3.6 Pearson's Correlation Coefficient

Provides information on the intensity distribution within the colocalization region.


Value range: -1 to 1.
1: All pixels are on a straight line in the scatter plot from bottom left to top right (if, for example,
you have used the same channel twice for the colocalization, you will find the value 1 in this col-
umn).
0: The pixels in the scatter plot are distributed in a cloud without a preferred direction.
-1: The pixels do not overlap. The scatter plot stretches from top left to bottom right. This situa-
tion can be described as negative colocalization and means "exclusion".
The calculation formula is as follows:

GV: Gray Value; AV: Average Gray Value; C: Channel

4.2.1.3.7 Manders' Correlation Coefficient

Insensitive to differences in the signal intensity between the two channels and bleaching.
Value range: 0 to 1
The calculation formula is as follows:

Fig. 11: C: Channel

4.2.1.3.8 Coloc. Coefficient 1

This coefficient indicates the relative number of colocalized pixels in channel 1 in relation to the
total number of pixels above the threshold value:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 217


4 Basic Functionality | 4.2 Colocalization ZEISS

The values range between 0 and 1, with 0 indicating no colocalization and 1 indicating full colo-
calization.
Numerator = Number of pixels in quadrant 3
Denominator = Number of pixels in quadrant 3 + number of pixels in quadrant 1

4.2.1.3.9 Coloc. Coefficient 2

This coefficient indicates the relative number of colocalized pixels in channel 2 in relation to the
total number of pixels above the threshold value:

The values range between 0 and 1, with 0 indicating no colocalization and 1 indicating full colo-
calization.
Numerator = Number of pixels in quadrant 3
Denominator = Number of pixels in quadrant 3 + number of pixels in quadrant 2

4.2.1.3.10 CC (Weighted) 1

Weighted correlation coefficient channel 1. Calculated like the simple colocalization coefficient,
but using the sum of the gray value intensity rather than the number of pixels.

The values range between 0 and 1, with 0 indicating no colocalization and 1 indicating full colo-
calization.
Numerator = Sum of intensity of all pixels in quadrant 3
Denominator = Sum of intensity of all pixels above the threshold value

4.2.1.3.11 CC (Weighted) 2

Weighted correlation coefficient channel 2. Calculated like the simple colocalization coefficient,
but using the sum of the gray value intensity rather than the number of pixels.

The values range between 0 and 1, with 0 indicating no colocalization and 1 indicating full colo-
calization.
Numerator = Sum of intensity of all pixels in quadrant 3
Denominator = Sum of intensity of all pixels above the threshold value

4.2.1.3.12 Average Intensity 1

The sum of all gray values from channel 1, divided by the total number of pixels in this channel:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 218


4 Basic Functionality | 4.3 Direct Processing ZEISS

4.2.1.3.13 Average Intensity 2

The sum of all gray values from channel 2, divided by the total number of pixels in this channel:

4.2.1.3.14 Standard Deviation 1

Displays the standard deviation of the gray values in channel 1:

4.2.1.3.15 Standard Deviation 2

Displays the standard deviation of the gray values in channel 2:

4.2.1.3.16 Z Index

Displays the Z index for Z-stack images.

4.2.1.3.17 T Index

Displays the time index for time lapse images.

4.2.1.3.18 Relative Time

Displays the time of acquisition for all dimensions of a multidimensional image, beginning at
0h:00min:00sec:00msec.

4.2.1.3.19 Relative Focus

Displays the relative focus position at which an image has been acquired.

4.3 Direct Processing

The development of microscopic techniques makes the data structure ever more complicated. In
many cases, the raw data is large, time consuming to process and not needed at the end of the
experiment. The module Direct Processing is designed to simplify the workflow to improve us-
ability and to parallelize the acquisition and processing steps to save time.
During image acquisition using an acquisition PC, Direct Processing enables the user to select
processing functions which are executed on a processing PC. Several different functions are avail-
able and you can define a sequence of functions (in a so-called pipeline), which are then executed
sequentially one after another. Direct Processing starts to process the smallest processable en-
tity as soon as its acquisition has been completed. In the case of deconvolution, this is typically a
z-stack for one channel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 219


4 Basic Functionality | 4.3 Direct Processing ZEISS

Direct Processing allows an acquisition computer to communicate with a second PC (processing


computer) connected via a network connection. The acquisition computer instructs the processing
computer to process images as they are being acquired. Before you can use the module, you typi-
cally need to connect the two computers. As there are numerous ways, how computers can be
set up to become networked, we can only give some general advice here. Contact your local IT
administration for help on how to configure the computers in accordance to the local infrastruc-
ture.
One way is to connect the computer controlling the microscope system to a second computer via
a direct ethernet connection. If Network Discovery is switched on, Windows 10 will directly sup-
port such a point to point connection. Create a shared folder which can be accessed from both
computers. Since no other network traffic will use this connection, the whole bandwidth will be
available for saving data directly from the acquisition computer to a shared folder on the process-
ing computer. This is the most efficient way as the acquired data do not have to be copied off the
acquisition computer after the acquisition has finished.
Alternatively, it is also possible, to use a processing computer which is already integrated into an
existing network. Depending on the network type and the kind of experiments being done, the
bandwidth might not be sufficient to directly stream data to the processing computer. In such
cases, to not limit the throughput of the acquisition, it is advisable to let the acquisition computer
acquire data to a local drive and instruct the processing computer where to look for the acquired
data.
If no processing PC is available, it is also possible to configure the same acquisition PC for parallel
processing steps, i.e. acquire and process images on the same workstation.
For a communication via network, it is possible to link both computers with a discovery proxy. The
discovery proxy is a service where you can register all available processing computers and your ac-
quisition computer can then ask this service for the list of these available PCs. You can also link
the PCs without such a discovery service, for which you then need the IP address and/or network
name of the processing computer. Note that such a use of a discovery proxy is primarily designed
for configurations in which you have more than one processing PCs.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 220


4 Basic Functionality | 4.3 Direct Processing ZEISS

Fig. 12: Schematic of the function of a discovery proxy

4.3.1 System Requirements

4.3.1.1 Hardware Requirements

There are two main hardware requirements to use Direct Processing.


1. In case more than one PC is being used, it is required that the n >=2 PCs can communicate
with each other. This may happen in a network, for example.
2. Both PCs need to share a common network drive, as they need to be able to read and write
data on this drive. Since Direct Processing is working on a shared common folder, there is no
fixed bandwidth requirement.
For more information about connecting PCs and creating a shared folder on a drive, ask your IT
department and see the installation guide for ZEN.

Fig. 13: Schematic overview of an acquisition PC using the power of a processing PC

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 221


4 Basic Functionality | 4.3 Direct Processing ZEISS

Graphic cards
All released ZEISS workstations for use of Deconvolution are equipped with a sufficiently large
GPU. Deconvolution uses GPU acceleration, so a dedicated Nvidia CUDA based graphic card is op-
timal and recommended. ZEN has been tested with professional grade Nvidia Quadro GPU
(P6000, P4000, M6000, M4000 and RTX6000). The use of Nvidia Geforce grade GPU should also
be possible, but is not extensively tested. The other processing methods in Direct Processing, such
as Airyscan/Apotome processing and denoising use CPU and not GPU.
The drivers need to be compatible with Windows 10.

System Graphic card Drivers


Z6 P4000 442.50

4.3.1.2 Software Requirements

If processing and acquisition run on different computers and a second acquisition computer is
added to the network, then the ZEN version of the computers can be different. In this case, the
“older” ZEN version will not be able to use the added functionalities of the more recent ZEN ver-
sion on the processing machine. There is no “backward” compatibility implemented.

See also
2 Connecting Acquisition Computer and Processing Computer [} 222]

4.3.2 Overview Direct Processing

This overview shows you how to perform Direct Processing.

§ Before using the Direct Processing functionality on two computers, the acquisition and the
processing computers need to be connected, see Connecting Acquisition Computer and
Processing Computer [} 222].
§ On the acquisition computer, settings need to be defined, see Direct Processing Tool on Ac-
quisition Tab [} 233].
§ On the acquisition computer, settings in the Auto Save tool need to be defined, see Defining
Settings in the Auto Save Tool [} 229].
§ On the processing computer, the receiving needs to be activated, see Direct Processing Tool
on Applications Tab [} 237].
§ Set up and run an experiment with Direct Processing, see Using Direct Processing [} 230].

See also
2 Using Deconvolution in Direct Processing [} 604]
2 Using Direct Processing with Airyscan Processing [} 231]

4.3.3 Connecting Acquisition Computer and Processing Computer

Before you can use Direct Processing on two or more computers, you need to connect the com-
puters. For general information, see Direct Processing [} 219]. For this the network configuration
of your PCs is a very important aspect, as depending on the configuration, your PC might have
more than one (ethernet) network connection.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 222


4 Basic Functionality | 4.3 Direct Processing ZEISS

For the communication via network with or without a discovery proxy, see Connecting Comput-
ers Without Discovery Proxy [} 223] or Connecting Computers With Discovery Proxy [} 226] re-
spectively.

4.3.3.1 Connecting Computers Without Discovery Proxy

On the Processing PC

Prerequisite ü You are on the processing computer.


1. Open Tools > Options > Direct Processing.
2. Open the Setup Processing PC section and make sure that Announcement to Discovery
Proxy is deactivated.

3. If you have several network connections, under IP Address (this PC), select the IP address
you want to use from the dropdown. For example if you want to use a direct connection
with a 10 GB cable, you can select the corresponding IP here. Make sure to enable the
same connection on the acquisition PC.
4. Note down the name and/or the IP address and port of the processing PC. You can find the
IP and port under IP Address (this PC) and the computer name if you activate Send
Hardware Information. Alternatively, ask your IT department for information on how to
find the IP address or name of the computer. Note: In some networks the computers might
get assigned a new IP address over time (e.g. each day), so using the computer name for
establishing communication would be advisable.
5. If you want to display information about the processing computer on your acquisition com-
puter, enter the information in the text box PC Description.
6. If you want to have the hardware information, activate Send Hardware Information, and
for displaying statistics about the average job time, activate Send Processing Statistics.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 223


4 Basic Functionality | 4.3 Direct Processing ZEISS

7. Click OK to close the dialog.


à The Tools > Options dialog closes.
8. On the Applications tab, in the Direct Processing tool, click Start Receiving. Note that
this is usually already activated by default.

Everything is now set up on the processing computer.

On the Acquisition PC

Prerequisite ü You are on the acquisition computer.


ü You know the IP address of the processing computer.
1. Open Tools > Options > Direct Processing.
2. Open the Setup Acquisition PC section and make sure that Find From Discovery Proxy
is deactivated.

3. If you have several network connections and want to force the use of a specific one (e.g.
direct connection with a 10 GB cable), under IP Address (this PC), activate Select IP Ad-
dress and select the respective address from the dropdown.
4. Click OK to close the dialog.
à The Tools > Options dialog closes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 224


4 Basic Functionality | 4.3 Direct Processing ZEISS

5. On the Acquisition tab, activate Direct Processing.


à The Direct Processing tool is displayed. Make sure that Show All is activated to see all
options.
6. In the Direct Processing tool, click Remote PC.
à Additional parameters are displayed.
7. Click Edit Connection.
à The Direct Processing PCs dialog opens.

8. In the Custom Processing PC text fields, enter the name or the IP address of the process-
ing computer in the Host Name field and the Port of the processing computer.
9. Click Add.
à The processing computer is now added to the list.
10. Select your processing computer in the list and click Connect. Alternatively, activate Auto-
matically Select Processing PC and the processing PC is automatically selected for each
experiment based on the available PCs and their queue length (the PC with the shortest
queue is selected).
à You are now connected to the processing computer.
11. Click Close to exit the dialog.
Both computers are now connected and Direct Processing is set up. You can now configure and
run your experiment.

See also
2 Overview Direct Processing [} 222]
2 Using Deconvolution in Direct Processing [} 604]
2 Using Direct Processing with Airyscan Processing [} 231]
2 Connecting Acquisition Computer and Processing Computer [} 222]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 225


4 Basic Functionality | 4.3 Direct Processing ZEISS

4.3.3.2 Connecting Computers With Discovery Proxy

On the Processing PC

Prerequisite ü You are on the processing computer.


ü You know the IP address of the PC that is acting as the discovery proxy server​.
1. Open Tools > Options > Direct Processing.
2. Open the Setup Processing PC section and activate the checkbox Announcement to
Discovery Proxy.

3. Under IP Address (Discovery Proxy), enter the IP address and Port of the discovery
proxy.
4. If you have several network connections, under IP Address (this PC), select the IP address
you want to use from the dropdown. For example, if you want to use a direct connection
with a 10 GB cable, you can select the corresponding IP here. Make sure to enable the
same connection on the acquisition PC.
5. If you want to display information about the processing computer on your acquisition com-
puter, enter the information in the text box PC Description.
6. If you want to have the hardware information, activate Send Hardware Information, and
for displaying statistics about the average job time, activate Send Processing Statistics.
7. Click OK to close the dialog and save the settings.
à The Tools > Options dialog closes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 226


4 Basic Functionality | 4.3 Direct Processing ZEISS

8. On the Applications tab, in the Direct Processing tool, click Start Receiving. Note that
this is usually already activated by default.

Everything is now set up on the processing computer.

On the Acquisition PC

Prerequisite ü You are on the acquisition computer.


ü You know the IP address of the PC that is acting as the discovery proxy server​.
1. Open Tools > Options > Direct Processing.
2. Open the Setup Acquisition PC section and activate the checkbox Find from Discovery
Proxy.

3. Under IP Address (Discovery Proxy), enter the address of the Discovery Proxy. Alterna-
tively, this can also be done or changed in the Connected Processing PCs dialog later.
4. If you have several network connections and want to force the use of a specific one (e.g.
direct connection with a 10 GB cable), under IP Address (this PC), activate Select IP Ad-
dress and select the respective address from the dropdown.
5. Click OK to close the dialog.
à The Tools > Options dialog closes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 227


4 Basic Functionality | 4.3 Direct Processing ZEISS

6. On the Acquisition tab, activate Direct Processing.


à The Direct Processing tool is displayed. Make sure that Show All is activated to see all
options.
7. In the Direct Processing tool, click Remote PC.
à Additional parameters are displayed.
8. Click Edit Connection.
à The Connected Processing PCs dialog opens.

9. Select your processing computer in the list and click Connect. Alternatively, activate Auto-
matically Select Processing PC and the processing PC is automatically selected for each
experiment based on the available PCs and their queue length (the PC with the shortest
queue is selected).
à You are now connected to the processing computer.
10. Click Close to exit the dialog.
Both computers are now connected and Direct Processing is set up. You can now configure and
run your experiment.

See also
2 Overview Direct Processing [} 222]
2 Using Deconvolution in Direct Processing [} 604]
2 Using Direct Processing with Airyscan Processing [} 231]

4.3.4 Setting Up Your PC as Discovery Proxy

If you want to set up and use your computer as discovery proxy, take the following steps:

1. Open Tools > Options > Direct Processing.


2. Open the Setup Discovery Proxy Server section.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 228


4 Basic Functionality | 4.3 Direct Processing ZEISS

à The options for setting up the discovery proxy open.

3. If your PC has several active network connections, under IP Address (this PC), select the IP
address you want to use for the discovery proxy setup in the dropdown.
4. Click Start.
5. Click OK to close the Tools > Options dialog.
This computer is now set up and used as discovery proxy with the displayed IP address.

4.3.5 Defining Settings in the Auto Save Tool

Info
Auto Save and ZEN Connect
If you have opened a ZEN Connect Project, the folder in the Auto Save tool is automatically
set to the folder where the ZEN Connect project is saved. In this case you cannot change the
folder for Auto Save. Also note that with an active ZEN Connect project you cannot select the
upload to ZEN Data Storage.

Info
Using Direct Processing and ZEN Data Storage
If you are using the ZEN Data Storage server as the location for storing your data, all acquisi-
tion and processing computers involved must have access to the transfer share defined in ZEN
Data Storage.
Also note that the images are only uploaded to ZEN Data Storage after they are now longer
open in ZEN.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 229


4 Basic Functionality | 4.3 Direct Processing ZEISS

When using the Direct Processing functionality, perform the following steps on the acquisition
computer to define the settings in the Auto Save tool.

Prerequisite ü You have the Auto Save tool open on the Acquisition tab.
1. In the dropdown, select if you want to save the image(s) locally or upload them to ZEN
Data Storage.
2. In the Folder field, specify the local directory, where acquired images should be stored.
Make sure that it is a shared folder which can be accessed from both computers.
3. If you select Store in ZEN Data Storage Server, make sure that the processing computer
is also connected to the same server. Optionally, you can define if the image should directly
be shared with a particular collection.
4. If you want images to automatically be stored in a new subfolder named with the current
date, activate Automatic Sub-Folder.
5. In the Name field, specify the file base name for the acquired images.
6. Activate Close CZI Image After Acquisition if you want to release the image from the ac-
quisition computers memory.

See also
2 Uploading Images Automatically After Acquisition [} 272]

4.3.6 Using Direct Processing

Prerequisite ü If you are using Direct Processing on different computers, you have connected acquisition and
processing computer, see Connecting Acquisition Computer and Processing Computer
[} 222].
ü To ensure that the processing computer reads incoming files and starts the processing, on the
Applications tab, in the Direct Processing tool, you have clicked Start Receiving. This is
usually active by default.
ü On the Acquisition tab, you have set up your experiment for image acquisition.
ü On the Acquisition tab, Direct Processing is activated. This activates the Auto Save tool as
well.
ü Depending on your settings, you have defined the folder where the acquired images are
stored in the Direct Processing or the Auto Save tool. Use a folder to which the processing
computer has access. For information about sharing a folder, see Sharing a Folder for Direct
Processing [} 238].
1. On the Acquisition tab, open the Direct Processing tool.
à If no Direct Processing settings were made before for the current experiment, a particular
processing function is already preselected depending on your microscope, channel set-
tings and licenses.
2. From the Processing Function drop-down list, select the processing function you want to
use.
à The parameters of the function are displayed and the name of the function is displayed in
the pipeline container.
3. Set all the parameters of the function for your experiment. For detailed information about
the parameters refer to the descriptions of the individual image processing function.
4. To add another function or several other ones, click Add Function.
à A new container is added in the pipeline.
5. Select the next pipeline container, select a processing function from the dropdown, and set
the parameters for each function.
à You have added and set up a sequence of processing functions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 230


4 Basic Functionality | 4.3 Direct Processing ZEISS

6. Click Start Experiment to run the experiment. Note: You can pause the processing. If you
stop the experiment, requests that have been sent earlier by the acquisition computer are
not processed. However, already processed images will be retained.
à The images are stored in the folder you have defined in the Auto Save or Direct Pro-
cessing tool. When you abort the acquisition, the remote processing will not take place.
In case you have set up several processing functions, only the acquired image and the fi-
nal output image are stored.
à The processing computer reads incoming files and starts the processing. The path to the
selected folder, the currently processed image as well as the images to be processed are
displayed in the Direct Processing tool. The processed image is saved to the same
folder specified in the Direct Processing tool. If the image name already exists in this
folder, the new file is saved under a new name <oldName>-02.czi.
7. To cancel the processing on the processing computer, on the Applications tab, in the Di-
rect Processing tool, click Cancel Processing.
Once processing is finished, you are notified on the acquisition PC and can open and view the ac-
quired image as well as the processed image. This should be done on the processing computer, so
that you can immediately start a new experiment on the acquisition computer. However, you can
also automatically open the processed image on the acquisition PC with the respective setting in
the Direct Processing tool on the Acquisition tab.
Information about Direct Processing (e.g. the duration) is available on the Info view tab of the
processed image.

See also
2 Using Direct Processing with Airyscan Processing [} 231]
2 Using Deconvolution in Direct Processing [} 604]
2 Direct Processing Tool on Acquisition Tab [} 233]
2 Auto Save Tool [} 890]

4.3.7 Using Direct Processing with Airyscan Processing

Prerequisite ü This function is only available if an Airyscan detector is available.


ü If you are using Direct Processing on different computers, you have connected acquisition and
processing computer, see Connecting Acquisition Computer and Processing Computer
[} 222].
ü To ensure that the processing computer reads incoming files and starts the processing, on the
Applications tab, in the Direct Processing tool, you have clicked Start Receiving. This is
usually active by default.
ü On the Acquisition tab, you have set up your experiment for image acquisition.
ü On the Acquisition tab, Direct Processing is activated. This activates the Auto Save tool as
well.
ü Depending on your settings, you have defined the folder where the acquired images are
stored in the Direct Processing or the Auto Save tool. Use a folder to which the processing
computer has access. For information about sharing a folder, see Sharing a Folder for Direct
Processing [} 238].
1. On the Acquisition tab, open the Direct Processing tool.
à If no Direct Processing settings were made before for the current experiment, a particular
processing function is already preselected depending on your microscope, channel set-
tings and licenses.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 231


4 Basic Functionality | 4.3 Direct Processing ZEISS

2. In the Processing Function drop-down list, select Airyscan Processing.

Note: If you uncheck the Auto Filter checkbox and activate Adjust per Channel, you can
set the Super Resolution parameter in a channel specific manner.

3. Select the desired settings for Airyscan Processing. For details how to use this function,
see Airyscan Processing [} 186]. Ideally, you have already checked the best parameters be-
forehand, using a sample image acquired under the same conditions as set up for the ex-
periment.
4. Click Start Experiment to run the experiment.
Note: You can pause the processing. If you stop the experiment, requests that have been
sent earlier by the acquisition computer are not processed. However, already processed im-
ages will be retained.
à The images are stored in the folder you have defined in the Auto Save or Direct Pro-
cessing tool. When you abort the acquisition, the remote Airyscan processing will not
take place.
à The processing computer reads incoming files and starts the Airyscan processing. The
path to the selected folder, the currently processed image as well as the images to be
processed are displayed in the Direct Processing tool. The processed image is saved to
the same folder specified in the Direct Processing tool. If the image name already exists
in this folder, the new file is saved under a new name <oldName>-02.czi.
5. To cancel the processing, click Cancel Processing.
Once processing is finished, you are notified on the acquisition PC and can open and view the ac-
quired image as well as the processed images. This should be done on the processing computer
so that you immediately can start a new experiment on the acquisition computer. However, you
can also automatically open the processed image on the acquisition PC with the respective setting
on the Direct Processing Tool on Acquisition Tab [} 233].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 232


4 Basic Functionality | 4.3 Direct Processing ZEISS

When you open the image in the Image View, information about the executed Airyscan process-
ing is available on the Info view tab. Additionally, general information about Direct Processing
(e.g. the duration) is also available on the Info view tab of the processed image.

See also
2 Auto Save Tool [} 890]

4.3.8 Direct Processing Tool on Acquisition Tab

Parameter Description
Add Function Adds another processing function to the pipeline.

Remove Function Removes the currently selected processing function from the pipeline.

Pipeline Displays a list of containers for possible processing functions. To set


the function for the currently selected container, use the Processing
Function dropdown list.
The functions in this pipeline are executed one after the other in the
sequence as given here. You can change the position of a function in
the pipeline via drag & drop.

Processing Func- Selects the processing function you want to use for Direct Process-
tion ing for the currently selected container of the pipeline. Depending on
your experiment, microscope, channel settings and licenses, a particu-
lar processing function is already preselected by default.

Parameter Section In this section you have different parameters, depending on the se-
lected Processing Function. For more information, see:
§ Airyscan Joint Deconvolution Parameters [} 93]
§ Airyscan Processing Parameters [} 235]
§ LSM PLus Processing Parameters [} 205]
§ ApoTome RAW Convert Parameters [} 188]
§ Deblurring Parameters [} 94]
§ Deconvolution Parameters [} 236]
§ Denoise Parameters [} 112]
§ Extended Depth of Focus Parameters [} 175]
§ Intellesis Denoising Parameters [} 517]
§ Linear Unmixing Parameters [} 202]
§ Stitching Parameters [} 148]
§ Unsharp Mask Parameters [} 177]
§ Lattice Lightsheet Parameters [} 1198]
§ SIM Processing Parameters [} 1305]
§ Apotome Plus Parameters [} 608]

Use Advanced Set- Only visible if you have selected Deconvolution or Apotome Plus.
tings Activated: Enables the dropdown menu to load an advanced setting.

Load Setting cre- Only available if Use Advanced Settings is activated and Deconvo-
ated in the Decon- lution is selected.
volution function Select advanced settings which were created in the image processing
function Deconvolution (adjustable).
Note: Currently Direct Processing only supports settings configured in

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 233


4 Basic Functionality | 4.3 Direct Processing ZEISS

Parameter Description
the Deconvolution tab of the function, some settings on the PSF tab
such as spherical aberrations correction cannot be used in Direct Pro-
cessing.

Load Setting cre- Only available if Use Advanced Settings is activated and Apotome
ated in the Apo- Plus is selected.
tome Plus function Select advanced settings which were created in the image processing
function Apotome Plus (adjustable).
Note: Currently Direct Processing only supports settings configured in
the Apotome Plus tab of function, some settings on the PSF tab
cannot be used in Direct Processing.

Output Only visible if Show All is activated.


Displays options to adjust setting for the output image(s).

- Output Folder Displays the path where the processed image is saved. Make sure that
a shared folder is selected where both the acquisition and the pro-
cessing computers have access to.

- Use Output Activated: Synchronizes the output folder for Direct Processing with
Folder from the folder in the Auto Save tool. The Output Folder can only be
Auto-Save changed by editing the Folder in the Auto Save tool respectively. If
you have opened a ZEN Connect Project, the folder in the Auto Save
tool is automatically set to the folder where the ZEN Connect project
is saved.

- Create Sub- Activated: Creates sub-folders in the output folder. All processed im-
folders Auto- ages end up in a new folder named with the current date.
matically

- Define File Defines the filename of the processed image. Default: processed.czi.
Naming

- Use Original Activated: Uses the name of the file as it was acquired and adds the
Name with defined file naming as a suffix.
Suffix

- File Name Pre- Displays a preview of the name of the processed acquisition image.
view

- Remove Ac- Activated: Keeps only the processed image and deletes the acquisi-
quired Image tion image after processing.
after Process- Deactivated: Keeps both the acquired and processed image.
ing

Handling of Pro- Only visible if Show All is activated.


cessed Image Selects if/how the processed image should be displayed here on the
acquisition PC.

- Do Not Open The processed image is not opened automatically.


Automatically

- Display in The processed image is displayed in a splitter document together with


Split View the acquired image as soon as the first image data is processed.

- Only Open Fi- The processed image is displayed after processing is completed.
nal Image

Process On Only visible if Show All is activated.


Selects where the processing of the image takes place.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 234


4 Basic Functionality | 4.3 Direct Processing ZEISS

Parameter Description
- This PC Selects the option to process the data on this PC, i.e. the PC used for
the acquisition.

- Remote PC Selects the option to connect to a separate (remote) processing PC for


processing your data and displays an additional parameter to config-
ure the connection.

Connected Pro- Only visible if Remote PC is selected.


cessing PC Displays the status of your connection to a processing PC (e.g. to
which you are connected, how the progress of your job is). If you are
not connected to a PC, you can edit your connections here.

- Edit Connec- Opens the dialog which lists all the connected PCs that are ready to
tion receive remote processing requests.
In case of file based communication, it checks if there is a processing
PC listening to the communication path. A message informs you
about the result.

See also
2 Connecting Acquisition Computer and Processing Computer [} 222]
2 Using Direct Processing [} 230]
2 Using Deconvolution in Direct Processing [} 604]
2 Using Apotome Plus in Direct Processing [} 617]
2 Using Direct Processing with Airyscan Processing [} 231]

4.3.8.1 Airyscan Processing Parameters

This set of parameters is only visible if Airyscan Processing is selected as Processing Function.
For the information, you can also see Airyscan Processing [} 186].

Parameter Description
3D Processing Only available for images with 5 or more z-positions.
If activated, this option improves the resolution in axial and lateral di-
rection. The data set needs to have at least 5 z-sections acquired with
an optimal step size. 3D Processing is slower than 2D Processing. For
3D Processing, the whole z-stack (single channel and time point)
needs to fit into the physical memory.

2D SR Processing Only available for 2D images.


Enhances the 2D resolution. Note that this only results in increased
super resolution when images are acquired with optimal settings and
sufficient signal.

Auto Filter If activated, a suitable Super Resolution parameter for the Airyscan
processing is automatically determined for the selected data set. To
manually adjust the Super Resolution parameter, deactivate the
checkbox.

Strength Use this option for an increased (high) or decreased (low) strength of
the automatically assigned filter value. This is especially useful for 3D
processing, as the 2D preview of the processing filter value in the
Airyscan viewer does not allow to conclude the result after a 3D data
processing.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 235


4 Basic Functionality | 4.3 Direct Processing ZEISS

Parameter Description
The increment of this parameter is ± 0.4 compared to the standard
auto Airyscan processing. This setting is not available when manual
processing strength is selected.

Adjust per Channel Only visible if Auto Filter is deactivated and only for images with two
or more Airyscan channels.
If activated, you can manually set channel specific Airyscan processing
parameters.

Super Resolution Only available if Auto Filter is deactivated.


Manually adjusts the Super Resolution parameter.
Note: High strength might look attractive at some images, Z planes
or color channels, but other filtering artefacts might occur which ap-
pear like small rings in the image. Also the results will become very
sharp, but grainy. So carefully check your image data in order to avoid
such artefacts.

See also
2 Using Direct Processing [} 230]
2 Using Direct Processing with Airyscan Processing [} 231]

4.3.8.2 Deconvolution Parameters

This set of parameters is only visible if Deconvolution is selected as Processing Function.

Parameter Description
- Simple, very Only available if Use advanced settings is deactivated. The Simple,
fast (Nearest very fast method is only available if you have configured an experi-
Neighbor) ment with a z-stack acquisition.

- Better, fast In Direct Processing, the parameters for Deconvolution are based on
(Regularized Deconvolution (adjustable). The Normalization is set to Clip (with
Inverse Filter) a Factor of 1) in case of remote processing because only with Clip
the output images contain brightness values which allow quantitative
- Good, medium comparisons.
speed (Fast It-
For Direct Processing, you cannot change any other values.
erative)
We recommend Excellent, slow (Constraint Iterative). Note that
- Excellent, this method is only available if you have the license for the Deconvo-
slow (Con- lution module.
straint Itera-
tive)

See also
2 Creating Deconvolution Settings [} 601]
2 Using Deconvolution in Direct Processing [} 604]
2 Deconvolution (Defaults) [} 104]
2 Deconvolution (adjustable) [} 95]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 236


4 Basic Functionality | 4.3 Direct Processing ZEISS

4.3.9 Direct Processing PCs Dialog

Parameter Description
Use Discovery Activated: Uses a Discovery Proxy server for the communication be-
Proxy tween the computers. This control is synchronized with the respective
options in the Tools > Options > Direct Processing dialog.

– Host Name Only available if Use Discovery Proxy is activated. Displays and edits
the name/IP address of the discovery proxy.

– OK Uses the defined Discovery Proxy.

Automatically Se- Activated: Automatically selects a processing PC for each experiment


lect Processing PC based on the available PCs and their queue length (the PC with the
shortest queue is selected). After the installation of ZEN, this option is
activated automatically and remains so until it is deactivated.
Note that an automatic selection is not possible if you want to use the
function Intellesis Denoising in Direct Processing.

Available Process- Displays a list with all the available processing PCs. It provides the
ing PCs name, an overview of how many jobs are currently in the Queue.
Your current PC is automatically listed if you have clicked Start Re-
ceiving in the Direct Processing tool on the Applications tab.

– Connect Connects to the respective processing PC.

– Only available for PCs that are added as Custom Processing PC.
Deletes the custom PC from the list.
Delete

Custom Processing Defines a custom PC for processing.


PC

– Host Name Sets the name/IP address of the respective processing PC.

– Port Sets the port of the respective processing PC.

– Add Adds the defined custom PC to the list of available PCs.

Refresh Refreshes the list of available PCs.

Close Closes this dialog.

4.3.10 Direct Processing Tool on Applications Tab

Info
Receiving by Default
By default, the computer is starting the receiving of processing requests automatically on ap-
plication startup, i.e. Start Receiving is already active. If necessary, this behavior can be
changed under Tools > Options > Direct Processing > Setup Processing PC.

Parameter Description
Start/Stop Receiv- Starts or stops the reception of processing requests. The processing
ing computer waits for processing requests from the acquisition com-
puter. The computer is receiving by default.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 237


4 Basic Functionality | 4.3 Direct Processing ZEISS

Parameter Description
Note: If you click Stop Receiving while an experiment is running, the
experiment is continued and processed. Only after finishing the cur-
rently running experiment, a new experiment is processed.

Listening on Com- Shows the path where the computer is listening for processing re-
munication Path quests.

Current Request Displays which image is currently being processed. A progress bar in-
dicates how close you are to completing the currently processed im-
age.

Items in the Queue Displays the number of images to be processed. Note that due to the
integrative nature of the CZI images, individual scenes will not show
up as individual steps in the queue. Only when separated CZI docu-
ments are being produced, will the queue show a count > 0.

Cancel Processing Cancels the processing of the images in the output folder.

See also
2 Direct Processing [} 219]

4.3.11 Sharing a Folder for Direct Processing

This step by step guide gives instructions on how to create a shared folder for the Direct Process-
ing functionality in ZEN.
You need an imaging system with its workstation (called acquisition computer) and for process-
ing you need a high-end workstation (called processing computer) with a P6000 card (M/P4000
or M6000 works too) running the newest NVIDIA driver. Both computers need the software ver-
sion ZEN 3.0 or higher.

Computer connection
The processing computer must be connected to the acquisition computer via ethernet connection.
It works best to have both workstations equipped with a 10 GB ethernet card. A 1GB Ethernet is
fine as well, just make sure to not create very large images and deactivate Follow Acquisition in
ZEN when acquiring larger images. For details on how to connect your computer in a network,
ask your local IT department. For some basic information, see also Connecting Computers via
Cable [} 244].

IP Addresses
This is not strictly necessary, but knowing the IP Addresses is the safest way to troubleshoot net-
working issues, so we recommend to check this in any case. It is easiest to network the comput-
ers if both have the same login credentials, e.g. Username = ZEISS, password = zeiss. The comput-
ers can only network with each other if a password is set for both logins. For a description of how
to look up the IP address of your PC, see Looking Up the IP Address of Your Computer [} 243].
Also note down the computer names. You can find those when you right click This PC in the ex-
plorer and select Properties.

4.3.11.1 Creating a Shared Folder on the Processing Computer

You have to make your processing PC discoverable in your network and create a shared folder.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 238


4 Basic Functionality | 4.3 Direct Processing ZEISS

Prerequisite ü You are on the processing computer.


1. Click on Windows start menu > Settings > Network & Internet > Status > Network and
Sharing Center.
à The Network and Sharing Center opens.

2. Click Change advanced sharing settings.


à The Advanced sharing settings window opens.

3. Turn on network discovery for your network.


4. Click Save changes.
5. Open the Windows Explorer and create a folder where both data and communication be-
tween both ZENs should happen, e.g. “D:\direct processing”.
6. Right click on the folder and select Properties.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 239


4 Basic Functionality | 4.3 Direct Processing ZEISS

7. Go to the Sharing tab.

8. Click Advanced Sharing.


à The Advanced Sharing dialog opens.

9. Activate Share this folder.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 240


4 Basic Functionality | 4.3 Direct Processing ZEISS

10. Click Permissions.


11. The Permissions dialog opens.

12. To give access to specific groups or people, click Add.


à The Select Users, Computers, Service Accounts, or Groups dialog opens.

13. If you want to change which accounts you can add, click Object Types to open a dialog to
select different types.
14. If you want to change the (network) location, click Locations to open a dialog to select the
location.
15. In the text field, enter the user or group name you want to give access to and click Check
Names.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 241


4 Basic Functionality | 4.3 Direct Processing ZEISS

à If the name exists, it is verified. In case there is no (exact) match, or in case there are mul-
tiple matches, a dialog opens where you can refine your search or select the right user/
group.
16. Click OK.
à The Select Users, Computers, Service Accounts, or Groups dialog closes and the
user/group is added to the list on the Permissions dialog.
17. Select the user(s)/group(s) and activate the checkboxes for the permissions you want to give
them to this folder.
18. Click OK to confirm all changes in all dialogs.
You have created a shared folder on the processing computer. You can now setup the access to
the folder on the acquisition computer.

4.3.11.2 Accessing the Shared Folder from the Acquisition Computer

On the acquisition computer, you need to map the folder from the processing computer to a drive
letter.
Note: You could also do this by directly accessing the folder via the IP address, however, it is bet-
ter to use the Windows mapping function as this enables some caching mechanisms which make
the connection more reliable.

Prerequisite ü You are on the acquisition computer.


1. In Windows Explorer, open the Network location.
2. Select the processing computer. Here you might need the computer name you noted down
before.
3. Select the shared folder of the processing computer.
4. On the top of the Windows explorer, click Easy access and select Map as drive from the
dropdown menu.
à The Map Network Drive dialog opens.
5. Select the respective Drive for the Folder.
à A login screen opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 242


4 Basic Functionality | 4.3 Direct Processing ZEISS

6. Enter the credentials of the processing computer.

7. Click OK.
8. Click Finish.
à The folder is mapped to your acquisition PC. The result will look something like this:

You are now ready to setup the connection of the two computers in ZEN. Refer to the respective
chapter in the software manual or the help in the software, which is accessible by pressing the F1
key.

4.3.11.3 Looking Up the IP Address of Your Computer

1. In the Windows search, enter cmd.


2. Select Command Prompt.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 243


4 Basic Functionality | 4.4 Extended Focus Processing ZEISS

à The Command Prompt window opens.


3. Type in ipconfig/all and press Enter.
You can now see information for the network configuration of your computer. There you can
look up the IP address of your computer. You have to make sure to select the correct Ethernet
port, as ZEISS workstations usually have at least two. If only one is connected, this is the one
which shows an IP address.

4.3.11.4 Connecting Computers via Cable

We recommend connecting the PCs in a network by using i.e. a rooter. In case a rooter cannot be
used and two PCs are connected via a cable, consider the following remarks:

1. Establish a network by cable.


à By default, a network/connection is established.
2. As a test, check the IPs of the computers and ping each other.
3. In case this fails, check the ethernet adapter and enable DHCP. Also check firewall notifica-
tions/settings.
à Ports used by ZEN are open by default, but could be blocked by various reasons (IT, Win-
dows, firewall).
4. If a port is blocked. try to set another port in the ZEN options for Direct Processing (see also
the help for ZEN).
5. You can also test more than one ethernet adapter by pinging the PCs.

4.4 Extended Focus Processing

Extended Focus Processing enables you to generate images with no limitation of depth of field. It
supports the extraction of the sharp details from individual images at various focus positions and
the combination into an image with high depth of field. You can process z-stacks that have al-
ready been acquired and a wavelet algorithm allows the use in transmitted light, reflected light
and fluorescence imaging.

4.5 Manual Extended Focus

The functionality Manual Extended Focus allows you to create one single image out of several
image acquisitions with different focus positions. The sharp areas of all acquisitions are combined
to one consistently sharp image, the so called EDF image (EDF = Extended Depth of Focus). To
work with the Manual Extended Depth of Focus functionality, it has to be activated in Tools >
Modules Manager > Manual Extended Focus. The tool Manual Extended Depth of Focus is
displayed on the Locate tab.

4.5.1 Preparing a Manual EDF Acquisition

Prerequisite ü You are on the Locate tab.


1. Click the Live button to open the live image.
à The button changes to a Stop button during a live image.
2. Look for a suitable position on the sample.
3. Click Stop to switch off the live image.
You have made all necessary preparations to acquire an image with manual EDF. You can now
continue by acquiring an EDF image using one of two modes, see Acquiring EDF Images with
Timer [} 245] or Acquiring EDF Images with F12 Key [} 245].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 244


4 Basic Functionality | 4.5 Manual Extended Focus ZEISS

See also
2 Comparing Images Using Split Display [} 246]

4.5.2 Acquiring EDF Images with Timer

In this mode, a new image is automatically added after a defined interval. In the time period be-
tween the acquisitions you can set a different focus position. After each recording a new image
with extended depth of focus is calculated immediately. After finishing the acquisition, the final
image is the one that was calculated last.

Prerequisite ü You have opened the Manual Extended Depth of Focus tool on the Locate tab.
1. If you want to store all acquired images in memory for a complete recalculation of the EDF
image after each single acquisition, activate Z-Stack. Note that the more images you ac-
quire, the more time it takes to calculate the EDF.
2. Click Timer.
3. Adjust the length of your interval with the Interval slider or input field. Set the interval long
enough so that you can comfortably move the specimen to a new focus position. After the
time elapses, an image is automatically acquired at your current position.
4. Click Start to acquire the images.
à The Central Screen Area is split into two parts. On the left you can see the current live
image, on the right you see the currently calculated extended focus image.
5. Move to a new focus position after each acquisition.
6. Repeat these steps until you have sharp images from all desired areas of your sample.
7. Click Stop to finish your acquisition. If you want to pause the acquisition, click Pause.
You have finished the acquisition of the manual EDF image. The resulting image is displayed in the
Central Screen Area.

See also
2 Acquiring EDF Images with F12 Key [} 245]
2 Comparing Images Using Split Display [} 246]

4.5.3 Acquiring EDF Images with F12 Key

In this mode you can manually record a new image by pressing the F12 key on your keyboard.
With this you can achieve different time intervals between the individual acquisitions when you
change the focus position.

Prerequisite ü You have opened the Manual Extended Depth of Focus tool on the Locate tab.
1. If you want to store all acquired images in memory for a complete recalculation of the EDF
image after each single acquisition, activate Z-Stack. Note that the more images you ac-
quire, the more time it takes to calculate the EDF.
2. Click F12 Key.
3. Click Start to acquire the images.
à The Central Screen Area is split into two parts. On the left you can see the current live
image.
4. Press F12 on your keyboard to acquire an image manually.
à The calculated extended focus image on the right side is updated.
5. Move to a new focus position.
6. Repeat the last two steps until you have sharp images from all desired areas of your sam-
ple.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 245


4 Basic Functionality | 4.5 Manual Extended Focus ZEISS

7. Click Stop to finish your acquisition. If you want to pause the acquisition, click Pause.
You have finished the acquisition of the manual EDF image. The resulting image is displayed in the
Central Screen Area.

See also
2 Acquiring EDF Images with Timer [} 245]
2 Comparing Images Using Split Display [} 246]

4.5.4 Comparing Images Using Split Display

Prerequisite ü You have already acquired images with an extended depth of focus which you want to com-
pare to each other.

1. To compare images click .


à The split view opens.
2. On the Split Display view options tab, define an arrangement of two Columns and two
Rows.
à Four image containers are displayed in the Center Screen Area.
3. Move the different images from the Image and Documents gallery into the Center
Screen Area via Drag & Drop.

The comparison of all four methods (Timer, F12-key, Z-stack without shift, Z-stack with
shift) shows identical resulting images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 246


4 Basic Functionality | 4.5 Manual Extended Focus ZEISS

Fig. 14: Image comparison with multi image

See also
2 Acquiring EDF Images with Timer [} 245]
2 Acquiring EDF Images with F12 Key [} 245]

4.5.5 Manual Extended Depth of Focus Tool

Parameter Description
Z-Stack Activated: Stores all acquired images in memory and calculates the
EDF image based on all images after each individual acquisition. Note
that the more images you acquire, the more time it takes to calculate
the EDF.
Deactivated: Calculates the EDF image based on the last acquired
image and the previously calculated EDF image. Thus this mode is
only additive and does not store all acquired individual images nor
does it recalculate the entire image stack.

Quality Selects the quality level that you want the function to work with.

Registration Selects the method (or combination of methods) that is used to align
Method the images.

- Translation The neighboring sections of the z-stack image are shifted in relation
to each other in x and y direction.

- Rotation The neighboring sections of the z-stack image are rotated in relation
to each other.

- Iso Scaling The magnification is adjusted from section to section.

- Skew Scaling The neighboring sections of the z-stack image are corrected for skew-
ness/shearing.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 247


4 Basic Functionality | 4.6 Measurement ZEISS

Parameter Description
- Affine The neighboring sections of the z-stack image are shifted in x and y
direction, rotated and the magnification is adjusted from section to
section.

Interpolation Selects the interpolation that is performed if a pixel is calculated from


several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Mode

- Timer Acquires an EDF (Extended Depth of Focus) image automatically after


a defined time interval.

- F12 Key Acquires an EDF image when you press F12 key.

Interval Only active if Timer is selected.


Sets an interval (in sec.) after which the individual images are ac-
quired.

Start Starts the acquisition of an image series.

- Pause/Con- Pauses/Continues the acquisition.


tinue

- Stop Stops the acquisition.

See also
2 Acquiring EDF Images with Timer [} 245]
2 Acquiring EDF Images with F12 Key [} 245]

4.6 Measurement

This module enables you to measure morphological parameters of interactively defined contours,
like area, orientation angle, perimeter, diameter, center of gravity, radius of circle with equal area,
shape factor, bounding box, projections, etc. The free configuration of all interactive measure-
ment tools displays desired parameters in tables, lists or graphs. You can measure intensity values
for rectangles and contours and have the option for interactive measurement in online images.

4.6.1 Using Interactive Measurements

Prerequisite ü You have opened the image where you want to add measurements.
1. Go to the Analysis tab and open the Interactive Measurement tool.
2. In the Feature Subset section, click Define.
à A dialog opens.
3. Activate all the measurement features you want to be able to use for interactive measure-
ments.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 248


4 Basic Functionality | 4.6 Measurement ZEISS

4. Click OK.
à The dialog closes and the selected features are available for further definitions.
5. In the Feature Set section, click Define.
à A dialog opens.
6. In the Available Elements list, select the graphical element for which you want to define
measurement features.
à The already defined features for the respective element are displayed in the Selected
Features list in the middle.
7. To add an additional feature to the currently selected graphical element, double click the
feature in the list on the right, or select it and click .
à The feature is added to the element and is displayed in the Selected Features list.
8. Repeat the previous steps to define the features for all graphical elements you need.
9. Click OK.
à The changes are saved and the dialog for feature selection closes.
10. In the Measurement Sequence section, click Define.
à A dialog opens.
11. In the Available Elements list, double click the elements you want to add to the measure-
ment sequence.
à The elements are displayed in the Selected Elements Sequence list in the middle.
12. Optionally, you can also add additional features to the currently selected element of the se-
quence by double clicking the feature in the list on the right.
13. Click OK.
à The changes are saved and the dialog for sequence definition closes.
14. Click Run.
à The dialog for interactive measurement execution opens.
15. Click Start.
à You enter the drawing mode.
16. Go to the image and draw the graphical element.
à The first element of the sequence is drawn into the image and added to the table on the
left. The values are displayed in the image according to your previous settings.
à The second element of the sequence is automatically selected for drawing.
17. Continue drawing all elements of the sequence into the image.
18. Click Stop.
à You exit the drawing mode.
19. Click OK.
à The dialog closes and the image with measurements is displayed in the 2D view of ZEN.

4.6.2 Interactive Measurement Tool

Parameter Description
Feature Set

– Feature Set Selects and loads previously saved feature definitions/feature sets. If
Dropdown you have made changes to a feature definition, the name of the fea-
ture selection is marked with an asterisk (*). If you close the applica-
tion without saving a changed feature selection, you will be asked
whether you want to save the changes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 249


4 Basic Functionality | 4.6 Measurement ZEISS

Parameter Description
– Opens the options menu to create, import, export, save or delete a
feature set definition.
Options

– Define Opens the Feature Selection dialog to define the features that are
available for interactive measurements.

Feature Subset Only visible if Show All is activated.

– Feature Sub- Selects and loads previously saved definitions of subsets. If you have
set Dropdown made changes to a subset definition, the name of the feature subset
is marked with an asterisk (*). If you close the application without sav-
ing a changed feature subset, you will be asked whether you want to
save the changes.

– Opens the options menu to create, import, export, save or delete a


feature subset definition.
Options

– Define Opens the Feature Subset Definition dialog to define which fea-
tures are available for the definition of the feature set.

Measurement Se- Only visible if Show All is activated.


quence

– Measurement Selects and loads previously saved measurement procedures. If you


Sequence have made changes to a measurement procedure, the name of the
Dropdown measurement procedure is marked with an asterisk (*). If you close
the application without saving a changed measurement procedure,
you will be asked whether you want to save the changes.

– Opens the options menu to create, import, export, save or delete a


measurement sequence.
Options

– Define Opens the dialog to define the sequence of measurements that you
want to execute interactively.

Run Only visible if Show All is activated.


Opens a dialog to start the selected measurement sequence.

Create Measure- Creates a measurement data table and opens it as a separate docu-
ment Table ment. This contains the measurement data from the Measure view of
the current image.

See also
2 Using Interactive Measurements [} 248]

4.6.2.1 Feature Selection Dialog

In this dialog you can specify which features are measured with the available graphical elements.

Available Elements Section


This section displays all available graphical elements ordered by type. The following types are
available for selection:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 250


4 Basic Functionality | 4.6 Measurement ZEISS

Element Type Description


Region 2D Displays graphical elements you can use to define a closed region.

Line Displays graphical elements you can use to measure a single distance.

Lines Displays graphical elements you can use to measure several distances
at once.

Angle Displays graphical elements you can use to measure an angle.

Point Displays graphical elements you can use to perform measurements at


a pixel.

Points Displays graphical elements you can use to count various events in an
image.

Selected Features Section


This section displays the features that you selected for the currently selected graphical element.
These features are then measured when the element is drawn into the image. To add a new fea-
ture to the element, double click the feature in the list on the right, or select it and click .

Parameter Description
Name Displays the name of the feature.

Display Activated: The measured value of the feature is displayed in the


graphics plane of the image.

Deletes the selected feature.


Delete

Moves the selected feature one position higher.


Upwards

Moves the selected feature one position lower.


Downwards

Features Section
This section displays a list with all the features that are available for measuring the selected graph-
ical element. For a description of individual measurement features, see Measurement Features
[} 440].

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 251


4 Basic Functionality | 4.6 Measurement ZEISS

Parameter Description
- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features.


Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed.
tures Unscaled

- Polygon-based All features polygon-based features are listed.


Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

4.6.2.2 Feature Subset Definition Dialog

In this dialog you can specify which features are available in the Feature Selection dialog by acti-
vating the checkbox in front of the features. A right click menu offers the possibility to select or
unselect all features.

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features.


Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed.
tures Unscaled

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 252


4 Basic Functionality | 4.6 Measurement ZEISS

Parameter Description
- Polygon-based All features polygon-based features are listed.
Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

4.6.2.3 Interactive Measurement Sequence Definition Dialog

In this dialog you can define an interactive measurement procedure. You can specify the order in
which the individual graphic elements should be drawn in and which measurement parameters
you want to have calculated for them.

Available Elements Section


This section displays all available graphical elements ordered by type. The following types are
available for selection:

Element Type Description


Region 2D Displays graphical elements you can use to define a closed region.

Line Displays graphical elements you can use to measure a single distance.

Lines Displays graphical elements you can use to measure several distances
at once.

Angle Displays graphical elements you can use to measure an angle.

Point Displays graphical elements you can use to perform measurements at


a pixel.

Points Displays graphical elements you can use to count various events in an
image.

Double click on an element to select it and add it to the Selected Elements Sequence list.

Selected Elements Sequence Section


This list displays the selected graphical elements in the order in which they will be drawn during
the measurement, from top to bottom. To display the value of the measured feature in the image,
activate the corresponding checkbox. To add a new feature to the element, double click the fea-
ture in the list on the right, or select it and click .

Parameter Description
Deletes the selected feature.
Delete

Moves the selected feature one position higher.


Upwards

Moves the selected feature one position lower.


Downwards

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 253


4 Basic Functionality | 4.6 Measurement ZEISS

Features Section
This section displays a list with all the features that you can measure with the graphical element
activated in the Available Elements section. For a description of individual measurement fea-
tures, see Measurement Features [} 440].

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features.


Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed.
tures Unscaled

- Polygon-based All features polygon-based features are listed.


Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

4.6.2.4 Interactive Measurement Sequence Execution Dialog

With this dialog you can execute your previously defined sequence for interactive measurement.
You can draw the graphical elements into the image. You also have the standard controls of the
Dimensions and Display tabs to adapt the image display and change to other image dimensions
to draw the elements.
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 measure-
ments or annotations. Note that this cursor only works reliably on one channel, so for multi-chan-
nel 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.

Parameter Description
Operation

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 254


4 Basic Functionality | 4.7 Panorama ZEISS

Parameter Description
– Start Starts the drawing mode to add the sequence of graphical elements
to the image.

– Pause/Con- Pauses the drawing. This allows you to modify graphical elements
tinue that have already been drawn. The button changes to Continue for
resuming the drawing of the elements.

– Stop Ends the drawing mode of the measurement sequence.

Measurement Se- Displays the graphical elements of the current measurement sequence
quence in the predefined order.

Measurement Data Displays the values measured with the graphical elements. A right
Table click in the header of a column opens a context menu for the respec-
tive column.

Opens a context menu with options for the data table.


Options

– Sort Data Opens a dialog to define how to sort the data in the table.

– Filter Data Displays a field to define criteria for filtering the data in the table.

– Name Activated: Displays the column with the name of the graphical ele-
ments.

– Scene/Z-Posi- Only visible if the image contains the respective dimension(s).


tion/Time Activated: Displays the column with the image dimension (the scene,
z-position or time point).

– Feature Activated: Displays the column with the name of the measurement
feature used for the respective element.

– Value Activated: Displays the column with the measurement value.

– Unit Activated: Displays the column with the unit of the measurement.

– Add Columns Opens a dialog to add an additional column.

– Formula Col- Opens a dialog to add and define a formula column.


umn

– Delete Rows Opens a dialog to delete rows from the table.

OK Ends the execution of the interactive measurement and saves the


graphical elements drawn into the image.

Cancel Cancels the interactive measurement without saving the graphical ele-
ments.

4.7 Panorama

This module enables you to create overview images of large areas of your sample.

Prerequisites
For the interactive panorama acquisition following prerequisites are necessary:

§ All available microscope components in the MTB (MicroToolBox) have to be defined correctly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 255


4 Basic Functionality | 4.7 Panorama ZEISS

§ The Panorama module is licensed and activated under Tools > Modules Manager.

4.7.1 Prerequisites

Prerequisite ü You are on the Locate tab.


1. In the Lightpath tool set the components that you want to use for the acquisition.

à All these settings will be stored as metadata of the image.


à Additionally the optical components will be used to automatically determine the pixel
size for the scaling.
2. Click on the Live button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 256


4 Basic Functionality | 4.7 Panorama ZEISS

à Now you see the cameras live image of your sample in the Center Screen Area.
3. Click on the Set Exposure button.
à The exposure time will be calculated automatically.
4. Alternatively you can set the camera parameters manually in the Camera tool.
5. Focus on your sample now.
You have completed the prerequisites for a panorama experiment.

4.7.2 Acquiring a Reference Image

Before starting the experiment itself, we recommend tthat you first take a reference image for the
shading correction. This image will be used later for processing the panorama image.

1. Move the sample to an empty field.


2. Click on the Snap button to acquire this position as reference image.

3. Save the image and let it open in the background.


You have successfully acquired a reference image for the shading correction.

4.7.3 Settings for a Panorama Experiment

Prerequisite ü You are on the Acquisition tab.


ü You have started the live mode via the Live button.
1. Activate the Panorama checkbox.
2. Move the sample to the desired start field of the panorama image to be acquired.
3. Check the defined exposure time again if necessary.
à In the Display tab you can adjust the Display curve to avoid over-exposures in your im-
ages.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 257


4 Basic Functionality | 4.7 Panorama ZEISS

4. In the Imaging Setup tool, you can check the settings before/after the experiment.

à The Advanced Imaging Setup is only displayed if you have activated the Enable Ad-
vanced Imaging Setup checkbox under Tools > Options > Acquisition > Acquisi-
tion Tab > Enable Imaging Setup.
5. In the Acquisition Mode tool, click the Get button to transfer the active camera settings
into the experiment.
As an alternative you can define your experiment settings here as well.
6. In the Panorama tool you can adjust several options for automatic or manual stitching if
desired.
7. Finally save your experiment with a suitable name in the Experiment Manager.

4.7.4 Acquiring a Panorama Image

Info
4 After the image acquisition you can adapt the size of image and surrounding area with the
zoom keys F7 and F8 to your needs.
4 Keep a sufficient overlap area of the live image with the stored image.

1. Click on the Start Experiment button to start the Panorama acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 258


4 Basic Functionality | 4.7 Panorama ZEISS

à You will see the reduced display of the start image in the Center Screen Area.

à The displayed image is a live image. You can still change position and focus.
2. Click on the Acquire Tile Image button in the Center Screen Area to acquire the first tile
image.
à The image will be acquired and stored. The live image is still active as an overlay to the
stored image.
3. Move the blue frame with the active live image in the desired direction aside the stored im-
age by using the mouse.

4. Now move the sample to the corresponding neighbor position using the microscope stage.
à Try to position the structures in the overlap region as good as possible.
5. Click again on the Acquire Tile Image button to acquire this tile to the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 259


4 Basic Functionality | 4.7 Panorama ZEISS

6. Move the blue frame to the next position.

7. Continue these steps until you acquired the desired panorama image of your sample.
8. After acquiring the last tile image click on the Stop button to close the live mode.

9. Finally end the experiment via the Stop button on the Acquisition tab.
à As a result you now see the recorded panorama image in a new image container.

10. Save the image as a raw image (*.czi).


You have successfully acquired and stored a panorama image.

4.7.5 Acquiring a Panorama Image Automatically

The field of view of your microscope might be too small for the sample area you wish to acquire.
You can automatically visualize panorama images from a sample area which is larger than the
camera sensor can cover by means of a single snap.
With the Live Panorama tool, you can move the stage while the software automatically acquires
individual images, stitches them together and creates a panorama image.
Note that Live Panorama works for un-coded and un-motorized stages as well as motorized
stages.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 260


4 Basic Functionality | 4.7 Panorama ZEISS

Prerequisite ü You have set-up and configured your microscope system correctly.
ü You work with brightfield or widefield illumination.
ü Your image has sufficient contrast. Lower magnification objectives typically give better results.
ü A sample is on the stage and stays in focus. Note that you can adjust the focus during the
Live panorama.
ü You have started the software and selected the Locate tab. If you work with an LSM, activate
camera mode.
1. On the Locate tab, click the Live button to get a live image from the microscope camera.
Adjust the camera and microscope settings to see a well illuminated and sharp live image.
2. Navigate to a specific area on your sample you want to image.
à Move the stage gently and not too fast!
3. Select the Live Panorama tool, and click the Start Live Panorama button.
à After a short moment, the camera rectangle changes to green and you can move the
stage. The panorama acquisition starts. You see the live image of the sensor area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 261


4 Basic Functionality | 4.7 Panorama ZEISS

à Note that the color of the rectangle changes to orange or red, when the software loses
the stitching algorithm. This might happen if the stage is moved too quickly. Then you
have to manually go back to the last known or successfully synchronized position. If you
wish to image a continuous area of the sample without any gaps, we recommend using
a zig-zag pattern to move over your sample to slowly build up the image.

4. Move the stage slowly in the desired direction.


à During the stage movement the software automatically acquires the panorama image.
5. To finish the acquisition, click Live Panorama tool > Stop button.
à A message is displayed, prompting you to decide if you want to generate an image pyra-
mid to optimize the later display of your image.
6. Click Yes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 262


4 Basic Functionality | 4.7 Panorama ZEISS

The panorama image is added to the Documents tab > Images and Documents tool.
Stitching artifacts can be corrected by making sure the camera rotation has been corrected. You
can make use of the stitching image processing function to correct them.
You can save the image to your file system.

See also
2 Live Panorama Tool [} 269]

4.7.6 Processing a Panorama Image

The next chapters will show you how to process panorama images with the Stitching processing
function. Using this method you can correct an offset between the tile images. We will show you
the different settings and make a comparison of the output images. So you can see which settings
will give you the best result.

Prerequisites

Prerequisite ü You are on the Processing tab.

1. Open the Method tool and select in the group Geometric the Stitching function.
The following instructions are all based on this selection and show the different settings and re-
sults of this function.

4.7.6.1 Stitching (Defaults)

1. In the Method tool open the Geometric group.


2. Select the Stitching function.
3. Click on the Apply button in the Processing tab to start the processing.
à The stitching process will take a while depending on the image size.

à In the Status bar you can see the work in progress.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 263


4 Basic Functionality | 4.7 Panorama ZEISS

You have successfully used the Stitching function. As you still can see shadows and edges in the
output image, we will show you how to use the function receiving better results in the following
chapters.

4.7.6.2 Stitching with Shading Correction

If your tile images contain a certain background shading, you can correct this if you have acquired
a reference image for the shading correction. This image has to be opened in the Center Screen
Area.

1. Select in the tile image for the stitching in the Input tool as first input.
2. In the Parameters tool select the New Output button.

à This will keep the original image and create a new output image.
3. Activate the Correct Shading checkbox.
4. Select the Reference entry from the dropdown list.
à This will let you select your reference image which is opened in Center Screen Area.
5. Now as a second input image select the reference image for the shading correction in the
Input tool.
6. Click on the Apply button to start the processing.
As a result you will get a stitched panorama image without any shading influences. The next
chapter will show you how to get rid of the edges which are still visible between the tiles.

4.7.6.3 Stitching with Fuse Tiles

With very low shading content in the image you have an alternative method to homogenize the
image transitions between the single tiles.

1. Under Image Parameters in the Input tool select the tile image for the stitching.
2. In the Parameters tool, click on the New Output button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 264


4 Basic Functionality | 4.7 Panorama ZEISS

3. Activate the Fuse Tiles checkbox.

4. Click on the Apply button to start the processing.


This function will smoothly average all edge regions of the tiles via their grey values in order to
avoid sharp edges. With high background shading this function alone will not be sufficient.

4.7.6.4 Stitching with Fuse Tiles and Shading Correction

For extreme cases you have the possibility to combine both transition corrections.

1. In the Parameters tool click on the New Output button.


2. Activate the checkboxes Correct Shading and Fuse Tiles.

3. Under Image Parameters in the Input tool select the tile image for the stitching and the
reference image for the shading correction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 265


4 Basic Functionality | 4.7 Panorama ZEISS

4. Click on the Apply button.


Both settings will be applied to the image. With this method you will receive a perfectly stitched
image with no visible transition areas between the tiles anymore.

4.7.6.5 Image Comparison via Split Display

You can create a Multi Image to compare the different results of your processed images via the
Splitter-Mode.

1. To compare different images, you can select the Split Display via the Create New Multi

Image button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 266


4 Basic Functionality | 4.7 Panorama ZEISS

2. On the Split Display tab you can define how many images shall be displayed in X- and Y-
direction aside each other and how they shall be synchronized, e.g. 2 Columns and 2
Rows.

3. Move each of the different panorama images via drag&drop from the Right Tool Area >
Images and Documents gallery to an empty frame in Center Screen Area.
In our example we show the transition areas of the tile image as raw image (top left), as fused
tile image (top right), as shading corrected tile image (bottom left) and finally the combination
of shading correction and fused tiles (bottom right). In this last image no transitions between
the tiles are visible anymore.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 267


4 Basic Functionality | 4.7 Panorama ZEISS

4.7.7 Panorama Tool

Here you can adjust settings for the panorama acquisition.


After you have acquired the single tile images simply activate the Perform stitching after the
experiment checkbox. If you want to stitch the images manually, click on the Perform Stitching
button, after you have finished the experiment.
The panorama acquisition itself is performed interactively via in the Panorama view. If you click
on Start Experiment' the Panorama view opens and you can start to acquire the single tile im-
ages.

See also
2 Panorama View [} 268]

4.7.8 Panorama View

In this view you see the representation of the microscope stage. The Live image from the camera
(blue frame) is automatically shown in the middle of the image area. Furthermore a tool window
is displayed, that allows you to control the image acquisition, e.g. perform auto exposure or ac-
quire an individual tile image.

See also
2 General View Options [} 1029]

4.7.8.1 Stage View

In the image area the full travel range of the microscope stage is displayed. You can control the
stage view using the arrow icons at the edges of the image area. The view can be enlarged, re-
duced or moved using the general control elements.

Navigator frame
The current stage position is shown as a tile outlined in blue, the Navigator frame. In the Naviga-
tor frame you can see the camera's live image.
To move the frame, double-click on the position on the microscope stage to which you want to
move it.
To acquire images, use the Acquisition buttons in the Tools window.

See also
2 Tools Window [} 268]

4.7.8.2 Tools Window

The tool window for panorama view is normally visible in the lower right corner of the center
screen area. It becomes active if you move the cursor over it. You can use it to set acquisition pa-
rameters and acquire tile images for your panorama image.

Parameter Description
Center to Live Nav- Centers the stage view at the current position of the Navigator frame.
igator

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 268


4 Basic Functionality | 4.8 Third Party Import ZEISS

Parameter Description
Action Buttons With the three action buttons (Live, Set Exposure, Continuous)
you're able to control acquisition parameters like you are used to do it
on the Acquisition tab.

Acquire Tile Image Acquires a tile image. This comprises all activated channels as well as
Z-stacks. After the acquisition, the tile image is placed in the corre-
sponding location in the stage view.

4.7.9 Live Panorama Tool

With this tool you can acquire a panorama image exceeding the size of a single image.

Parameter Description
Start Live Starts the acquisition. The button disappears. The animated Stop but-
Panorama ton appears in the window above the button.
For more information, see Acquiring a Panorama Image Automati-
cally [} 260].

4.8 Third Party Import

This module enables you to import the BIO-Formats by OME (Open Microscopy Environment).
More details on the supported BIO-Formats, see https://www.openmicroscopy.org/ .

4.9 ZEN Data Storage Client

Info
Time Deviation
In the very unlikely event that there is a time deviation greater than five minutes between the
client and the server, the authentication of the client fails for security reasons. In this case an
error message is displayed and working with ZEN Data Storage is not possible. You have to fix
the system time of the client and/or server before a retry.

You can store your data on your computer's file system. Additionally, you have the option to save
your projects and images in a database called ZEN Data Storage. This makes the information more
accessible, as you can search within the database and filter your results. The data storage is an ad-
ditional product which has to be installed. For more information, refer to the installation guide of
ZEN Data Storage.
To activate the access and use of the database, you need to go to Tools > Modules Manager to
activate Data Storage Client. Afterwards restart the software.

4.9.1 Setting up ZEN Data Storage Server

After the installation of ZEN Data Storage (for information see the Installation Guide ZEN Data
Storage), you have to set up the server in ZEN. This setup has to be done once on every machine
using the data storage.

Prerequisite ü You have installed ZEN Data Storage.


ü You are logged in as an administrator (if you use ZEN with user management).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 269


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

ü In Tools > Modules Manager, the Data Storage Client module is activated.
1. Click Tools > Options > Settings.
2. On the Simple tab, change the Host Name if necessary.
3. Select the Hosting Scheme you use for the server.
4. Set the Storage Server Port.
5. Click Server Setup.
6. Click Yes to confirm the message and setup ZEN Data Storage.
à The server is set up in ZEN and a setup dialog opens.
7. Click Close to exit the setup dialog.
à Your server settings are also automatically validated and the result is displayed below the
Validate Settings button.
8. Click OK to close the Tools > Options dialog and save all settings.
You have successfully set up your ZEN Data Storage server in ZEN.

See also
2 Storage Settings Tab [} 852]

4.9.2 Validating the ZEN Data Storage Settings

When setting up your ZEN Data Storage on the Settings tab of the Tools > Options dialog, your
server settings are usually validated automatically. For a manual validation and to look up the sta-
tus, take the following steps:

Prerequisite ü You have installed ZEN Data Storage.


ü You are logged in as an administrator (if you use ZEN with user management).
ü In Tools > Modules Manager, the Data Storage Client module is activated.
1. Click Tools > Options > Settings.
à A status message is displayed on the page.
2. Click Validate Settings.
à The status message below the button is updated. In case the validation succeeded, the
message displays the currently used server version as well as the minimal required ver-
sion. In case the validation failed, an error message is displayed.

4.9.3 Saving an Image to ZEN Data Storage

You can save any image to the data storage. You can also open images from the data storage,
update them, and save the updated image to the data storage.

Prerequisite ü You have opened an image.


1. Click on File > ZEN Data Storage > Save Image.
The image is saved to the data storage.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 270


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

4.9.4 Saving a ZEN Connect Project to ZEN Data Storage

Info
Changes to local project
If you save a ZEN Connect project to the ZEN Data Storage, the local project file is changed
and cannot be used any more to open the project in ZEN. The project has to be opened from
the ZEN Data Storage, see Opening or Deleting a ZEN Connect Project from ZEN Data Stor-
age [} 273].

You can save existing ZEN Connect projects that are currently saved on your computer to the data
storage. If you save a project with images, the image information is contained in the Project
View. You can check it in the Layers View.
Optionally, you can create a new project and save it immediately to the data storage.

Prerequisite ü You have loaded a ZEN Connect project that is saved to your computer, or you are in the
process of creating a new Connect project.
1. Click File > ZEN Data Storage > Save and Convert ZEN Connect Project.
The ZEN Connect project is saved to ZEN Data Storage.

See also
2 Saving an Image to ZEN Data Storage [} 270]

4.9.5 Exporting a ZEN Connect Project from ZEN Data Storage

Info
Saving changes
If you have made changes to a ZEN Connect project opened from ZEN Data Storage, you have
to first save the project back to the database (via File > ZEN Data Storage > Save ZEN Con-
nect Project) before you export it.

In ZEN, you can export a ZEN Connect project from the ZEN Data Storage to use it locally, e.g. on
a machine with no access to the database.

Prerequisite ü You have opened your project from ZEN Data Storage in ZEN, see Opening or Deleting a ZEN
Connect Project from ZEN Data Storage [} 273].
1. In the ZEN Connect tool, select Export Project... for the Export button.
2. In the file browser, select the location where you want to export your project.
3. Click OK.
à Your project is exported to the selected location. The state of the export is displayed in
the progress bar. For each exported project a subfolder is created in the selected export
location.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 271


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

4.9.6 Uploading Images Automatically After Acquisition

Info
If you have a ZEN Connect project open, you cannot upload the image to ZEN Data Storage.
The folder in the Auto Save tool is automatically set to the path of the project and you cannot
select an upload to the server.

Info
Using Direct Processing and ZEN Data Storage
If you are using the ZEN Data Storage server as the location for storing your data, all acquisi-
tion and processing computers involved must have access to the transfer share defined in ZEN
Data Storage.
Also note that the images are only uploaded to ZEN Data Storage after they are now longer
open in ZEN.

Prerequisite ü You have set up ZEN Data Storage in ZEN.


ü You have defined a default transfer share in the server management (or during the installa-
tion) of ZEN Data Storage. Both the server and ZEN need to have access to this folder. For in-
formation, also refer to the installation guide of ZEN Data Storage.
1. On the Acquisition tab, activate Auto Save.
à The Auto Save tool is displayed on the Acquisition tab.
2. In the Auto Save tool, select Store in ZEN Data Storage Server from the dropdown
menu.
3. If you want to directly add the image to a collection, select it in the respective dropdown.
4. Setup and start your experiment as usual.
After the experiment is finished and the images are closed in ZEN, they are automatically up-
loaded to ZEN Data Storage and added to the selected collection after the acquisition is finished.

4.9.7 Opening or Deleting an Image from ZEN Data Storage

1. Click File > ZEN Data Storage > Open Image.


à The Stored Documents [} 277] dialog is displayed.
2. Double-click the image you want to open. Alternatively, select the image and click Open.
The Stored Documents closes and the image is loaded in ZEN.

Deleting an image from the data storage

Prerequisite ü You have opened the Stored Documents [} 277] dialog.


1. Right-click the image you want to delete, and select Delete document. Alternatively, se-
lect the image and click .
à You are prompted to confirm the operation.
2. Click Yes.
The image is deleted from the data storage.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 272


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

4.9.8 Opening or Deleting a ZEN Connect Project from ZEN Data Storage

Info
Working locally
If you have opened a ZEN Connect project from ZEN Data Storage, but you want to work with
it locally, use the export functionality before you make any changes to the opened project, see
Exporting a ZEN Connect Project from ZEN Data Storage [} 271].

Prerequisite ü You have saved a ZEN Connect project to ZEN Data Storage, see Saving a ZEN Connect
Project to ZEN Data Storage [} 271].
1. Click File > ZEN Data Storage > Open ZEN Connect project.
à The Stored Documents dialog opens.
2. Select the ZEN Connect project and click Open.
In the ZEN Connect Project View, the current state of the project is displayed. In the Image
View, the sample holders are marked and previously acquired images are displayed. Note that the
project including its images is linked in the data storage. So take care that these files are not
moved or deleted as the links will be broken.
The current stage position is marked with a cross hair.

Deleting a Connect project from ZEN Data Storage

Prerequisite ü You have opened the Stored Documents dialog.


1. Right-click the project you want to delete and select Delete Document. Alternatively, se-
lect the project and click .
à You are prompted to confirm the deleting.
2. Click Yes.
The ZEN Connect project is deleted from ZEN Data Storage.

See also
2 Stored Documents Dialog [} 277]

4.9.9 Configuring the Stored Documents Table

In the Stored Documents dialog, you select Connect projects or images to open or to delete.
You can configure the columns of the table according to your needs.

1. Click File > ZEN Data Storage > Open ZEN Connect Project or File > ZEN Data Stor-
age > Open Image.
à The Stored Documents dialog opens.
2. Right-click into the header of the table and activate the columns you want to see in the ta-
ble.
You have configured the table.

See also
2 Stored Documents Dialog [} 277]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 273


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

4.9.10 Filtering Connect Projects and Images in ZEN Data Storage

1. Click File > ZEN Data Storage > Open ZEN Connect Project or File > ZEN Data Stor-
age > Open Image.
à The Stored Documents [} 277] dialog opens.

2. Click .
à The search area with filter panel and metadata of the search results is displayed. The
number in brackets indicates the amount of search results.
3. To limit the search results, select a term of interest.
à The available images are displayed accordingly.
4. Optionally, enter a term you are looking for in the Search field, e.g., the file name.
5. To filter images based on their tags, click Tags.
à An input field opens as dropdown.
6. In the search field, enter a term you want to filter for. Alternatively, in the list of available
tags, activate all tags you want to filter for and activate Or/And, depending on whether the
filtered images should contain all activated tags (And), or at least one of the tags (Or).
à The filter for tags is applied.
The available files are filtered and displayed accordingly.

4.9.11 Adding and Deleting Tags for ZEN Data Storage Images

To structure your image data in ZEN Data Storage, you can also add tags to individual images.

Prerequisite ü You have opened the Stored Documents Dialog [} 277].


1. In the data table, select the image.
à A preview of the image is displayed on the right side of the dialog.

2. Under the preview of the image, open the Metadata section by clicking .
à An additional section with the image metadata opens.
3. For Tags, click +.
à A text field is displayed.
4. Enter the respective name and press Enter.
à The tag is added to the image.
5. To delete a tag, click X in the tag name.
à The tag is removed.
You have added (or deleted) a tag for an image in ZEN Data Storage.

4.9.12 Creating a Collection for Data

You can create collections to structure your data and share it with others.

Prerequisite ü You have started the application with active user management to be able to add users or
groups to a collection.
1. Go to Tools > Options > Collections.
2. Click .
à The Add Collection dialog opens.
3. Enter a name for the new collection.
4. Click .

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 274


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

à The Add Collection Access dialog opens.


5. On the Groups and/or Users tab, select the group or user you want to grant access to the
collection. Selection of multiple users and groups is possible by pressing Ctrl.
6. Select the Access Level for the currently selected user(s)/ group(s).
7. Click OK.
à The Add Collection Access dialog closes and the selected user(s) and/or group(s) are
granted access based on the selection.
8. You can now adapt the Access Level of individual users and groups of this collection, if nec-
essary.
9. Click OK.
à The Add Collection dialog closes.
You have created a collection for your data. You can now structure your data and also share it
with the people having access to this collection.

See also
2 Add/Edit Collection Dialog [} 853]
2 Add Collection Access Dialog [} 853]
2 Editing or Deleting a Data Collection [} 275]

4.9.13 Editing or Deleting a Data Collection

Prerequisite ü You have created a collection for your data. For more information, see Creating a Collection
for Data [} 274].
ü You have started the application with active user management to be able to add users or
groups to a collection or edit them.
1. Go to Tools > Options > Collections.
2. To delete a collection, select it and click .
3. To edit a collection, select it and click .
à The Edit Collection dialog opens.
4. If you want to change the name, adapt it under Collection Name.
5. If you want to change the access of a particular user, change the Access Level with the re-
spective dropdown.
6. To add a new user or group, click .
à The Add Collection Access dialog opens.
7. On the Groups and/or Users tab, select the group or user you want to grant access to the
collection. Selection of multiple users and groups is possible by pressing Ctrl.
8. Click OK.
à The Add Collection Access dialog closes and the selected user(s) and/or group(s) are
granted access based on the selection.
9. Click OK.
à The Edit Collection dialog closes.
10. Click OK.
à The Tools > Options dialog closes.
You have edited (or deleted) this collection.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 275


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

4.9.14 Adding Data to a Collection

In ZEN Data Storage you can share your data with a collection.

Prerequisite ü You have created collections for ZEN Data Storage, see Creating a Collection for Data
[} 274].
1. Click File > ZEN Data Storage > Open Image if you want share an image, or click File >
ZEN Data Storage > Open ZEN Connect Project if you want to share a project.
à The Stored Documents dialog opens.
2. Select the files you want to share. To select multiple files, press Ctrl while clicking on the
files.
3. Right click on the selected images or projects and select Add to Collection. Alternatively,
click .
à The Add to Collection dialog opens.
4. In the table, activate the checkbox for every collection you want to share the data with.
5. Click Save.
You have shared your images or projects with other users/groups that are part of a collection.
Shared files are marked by in the Shared column.

4.9.15 Sharing Data Directly With Users and Groups

In ZEN Data Storage you can directly share your data with other users or groups.

1. Click File > ZEN Data Storage > Open Image if you want share an image, or click File >
ZEN Data Storage > Open ZEN Connect Project if you want to share a project.
à The Stored Documents dialog opens.
2. Select the file you want to share.
3. Right click on the selected images or projects and select Share and Manage Access. Al-
ternatively, click .
à The Share and Manage Access dialog opens.
4. Enter the name of the user or group you want to share the data with and select it from the
list.
5. In the access dropdown, select the access level for the respective user or group and click
Add.
à The user or group is added to the table and the access right is displayed.
6. Repeat the previous steps until all users and groups that you want to share your data with
are added to the table.
7. Click Save.
You have directly shared your image or project with other users and groups.
Shared files are marked by in the Shared column.

4.9.16 Adding an Active Directory User

Info
Domain Administrator
It is not possible to use the initial Active Directory domain administrator as a user for ZEN Data
Storage. The administrator account for the Active Directory domain should only be used for
the administration of the Active Directory itself.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 276


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

When you are using ZEN with ZEN Data Storage, you can add individual Active Directory users to
your user management.

Prerequisite ü ZEN is open with active user management and you are signed in as administrator.
ü You are using ZEN Data Storage and have configured an Active Directory group to be able to
use Active Directory in ZEN, see Setting Up the Login with Windows Credentials (Active Di-
rectory) [} 48].
ü During the installation of ZEN Data Storage, you have set the parameter Enable Active Di-
rectory to True on the Settings tab of the installer. For more information also refer to the
installation guide for ZEN Data Storage.
ü The ZEN Data Storage server must be part of the same Windows domain from where the soft-
ware tries to login with its Windows credentials.
1. Go to Tools > Users and Groups.
à The User and Group Management dialog opens.
2. Go to Users.
à The tab displays all currently configured users.

3. Click .
à The New User dialog opens.
4. For Type, select Active Directory.
5. For Name, click .
à The Select User dialog opens.
à The fields for object type and location are filled with a default. To change them, click Ob-
ject Types or Locations to open another dialog to select the respective Object Types
or Locations.
6. In the text field below, enter the name of the user you want to select. If you are not sure if
your name is correct, click Check Names to open a dialog and select the suitable entry.
7. Click OK.
à The name is displayed in the New User dialog.
8. Click OK to close the New User dialog.
à The respective Active Directory user is added to the list of users.
9. Click OK to close the User and Group Management dialog.
You have configured an Active Directory user. You can now assign this user to a group to grant
him certain rights and privileges.

4.9.17 Stored Documents Dialog

With this dialog you can open images or ZEN Connect projects saved in the ZEN Data Storage.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 277


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

1 Stored Data
Displays the data available in ZEN Data Storage (images or ZEN Connect projects) and
provides functionality to filter the data, see Stored Data Section [} 278].

2 Image Preview
Displays a preview of the currently selected image. This functionality is only available if
you try to open images from the data storage, there is no preview available for ZEN Con-
nect projects. For image documents that contain attachments like thumbnails, label or
preview scans, a special control in the Image Control Section allows you to switch the
view to those attachments.

3 Image Control Section


Displays metadata information and controls for the image preview as well as the general
controls to open the selected data or close the dialog, see Image Control Section
[} 281].

See also
2 Saving a ZEN Connect Project to ZEN Data Storage [} 271]
2 Saving an Image to ZEN Data Storage [} 270]
2 Opening or Deleting an Image from ZEN Data Storage [} 272]
2 Opening or Deleting a ZEN Connect Project from ZEN Data Storage [} 273]

4.9.17.1 Stored Data Section

Parameter Description
Search Searches the database for the term entered in the text field.

Tags Opens an input field to filter images based on their tags, see Filtering
Connect Projects and Images in ZEN Data Storage [} 274].

– Search Field Searches the image tags for the input of this field

– Or Activated: Applies a logical Or operator if multiple tags are selected


in the list below and filters for all images that contain at least one of
the selected tags.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 278


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

Parameter Description
– And Activated: Applies a logical And operator if multiple tags are se-
lected in the list below and filters only images that contain all selected
tags.

– Tag List Displays all available tags. Filters the documents in ZEN Data Storage
based on the activated tags of this list.

– Clear Clears all filter criteria for tags.

Displays a filter panel with metadata, see Filtering Connect Projects


Options and Images in ZEN Data Storage [} 274].

File Dropdown Selects which files are displayed in the table below. If you have access
to collections, they are also displayed as an option in the dropdown,
see Creating a Collection for Data [} 274].

– All Files Displays all accessible data.

– My Files Displays only my images or projects.

– Files Shared Displays all files that are shared with me, including public images/
With Me projects.

Document Table Displays all available images or ZEN Connect projects and information
about them. The table entries can be sorted according to each individ-
ual column. You can customize the view of the table by toggling the
visibility of individual columns, see Configuring the Stored Docu-
ments Table [} 273].
The displayed information for the images are extracted from the im-
age metadata. If you have configured ZEN Data Storage to extract
custom metadata, they can also be displayed as columns. For informa-
tion about configuring custom metadata, see the installation guide of
ZEN Data Storage.
Additional functionality for the images or projects is provided by an
extra right click menu, see Stored Documents Right Click Menu
[} 280].

– Preview Displays the preview of the image.

– File Name Displays the file name and the format of the image. You can sort the
file names alphabetically.

– Original File Displays the original file name in case you have uploaded the image
Name as a third party image with the ZEN Data Storage Uploader.

– File Size Displays the file size.

– Software Ap- Displays with which software application the image was acquired.
plication

– Software Ap- Displays the version of the software application.


plication Ver-
sion

– Created Date Displays the creation day.

– Last Changed Displays at what date the image was last changed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 279


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

Parameter Description
– Shared Displays if the file is shared with others.

– Comment Displays a comment.

– Microscope Displays the type of the microscope.


Type

– Microscope Displays the user defined custom name of the microscope.


Name

– System Name Displays the system name.

– Objective Displays the name of the objective.


Name

– Objective Displays the objective magnification.


Magnification

– Reflector Displays the reflector.

– Channel Name Displays the name of the channel.

– Camera Name Displays the name of the camera.

– Scaling Displays the scaling.

– Imaging Light Displays the name of the imaging light source.


Source Name

Opens the Share and Manage Access dialog to directly share the
Share and Manage selected file with a user or group, see Sharing Data Directly With
Access Users and Groups [} 276].

Opens the Add to Collection dialog to share the selected files with a
Add to Collection collection, see Adding Data to a Collection [} 276].

Deletes the selected documents from the database.


Delete Document

4.9.17.1.1 Stored Documents Right Click Menu

If you right click a document in the list, the following menu items are displayed.

Parameter Description
Share and Manage Opens the Share and Manage Access dialog to share the file with a
Access user or group, see Sharing Data Directly With Users and Groups
[} 276].

Add to Collection Opens the Add to Collection dialog to add the selected file to a col-
lection, see Adding Data to a Collection [} 276].

Delete Document Deletes the selected document from the database.

See also
2 Add to Collection Dialog [} 281]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 280


4 Basic Functionality | 4.9 ZEN Data Storage Client ZEISS

4.9.17.2 Image Control Section

Parameter Description
Z-Position Only available for z-stack images.
Selects which z-slice is displayed in the preview.

Time Only available for time series images.


Selects which time point is displayed in the preview.

Only visible, if the selected image document contains attachments


Preview Image (e.g. a thumbnail, label or preview scans) like for Axioscan images.
Control Selects which image is displayed in the preview area by using the ar-
rows or clicking on the small circles. The small circles also display a
tooltip indicating what kind of image it is (e.g. Label).

Metadata Displays a section with metadata of the selected image.

– Tags Displays and edits tags for the image. For more information, see
Adding and Deleting Tags for ZEN Data Storage Images [} 274].

– Image Meta- Displays metadata for the currently selected image. The metadata is
data synchronized with the displayed columns in the stored data section on
the left.

Open Opens the image or project in ZEN.

Cancel Closes the dialog without opening a file.

4.9.18 Add to Collection Dialog

Parameter Description
Search for Collec- Searches the collections according to the input.
tions

Table Displays all available collections.

– Name Displays the names of the collections.


Activated: The image is shared with the respective collection.

– Shared Shared collections are marked with .

Manage Collec- Opens the Manage Collections dialog to manage the collection.
tions

Save Saves the changes and closes the dialog.

Cancel Closes the dialog without saving.

See also
2 Collections Tab [} 852]
2 Adding Data to a Collection [} 276]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 281


4 Basic Functionality | 4.10 ImageJ ZEISS

4.9.19 Share and Manage Access Dialog

Parameter Description
Enter Name Searches all available users and groups according to the input and se-
lects a user or group from a dropdown.

Access Rights
dropdown

– Read Grants the group/user access to see, open and download a docu-
ment.

– Write Grants the group/user access to modify a document.

– Manage Grants the group/user access to modify the access control list.

Add Adds the selected user or group with the selected access right to the
table.

User and Group ta- Displays all users and groups added for sharing the file.
ble

– User or Group Displays the name of the user or group.

– Access Right Displays the access right for the respective user or group and allows
you to change the access.

– Remove Removes the entry by clicking the button.

Save Shares the file with the users and groups defined here and closes the
dialog.

Cancel Closes the dialog without sharing the file.

See also
2 Sharing Data Directly With Users and Groups [} 276]

4.10 ImageJ

This extension offers following possibilities:

§ Easy exchange of images, from simple two-dimensional images, to more complex, multidi-
mensional entities, like Z-stacks, time series and so on. The exchange can go both ways, from
ZEN to ImageJ, as well as from ImageJ to ZEN.
§ Execute functions in ImageJ, without having to leave the ZEN environment.
§ Combine the two benefits, introduced above: sending a ZEN image to ImageJ, having it pro-
cessed there, and then returning the resulting image back to ZEN in one single step.
Note that different versions and variants of ImageJ and Fiji exist. This document is based on the
ImageJ/Fiji version 1.46. See notes for specifics of other versions and variants. For the sake of sim-
plicity, Fiji is implied also, wherever ImageJ is mentioned in the following text.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 282


4 Basic Functionality | 4.10 ImageJ ZEISS

4.10.1 Preparations

Info
Note that the extension for ImageJ is not available in ZEN lite.

1. Install ImageJ on your computer. Make sure that you use the latest version (check for on-
line updates after installation).
2. Download loci_tools.jar and drop it into in the ImageJ/plugins folder.
3. Note the name of the folder with your preferred alternative. While you can switch freely
among them all, it makes sense to stick to one and the same environment, once you have
started to add your own programs and macros.
4. The ImageJ/Fiji folder you will eventually decide on, can either belong to you alone or be
shared among other users of the system. It is up to you decide, what you prefer: if you are
the only user, nobody will meddle with its contents (images, macros etc), but then, you will
need to copy and distribute the contents, if they are of interest to others as well.
You have successfully fulfilled all prerequisites. You can now continue with setting up ImageJ
within ZEN software.

4.10.2 Activate ImageJ Extension

The extension is automatically included in the ZEN installation. To set it up, start the software and
then proceed as follows:

1. Go to Tools > Options > ImageJ.


2. In the ImageJ Executable dropdown list, select your preferred ImageJ.exe.
3. If you prefer another executable or your preferred executable is not in the list, click on the
last entry ... to search for it.
You have successfully set up ImageJ extension within the software. Now you can start working
with the extension.

4.10.3 Sending and Retrieving Images

1. In the Left Tool Area, click on the Extensions tab.


à The tool group ImageJ will appear containing the Apply tool.

2. To send an image from ZEN to ImageJ select the image in ZEN.


3. In the Apply tool, click on the Send Image button.
à The image will be sent to ImageJ and opened within a new image frame. You can now
edit the image within the ImageJ application.
4. To retrieve an image from ImageJ to ZEN select the image in ImageJ.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 283


4 Basic Functionality | 4.10 ImageJ ZEISS

5. Click on the Retrieve Image button.


à The image will be opened in ZEN.
You have successfully exchanged images between ZEN and ImageJ.

4.10.4 Use ImageJ Methods

The extension offers the possibility of sending images to ImageJ to get processed, to retrieve the
result of the operation or both. The following instruction will show the basic steps which are nec-
essary to apply ImageJ methods on any images.

Prerequisite ü You are on the Extensions tab in the ImageJ group.


1. In the Methods tool select the command or method to be executed, e.g. an ImageJ macro.

2. In the Parameters tool, specify if the method selected will need an input image and/or
provide a resulting image.
3. In the Apply tool, click on the Apply button to execute the command.
You have successfully applied an method to an image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 284


4 Basic Functionality | 4.10 ImageJ ZEISS

4.10.5 Image Type Send/Retrieve Conventions

ZEN to ImageJ

Image Type Received Comments


as…
.tif, .jpg, .bmp, .png, .gif Original

.ome.tif Original

2D image B/W .czi 32-bit (RGB) Convert the image in ImageJ to the required
pixel type using Image > Type command

2D image 24/48 bit 32-bit (RGB)


color .czi

2D image 36/42 bit - Convert the CZI image to 24/48 bits before
color .czi sending it or using it in a method

Multi-channel x Z-Stack x MD image If necessary, reassign the dimensions using


T-series Image > Hyperstacks for instance. Channel
colors may be different from those set in ZEN

Tiled images - Only the first tile gets loaded.

12bit B/W images Error in Im- Workaround: convert the pixel type of the
ageJ image to 16 bits in ZEN

ImageJ to ZEN

Image Type Received Comments


as…
.tif, .jpg, .bmp, .png, .gif Original

.ome.tif Original

2-D images, B/W and RGB B/W, RGB TIF

Multi-channel x Z-Stack x MD image Hint: select RGB in Quick Color Setup to get
T-series the same colors for channels as in ImageJ

Tiled images - Only the first tile gets loaded.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 285


5 Acquisition Toolkits | 5.1 Experiment Designer ZEISS

5 Acquisition Toolkits
You can expand the software functionality with the following acquisition packages:

Toolkit Included Functionality


Base Acquisition § Multi-Channel [} 327]
§ Time Series [} 390]

Motorized Focus Ac- § Extended Focus Processing [} 244]


quisition § Software Autofocus [} 328]
§ Z-Stack [} 394]

Motorized Acquisi- § Extended Focus Processing [} 244]


tion § Software Autofocus [} 328]
§ Tiles & Positions [} 337]
§ Z-Stack [} 394]

Advanced Acquisi- § Extended Focus Processing [} 244]


tion § HDR Confocal Basic [} 327]
§ Software Autofocus [} 328]
§ Tiles & Positions [} 337]
§ Z-Stack [} 394]

Smart Acquisition § Experiment Designer [} 286]


§ Experiment Feedback [} 289]
§ Guided Acquisition [} 319]

5.1 Experiment Designer

This module allows you to configure inhomogeneous acquisition experiments with support for all
experiment dimensions: time series, z-stacks, tile images and channels. Experiments can consist of
any number of components. A component is referred to as an experiment block. Each experiment
block has a distinct number, which is shown above the block. In the dedicated tool, you can set
up four different types of experiment blocks and make use of a set of powerful processing func-
tions to extract or fuse multiblock images. Experiment Designer allows the definition of a number
of iteration loops, and synchronous or asynchronous control of hardware actions during the ex-
periment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 286


5 Acquisition Toolkits | 5.1 Experiment Designer ZEISS

5.1.1 Experiment Designer Tool

Info
4 Each acquisition block can be seen as its own independent single experiment with its own
individual settings.
4 Each experiment block can have its own dimensions (e.g. channel settings like exposure
time, active camera, camera parameters; Z; T).
4 If an objective change is required, create a separate Execute block for this change.
4 Focus strategies are block specific as well.
4 You can change the order of experiment blocks via drag & drop in the experiment time-
line.
4 Special actions that influence the course of an experiment are performed with a special
block.

Parameter Description
Mode Only visible for Celldiscoverer 7.

– Standard Selects the standard mode for designing your experiments. The pa-
rameters are described below.

– Multi Carrier Selects the multi carrier mode which allows you to define experiments
for the individual carriers of a multi carrier insert. For the descriptions
of the parameters, see Experiment Designer (Multi Carrier Mode)
[} 1182].

Import Opens a dialog to import a block from an existing experiment.

Export Opens a dialog to select which experiment blocks you want to export
to the file system.

Create Creates a new block of the currently selected type. Clicking on the ar-
row opens a dropdown to select which type of experiment block you
want to add. Each created block is displayed in the Timeline of the
experiment below the buttons.

– Create Acqui- Adds a new, empty acquisition block to the experiment timeline.
sition Block

– Create Delay Adds a delay block to the experiment timeline which pauses the ex-
Block periment for a predefined period. After that period, the experiment
continues automatically.

– Create Wait Adds a wait block to the experiment timeline which holds the experi-
Block ment in idle status until you click Continue Experiment. This can be
used for adding a solution or changing the buffer of the specimen. A
message box is displayed when a wait block is reached.

– Create Exe- Adds an execute block to the experiment timeline to execute a se-
cute Block lected hardware setting.

Duplicate Duplicates the selected block and inserts the newly created block after
the last block.

Delete Deletes the selected block from the timeline.

Properties of Block Displays options for the currently selected experiment block.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 287


5 Acquisition Toolkits | 5.1 Experiment Designer ZEISS

Parameter Description
– Delay Only visible if a delay block is selected.
Sets the delay with the slider or input field. The delay is displayed in
the block.

– Synchronize Only visible if a delay block is selected.


with Preced- Activated: Reduces the duration of the delay block by the measured
ing Blocks execution time of the preceding blocks.

– Wait Only visible if a wait block is selected.


Defines the message that is displayed once the wait block is reached.

– Execute Only visible if an execute block is selected.


If Sequential is activated, the experiment continues while the hard-
ware setting is executed. If it is deactivated, the experiment waits un-
til the hardware setting was executed.

Clicking opens the options for configuring and selecting the


hardware settings.
If a hardware setting is selected, the Go! button is active. Clicking this
button applies the selected hardware setting immediately.

Loops and Repeti- Only visible if Show All is activated.


tions Displays options to define loops and repetitions, see Loops and Repe-
titions Section [} 288].

5.1.1.1 Loops and Repetitions Section

Specifies which experiment blocks should be repeated during the experiment. You can define as
many repetitions as you like for each experiment. An experiment block can only be part of one of
the defined repetitions.

Info
If you define several repetitions, the following conditions must be met:
4 Repetitions must form a complete unit.
4 One repetition may not be placed within another.
ð If these conditions are not met, the repetition cannot be performed. In this case a yellow
warning symbol appears in the Active column.

Parameter Description
Loops Sets the number of loops that are performed.

Start Sets the number of the starting block.

End Sets the number of the end block.

Active Activated: Performs this loop in the experiment.

Adds a new loop to the experiment.


Add

Deletes the selected loop.


Delete

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 288


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

Parameter Description
Time Stitch all Images Activated: All images of a looped acquisition block are put into
of Each Looped Acqui- one image document. The images are automatically stitched to-
sition Block gether using the time (T) index.

5.1.1.2 Execute Block Options

Parameter Description
Edit Setting/Light Path Opens the light path dialog to change the relevant hardware set-
ting.

Set to None Removes the existing hardware setting.

Get Current Hardware Adopts the current hardware settings.

Experiment Settings Displays a list of existing hardware settings you can select.
Pool

Harddrive Folder Displays a list of saved hardware settings.

From File... Opens a dialog window to select and import a hardware settings
file (*.czhws).

Export to User Folder Exports the current hardware setting.

5.1.1.3 Import Experiment Blocks Dialog

Enables you to import experiment blocks from existing experiments.

Parameter Description
Import from Selects the experiment you want to import experiment blocks from.
The experiment must be saved on your computer.

Select Desired Selects the experiment blocks you want to import. The selected block
Blocks is marked in blue. If you want to import all blocks of an experiment,
do not select a block but continue by clicking on the Import button
directly.

Import Imports the experiment blocks to the experiment timeline.

Cancel Cancels the import.

5.2 Experiment Feedback

Experiment feedback (also known as conditional or adaptive experiments) allows you to define
specific rules and actions to be performed during the acquisition of an experiment. It is possible to
change the course of an experiment depending on the current system status or the nature of the
acquired data during acquisition. Moreover, it is possible to integrate certain tasks like data log-
ging or starting of an external application, directly into the ZEN experiment. A typical use case is
to connect the image acquisition with automated image analysis.
Feedback experiments can be set up and controlled with the Experiment Feedback Tool [} 294]
and the Script Editor [} 294]. For an example workflow for experiment feedback, see Workflow
Experiment Feedback [} 290].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 289


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

Note that we do not describe experiment feedback in detail here, as you can find a detailed in-
struction on how to perform feedback experiments and a lot of tutorials with the latest ZEN in-
stallation, if you activate the entry OAD Samples in the ZEISS Microscopy Installer. The tutori-
als and documentation are then placed in a folder on your PC like C:\Oad\Experiment Feed-
back.

Key Features
§ Create smart experiments and modify the acquisition on-the-fly based on online image analy-
sis, hardware changes or external inputs (e.g. TTL signals).
§ The adaptive acquisition engine allows modifying running experiments according to the rules
defined inside the feedback script.
§ The feedback script uses ZEN commands in combination with the Python programming lan-
guage.
§ The feedback script gives access to the current system status and results from the online im-
age analysis during runtime of an experiment.
§ Data Logging or starting an external application (e.g. Python, Fiji, MATLAB, etc. ), directly
from within the imaging experiment is possible.

5.2.1 Workflow Experiment Feedback

Fig. 15: Workflow Experiment Feedback


In the figure you can see the typical workflow of an Experiment Feedback experiment and the
most important steps involved. The yellow boxes Define Experiment, Define Image Analysis
and Define Rules and Observables show the most important steps for setting up a feedback ex-
periment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 290


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

Step Description
Define Experiment Set up and configure the actual image acquisition experiment to
obtain the desired image data, e.g. time lapse, Z-stack, multi-
channel, tile acquisition, etc. Once the setup of the acquisition is
completed, you acquire sample data which will be used in the
following step to setup and test the image analysis setting.

Define Image Analysis Sets up an image analysis setting via the Image Analysis Wizard
for the use inside the feedback script if an analysis step is re-
quired. Only parameters specified in the image analysis setting
can later be accessed from within the experiment feedback
script. Test the image analysis setting to ensure the results of the
image analysis are meaningful.
For more information on the Image Analysis Wizard, see Creat-
ing a New Image Analysis Setting [} 403].
For advanced analysis requirements it is also possible to use an
OAD macro to create an image analysis setting (*.czias file).

Define Rules and Ob- This step defines how the script actually works. Here you define
servables the rules in the feedback script, e.g. which parameters are ob-
served and how the experiment should react when a certain
event occurs.

Start Experiment Start the Experiment Feedback experiment and watch the out-
put. The general concept behind this workflow can be described
as a loop, which is the actual acquisition. For every event, e.g.
when a new image has been acquired, the script will be exe-
cuted. The rules are checked and if required, certain tasks are
carried out. Additionally, it is possible to log data into a text file
and/or start an external application at any time point during the
experiment.

See also
2 Script Editor for Experiment Feedback Dialog [} 294]

5.2.1.1 Editing the Feedback Script

To use the Experiment Feedback tool, you need to edit the feedback script.
The main loop script run will only be triggered, when an observable that is used in the main loop
script has changed. If the parameters within the loop script do not change, the script will not be
executed.
These changes can be:

§ A new image has been acquired


§ The XYZ position has changed
§ The status of a trigger port has been altered
§ The settings for filter, objective, light source, etc. have changed
§ The incubation parameters have changed
For advanced use cases it is possible to execute the script with the command RunLoopScript in
conjunction with a timer.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 291


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

1. Select Acquisition tab > Experiment Feedback tool > Edit Feedback Script.

à The Script Editor for Experiment Feedback dialog opens. For more information, see
Script Editor for Experiment Feedback Dialog [} 294].
2. Create and edit the feedback script in the following sections: the PreLoop Script, the
Loop Script and the PostLoop Script. To do so, use the commands on the Command
tab. Add observables and actions to your experiment feedback script either via double-click
or drag-and-drop. All observables and actions are also available via IntelliSense auto-com-
pletion starting with ZENService.
3. If an image analysis is part of your feedback experiment, you can select an existing image
analysis you previously created. Select Command tab > Available Observables section >
Analysis drop-down menu.
à A list of the features that were defined in this image analysis setting, e.g. number of cells
detected, is displayed. If you selected an image analysis setting and use one or more fea-
tures in the feedback script, this image analysis setting is executed for each acquired im-
age. Note that only features you have previously defined in the Image Analysis Wizard
are available from within the Feedback Experiment. If you make any changes within the
image analysis wizard to an existing *.czias file, you need to reload it in the feedback
script editor to activate the changes in the feedback experiment.
4. Click OK.
à The existing code is validated. You can only save and close the script editor if the code is
free from syntax mistakes.
The feedback script will be stored as part of the experiment file *.czexp.

5.2.1.2 Selecting Script Runtime Conditions

The script runtime conditions describe how the different steps of the experiment Feedback
Script are executed. You can choose between Free Run and Synchronized execution.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 292


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

1. Select Acquisition tab > Experiment Feedback tool, and select Free Run.

à The execution of all steps of the Feedback experiment are independent and not executed
sequentially.

1. Select Acquisition tab > Experiment Feedback tool, and select Synchronized.

2. Click on the blue buttons to define the script slot and to change the execution order of the
script.
à The selected steps are executed sequentially.

§ The script run starts after the acquisition together with the online image analysis. Therefore,
the script execution, image analysis and writing of the image subblock to the hard drive are
not in sync.

§ The online image analysis starts after the acquisition of a frame is finished. Only when the im-
age analysis is finished, the next script run is triggered. This guarantees that all analysis results
exist and can be used in the feedback script. The writing to disk is not synchronized.

§ The online image analysis starts after the acquisition of a frame is finished. The image data are
written to disk and only when all tasks are finished the next script run is triggered. This guar-
antees, that all analysis results exist and the image data is stored on disk before the next

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 293


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

script run is triggered. This option is relevant in case the script starts an external application to
analyze the data.

5.2.2 Experiment Feedback Tool

Parameter Description
Edit Feedback Opens the Script Editor [} 294] dialog. There you can create scripts
Script... for an Experiment Feedback.

Select script run-


time conditions

- Free Run Upon the experiment start the acquisition and the feedback script are
started but run from here in a completely unsynchronized manner.
The online image analysis or the script run itself will not slow down
the actual image acquisition.

- Synchronized This mode will lead to strictly determined order of events depending
on the chosen level of synchronization. The online image analysis and/
or the feedback script will be started after current acquisition is fin-
ished.
In contrast to the Free Run mode, a synchronized run can slow the
whole acquisition down. The big advantage of the mode is, that the
synchronized run ensures a predictable workflow.

Define Script Slot Here you define the experiment feedback sequence by arranging the
slots (represented by blue buttons). The blue slots run one after an-
other the non-blue slots are run separately.
§ The Acquisition slot represents the actual image acquisition.
§ The Analysis slot represents the online image analysis.
§ The Script Run* slot represents the execution of the experiment
feedback loop script. Note that the loop script will be only exe-
cuted when triggered by a used observable inside the loop script.
§ The HD Writing slot represents the slot for writing the image data
to your hard drive.

Allow additional Triggers the main loop if observables that are not part of the multidi-
loop script runs mensional experiment (e.g. frame index, time index, block index, etc.)
change. Those observables could be time or temperature of the incu-
bation. If the checkbox is not activated only experiment observables
trigger the main loop script. This only applies when the acquisition is
idle. This only applies when acquisition is idle.

5.2.2.1 Script Editor for Experiment Feedback Dialog

See also
2 Editing the Feedback Script [} 291]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 294


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

5.2.2.1.1 Input Windows

The three windows on the left allow you to input scripts based on the programming language
Python:

Window Description
Pre Loop - Single Exe- Import modules and define functions or variables. This part is ex-
cution on Experiment ecuted only once at the beginning of the feedback experiment.
Start

Loop Script - Repetitive Executed every time an observable used within the loop script
Execution During Ex- changes. Allows to modify the experiment on-the-fly and react
periment Runtime on results from the online image analysis, e.g. stop the acquisi-
tion when a defined number of cells have been counted, or to
take action upon external signals.

Post Loop Script - Sin- Define actions that are executed only once when the acquisition
gle Execution on Exper- is finished, e.g. write the data in a logfile or play a sound when
iment Stop the experiment is finished.

Clear output Clears the output messages field.

Accept Adopts the script within the experiment without closing the win-
dow.

OK Adopts the script and closes the window.

Cancel Leaves the dialog without adopting the script.

For more information, see Editing the Feedback Script [} 291].

5.2.2.1.2 Commands Tab

The Commands tab on the right contains all commands for observables, actions and editor tools.

Parameter Description
Available Observables Observables are conditions or parameters that can be deter-
mined and observed during the course of the experiment. Select
observables, actions and tools by clicking on the black triangle at
the right-hand edge and dragging the desired action from the list
to the desired input area.
The following observables are available:

- Analysis Analysis observables contain measurement parameters from im-


age analyses that have been previously defined, e.g in the Image
Analysis Wizard. Only those variables that are specified through
the selection of the measurement program appear in the list.

- Experiment Experiment observables relate to the experiment currently run-


ning and display the current time point or the current Z-stack
plane, for example.

- Hardware Hardware observables include, for example, the status of con-


nected devices, such as trigger devices, or incubators.

- Environment Environment observables describe the system environment, such


as the time or available memory space on the computer.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 295


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

Parameter Description
Available Actions Actions are possible actions and reactions that can be performed
during the experiment. These can vary greatly and include, for
example, changing microscope hardware, changing camera pa-
rameters, generating notifications or audible alerts, calling up
other programs or canceling the experiment.

- Experiment Ac- Commands that can be used to modify a running experiment on-
tions the-fly. It also includes modifying hardware parameters which
are typically part of an acquisition experiment, like exposure
times or light source intensities.

- Hardware Actions Hardware Actions are modifications of a running experiment


concerning the incubation, XYZ positions and the Digital IO
ports.

- Extra Actions Commands that can be used to log any kind of data into a text
file or to start an external application outside ZEN at any time
during a running experiment.

Editor Tools The Editor tools include sample scripts, allow to play sounds or
write debugging outputs.

- Examples and Contains a small collection of script samples to illustrate some


Templates basic ideas of the feedback script. You can adopt the sample
scripts by double-clicking. After receiving a prompt, the current
content in the script window is overwritten entirely .

Validate Script Checks your script for errors. An information is displayed if your
script is valid or not.

Information

- IO Card Port La- Contains the exact naming of the available IO ports for the cur-
bels rent system.

5.2.2.1.2.1 Script Commands - Observables

Info
It is crucial to understand that observables are more than just values "that can be observed".
They are required to trigger a script-run of the Loop Script.
If there are no observables used or they remain unchanged, the script will not be executed.

5.2.2.1.2.1.1 Observables - Analysis

The available commands inside the analysis sections depend on the definition of the image analy-
sis pipeline and the defined ROIs from the Physiology module. Therefore this is a dynamically cre-
ated list that will always look different. The list will only contain those parameters, which
are defined inside the CZIAS measurement file. Such a file can be created using the im-
age analysis wizard or an OAD macro.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 296


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

5.2.2.1.2.1.2 Observables - Experiment

CurrentBlockIndex
Complete Command ZenService.Experiment.CurrentBlockIndex

Input

Output integer

Description Returns the current experiment block index in heterogeneous experi-


ments.

CurrentSceneIndex
Complete Command ZenService.Experiment.CurrentSceneIndex

Input

Output integer

Description Returns the index of the current position for multi-position experi-
ments.

CurrentTileIndex
Complete Command ZenService.Experiment.CurrentTileIndex

Input

Output integer

Description Returns the current tile index.

CurrentTimePointIndex
Complete Command ZenService.Experiment.CurrentTimePointIndex

Input

Output integer

Description Returns the current time point index, e.g. the frame number from a
time-lapse experiment.

CurrentTrackIndex
Complete Command ZenService.Environment.CurrentTrackIndex

Input

Output integer

Description Returns the current track number.

CurrentZSliceIndex
Complete Command ZenService.Experiment.CurrentZSliceIndex

Input

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 297


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

CurrentZSliceIndex
Output integer

Description Returns the current Z-Plane form the Z-stack.

ElapsedTimeInMinutes
Complete Command ZenService.Experiment.ElapsedTimeInMinutes

Input

Output double

Description Returns the elapsed time in minutes for the current experiment.

ElapsedTimeInSeconds
Complete Command ZenService.Experiment.ElapsedTimeInSeconds

Input

Output double

Description Returns the elapsed time in seconds for the current experiment.

ImageFileName
Complete Command ZenService.Experiment.ImageFileName

Input

Output string

Description Returns the name of the current experiment as a string. The String
ending will be *.czi and *.czmbi for multi-block experiments, respec-
tively.

IsExperimentPaused
Complete Command ZenService.Experiment.IsExperimentPaused

Input

Output boolean

Description Returns the paused state of the current experiment, i.e. it will be True
if the experiment is paused.

IsExperimentRunning
Complete Command ZenService.Experiment.IsExperimentRunning

Input

Output boolean

Description Returns the running state of the current experiment, i.e. it will be True
if the experiment is running.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 298


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

HasChanged
Complete Command ZenService.Environment.HasChanged(String observableId)

Input

Output boolean

Description Returns true/false if a certain observable has/ has not changed. On


simple occurrences it is possible to use the HasChanged("observ-
ableId") method. Where available the HasChanged("observableId")
method takes an observable name as parameter. HasChanged("ob-
servableId") returns true whenever the specified observable has
changed since last script run; otherwise false. So it might not be suit-
able for situations when an observable changes very often and/or
when really a singular execution is desired.

5.2.2.1.2.1.3 Observables - Environment

CurrentDateDay
Complete Command ZenService.Environment.CurrentDateDay

Input

Output integer

Description Returns the current day.

CurrentDateMonth
Complete Command ZenService.Environment.CurrentDateMonth

Input

Output integer

Description Returns the current month.

CurrentDateYear
Complete Command ZenService.Environment.CurrentDateYear

Input

Output integer

Description Returns the current year.

CurrentTimeHour
Complete Command ZenService.Environment.CurrentTimeHour

Input

Output integer

Description Returns the current hour.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 299


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

CurrentDateTimeMinute
Complete Command ZenService.Environment.CurrentTimeMinute

Input

Output integer

Description Returns the current minute.

CurrentDateTimeSeconds
Complete Command ZenService.Environment.CurrentTimeSeconds

Input

Output integer

Description Returns the current second.

CurrentDateTimeMilliseconds
Complete Command ZenService.Environment.CurrentTimeMilliseconds

Input

Output integer

Description Returns the current millisecond.

FreeDiskSpaceInMBytes
Complete Command ZenService.Environment.FreeDiskSpaceInMBytes

Input

Output double

Description Returns the free disk space on the hard disk where the experiment
data will be saved.

HasChanged
Complete Command ZenService.Environment.HasChanged(String observableId)

Input

Output boolean

Description Returns whether a certain observable has changed. On simple occur-


rences it is possible to use the HasChanged("observableId") method.
Where available the HasChanged("observableId") method takes an
observable name as parameter. HasChanged("observableId") returns
true whenever the specified observable has changed since last script
run; otherwise false. So it might not be suitable for situations when
an observable changes very often and/or when really a singular execu-
tion is desired.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 300


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

5.2.2.1.2.1.4 Observables - Hardware

IncubationAirHeaterIsEnabled
Complete Command ZenService.Hardware.IncubationAirHeaterIsEnabled

Input

Output boolean

Description Returns the state of the incubator.

IncubationAirHeaterTemperature
Complete Command ZenService.Hardware.IncubationAirHeaterTemperature

Input

Output double

Description Returns the current temperature setpoint.

IncubationChannelXIsEnabled (X=1-4)
Complete Command ZenService.Hardware.IncubationChannelXIsEnabled

Input

Output boolean

Description Returns the state for a specific incubation channel.

IncubationChannelXTemperature (X=1-4)
Complete Command ZenService.Hardware.IncubationChannelXTemperature

Input

Output double

Description Returns the temperature for a specific channel.

IncubationCO2Concentration
Complete Command ZenService.Hardware.IncubationCO2Concentration

Input

Output Double

Description Returns the current CO2 concentration setpoint.

IncubationCO2IsEnabled
Complete Command ZenService.Hardware.IncubationCO2IsEnabled

Input

Output Boolean

Description Returns the state of the CO2 incubation system.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 301


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

IncubationO2Concentration
Complete Command ZenService.Hardware.IncubationO2Concentration

Input

Output Double

Description Returns the current O2 concentration setpoint.

IncubationO2IsEnabled
Complete Command ZenService.Hardware.IncubationO2IsEnabled

Input

Output Boolean

Description Returns the state of the O2 incubation system.

IncubationCoolingChannelIsEnabled
Complete Command ZenService.Hardware.IncubationCoolingChannelIsEnabled

Input

Output Boolean

Description Returns the state of the cooling system.

IncubationCoolingChannelTemperature
Complete Command ZenService.Hardware.IncubationCoolingChannelTemperature

Input

Output Double

Description Returns the current cooling temperature.

IncubationHumidityIsEnabled
Complete Command ZenService.Hardware.IncubationHumidityIsEnabled

Input

Output Boolean

Description Returns the state of the humidifier.

IncubationHumidityValue
Complete Command ZenService.Hardware.IncubationHumidityValue

Input

Output Double

Description Returns the current humidity.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 302


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

TriggerDigitalInX (X = ...)
The range of values for X depends on the IOcard configuration.

Complete Command ZenService.Hardware.TriggerDigitalInX

Input

Output Boolean

Description Returns the state of a specific TriggerDigitalIn port.

TriggerDigitalOutX (X = ...)
The range of values for X depends on the IOcard configuration.

Complete Command ZenService.Hardware.TriggerDigitalOutX

Input

Output Boolean

Description Returns the state of a specific TriggerDigitalOut port.

TriggerDigitalOutRLShutter
Complete Command ZenService.Hardware.TriggerDigitalRLShutter

Input

Output Boolean

Description Returns the state of the reflected light shutter, where True = Open
and False = Closed.

TriggerDigitalOutTLShutter
Complete Command ZenService.Hardware.TriggerDigitalOutTLShutter

Input

Output Boolean

Description Returns the state of the transmitted light shutter, where True = Open
and False = Closed.

5.2.2.1.2.2 Script Commands - Available Actions

5.2.2.1.2.2.1 Actions - Experiment

Depending on the present hardware they shown options might vary, e.g. it is only possible to set
the laser intensity, if there is a laser engine configured.

ContinueExperiment
Complete Command ZenService.Actions.ContinueExperiment()

Input

Output

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 303


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

ContinueExperiment
Description This will continue the current experiment in case it was paused.

JumpToBlock
Complete Command ZenService.Actions.JumpToBlock(int newBlockIndex)

Input integer newBlockIndex

Output

Description This will jump to the specified experiment block inside a heteroge-
neous experiment.

JumpToContainer
Complete Command ZenService.Actions.JumpToContainer(string containerId)

Input string containerId

Output

Description This will jump to the specified container of the sample carrier.

JumpToNextBlock
Complete Command ZenService.Actions.JumpToNextBlock()

Input

Output

Description This will jump to next acquisition block defined inside the Experiment
Designer tool

JumpToNextContainer
Complete Command ZenService.Actions.JumpToNextContainer()

Input

Output

Description This will jump to next container inside the currently used sample car-
rier.

JumpToNextRegion
Complete Command ZenService.Actions.JumpToNextRegion()

Input

Output

Description This will jump to next defined region.

JumpToPreviousBlock
Complete Command ZenService.Actions.JumpToPreviousBlock()

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 304


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

JumpToPreviousBlock
Input

Output

Description This will jump to the previous acquisition block inside the experiment
designer tool.

MoveTileRegion (1)
Complete Command ZenService.Actions.MoveTileRegion(int regionIndex, double x,
double y)

Input integer regionIndex, double x [nm], double y [nm]

Output

Description Updates the specified tile region inside the tile region list with the
given X and Y coordinates.

MoveTileRegion (2)
Complete Command ZenService.Actions.MoveTileRegion(int regionIndex, double x,
double y, double z)

Input integer regionIndex, double x [nm], double y [nm], double z [nm]

Output

Description Updates the specified tile region inside the tile region list with the
given X, Y and Z stage coordinates.

MoveTileRegionByOffset
Complete Command ZenService.Actions.MoveTileRegionByOffset(int regionIndex,
double offsetX, double offsetY, double offsetZ)

Input integer regionIndex, double offsetX [nm], double offsetY [nm], double
offsetZ [nm]

Output

Description Updates the specified tile region inside the tile region list with the
given offset in X, Y and Z.

PauseExperiment
Complete Command ZenService.Actions.PauseExperiment()

Input

Output

Description This will pause the current running experiment.

ReadLEDIntensity
Complete Command ZenService.Actions.ReadLEDIntensity(int trackindex, double
wavelength)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 305


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

ReadLEDIntensity
Input integer trackindex, double wavelength [nm]

Output double intensity

Description This will read the intensity for the specified track and LED.

ReadTLHalogenLampIntensity
Complete Command ZenService.Actions.ReadTLHalogenLampIntensity(int
trackindex)

Input integer trackindex

Output double intensity

Description This will read the intensity for the specified track and LED.

SetExposureTime (1)
Complete Command ZenService.Actions.SetExposureTime(int channelindex, double
exposure)

Input integer channelindex, double exposure [ms]

Output

Description This will set the exposure time of the camera for the specified chan-
nel.

SetExposureTime (2)
Complete Command ZenService.Actions.SetExposureTime(int trackindex, int chan-
nelindex, double exposure)

Input integer trackindex, integer channelindex, double exposure [ms]

Output

Description This will set the exposure time of the camera for the specified track
and channel.

SetLEDIntensity
Complete Command ZenService.Actions.SetLEDIntensity(int trackindex, double
wavelength, double intensity)

Input integer trackindex, double wavelength [nm]

Output

Description This will set the intensity for the specified track and channel.

SetLEDIsEnabled
Complete Command ZenService.Actions.SetLEDIsEnabled(int trackindex, double
wavelength, bool isEnabled)

Input integer trackindex, double wavelength [nm], boolean is Enabled

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 306


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

SetLEDIsEnabled
Output

Description This will enable the specified LED for the specified track. The prede-
fined intensity value will be used.

SetMarkerString
Complete Command ZenService.Actions.SetMarkerString(string markerText)

Input string markerText

Output

Description This will insert a marker at the current time point.

SetTimeSeriesInterval (1)
Complete Command ZenService.Actions.SetTimeSeriesInterval(double interval, Time-
Unit unit)

Input double interval, TimeUnit unit (e.g. TimeUnit.ms)

Output

Description This will set the interval of a time series to the specified value.

SetTimeSeriesInterval (2)
Complete Command ZenService.Actions.SetTimeSeriesInterval(double interval)

Input double interval [ms]

Output

Description This will set the interval of a time series to the specified value in [ms].

SetTLHalogenLampIntensity
Complete Command ZenService.Actions.SetTLHalogenLampIntensity(int trackindex,
double intensity)

Input integer trackindex, double intensity

Output

Description This will set the intensity of the TL Halogen lamp for the specified
track.

StopExperiment
Complete Command ZenService.Actions.StopExperiment()

Input

Output

Description This will stop the current running experiment (similar to pressing the
Stop button).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 307


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

UpdateZStackCenterPosition
Complete Command ZenService.Actions.UpdateZStackCenterPosition(double center-
Position)

Input double center position [nm]

Output

Description Updates the center position of the defined Z-stack with the specified
center position.

UpdateZStackCenterPositionByOffset
Complete Command ZenService.Actions.UpdateZStackCenterPositionByOffset(dou-
ble centerPositionOffset)

Input double center position offset [nm]

Output

Description Moves the center position of the defined Z-stack by the specified off-
set.

5.2.2.1.2.2.2 Actions - Experiment - LSM

LSM - ReadAnalogInTriggerState
Complete Command ZenServiceLSM.Actions.ReadAnalogInTriggerState(int port)

Input integer trigger port

Output

Description Returns the state of specified AnalogInTriggerIn port.

LSM - ReadAnalogOutTriggerState
Complete Command ZenServiceLSM.Actions.ReadAnalogOutTriggerState(int port)

Input integer trigger port

Output

Description Returns the state of specified AnalogInTriggerIn port.

LSM - ReadDigitalGain
Complete Command ZenServiceLSM.Actions.ReadDigitalGain(int trackIndex, int
channelIndex)

Input integer trackindex, integer channelIndex

Output double digitalGain

Description Returns the value for the DigitalGain for the specified track/channel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 308


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

LSM - ReadLaserIntensity
Complete Command ZenServiceLSM.Actions.ReadLaserIntensity(int trackIndex, int
lineWavelength)

Input integer trackIndex, integer lineWavelength [nm]

Output double intensity

Description Returns the laser intensity [%] for the specified laser wavelength.

LSM - ReadMasterGain
Complete Command ZenServiceLSM.Actions.ReadMasterGain(int trackIndex, int de-
tectorIndex)

Input integer trackIndex, integer detectorIndex

Output double masterGain

Description Returns the value for the masterGain for the specified track/dectector
combination.

LSM - ReadPinholeDiameter
Complete Command ZenServiceLSM.Actions.ReadPinholeDiameter(int trackIndex)

Input integer trackIndex

Output double pinholeDiameter [micron]

Description Returns the value for the pinhole in [micron] for the specified track.

LSM - ReadScanDirection
Complete Command ZenServiceLSM.Actions.ReadScanDirection()

Input

Output ScanDirections direction

Description Returns the current scan direction.

LSM - ReadScanSpeed
Complete Command ZenServiceLSM.Actions.ReadScanSpeed()

Input

Output int speed

Description Returns the current scan speed.

LSM - ReadTLLEDIntensity
Complete Command ZenServiceLSM.Actions.ReadTLLEDIntensity(int trackIndex)

Input integer trackIndex

Output double intensity [%]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 309


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

LSM - ReadTLLEDIntensity
Description Returns the intensity value [%] for the TL-LED.

LSM - SetAnalogOutTriggerState
Complete Command ZenServiceLSM.Actions.SetAnalogOutTriggerState(int port,
double state)

Input integer port, double state

Output

Description Sets the voltage value for the AnalogOutTrigger port.

LSM - SetDigitalGain
Complete Command ZenServiceLSM.Actions.SetDigitalGain(int trackIndex, int chan-
nelIndex, double digitalGain)

Input integer trackIndex, integer channelIndex, double digitalGain

Output

Description Sets the value for the DigitalGain for the specified track/channel.

LSM - SetLaserEnabled
Complete Command ZenServiceLSM.Actions.SetLaserEnabled(int trackIndex, int
lineWavelength, bool isEnabled)

Input integer trackIndex, integer lineWavelength, bool isEnabled

Output

Description Sets the state for the specified laser inside the specified track.

LSM - SetLaserIntensity
Complete Command ZenServiceLSM.Actions.SetLaserIntensity(int trackIndex, int
lineWavelength, double intensity)

Input integer trackIndex, integer lineWavelength [nm], double intensity [%]

Output

Description Sets the laser intensity for the specified laser inside the specified track.

LSM - SetMasterGain
Complete Command ZenServiceLSM.Actions.SetMasterGain(int trackIndex, int de-
tectorIndex, double masterGain)

Input integer trackIndex, integer detectorIndex, double masterGain

Output

Description Sets the value for the MasterGain for the specified track/detector.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 310


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

LSM - SetPinholeDiameter
Complete Command ZenServiceLSM.Actions.SetPinholeDiameter(int trackIndex,
double pinholeDiameter)

Input integer trackIndex, double pinholeDiameter [nm]

Output

Description Adjusts the pinhole for the specified track.

LSM - SetScanDirection
Complete Command ZenServiceLSM.Actions.SetScanDirection(ScanDirections direc-
tion)

Input ScanDirections direction

Output

Description Adjust the ScanDirection to the specified value.

LSM - SetScanSpeed
Complete Command ZenServiceLSM.Actions.SetScanSpeed(int speed)

Input integer speed

Output

Description Adjusts the ScanSpeed to the specified value.

LSM - SetTLLEDIntensity
Complete Command ZenServiceLSM.Actions.SetTLLEDIntensity(int trackIndex, dou-
ble intensity)

Input integer trackIndex, double intensity [%]

Output

Description Adjusts the intensity of the TL-LED to the specified value.

5.2.2.1.2.2.3 Actions - Hardware

ExecuteHardwareSetting
Complete Command ZenService.HardwareActions.ExecuteHardwareSetting(string
settingNameInExperimentSettingsPool)

Input string settingNameInExperimentSettingsPool

Output

Description Loads a specific experiment setting from the list of experiment set-
tings. The settings will be overwritten within the next experi-
ment loop, if the settings are included in the regular experi-
ment settings.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 311


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

ExecuteHardwareSettingFromFile
Complete Command ZenService.HardwareActions.ExecuteHardwareSettingFrom-
File(string hardwareSettingFilePath)

Input integer string hardwareSettingFilePath

Output

Description Loads a specific experiment setting from a file directly. The settings
will be overwritten within the next experiment loop, if the set-
tings are included in the regular experiment settings.

PulseTriggerDigitalOut
Complete Command ZenService.HardwareActions.PulseTriggerDigitalOut(string
port-Label, double duration)

Input string portLabel, double duration

Output

Description Produces a TLL pulse with a specified duration at the selected trigger
port.

PulseTriggerDigitalOutX (X=7-8)
Complete Command ZenService.HardwareActions.PulseTriggerDigitalOutX(double
duration)

Input double duration

Output

Description Produces a TLL pulse with a specified duration at trigger port X.

ReadFocusPosition
Complete Command ZenService.HardwareActions.ReadFocusPosition(double Posi-
tion- InMicrometer)

Input double PositionInMicrometer

Output

Description Get the current value of the Z-drive. This function was placed under
the category HardwareActions, and not under Observables, since
they trigger the execution of the main loop of the script automatically
when changing.

ReadStagePositionX
Complete Command ZenService.HardwareActions.ReadFocusPosition(double Posi-
tion- InMicrometer)

Input double PositionInMicrometer

Output

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 312


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

ReadStagePositionX
Description Get the current value of the stage X-axis. This function was placed un-
der the category HardwareActions, and not under Observables
since they trigger the execution of the main loop of the script auto-
matically when changing.

ReadStagePositionY
Complete Command ZenService.HardwareActions.ReadFocusPosition(double Posi-
tion- InMicrometer)

Input double PositionInMicrometer

Output

Description Get the current value of the stage Y-axis. This function was placed un-
der the category HardwareActions, and not under Observables
since they trigger the execution of the main loop of the script auto-
matically when changing.

SetFocusPosition
Complete Command ZenService.HardwareActions.SetFocusPosition(double Position-
InMicrometer)

Input double PositionInMicrometer

Output

Description Sets the focus drive to the specified position. Currently the piezo drive
is not accessible from the Experiment Feedback script.

SetIncubationAirHeaterIsEnabled
Complete Command ZenService.HardwareActions.SetIncubationAirHeaterIsEn-
abled(bool IsEnabled)

Input bool IsEnabled

Output

Description Enables the AirHeater of the incubation system.

SetIncubationAirHeaterTemperature
Complete Command ZenService.HardwareActions.SetIncubationAirHeaterTempera-
ture(double temperature)

Input double temperature

Output

Description This will set the temperature of the AirHeater to the specified temper-
ature.

SetIncubationChannelIsEnabled
Complete Command ZenService.HardwareActions.SetIncubationChannelIsEn-
abled(int channel, bool isEnabled)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 313


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

SetIncubationChannelIsEnabled
Input integer channel, boolean isEnabled

Output double intensity

Description This will enable the specified channel.

SetIncubationChannelTemperature
Complete Command ZenService.HardwareActions.SetIncubationChannelTempera-
ture(int channel, double temperature)

Input integer channel, double temperature

Output

Description Sets the temperature of the selected channel to the specified value.

SetIncubationCO2Concentration
Complete Command ZenService.HardwareActions.SetIncubationCO2Concentra-
tion(double concentration)

Input double concentration

Output

Description Sets the CO2 concentration to the specified value.

SetIncubationCO2IsEnabled
Complete Command ZenService.HardwareActions.SetIncubationCO2IsEnabled(bool
isEnabled)

Input boolean isEnabled

Output

Description Enables the CO2 incubation.

SetIncubationO2Concentration
Complete Command ZenService.HardwareActions.SetIncubationO2Concentra-
tion(double concentration)

Input double concentration

Output

Description Sets the O2 concentration to the specified value.

SetIncubationO2IsEnabled
Complete Command ZenService.HardwareActions.SetIncubationO2IsEnabled(bool
isEnabled)

Input boolean isEnabled

Output

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 314


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

SetIncubationO2IsEnabled
Description Enables the O2 incubation.

SetStagePosition
Complete Command ZenService.HardwareActions.SetStagePosition(double posi-
tionXInMicrometer, double positionYInMicrometer)

Input double positionXInMicrometer, positionYInMicrometer

Output

Description Sets the stage XY position to the specified value.

SetStagePositionX
Complete Command ZenService.HardwareActions.SetStagePosition(double posi-
tionXInMicrometer)

Input double positionXInMicrometer

Output

Description Sets the stage X position to the specified value.

SetStagePositionY
Complete Command ZenService.HardwareActions.SetStagePosition(double posi-
tionYInMicrometer)

Input double positionYInMicrometer

Output

Description Sets the stage Y position to the specified value.

SetTriggerDigitalOut
Complete Command ZenService.HardwareActions.SetTriggerDigitalOut(string port-
Label, bool isSet)

Input string portLabel, boolean isSet

Output

Description Sets the selected TriggerDigitalOut port to the specified value.

SetTriggerDigitalOut7
Complete Command ZenService.HardwareActions.SetTriggerDigitalOut7(bool isSet)

Input boolean isSet

Output

Description This will set TriggerDigitalOut7 port to the specified value.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 315


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

SetTriggerDigitalOut8
Complete Command ZenService.HardwareActions.SetTriggerDigitalOut8(bool isSet)

Input boolean isSet

Output

Description Sets the selected TriggerDigitalOut8 port to the specified value.

SetTriggerDigitalOutRLShutter
Complete Command ZenService.HardwareActions.SetTriggerDigitalOutRLShut-
ter(bool isSet)

Input boolean isSet

Output

Description Sets the TriggerDigitalOutRLShutter port to the specified value.

SetTriggerDigitalOutTLShutter
Complete Command ZenService.HardwareActions.SetTriggerDigitalOutTLShut-
ter8(bool isSet)

Input boolean isSet

Output

Description Sets the selected TriggerDigitalOutTKShutter port to the specified


value.

5.2.2.1.2.2.4 Actions - Extra

AppendLogLineString (1)
Complete Command ZenService.Xtra.System.AppendLogLineString(string logMes-
sage)

Input string logMessage

Output string (contains the file path of the data log file)

Description Creates a text file (ExperimentName_Log.txt) inside the folder save


folder/temp and the file path to the log file is returned. Numbers have
to be converted to strings in order two write them into the log file.
Column separators have to be specified as strings as well.

AppendLogLineString (2)
Complete Command ZenService.Xtra.System.AppendLogLineString(string logMes-
sage, string logFileName)

Input string logMessage, string logFileName

Output string (contains the file path of the data log file)

Description This is similar to the function AppendLogLineString (1) but allows to


specify the file path where the text file will be saved.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 316


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

ExecuteExternalProgram (1)
Complete Command ZenService.Xtra.System.ExecuteExternalProgram(string exe-
FilePath)

Input string exeFilePath

Output

Description Starts an external application (*.exe, *.py, *.mp3, ...). It may be re-
quired to add the location of the application the environmental vari-
ables, usually PATH, in order for windows to find the application. It is
also possible to use the absolute file path.

ExecuteExternalProgram (2)
Complete Command ZenService.Xtra.System.ExecuteExternalProgram(string exe-
FilePath, string arguments)

Input string exeFilePath, string arguments

Output

Description This is similar to the function above but it allows to specify arguments
which can be passed to the application. An example could look like
this: ZenService.Xtra.ExecuteExternalProgram("fiji-win64.exe", "-
macro Open_CZI_OME_complete.ijm Experiment-123.czi")

ExecuteExternalProgramBlocking (1)
Complete Command ZenService.Xtra.System.ExecuteExternalProgram(string exe-
FilePath, string arguments, int timeoutInMs)

Input string exeFilePath, string arguments, int timeoutInMs

Output integer exitCode

Description This advanced method will run an external program and blocks the
subsequent script. When the Experiment Feedback runs in synchro-
nous script execution it also blocks the experiment until the external
application is closed. It requires a parameter called timeoutinMs,
which specifies after which time period the script will continue inde-
pendent from the external applications. As an output it returns a so-
called ExitCode (integer), which is produced by the external applica-
tion when exiting. This ExitCode has to be supported by the external
application. Standard Windows programs (like Notepad, etc.) just re-
turn '0'. When using a special application or self-written applications
it is possible to set a special own ExitCode.

ExecuteExternalProgramBlocking (2)
Complete Command ZenService.Xtra.System.ExecuteExternalProgram(string exe-
FilePath, int timeoutInMs)

Input string exeFilePath, int timeoutInMs

Output integer exitCode

Description This is the same method as above but with additional arguments for
the external application. The timeout parameter is still required.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 317


5 Acquisition Toolkits | 5.2 Experiment Feedback ZEISS

PlaySound (1)
Complete Command ZenService.Xtra.System.PlaySound()

Input

Output

Description This will play the system sound.

PlaySound (2)
Complete Command ZenService.Xtra.System.PlaySound(string waveFilePath)

Input string waveFilePath

Output

Description Plays the specified wave sound file.

RunLoopScript
Complete Command ZenService.Xtra.System.RunLoopScript()

Input

Output

Description This command will trigger a run of the LoopScript. It is only meant to
be used when running the Experiment Feedback script in synchronous
script execution.

WriteDebugOutput
Complete Command ZenService.Xtra.System.WriteDebugOutput(string message)

Input string

Output

Description Writes string messages in the Output for debugging.

5.2.2.1.3 Debugging Tab

Parameter Description
General

- Show Warn- Allows to open warning popups.


ing Popup

- Show Output Opens the output messages field. Here the messages defined below
Messages are displayed during script run for debugging purposes.

Output Messages

- Show Displays the corresponding message in white.

- Highlight Displays the corresponding messages with different colors.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 318


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

Parameter Description
User Defined Mes-
sages

- Write to Out- Writes user defined messages (ZenService. Xtra.System. WriteDebu-


put gOutput (string message)).

Auto Messages

- Observable Writes a notification each time an observable changes.


Change

- Action Called Writes a notification each time an action is called.

- Action Exe- Writes a notification each time an action is executed.


cuted

- Action Warn- Writes action warning messages.


ing

- Exception Writes exception messages.

- Script Run Writes which part of the script (preloop, loop script, post loop script)
is run.

Additional Infor-
mation

- Show Mes- Allows to additionally display the message type.


sage Type

- Show Time Allows to additionally display the time stamp for each message.
Stamp

- Follow Debug Follows the output if activated.


Message

Clear output Clears the messages in the output field.

5.3 Guided Acquisition

With Guided Acquisition for ZEN you can create an automated workflow to acquire images
(overview), detect relevant objects (image analysis) and re-image these positions, using another
experiment, e.g. with higher magnification, z-stack etc.
Guided Acquisition Workflow:
1. Scan or inspect a large area (or over a long period of time).
2. Perform an analysis to detect interesting objects.
3. Acquire detailed images for every detected object.
A possible application is to detect rare events, e.g. to find transfected cells. For example, the sam-
ple contains many cells that are stained with a blue dye, but only a few are additionally expressing
GFP. Guided Acquisition allows you to find these cells and run another, e.g. high-magnification,
experiment on these positions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 319


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

After performing a (low-magnification) overview scan, the image analysis detects all cells and de-
termines which of them are expressing GFP, i.e. show a certain intensity in the GFP channel. Then
the microscope revisits all GFP-expressing cells and performs a second acquisition there, e.g. with
higher magnification, a z-stack, etc. The analysis results are automatically saved to a folder.

5.3.1 Preliminary Work to Guided Acquisition

For a successful Guided Acquisition experiment, you need to prepare an overview and a detailed
experiment as well as an image analysis setting. If you want to process your overview image be-
fore it is analyzed, you also need a suitable setting for each processing step or function you want
to execute.

Overview scan
You have defined the experiment for the overview scan. Typically, the overview scan is using a
lower magnification in combination with a tile experiment.

Processing setting(s)
You have defined a suitable setting for each processing step or function you want to execute. For
more information, see General Settings [} 83].
Note that if you want to use Shading Correction with a reference image, you have to define your
setting in Batch mode!

Image analysis setting


You have defined a suitable image analysis setting, see Creating a New Image Analysis Setting
[} 403].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 320


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

Detailed scan
You can perform for example the following experiments:

§ simple Z-stacks with a high-NA objective lens


§ Multi-Channel Z-stacks using an optical sectioning method like SD, Apotome or Airyscan
§ Tile experiments
Note: If you have activated Auto-Distribute for New Tile Regions for support point distri-
bution in the Tiles tool, this is saved in the experiment and used for Guided Acquisition as
well.

Parcentricity
If you use different detectors for the overview and the detailed scan, it might be necessary to cor-
rect for the shift between both detectors (to ensure parcentricity). For this you have to take an im-
age at the exact same position with both cameras and then determine the offset between the
two (to ensure parcentricity). The reference to calculate this offset is the image taken with the
camera for the overview experiment. You can then enter the values for the shift in X and Y in the
guided acquisition setup.

Focus strategies
You have several options, to perform a focus strategy.
Detailed scan and overview scan can be defined with their own focus strategy using Focus Sur-
face and/or Software Autofocus.
During the Guided Acquisition experiment, you can define additional focusing steps. They are in-
dependent from the focus strategy defined on the Acquisition tab, see Focus Strategy Tool
[} 928].
For more information on Guided Acquisition, see Performing a Guided Acquisition [} 321].

5.3.2 Performing a Guided Acquisition

Info
Auto Immersion
If you set up your Guided Acquisition experiment using an immersion objective and user input
would be necessary between overview and detailed experiments, a dialog is displayed directly
after clicking Start. With this dialog you can control if the immersion is created when chang-
ing the objective for the scan. The experiment runs uninterrupted afterwards.

Prerequisite ü Guided Acquisition is activated under Tools > Modules Manager > Guided Acquisition.
ü You have calibrated the XY stage.
ü You have defined a suitable experiment for overview scans and for detailed scans.
ü You have defined a suitable setting for each processing step or function you want to execute.
ü You have defined a suitable image analysis setting using the Image Analysis Wizard.
ü For more information, see Preliminary Work to Guided Acquisition [} 320].
1. On the Applications tab, open the Guided Acquisition tool.
2. Create a setting to save your experiment setup, see Using Guided Acquisition settings
[} 323].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 321


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

3. In the Overview Scan section, select the experiment you want to use for creating the over-
view image and the objective and (if available) after-magnification lens to be used. Note
that as default objective and after-magnification are not stored as part of an experiment.
4. If your system is equipped with Definite Focus, the Find Surface and SW Autofocus
checkboxes are visible. Activate the checkbox to perform an additional focusing step before
the overview experiment.
5. If you want to process your overview image before it is analyzed, click Add processing
method.
6. Select a Method for processing and a corresponding Setting.
7. In the Image Analysis section, select a suitable setting to analyze the overview scan and
detect the objects of interest.
à If your setting contains more than one class for analysis, the Class dropdown is dis-
played.
8. Select the Class from the image analysis setting with multiple classes, whose segmented re-
gions should be imaged (e.g. with higher resolution) in the detailed experiment.
9. If you want the detailed scans to stop after a particular amount of objects, activate Add
Stop Criterion for Detailed Scans.
à Additional options to define an automatic stop criterion for detailed scans are displayed.
10. Select the measurement feature that should be used to sort the objects detected by the im-
age analysis and set the order for sorting the results. The drop down list displays all suitable
measurement features as defined in selected the image analysis setting. Additionally, enter
the maximum number of objects that should be scanned by the detailed experiment and
select if it is the overall number of objects or the number of objects per well.
à You have set up a stop criterion for the detailed experiment.
11. In the Detailed Experiment section, select the experiment for the detailed scan, the objec-
tive and - if available - the after-magnification lens to be used. Note that as default objec-
tive and after-magnification are not stored as part of an experiment.
12. If you use different detectors for the detailed and overview experiments, enter a X offset
and Y offset to correct the parcentricity.
13. If your system is equipped with Definite Focus, the checkbox Find Surface is available. Ac-
tivate this checkbox to use the Definite Focus to find z-position of the glass surface once
before the detailed scans. Activate SW Autofocus to perform a SW autofocus once before
the detailed scans. Optionally, activate Recall Focus to store the difference between the
glass surface and the sample and use this value for each of the detailed experiments.
14. Define the folder where you want to store the experiment data.
15. Click Start.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 322


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

An overview scan is performed and a .czi image is acquired and saved to your folder.

In the example above, the image in the top left shows the overview scan and three identified ob-
jects marked with an orange box. For these positions, a detailed scan is performed with a higher
magnification.
One Overview Scan Regions.csv and one OverviewScan Region.csv are displayed. The OverviewS-
can Region.csv table shows the found objects with ID, Bound Center X Stage [µm] and with Y
Stage [µm], Bound Width, and Bound Height [µm], as well as Image Scene Container
Name and Image Index Scene.
For each detected object a detailed scan is performed. For each object, a *.czi image is acquired
and stored in your folder.

See also
2 Guided Acquisition Tool [} 324]
2 Setting Up a New Experiment [} 51]

5.3.3 Using Guided Acquisition settings

Guided Acquisition offers you the possibility to save your whole experiment setup in a settings
file. This file is saved in the folder for your Guided Acquisition experiment together with all the
other settings (e.g. the overview and detailed experiment, the image analysis setting, and the im-
age processing settings, if a processing step was selected).

Creating a Guided Acquisition setting


1. On the Applications tab, open the Guided Acquisition tool.
2. Click on the Options button and select New.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 323


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

3. Name the setting and press Enter on your keyboard or click on .


You have created a setting for Guided Acquisition.

Saving a Guided Acquisition setting


When you have set up your Guided Acquisition experiment and created a setting, you can save
the set up as a setting.

1. Click on the Options button and select Save.


Your experiment set up is now saved.

Importing and exporting a Guided Acquisition setting


1. On the Applications tab, open the Guided Acquisition tool.
2. Click on the Options button and select Import or Export.
à A file browser opens.
3. Select the file you want to import or the folder where you want to export the setting to.
4. Click on Open/Save.
You have now imported/ exported a setting.

Deleting a Guided Acquisition setting


1. On the Applications tab, open the Guided Acquisition tool.
2. Select the setting that you want to delete in the drop-down list.
3. Click on the Options button and select Delete.
4. Confirm that you want to delete the file.
The selected setting is deleted.

See also
2 Performing a Guided Acquisition [} 321]
2 Guided Acquisition Tool [} 324]

5.3.4 Guided Acquisition Tool

Parameter Description

Options

- New Creates a new Guided Acquisition setting. Enter a name for the set-
ting.

- Rename Renames the setting.

- Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

- Save As Saves the current setting under a new name. Enter a name for the
setting.

- Import Imports an existing setting.

- Export Exports the current setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 324


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

Parameter Description
- Delete Deletes the current setting.

Overview Scan

- Experiment Selects the experiment setup to acquire the overview scan.

- Objective Selects the appropriate objective for the overview scan (typically with
a low magnification). If the objective has already been defined in the
experiment, it is read only (greyed out) here.

- Optovar Only visible if an optovar is available.


Selects the optovar for after magnification of the overview scan. If the
optovar has already been defined in the experiment, it is read only/
greyed out here.

- Find Surface Only visible if Definite Focus is licensed.


Performs a Find Surface before the overview scan. This step is inde-
pendent from and additional to any focusing strategy defined in the
overview experiment.

- SW Autofocus Performs a SW Autofocus before the overview scan and sets the
found z-position as z-position for the overview scan. This step is inde-
pendent from and additional to any focusing strategy defined in the
overview experiment.

- Initial Range Only available if SW Autofocus is activated.


Sets the range for the software autofocus.

Processing Section for processing steps to process the overview image before it is
analyzed.

- Add process- Adds a step for a new processing method.


ing method

- Method Selects a processing method from a drop-down list.


Available processing methods:
§ Airyscan Processing
§ ApoTome Raw Convert
§ Deconvolution (defaults)
§ Shading Correction
§ Extended Depth of Focus

- Setting Selects the setting for the processing method from the drop-down
list.
Note: If you want to use Shading Correction with a reference im-
age, you have to define your setting in Batch mode!

- Removes this entire processing step.


Remove

Image Analysis

- Setting Selects the image analysis setting used to analyze the overview scan.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 325


5 Acquisition Toolkits | 5.3 Guided Acquisition ZEISS

Parameter Description
- Class Only visible if you have selected an analysis setting where more than
one class is defined.
Selects the class of the image analysis whose regions are used to per-
form the detailed scans.

- Add Stop Cri- Activated: Displays options to define a stop criterion for the detailed
terion for De- experiment.
tailed Scans

- Select Feature Only visible if Add Stop Criterion for Detailed Scans is activated.
Selects the measurement feature that is used to sort the objects de-
tected by the image analysis from the list of suitable measurement
features defined in the image analysis.

- Select Order Only visible if Add Stop Criterion for Detailed Scans is activated.
Selects the order for sorting the results.

- Max. Objects Only visible if Add Stop Criterion for Detailed Scans is activated.
Sets the maximum number of objects that get scanned by the detailed
experiment. You can either define the number of objects for the
whole overview scan (Overall), or the number of objects Per Well.

Detailed Experi-
ment

- Experiment Selects the experiment setup to acquire a detailed scan at the position
of each object detected by the image analysis.

- Objective Selects the appropriate objective for the detailed scan (typically with
high magnification). If the objective has already been defined in the
experiment, it is read only/greyed out here.

- Optovar Only visible if an optovar is available.


Selects the optovar for after magnification of the detailed scan. If the
optovar has already been defined in the experiment, it is read only/
greyed out here.

- Detector Par- Only visible if the detectors used in the overview and detailed experi-
centricity Cor- ment are different.
rection
Sets a correction for parcentricity for the two detectors. In the two
text fields you can enter the X offset and Y offset of the two differ-
ent detectors in µm.

- Find Surface Only visible if Definite Focus is licensed.


Performs a Find Surface before the first detailed scan. This step is in-
dependent from and additional to any focusing strategy defined in
the detailed experiment.

- SW Autofocus Performs a SW Autofocus before the first detailed scan and sets the
found z-position as z-position for the detailed scan. This step is inde-
pendent from and additional to any focusing strategy defined in the
detailed experiment.
If the detailed experiment is not a tiles experiment the focus strategy
is automatically set to the “standard” behavior, i.e. the selected auto-
focus strategy will be performed on each tile of each detailed experi-
ment or each timepoint for a time-series, respectively. If you want to
use a different strategy, e.g. perform the selected autofocus strategy

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 326


5 Acquisition Toolkits | 5.4 HDR Confocal Basic ZEISS

Parameter Description
on each n-th tile of each detailed experiment, you have to activate the
Tiles checkbox for the detailed experiment.
Then you can select the desired frequency of autofocus in the Focus
Strategy tool under Stabilization Event Repetitions and Fre-
quency when you switch to Expert mode.

- Initial Range Only available if SW Autofocus is activated.


Sets the range for the software autofocus.

- Recall Focus Only visible if Definite Focus is licensed and if both Find Surface and
SW Autofocus are checked.
Restores the saved focus position and applies it for each detailed ex-
periment.

Output Folder

- Output Folder Determines the folder where the analysis results are saved.
A subfolder will automatically be created for each run of a Guided Ac-
quisition experiment.
Note: When a ZEN Connect project is open, the output folder cannot
be set here, but is defined by the ZEN Connect project.
Note: When using Guided Acquisition with Direct Processing, make
sure that the processing computer has access to this output folder!

Open output Activated: Opens the output folder after Guided Acquisition is fin-
folder after execu- ished.
tion

Start Starts Guided Acquisition.


The Start button turns into a Stop button as long as Guided Acquisi-
tion is running. Click Stop to stop the running Guided Acquisition
workflow.

See also
2 Preliminary Work to Guided Acquisition [} 320]
2 Performing a Guided Acquisition [} 321]
2 Software Autofocus Tool [} 333]

5.4 HDR Confocal Basic

HDR Confocal Basic enables the acquisition of image data with extended dynamic range by auto-
matic acquisition and combination of images with different excitation intensities.

5.5 Multi-Channel

Multi-Channel enables you to acquire fluorescence and transmitted light images in independent
channels with a technically unlimited number of independent channels for reflected light and
transmitted light techniques. It provides a fully automatic generation of the required microscope
setting for a channel with the possibility of adjusting the setting manually for the channel. It sup-
ports simultaneous acquisition of two channels using two synchronized cameras and offers inde-
pendent exposure times and shading corrections for each channel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 327


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

5.6 Software Autofocus

This module offers a configurable image based autofocus functionality that will search through a
series of axially stepped images analyzing the “sharpness” of each. The z-value of the image re-
turning the maximum sharpness is set as the new plane of observation.
The module requires the microscope to be fitted with a motorized Z-drive. It does not require a z-
piezo actuator nor is the z-piezo used by the software autofocus (SWAF) in the current implemen-
tation. On the Acquisition or Locate tab the settings for the SWAF can be adjusted in the Soft-
ware Autofocus tool. These can also be called (and tested) by clicking the Find Focus (AF) button
on the main button bar on Acquisition tab. SWAF settings are stored as part of an experiment on
Acquisition tab.
The configuration allows the function of the SWAF run to be matched to the conditions under
which the focus should be found. A basic description of the functions adjusted by the individual
controls can be found further below. However, before going into the description of each parame-
ter, we will try to address the following questions: How does the SWAF in the software attempt
to locate the “focus”? And how do the parameters settings influence its behavior in this respect?

5.6.1 Terminology & Abbreviations

Perhaps the best place to start is with an explanation of the terms encountered when working
with focus strategies before looking at the individual strategies in detail. Many of these terms are
also encountered in the Tiles and Software Autofocus module. The nomenclature takes some
time familiarize with due to its subtleties. Here is a list of the more common terms:

Term/Abbreviation Description
SWAF Stands for Software Autofocus.

DF,DF.1 or DF.2 Stands for Definite Focus, Definite Focus.1 or Definite Focus.2

Tile One of the individual image fields that make up a tile region i.e. a 2x2
Tile region is made up of 4 tiles arranged as a grid. The tiles have a
given overlap with their neighbors (default setting 10%) allowing
them to be stitched together as one image if necessary. Unless other-
wise specified by a focus strategy, each tile has the same z-value as
the parent Tile region. After acquisition, the individual tiles are dis-
played together as part of the tile region to which they belong, which
in turn makes up one scene.

Tile Region In a tile experiment a tile region refers to an ordered group of individ-
ual image fields (or tiles) that belong together and are arranged in the
form of a grid (these arrangements can be based on quadrilaterals,
circles, ellipses or freehand polygons) with a predefined overlap (de-
fault 10%) to facilitate stitching the images together. With the help of
tile regions it is possible to acquire areas with dimensions that vastly
exceed the size of an individual image field. Within an experiment a
number of tile regions can be acquired at various localities/ wells/ con-
tainers on the sample. Each tile region is based on an X and Y coordi-
nate of the stage and a Z coordinate of the focus drive and are de-
fined using the Tiles tool. After acquisition, the individual tile regions
are displayed as scenes to facilitate viewing.

Position In a tile experiment position refer to independent, individual image


fields that placed at various locations on the sample. A position corre-
sponds to (or is in some ways equivalent to) a tile region consisting of

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 328


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Term/Abbreviation Description
just one tile. Each position is based on an X and Y coordinate of the
stage and a Z coordinate of the focus drive. Individual positions or po-
sition arrays (grouped individual positions) are defined using the Tiles
tool. After acquisition, the individual positions are displayed as scenes.

Reference Channel The channel selected as a reference z-value for focus strategies and
events in particular a SWAF. The selected reference channel can be
changed in the Reference channel expander or in the Channels tool. It
is also possible to define a relative axial offset to the reference chan-
nel. This can be done for one or more other channels.

Focus Surface Refers to the interpolated surface of z-values derived from support
points (discrete z-values) defined by the user (or by functions such as
SWAF or DF.2) prior to the experiment (or immediately before acquisi-
tion start). A focus surface can be “local” or “global”. The local form is
confined to a single Tile region and attempts to describe the sample
topography covered by the tile region such that all its image fields
(tiles) will be in focus. The global surface form is technically identical,
but is associated with a sample carrier, and defined in the sample car-
rier template dialogue. Thus, tile regions or positions placed on this
carrier will follow the slope or contour defined by a topography that
covers part or most of the sample carrier. In both cases the surface is
defined by interpolation from discrete z-values – so called “support
points”. Note that a positions z-value is used as its local surface, and
as such does not require a support point. Global and local surfaces
cannot be mixed in a single experiment (or block).

Support Point To create a focus surface it is necessary to define one or more support
points. Support points are user defined collections of z-values that
correspond to the desired plane of observation at a given XY-coordi-
nate. They can also be defined initially by a SWAF run or DF.2 recall
focus function- initially, after the experiment is started, but before the
first loop of images are acquired. The number of support points, de-
fined by the user, can be distributed automatically by an algorithm, re
arranged individually by hand or placed at the current stage position.
The number of support points employed determines the degree of in-
terpolation that can be used to generate the topography of the focus
surface. Typically, the interpolation criteria (minimum number of sup-
port points required to generate a certain degree) should be over
filled with support points, and a lower interpolation degree selected
for more robust results. By default the software employs an interpola-
tion degree of level 2 (which can generate a parabolic saddle surface
with at least 9 support points). If too few support points are used the
next lower level (a “tilted plane”) will be use automatically. Higher in-
terpolation degrees have to be manually selected, but for most use
cases are typically not necessary.

Z-value The current Z coordinate of the focus drive that is used to define a
Tile region, position or support point when it is created by the user.
Note that the individual tiles of a tile region all have the same initial z-
value unless support points are used either in the context of a local or
global focus surface, a software autofocus is used to determine them
individually or a definite focus stabilization adjusts them. The z-value
of a position defines its z-coordinate initially when a local focus sur-
face is used. Positions spread on a global focus surface (carrier based)
are adjusted accordingly as are the individual image fields of a tile re-
gion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 329


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Term/Abbreviation Description
Adapt Z Values/Fo- The focus strategy Use Z Values/Focus Surface defined in Tiles
cus Surface Setup allows the Focus surface or z-values defined in the Tiles tool to
be modified by the result of a SWAF or DF stabilization based on
these initial values. These functions are not available when no SWAF
module is present or no DF is configured. The function has several
module/hardware dependent variations:

- As Additional Ac- In focus strategies that use a focus surface or z-value defined by the
tion Tile setup (tool) it is possible to optionally execute a so called “addi-
tional action” (a stabilization event) that adapts the focus surface/ z-
values. This occurs after the reference z-value has been reached as de-
fined in the tiles set-up for each discreet z-value (i.e. each tile/position
or the defining focus surface). Depending on the system configuration
this can be a SWAF run or a DF stabilization. In the case of a SWAF
run the initially defined reference z-value is used to center the search
range defined in the SWAF settings. Thus, a SWAF run can be cen-
tered on the sample topology increasing the effectiveness and/ or
speed at which a maximum is detected and subsequently used for im-
age acquisition. In certain applications, such as Correlative array to-
mography (CAT) this function can be performed with DF instead. In
this case a local focus surface is used to make sure that the DF stabi-
lization stays within the catchment range of the device (only impor-
tant for DF.1!). Complimentary to this is the number of support points
needed to initially define the surface can be significantly reduced for a
large elongated Tile region - which greatly reduces set-up time to im-
age the extremely thin (typically 70 nm thick or less) “ribbon” of serial
sections.

- Update with Sin- In combination with a Definite Focus or SWAF if a time series is used
gle Offset it is possible to make use of a focus surface or z-value defined by the
Tiles setup and execute a so called “update” (a stabilization event) –
this makes use of a SWAF run or a DF stabilization to update the Fo-
cus surface/z-value defined initially by the Tiles set-up. In a time series
the update action is performed once each time point (or every nth) at
a single discrete “wait position” (default center of 1st Tile region / po-
sition). A change in Z (thermal or residual focal drift) at the wait posi-
tion - if detected - is then applied to all the focus surfaces or Z-values
defined in the Tiles Setup (adapting them all by the change in Z, ap-
plied as a common offset). In some cases it is useful to be able to de-
fine a specific waiting position – for example, when a special sample
carrier is used where the DF reflex signal might be disturbed by its
structure/optical properties at the first tile region/position. Alterna-
tively, if using a SWAF some kind of fiducial marker or such is avail-
able at this position that does not change (e.g. bleaching or move-
ment) can be used.

- Update with Mul- For Definite Focus.2 only an additional function is available that al-
tiple Offset lows the device to be initialized on each and every z-value prior to the
experiment and hence stabilize and update these individually accord-
ing to their location relative to the sample/ glass interface. This func-
tion can be used with or without a time series dimension. Thus, DF.2
enables true multi-location experiments in which the user defined z-
values (including support points) are used by DF.2 to create a stabi-
lization map that is monitored and updated throughout the experi-
ment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 330


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Term/Abbreviation Description
Initial Definition This function allows you to select how the initial z-values used in the
for Z Values/ Focus experiment are defined. By default this is By Tiles Setup and the z-
Surface values specified there (in the Tiles tool) are used. However, it is possi-
ble to define or adjust these z-values directly before the experiment
(after clicking Start Experiment) either with a SWAF run or a with a
DF.2 Recall Focus (Axio Observer). For the Celldiscoverer 7 this drop
down offers the additional options Find Surface or Find Surface +
Additional Offset to define the initial z-values. In this case the z-val-
ues are initially defined by the z-values resulting from this “pre-run”
before the imaging loop starts. This can be particularly useful when
working with multi well plates or chamber slides where the sample is
located at a similar position relative to the carrier surface in each well
or chamber. It also allows the imaging loop of the experiment itself to
be speeded up and to be run in a triggered or compromised protocol
(fast acquisition) thus reducing the time to complete the imaging loop
of the experiment.

Stabilization Event Defines the frequency and repetition of stabilization events within a
Repetitions and given focus strategy. For the DF and SWAF focus strategies you can
Frequency determine when and where in the experiment these events are exe-
cuted in synchrony to the imaging loops – a loop here means time se-
ries, or positions for example, with the event synchronized to occur
immediately prior to the chosen loop. A general limitation of this im-
plementation (to limit code complexity) is that these stabilization
events can only be synchronized to iterate with a single imaging loop
entity i.e. the selection is only possible in a mutually exclusive manner.
These settings can be accessed only when "Show all" is activated and
expert mode is selected. Initially default settings are assigned and can
be restored by clicking the "Standard" button. In "Expert" mode the
settings are displayed and can be, if necessary, modified. Depending
on the dimensions of the experiment or focus strategy different pa-
rameters can be modified to meet the experiment needs. For the Tile
Region loop you can optionally select where the event occurs within
the Tile region - either in the center or at the 1st Tile of the region
(typically upper left hand corner). This is of use when using SWAF
events as often the upper left hand corner of a Tile region might not
contain sample, thus often the SWAF run will not return a suitable
maxima (new z-value). Finally, focus strategies that include Definite
Focus and are used with a time series dimension may also allow stabi-
lization during the interval of the time series i.e. asynchronous to the
imaging loops of the experiment. This might be necessary if the time
interval is on the order of tens of minutes, or if a large thermal drift is
expected (more significant for DF.1), or if the time series has no or a
very short interval (i.e. fast as possible acquisition at a single position)
allowing synchronized events to be disabled completely.

Focus Surface Out- Under Tools > Options > Acquisition > Tiles you find the option
lier Enable Removing of Focus Surface Outlier. By two parameters
you can define how so called “outlier” values are handled prior to cal-
culation (interpolation) of a focus surface. This is particularly helpful
when the z-values that will be used for this purpose contain one or
more values that differ obviously from the others (for example if a
SWAF run has returned a z-value that does not lie close the sample
plane of interest). If not removed such values locally distort the focus
surface potentially producing “blur” in the resulting images. By default
a linear fit is used to detect such outliers in combination with a statis-
tical threshold value (sigma). Values that do not meet these criteria

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 331


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Term/Abbreviation Description
(i.e. are significantly outside this) are classified as outliers and are not
used to calculate the focus surface that will be subsequently gener-
ated for the experiment. In extreme use cases it is possible to modify
the sigma value or use a mean value instead of a linear fit for this pur-
pose, but typically these default values never need to be changed.

5.6.2 When is focus the "right" focus?

In microscopy, the focus can be implied from image parameters, such as the contrast or intensity,
that vary with the position of the objective’s plane of observation in the sample and the level of
detail at a given plane. However, an algorithm that tries to detect (and maximize) such values will
only return an axial position that corresponds to a plane of interest if these coincide (which is typi-
cally the case with (thin) samples with a singular discrete plane of detail).
This becomes increasingly difficult with higher numerical aperture (NA) lenses, thicker samples,
and less pronounced levels of detail (modulated as change in contrast or intensity in the resulting
image). Hence, SWAF is not to be understood as a focus finder, but can be used as a method for
reliably searching over a given axial range and locating such a plane in a sample. Thus, although
not all samples and imaging conditions will be appropriate, SWAF is an approach that allows a
useful detection of a focus plane as a start for further imaging activities.

5.6.3 Software Autofocus in ZEN

Basically, the SWAF searches, with a pre-set z step size, within a given range of z values for the
image plane that returns the maximal “sharpness” value. The step size or sampling rate of the
SWAF is determined by the objective NA and wavelength (more details are given below). In turn
the (automatic) search range is also largely determined by the objective NA – obviously optics dic-
tate that higher NA objectives have smaller search ranges and vice versa. For SWAF to be useful
for the application in question the image plane that returns the maximal sharpness should ideally
be equivalent to the plane of interest in the sample – i.e. thus sample characteristics determine
whether SWAF is the appropriate method to reliably detect the desired plane of observation. The
component algorithms and functions of the SWAF, their relationships and the basic SWAF work-
flow are visualized schematically in the image below:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 332


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Fig. 16: SWAF Workflow


The SWAF run is driven and controlled by the Maximizer which in turn controls the z-drive and
camera to acquire a sequence of images at predefined axial intervals. Each of these images is
transferred in sequence to a merit function that calculates a sharpness value for the image. This
value is returned to the maximizer where a table of sharpness values is maintained. The Maximizer
searches for (using either unidirectional (“full”) or bidirectional (“smart”) axial travel) and deter-
mines when a maximal sharpness value is found. Next data fitting is performed locally around the
returned maximum to refine its position. Subsequently, the SWAF sets this z-value as the resulting
axial position of the z-drive. If no maximum is found the Maximizer detects an error condition and
throws a corresponding exception (error message). In this case the z-drive returns to its position
of origin, thus minimizing the likelihood of a sample/ objective collision incident.

5.6.4 Software Autofocus Tool

Parameter Description
Mode Here you can select the sharpness measurement mode.

- Auto This is the default setting. If selected, the software makes a


choice based on the configuration of the microscope. Such that
for Widefield approaches or transmitted light the sharpness mea-
sure is always Contrast based.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 333


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Parameter Description
On the other hand, for optical sectioning methods (e.g. Spinning
Disk) the software will automatically select an Intensity based
approach to determine the sharpness values.
If the microscope configuration can`t be detected automatically
you can manually select the sharpness measurement mode.

- Contrast If selected the contrast-based mode will be used for sharpness


measurement.
This is the standard setting for Camera acquisition.

- Intensity If selected the intensity-based mode will be used for sharpness


measurement.
This is the standard setting for Confocal acquisition.

- Reflex Only available for LSM systems with imaging tracks other than
MPLX and Airyscan SR. Using those tracks might lead to overex-
posure of the channel and failure for the Autofocus.
If activated, the reflex of the laser on the cover glass surface is
detected.
An offset is used to focus onto the sample. You need to add the
offset once by clicking the Find Offset button while the sample
is in focus. The method requires a refractive index mismatch be-
tween the immersion medium and the cover glass and is there-
fore not for oil immersion objectives.
For Reflex mode, the Search parameter should ideally be set to
Smart. After the offset was defined, you can manually reduce
the search range in order to facilitate shorter focusing times. The
acquisition settings (e.g. laser line, PMT gain, emission filters) are
configured automatically.

Quality This parameter determines the merit function that will be used to
calculate the contrast value of the image when Contrast mode is
used by the SWAF (Software Autofocus) run to measure sharp-
ness.

- Default If selected, a composite of weighted merit functions is used.


Use this setting if the sample cover a greater part of the camera
field of view.

- Low Signal If selected, a single merit function to determine the value is used.
Use this setting if the image is noisy or the sample covers a small
area of the field of view. As might be the case if you work with a
calibration slide or beads.

Search There are two options Smart and Full. These define a different
type of primary maximizer used to run the SWAF, which in turn
determines a number of additional characteristics and parame-
ters of the entire process. To learn more about this, read the FAQ
entry [} 1320].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 334


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Parameter Description
- Smart If selected, an alternative maximizer is used that can search in a
bidirectional manner and will stop when a local maximum is
found in the sharpness values (i.e. a significant decrease of
sharpness in both z directions). Again if an error condition is de-
tected the Smart maximizer will throw an exception.
For specific information on the Software Autofocus using LSM
Tracks in this context, also refer to chapter Software Autofocus
Using LSM Tracks [} 336].

- Full If selected, the maximizer employed with this setting uses a uni-
directional movement of the z-drive stepping through the entire
relative or fixed search range defined in the SWAF tool (see Aut-
ofocus Search Range). The Full maximizer will return a global
maximum for the autofocus run or throw an exception when an
error condition is detected.
For specific information on the Software Autofocus using LSM
Tracks in this context, also refer to chapter Software Autofocus
Using LSM Tracks [} 336].

Sampling Here you can select the step size of how the search range is sam-
pled.

- Default Uses the default step size (dz = 1/sqrt(2) * 2 * n* lambda/NA).

- Fine Uses a small Z-distance (0.5 * dz) between the individual focus
images that are used to calculate the best focus position.
This doubles the number of z-slices for the given range.

- Medium Uses a medium Z-distance (2 * dz) between the individual focus


images that are used to calculate the best focus position.
Halves the number of z-slices for given range.

- Coarse Uses a large Z-distance (4 * dz) between the individual focus im-
ages that are used to calculate the best focus position.
Reduces number of z-slices by a factor of four.

Autofocus Search Here you can switch between two distinct approaches for the
Range autofocus search range:

- Relative Range This is the default mode.


If selected, the software autofocus is calculated over a relative
range. To learn more, read Relative Autofocus Search Range.

- Automatic Range Activated: Calculates the range for the autofocus search auto-
matically depending on the objective set.

- Range Only active if the Automatic Range checkbox is deactivated.


Here you can enter a range that you want to be used for the aut-
ofocus search.

- Step Size Shows the distance between the individual focus images set un-
der Range.

- Fixed Range If selected, the software autofocus is calculated over a fixed


range.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 335


5 Acquisition Toolkits | 5.6 Software Autofocus ZEISS

Parameter Description
To learn more, read Fixed Autofocus Search Range.

- Set Last Defines the current Z-position as the end (last) point for the soft-
ware autofocus. Alternatively, you can enter the desired value in
the input field to the left of the button.

- Range Displays the area which is used for the autofocus search. Adopt
the area via the Set Last/Set First buttons or the input fields.

- Step Size Displays the selected Sampling distance between the individual
focus shots.

- Set First Defines the current Z-position as the start (first) point for the
software autofocus. Alternatively, you can enter the desired
value in the input field to the left of the button.

Autofocus ROI Here you can define a Spot Meter or Focus ROI such that the pix-
els evaluated by the SWAF are limited to a user defined region of
the image.
This is particularly usefully if you use a fiducial marker such as a
speck of dirt or other constant artefact that serves as a reference
for the sample focus at a fixed position over time.
The autofocus ROI is displayed in the live image of the sample
enabling it to be positioned and resized, as necessary. As an ad-
ditional aid to help focusing you can also use the focus bar func-
tion of the live image that monitors the image contrast in the live
image or Spot Meter ROI.

- Spot Meter / Focus Activated: Only uses the values from the Spot Meter / Focus-ROI
ROI to calculate the focus position.
The Focus-ROI is displayed in the live image as a red dashed rec-
tangle. You can adopt it by clicking on the frame and changing
its size and position.
Note that this option is not available for LSM acquisition.

5.6.5 Software Autofocus Using LSM Tracks

Confocal Tracks are also suitable as reference Channels for the Software Autofocus. As LSM ac-
quisition is by design slower compared to Camera acquisition, some optimizations are done in
the background in order to speed up the focusing action.
The typical measure for the correct focus position in confocal images is the intensity. Hence the
aim of the SWAF is here not to generate images of a certain quality, but only to evaluate relative
image intensities along the z-stack. This allows us to use very coarse scanning parameters.
Generally, the SWAF for LSM uses a fixed Frame Size of 64*64 pixels in combination with the
fastest possible scan speed at the currently configured zoom. To further speed up the acquisition,
bidirectional scanning is used. Whatever Laser power you specify in the Channels tool window
for this Track is used during the SWAF action. Of note, while you assign a reference Channel, the
corresponding Track with all its channels will be active during the focusing.
Some behavior depends on the selected Search Mode Full or Smart.
In the Full search, the system will use the detector gain as configured in the Channels tool win-
dow.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 336


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

In contrast, the Smart search aims to start close to the likely intensity maximum of the z-Stack.
This focus position is approximated by a fast line z-stack in the center of the image frame. As the
line scan generates less pixels and a higher noise level, a useful dynamic range needs to be en-
sured. To this end, the fast line z-stack is repeated several times with increasing PMT gain. After
the line scan, regardless if an intensity peak was found or not, a frame wise autofocus will follow.
In case no peak could be identified, e.g. because of a sparsely distributed sample, the Smart
search will start at the original z-position and not optimization of the starting position will take
place. Essentially, the Smart search will outperform the Full search on high Search Ranges and
a highly varying effective focus position.
If the focus fluctuations are predictably small, a narrow Search Range in combination with a Full
search might be faster. As a final remark, Camera-based Autofocus can be time-saving, especially
when the search range needs to be large and a Full Search is required. While Camera and LSM
cannot be combined into one image document, the deactivated camera Track may be still be used
as a reference Track.

5.7 Tiles & Positions

This module enables you to acquire high-resolution images through automatic scanning of prede-
fined tile regions and positions of a sample. The regions of tile images and individual positions
can be combined freely and a motorized stage allows automatic scanning of specimens. Overlap-
ping individual images can be combined into an overview image using “stitching” algorithms. The
module supports the use of sample carriers, focus correction maps, stitching and shading correc-
tion and is compatible with Software Autofocus. Some functionality is generally available, for
the full set of features you need the dedicated license for the module, see Licensing and Func-
tionalities of Tiles & Positions [} 338].

Info
Acquiring Tiles with different z
If you want to acquire tile regions or positions with different z-positions, you need to use a
suitable focus strategy, see Using focus strategies [} 63].

Info
Automatic Focus Strategy Selection
When you activate the Tiles tool in any experiment for the first time, the software automati-
cally selects the suitable focus strategy Use Z Values/ Focus Surface defined in Tiles Setup.
This focus strategy is only available if you have licensed the Tiles & Positions module and it
can be optimized with the Focus Strategy Wizard in the Focus Strategy tool, see Focus
Strategy Wizard [} 933] and Focus Strategy Tool [} 928]. In the case that you do not have
the Tiles & Positions module, ZEN still selects the appropriate focus strategy for you.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 337


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

1 2

1 Tile Regions

2 Position-Array

3 Positions (Single Positions)

5.7.1 Licensing and Functionalities of Tiles & Positions

Some basic functionality for tiles and position experiments is generally available in the software,
but the full Tiles & Positions functionality requires a license.

Basic functionality
The functionality generally available in ZEN includes:

§ The setup of experiments with tile regions or positions.


§ The acquisition of images through automatic scanning of the predefined regions and posi-
tions.

Licensed Functionality
If you have licensed the module Tiles & Positions and activated it in Tools > Modules Man-
ager, the additional functionality includes:

§ The Advanced Setup functionality to set up experiments more easily, including the possibility
to copy and paste tile regions and positions.
§ The use of sample carriers for your tile or position experiments, including the functionality to
generate and use your own sample carrier templates.
§ The suitable focus strategy Use Z Values/ Focus Surface defined in Tiles Setup and the
Focus Strategy Wizard to guide you through the setup of a focus strategy for the best fo-
cus.
§ The creation and use of local and global focus surfaces.
§ The possibility to create and use custom categories for your tiles and positions.

5.7.2 General Preparations

Prerequisite ü The Tiles module is activated under Tools > Modules Manager... > Tiles & Positions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 338


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

ü To set up Tiles experiments, you require a motorized stage. This must be configured and cali-
brated correctly in accordance with the camera orientation. For more information read Cali-
brating the Stage and Selecting the Channel [} 343].
ü You are on the Acquisition tab.
ü You have created a new experiment [} 51], defined at least one channel [} 51] and cor-
rectly set the focus and exposure time.
1. Activate the Tiles checkbox in the Acquisition Dimensions section to display the Tiles
tool.
à In the Left Tool Area the Tiles tool appears in the Multidimensional Acquisition tool
group.
You have successfully completed the general preparations. You can now continue with the next
steps of this guide.

See also
2 Setting Up a Simple Tiles Experiment Without the Tiles & Positions Module [} 339]

5.7.3 Setting Up a Simple Tiles Experiment Without the Tiles & Positions Module

Prerequisite ü You are on the Acquisition tab in the Tiles tool.


1. Start the Live mode to use the stage to locate a point that you want to be at the center of
your tile region.
2. Bring the specimen into focus using the focus drive.
3. Open the Tile Regions section.
à The Tiles mode is activated by default.
4. Enter the number of tiles you want in the X and Y input fields, e.g. X = 3, Y = 3 equals a
tiles region containing 9 tiles.
Alternatively, you can enter the size of the tile region that you want to add. To do this, acti-
vate the Size mode.
5. Click .
à The tile region is added to your experiment. The current stage position and focus deter-
mines the center and the z-position of the tile region.
6. To add further tile regions, move the stage to another position on the sample and repeat
the previous steps.
à The added tile regions (TR1, TR2, etc.) are displayed in the tile regions list.
à If you scroll to the right in the table, you can read the Size of the tile regions.

7. Save the experiment. To do this, in the Experiment Manager click and select Save
As. Enter a name for the experiment in the input field (e.g. Simple Tile Experiment).
8. Click Start Experiment.
à The Tile Region experiment is acquired.
à The individual tile regions are displayed in the acquired file as scenes and can be selected
using the Scene slider on the Dimensions tab. If you deactivate the Scene checkbox, all
tile regions are displayed as an overview.
You have successfully set up and acquired a simple Tile Region experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 339


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Info
Z values
To ensure that the individual z values of the tile regions are taken into account, ZEN automati-
cally selects the most appropriate focus strategy when the checkbox Tiles is activated. For the
experiment described here no further modification needs to be made. If you want to acquire
all tile regions at the same z-position, then you have to select None from the dropdown list in
the Focus Strategy tool. The individual z-positions are then ignored and the current z-position
at the time the experiment is started is used for all tile regions.

Info
Shortcut
You can also add a predefined tile region at the current stage position by pressing the F9 but-
ton on your keyboard. The size of this region is the last defined number of tiles in x and y, or a
square of 3x3 tiles if you have never defined a region before.

5.7.4 Setting Up a Simple Positions Experiment without the Tiles & Positions Module

Prerequisite ü You are on the Acquisition tab in the Tiles tool.


1. Open the Positions section.

2. Start the Live mode to use the stage to locate a position that you want to acquire.
à The X and Y coordinates of the current position are displayed in the Current X/Y display
fields.
3. Bring the specimen into focus using the focus drive.
4. Click .
à The current position is added to your experiment.
à If you are close to a position that you added previously the software will ask you if you
really want to add another position at this location (the threshold for this lies within a cir-
cle whose radius is less than half the approximate width of the cameras visible field).
5. To add further positions, move the stage to another position on the sample and repeat the
previous steps.
à The added positions are shown in the list in the Single Positions section with their X, Y
and Z-coordinates.
6. Save the experiment. To do this, in the Experiment Manager click and select Save
As. Enter a name for the experiment in the input field (e.g. Simple Tile Experiment).
7. Click Start Experiment.
à The Positions experiment is acquired.
à The individual positions are displayed in the acquired file as scenes and can be selected
using the Scene slider on the Dimensions tab. If you deactivate the Scene checkbox, all
positions are displayed simultaneously as an overview.
You have successfully set up and acquired a Positions experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 340


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Info
Z values
To ensure that the individual Z values of the positions are taken into account the software au-
tomatically selects the most appropriate focus strategy when the checkbox Tiles is activated.
For the experiment described here no further modification needs to be made. If you want to
acquire all positions at the same Z-position, then you have to select None from the dropdown
list in the Focus Strategy tool. The individual Z-positions are then ignored and the current Z-
position at the time the experiment is started is used for all positions.

Info
Shortcut
You can also add a single position at the current stage position by pressing the F10 button on
your keyboard.

5.7.5 Adjusting Z-Values

If you add positions or tile regions, the current Z-value is automatically adopted for the tile region
or position.

§ Learn about how to adjust and verify the Z-values of positions in the chapter Adjusting Z-
Values of Positions [} 342].
§ Learn about how to adjust and verify the Z-values of tile regions in the chapter Adjusting Z-
Values of Tile Regions [} 341]. Note that the Z-values defined here are valid for all tiles in the
respective tile region.

Info
To ensure that the individual z values of the tile regions and/or positions are taken into ac-
count, ZEN automatically selects the most appropriate focus strategy [} 63] when the check-
box Tiles is activated. For the experiment described here no further modification needs to be
made. If you want to acquire all tile regions at the same z-position, then you must select None
from the dropdown list in the Focus Strategy tool. The individual z-positions are then ignored
and the current z-position at the time the experiment is started is used for all tile regions. In
the case that you do not have the Tiles & Positions module, ZEN will still select the appropri-
ate focus strategy for you.

See also
2 Creating a Local Focus Surface [} 351]

5.7.5.1 Adjusting Z-Values of Tile Regions

Prerequisite ü You have set up a Tiles experiment with at least one tile region.

1. To check the z-value of tile regions, open the Tile Regions section in the Tiles tool.
à The z-values of the tile regions are displayed in the Z column of the list.
2. Double-click on the list entry of the tile region that you want to check.
à The stage automatically locates the center of the tile region and the associated z-posi-
tion.
3. Use the Live mode to check the z-value of the tile region.
4. To adjust the z-value, set the new z-position with the Focus tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 341


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5. In the Tile Regions list, click on Options and select Set Current Z For Selected
Tile Regions. Alternatively, in the Tile Regions list, right-click the tile region entry and se-
lect Set Current Z For Selected Tile Regions.
6. To check further tile regions, repeat steps 2 to 4.
7. To check and adjust large number of tile regions, click on the Verify button.
à The Verify Tile Region dialog opens. There you have an interface for the verification
process of each tile region.
8. Click on Close after you have verified all tile regions.
You have successfully checked and adjusted the individual z-values for the tile regions.

See also
2 Introduction [} 63]

5.7.5.2 Adjusting Z-Values of Positions

Prerequisite ü You have set up a tile experiment with at least one position.
ü You are on the Acquisition tab in the Tiles tool.
1. To check and adjust the z-value of positions, open the Positions section.
à The z-values are displayed in the Z column of the Single Positions list.
2. Double-click on the list entry of the position that you want to check.
à The stage automatically locates the position.
3. Use the Live mode to check the z-position of the position.
4. To adjust the z-value, set the desired position using the focus drive.
5. In the Single Positions list, click on Options and select Set Current Z For Se-
lected Positions. Alternatively, in the Single Positions list, right-click the position entry
and select Set Current Z For Selected Positions.
6. To check and adjust a large number of positions, use the Verify Positions dialog.
7. To do this, click on the Verify Positions button in the Positions section.
à The Verify Positions dialog opens.
8. Select the Helper Method you want to use. This will support you in determining the z-val-
ues. The options are Autofocus (AF) and Definite Focus (DF). If you have neither then
you can only adjust z-values manually.
9. Click on the Move to Current Point button.
à The stage moves automatically to the position in the list that is highlighted in blue. Alter-
natively, you can double-click on the position in the list that you want to check.
10. In the Live mode use the Focus (or SW Autofocus) tool to adjust the desired z-value.
11. Click on the Set Z and Move to Next button.
à The position is marked with a check mark.
à The stage moves automatically to the next position in the list.
12. Repeat the last 3 steps until you have checked all the points in the list.
à The message All points have been verified appears.
13. Close the Verify Positions dialog.
You have successfully verified and adjusted the individual z-values for positions.

See also
2 Introduction [} 63]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 342


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.6 Exporting Tile Images

Prerequisite ü You have acquired or opened a tile image.


1. On the Processing tab, open the parameters for Image Export (Ctrl+6 or via File > Ex-
port/Import > Export).
à You will see the settings of the parameters for Image Export. Make sure that the Show
All mode has been activated.
2. Select the file type that you want to use. We recommend the PNG format, as this is a for-
mat that offers lossless compression with an acceptable file size.
3. Activate the Apply Display Curve and Channel Color checkbox. This means that the im-
ages will be exported with the settings you have made, e.g. tonal value corrections or con-
trast. If you activate the Original Data checkbox, the images are exported unchanged. In
this case, the settings from the display curve, e.g. tonal value corrections and contrast, are
not adopted.
4. Select the Define Subset radio button.
à The settings for the available dimensions open.
5. Open the settings for the Tiles dimension.
6. Select the Existing Tiles radio button.
7. Click on the Apply button at the top of the Processing tab.
à You have exported the individual tiles from a tile image. The files can be found in the ex-
port folder indicated.

5.7.7 Calibrating the Stage and Selecting the Channel

On startup of a system with motorized stage and/or focus a request will appear asking if the com-
ponents should be driven to the end switches and calibrated. This ensures that you begin working
with absolute coordinates in this session with the microscope. If the microscope power is cycled,
then this process should be repeated. This function is of particular use if you continually work
with a sample carrier e.g. 96 well plate, of the same format mounted in the same manner repeat-
edly with a given experiment template. If you perform a carrier calibration once with a calibrated
stage, then the carrier calibration is essentially always valid. This is done in the Sample Carrier
section of the Tiles tool. Note these features are only available if you have a license.

Info
The request to calibrate stage and focus on startup can be activated/deactivated under Tools
> Options > Startup/Shutdown > Stage/Focus Calibration.

Prerequisite ü You licensed the Tiles & Positions module and activated it in Tools > Modules Manager.
1. Put your Sample Carrier on the stage.
2. Go to the Acquisition tab.
3. Select a low magnification objective (e.g. 10x) from the Microscope tool in the Right Tool
Area.
4. Click Live and find your focus area either using transmitted or fluorescence light.
5. In the Stage tool of the Right Tool Area, activate the Show all mode and then click Cali-
brate.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 343


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

6. Check if the alignment and orientation of your camera and joystick is correct by dragging
the software joystick up, down, left and right and observe whether the movement of your
image corresponds to movement of the circle.
The alignment of the camera is correct if the movement of a given stage axis is congruent
to the corresponding axis of the image. An offset in the alignment will be seen as a saw
tooth pattern along the edge of a tiled image (e.g. 4x4 tile region).
In addition, check whether the image movement also corresponds accordingly when you
move the hardware joystick of the stage.
7. If the orientation of the camera to the software joystick (stage tool, right tool area) is incor-
rect, go to the Camera tool, activate the Show all mode, and click Model Specific. The
orientation of the camera (image) can be adjusted by flipping, rotating, or mirroring.
8. Alternatively, you can and may also need to invert the x- and y-axis of your stage in the
MTB in order to align the hardware joystick and the software-controlled stage movement.
9. Ensure that all the prerequisites (e.g. channel and camera settings) for a Tiles & Positions
experiment on your sample are fulfilled. If necessary, use the Smart Setup for the setup.
10. After you have defined at least one channel (e.g. EGFP), activate the Tiles checkbox.
11. If you wish to work with a sample carrier, complete the following steps.
12. Open the Tiles tool and activate the Show all mode.
13. In the Tiles tool, open the Sample Carrier section.
14. Click Select....
15. Select a sample carrier template and click OK.

5.7.8 Tiles & Positions with Advanced Setup

Advanced Setup makes it easier for you to create tile regions and positions by displaying the dis-
tribution and dimensions of tile regions and positions in the travel range of the stage. You can
generate a Preview Scan and draw in tile regions or positions precisely on the basis of this tem-
plate. For the preview scan you have the option of using an objective with a lower magnification
and/or a different channel (e.g. transmitted light).

Info
To ensure that the individual z values of the tile regions and/or positions are taken into ac-
count, ZEN automatically selects the most appropriate focus strategy [} 63] when the check-
box Tiles is activated. For the experiment described here no further modification needs to be
made. If you want to acquire all tile regions at the same z-position, then you must select None
from the dropdown list in the Focus Strategy tool. The individual z-positions are then ignored
and the current z-position at the time the experiment is started is used for all tile regions. In
the case that you do not have the Tiles & Positions module, ZEN still selects the appropriate
focus strategy for you.

Prerequisite ü To set up tiles experiments in Advanced Setup, you need the Tiles & Positions module.
ü You have read the general introduction, see Tiles & Positions [} 337].
ü You are on the Acquisition tab in the Tiles tool.
1. Click Show Viewer.
à The Tiles Advanced Setup view opens. For more information, see Tiles Advanced
Setup [} 372].
à The live mode is activated automatically. Deactivate the live mode if you do not need it
to prevent bleaching of the sample. To do this, click on the active Stop button in the
Left Tool Area. This default behavior can be changed in Tools >Options > Acquisition
> Tiles & Positions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 344


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.8.1 Generating a Preview Scan

Prerequisite ü You have selected an objective with a relatively low magnification in your experiment settings.
ü You are in Advanced Setup.
1. In the left toolbar, click on Preview Scan.
à The Preview Scan Toolbar [} 376] is displayed as the top toolbar.
2. In the top toolbar, deactivate Use Existing Experiment Settings and select/ unselect the
channels that you want to use for the preview scan.
3. If necessary, use the live mode to adjust the focus area and exposure following a change of
objective or channel.
4. To obtain a better overview, slightly zoom out of the Advanced Setup view.
5. Start the Live mode to use the stage to locate approximately the center of the region for
which you want to generate a preview scan.
6. In the left toolbar [} 375] in the Tiles section, click on the Setup by contour button.
à The Contour Toolbar [} 377] is displayed as the top toolbar.
7. In the top toolbar, select the Rectangular Contour tool.
8. In the Stage View, use the tool to draw a rectangle that approximately encloses the region
for which you want to generate a preview scan.
9. Alternatively, in the Stage View, use the live image to navigate to the edge of the area that
you want to image. We recommend, for example, the bottom left corner. Add the first
marker. Now navigate to the upper edge of the object and add a second marker. Finally, if
necessary, navigate to the right edge and add a third marker and click on Done. You can
optimize the tile region by selecting a circular contour shape for your sample instead.
à A tile region is created for the marked region and displayed in the list in the Tile Regions
section of the Tiles tool.

10. With the help of the Live mode, check whether the desired image region is covered by the
tile region. To do this, use the stage to locate the corners and edges of the tile region and
increase or reduce the yellow selection frame as necessary.
11. In the left toolbar, click on Preview Scan and in the top toolbar click on Start.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 345


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

à A series of snap images is acquired to generate a preview of the marked region.

You have successfully generated a preview scan.


Before you continue with the actual experiment, carry out the following steps:

1. In the Tiles Regions section, deactivate the preview tile region (TR 1) by deactivating the
checkbox of the corresponding list entry. This prevents the acquisition of the preview tile
region during the actual experiment.
2. In the Microscope Control tool in the Right Tool Area, select the objective you want to
use for final acquisition.
3. Use the Live mode to adjust the focus area and exposure accordingly.
You can now continue setting up the tile experiment.

See also
2 Channels Tool [} 914]
2 Tiles Advanced Setup [} 372]
2 Tiles & Positions with Advanced Setup [} 344]

5.7.8.2 Creating Tile Regions by Contour

Prerequisite ü You have generated a preview scan [} 345] that will help you to position the tile regions
more easily.
1. In the left toolbar [} 375] in the Tiles section, click on the Setup by contour button.
à The Contour Toolbar [} 377] is displayed as the top toolbar.
2. In the top toolbar, select the desired contour tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 346


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

3. Use the contour tool in the stage view to draw in the tile regions you want to acquire.

à Tile regions are created for each marked region. They are added to the list in the Tile Re-
gions section of the Tiles tool.
You have successfully created tile regions in Advanced Setup.

5.7.8.3 Creating Tile Regions by Predefined

1. In the left toolbar [} 375] in the Tiles section, click on the Setup by predefined button.
à The Predefined Toolbar [} 377] is displayed as the top toolbar.
2. In the top toolbar, choose how many tiles in x and y dimension you want to add.
3. Click Add Tile Region to add the respective tile region.
You have now created tile regions in the Advanced Setup.

Info
Shortcut
You can also add a predefined tile region at the current stage position by pressing the F9 but-
ton on your keyboard. The size of this region is the last defined number of tiles in x and y, or a
square of 3x3 tiles if you have never defined a region before.

5.7.8.4 Creating Tile Regions by Carrier

Prerequisite ü You have selected and calibrated a sample carrier with one or more wells/ containers.
1. In the left toolbar [} 375] in the Tiles section, click on the Setup by carrier button.
à The Tiles Carrier Toolbar [} 379] is displayed as the top toolbar.
2. In the Carrier tab, select the individual wells for which you want to create tile regions by
pressing the Ctrl key and clicking on the desired wells.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 347


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

à The selected wells are now bordered by a blue circle.

3. In the top toolbar, select Fill Factor and enter the desired value in the Fill Factor input
field.
4. Click .
According to the selected Fill Factor, the wells will be filled with a calculated number of tiles that
are located around the center. To create a given size of tile region, use the Columns/Rows func-
tion in a similar manner.

Info
Stage movement
If you only double-click one well , the stage moves to the center of that well.

5.7.8.5 Creating Positions by Location

1. In the left toolbar [} 375] in the Positions section, click on the Setup by location button.
à The Positions Location Toolbar [} 380] is displayed as the top toolbar.

2. In the top toolbar, click .


3. In the stage view, click on the location where you want to add a position.
à The added positions are displayed in the stage view and the Single Positions list in the
Positions section of the Tiles tool.
You have successfully created positions in Tiles- Advanced Setup.
Note: ZEN will query if you want to add a position that has more than 66% overlap of the field of
view in either x or y with an existing position.

Info
Shortcut
You can also add a single position at the current stage position by pressing the F10 button on
your keyboard.

5.7.8.6 Creating Positions by Array

1. In the Tiles tool, open the Positions section and click on Position Arrays.
2. In the left toolbar [} 375] in the Positions section, click on the Setup by array button.
à The Position Array Toolbar [} 380] is displayed as the top toolbar.
3. In the top toolbar, choose either the rectangular or circular Contour, adjust the Number
of required positions and the Bias where the positions should be located.
4. Mark the interesting area in the Center Screen Area with a pressed left mouse button.
The positions will be generated automatically.

Info
Random Distribution
If the Random checkbox is activated, the selected number of positions for the array is deter-
mined randomly within the arrays space.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 348


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.8.7 Creating Positions by Carrier

Prerequisite ü You have selected and calibrated a sample carrier template [} 356].
ü You are on the Acquisition tab.
1. To obtain a complete overview of the sample carrier, zoom out of the view using the
mouse wheel. If necessary, use the panning tool (press Alt and the left mouse button) to
move the stage view as needed.
2. In the left toolbar [} 375] in the Positions section, click on the Setup by sample carrier
button.
à The Positions Carrier Toolbar [} 381] is displayed as the top toolbar.
3. Select the containers in which you want to distribute positions by pressing the Ctrl key and
clicking on the relevant containers.
4. In the top toolbar adjust the Number of required positions and the Bias where the posi-
tions should be located. Alternatively, if you want to create the positions as a Grid, adjust
the Columns, Rows, and Overlap.
5. Click on the Create button .

à The selected containers are each filled with a Position Array (group of positions).

à In the Positions section of the Tiles tool, the Position Arrays are displayed in the Posi-
tion Arrays list.

You have successfully used a sample carrier to create positions.

5.7.8.8 Importing Images into the Advanced Setup

In the Tiles - Advanced Setup, you have several options to open/import images. Follow the re-
spective workflow.

Importing preview scan images

Prerequisite ü You are in the Advanced Setup.


1. In the ZEN menu bar, click on File > Tiles > Import Preview Image. Alternatively, right
click in the viewer and select Import Preview Image from the context menu.
à A file browser opens.
2. In the file browser, select your preview scan image (*.czi) and click on Open.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 349


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

You have now imported a preview scan image into the Tiles Advanced Setup.

Importing an image already opened in ZEN

Prerequisite ü You are in the Advanced Setup.


ü You have an image opened in ZEN.
1. In the Right Tool Area, in the Images and Documents tool, select the image you want
to import.
2. Drag and drop the image into the viewer of the Advanced Setup.
You have now imported an already opened image into the Tiles Advanced Setup.

Importing from Explorer

Prerequisite ü You are in the Advanced Setup.


ü You have opened the path to your image (*.czi) in the Windows File Explorer.
1. In the Windows File Explorer, select the image you want to import.
2. Drag and drop the image into the viewer of the Advanced Setup.
You have now imported an image from the Windows File Explorer directly into the Tiles Ad-
vanced Setup.

5.7.9 Copying a Tile Region or Position

To copy and paste a specific Tile Region or Position, follow these instructions.

Prerequisite ü You licensed the Tiles & Positions module and activated it in Tools > Modules Manager.
1. Right-click the respective tile region or position and select Copy. Alternatively, press Ctrl+C.
If you want to copy multiple tile regions and positions, select multiple regions or positions
by dragging a selection box across the objects or click to select multiple objects while press-
ing the Ctrl button.
2. Right-click in the setup and select Paste. Alternatively, press Ctrl+V.
The copied tile regions/ positions are now pasted next to the originally copied regions/ positions.

Copying Tile Region or Position settings between wells


When you want to copy and paste a tile region or position setting (e.g. a certain arrangement of
tiles, positions or local support points) from one well to other wells or even to all containers of a
carrier, apply the following workflow.

Prerequisite ü You licensed the Tiles & Positions module and activated it in Tools > Modules Manager.
1. Select the well from where the tile region/ position setting should be copied.
à The selected well is now highlighted by a blue border.
2. Right click within the selected well in the Center Screen Area (outside the tile region) to
open the context menu.
3. Select Copy Container for replication.
4. If you want to select specific wells, use the left mouse button to select the wells into which
you want to paste the copied tile region/ position setting. To select multiple wells, press
Ctrl while selecting the wells.
5. Right click in the Center Screen Area and select the context menu entry Paste Replica-
tion to and either choose Selected Container or All Container.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 350


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

The copied tile region/ position setting is pasted into the selected wells or all the wells of the car-
rier with the same relative coordinates to the center of each well.

5.7.10 Local and Global Focus Surfaces

5.7.10.1 Introduction

Local Focus Surface


To acquire large tile regions on tilted or uneven specimens, you need to assign individual z-values
to each tile of a tile region efficiently. ZEN will help you do this by creation of a Local Focus Sur-
face. Note that a local focus surface is always associated with precisely one tile region. Thus, you
need to create a focus area separately for each tile region.

Global Focus Surface


To create a focus area covering the entire sample, you need to create a Global Focus Surface.
Global focus surfaces are based on a sample carrier template (e.g. for slides or multiwell plates)
and result in a focus surface that is valid for the entire sample carrier and therefore for all the tile
regions and positions it contains. This allows you to compensate for any tilting and curvature of
the sample carrier.

5.7.10.2 Creating a Local Focus Surface

To create local focus surfaces, you must distribute support points across your tile regions and as-
sign their focus position. Tile-region-specific focus values are then interpolated to generate a fo-
cus surface that approximates the topology of the area you want to image.

5.7.10.2.1 Distributing Support Points

Prerequisite ü To create a local focus surface you need the Tiles & Positions module.
ü You have set up a Tiles experiment with at least one tile region.
ü You are on the Acquisition tab in the Tiles tool.
1. Click Show Viewer.
à The advanced tile setup opens.
2. Select a tile region for which you want to create support points. To do this, click on the cor-
responding tile region in the list in the Tile Regions section of the Tiles tool. Alternatively,
you can select tile regions by clicking directly on the desired tile region in the Advanced
Setup view. Both methods allow you to select several tile regions when pressing the Ctrl
key.
3. Open the Focus Surface and Support Points section in the Tiles tool.
4. To add a single support point at the current stage position, click Current Position. Alterna-
tively, you can add a single support point to the center of the currently selected tile region
by clicking Center of Tile Region.
5. Under Add Multiple Support Points, you have the settings to add multiple support
points. Indicate the number of Columns and Rows for the distribution of the reference
points. Alternatively, recommended for larger tile regions (>200 tiles), you can use the dis-
tribution method Onion Skin. Depending on the total size and shape you might need to
adjust the density parameter and/ or the maximum number of support points to optimize
the result. Typically, this method works best with large irregular or rounded tile regions.
6. Click Distribute.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 351


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

à The support points are distributed within the selected tile region(s) and shown as yellow
points in the stage view.
à The support points of the selected tile region are displayed with their coordinates in the
Local (per Tile Region) list in the Focus Surface and Support Points section of the
Tiles tool.
7. If necessary, you can adjust the distribution of the support points manually in the Tiles -
Advanced Setup. You can change the position of the support points using drag & drop.
8. Repeat the steps until you have distributed reference points across all desired tile regions.
You have successfully distributed support points across the tile regions.

Info
Automatic Distribution
If you activate Auto-Distribute for New Tile Regions in the Focus Surface and Support
Points Section [} 366] of the Tiles tool, support points are automatically added and distrib-
uted for all newly created tile regions.

Info
Support Point Distribution
Distribute the support points evenly across your tile region. The more irregular the surface of
your specimen, the more reference points you should set. An even but tilted surface requires
at least 4 reference points for a solid calculation, while a simple saddle surface requires at least
9 reference points. A high reference point density leads to a more precise result, although the
maximum useful density is one reference point per tile. The generic method follows a simple
grid pattern to place the support points. It works well on regular rectangular tile regions
smaller in size. For larger (>200 tiles) tile regions the Onion Skin will likely provide better re-
sults. In some cases, trial and error might be needed to optimize the parameters.

5.7.10.2.2 Verifying Z-Values of Support Points

1. Click on the Verify button in the Focus Surface and Support Points section of the Tiles
tool.
à The Verify Tile Regions/Positions dialog opens.
2. Select the Helper Method you want to use. This will support you in determining the z-val-
ues. The options are Autofocus (AF) and Definite Focus (DF). If you have neither then
you can only adjust z-values manually.
3. Click on the Move To Current Point button.
à The stage automatically moves to the support point that is highlighted in the reference
point list. Alternatively, you can also double-click on the support point you want to check
in the list .
4. In the Live mode use the Focus tool to adjust the z-value.
5. Click on the Set Z and Move to Next button.
à The checked reference point is marked with a green check mark.
à The stage moves automatically to the next support point in the list.
6. Repeat the last 3 steps until you have checked all the support points.
à The message All points have been verified appears.
7. Close the Verify Tile Regions/Positions dialog.
You have adjusted and verified the z-values of all support points.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 352


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Info
Positions always have a focus, which is determined by the z-value of the position. If you use
positions in addition to tile regions, you can verify the z-values of the positions with the help of
a similar dialog. Open this dialog by clicking on the Verify button in the Positions section of
the Tiles tool.

5.7.10.2.3 Selecting Interpolation Degree

1. If necessary, select the interpolation level in the Interpolation Degree dropdown list in the
Focus Surface and Support Points section of the Tiles tool.
You have successfully created a local focus surface. You can now start the experiment. To ensure
that the tiles are acquired along the focus surface the software automatically selects the most ap-
propriate focus strategy. For more information on focus strategies read the chapter Working with
Focus Strategies [} 63].

Info
The minimum number of support points necessary per tile region is indicated in the Interpola-
tion Degree dropdown list for each entry. The calculation is more solid if the number of sup-
port points exceeds this minimum number. We therefore recommend that you only increase
the interpolation degree as far as the surface of the sample demands, even if you have set
more support points. If the number of support points does not correspond to the minimum
number for the selected interpolation degree, the interpolation degree will be reduced auto-
matically. By default, ZEN uses a second order interpolation degree that creates a parabolic fo-
cus surface and requires at least 9 support points. Typically, this will be suitable for many sam-
ples and imaging scenarios.

5.7.10.3 Creating a Global Focus Surface

To create a global focus surface, you must distribute support points across your sample carrier
and define their focus position. A focus area across the sample carrier is then interpolated from
the values of these reference points.

5.7.10.3.1 Distributing Support Points

Prerequisite ü You have configured the general settings for setting up a tile experiment (experiment created,
at least one channel defined, Tiles dimension activated).
ü To create a global focus surface, you need the Tiles & Positions module.
ü You are on the Acquisition tab in the Tiles tool.
1. Open the Sample Carrier section.
2. Click on the Select... button.
à The Select Template dialog opens.
3. Select the sample carrier template that you want to use.
4. Click on Options and select Copy And Edit....
à A copy of the existing template is generated and opened in the sample carrier editor.
5. To distribute support points across the sample carrier template, open the Global Support
Points section.
6. Select the containers in which you want to create global support points. To do this, press
the Ctrl key and click on the containers.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 353


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

7. Click on the Distribute One Support Point For Each Selected Container button.
à One support point is assigned to each selected container.
à The support points are distributed automatically across the sample carrier.
à You can add further support points manually using the Add button .
8. To close the Editor window, click on OK.
9. To select the edited sample carrier template, click on OK.

à If you wish to re-edit the global support points at any time, click on the Edit icon in
the sample carrier section to open the sample carrier editor again.
10. To calibrate the sample carrier, click on the Calibrate button and follow the wizard.
You have successfully distributed support points across a sample carrier template and have se-
lected and calibrated it.

5.7.10.3.2 Verifying Z-Values of Support Points

1. In the Tiles tool open the Focus Surface and Support Points section.
2. Go to the Global (on Carrier) tab.
à All the support points of the selected sample carrier template are displayed in the Sup-
port Points list.
3. Click on the Verify button.
à The Verify Global Support Points dialog opens.
4. Select the Helper Method you want to use. This will support you in determining the z-val-
ues. The options are Autofocus (AF) and Definite Focus (DF). If you have neither then
you can only adjust z-values manually.
5. Click on Move To Current Point.
à The stage automatically moves to the support point that is highlighted in the list. Alterna-
tively, you can also double-click on the support point in the list.
6. In the Live mode use the Focus (or SW Autofocus) tool to set the z-value.
7. Click on Set Z and Move to Next.
à The support point is marked with a check mark.
à The stage automatically moves to the next support point in the list.
8. Repeat the last 3 steps until you have checked all the support points.
à The message All points have been verified appears.
9. Close the Verify Global Support Points dialog.
You have adjusted and verified the Z-values of all support points.

5.7.10.3.3 Selecting Interpolation Degree

1. Select the interpolation degree in the Interpolation Degree dropdown list in the Focus
Surface and Support Points section.
You have successfully created a global focus surface.
You can now set up your tile experiment using the sample carrier. Further information on this can
be found under: Using Sample Carriers [} 356]. To ensure the tiles are acquired along the focus
surface during the experiment the software automatically selects the most appropriate focus strat-
egy in the Focus Strategy tool. For information on focus strategies read the chapter Working
with Focus Strategies [} 63].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 354


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Info
The minimum number of support points necessary is indicated in the Interpolation Degree
dropdown list for each entry. The calculation is more solid if the number of support points ex-
ceeds this minimum number. We therefore recommend that you only increase the interpola-
tion degree as far as the surface of the carrier demands, even if you have created more sup-
port points. If the number of support points does not correspond to the minimum number for
the selected interpolation degree, the interpolation degree will be reduced automatically. In-
terpolation degree1 – Tilted Plane (at least 4 support points) is typically sufficient to com-
pensate for any tilting of the sample carrier.

5.7.11 Assigning Categories to Tile Regions and Positions

In some cases it can be helpful to not only display the well number together with the acquired im-
ages (Path: Graphics > Frequent Annotations > Carrier Container Name) but also to create
certain additional annotations for different tile regions or positions, e.g. "control condition" or
"experimental condition 1".
For that purpose, the software allows you to add and edit names and categories to the different
tile regions/positions that have been generated.

Prerequisite ü You licensed the Tiles & Positions module and activated it in Tools > Modules Manager.
1. In order to assign individual names to different individual positions and/or tile regions in a
well plate experiment, in the Tiles tool click on the respective name in the Tile Regions or
Positions list. You can now edit the name field and press Enter to finish.
2. Repeat this step to rename different tile regions or positions.
3. To assign or edit categories of your tile regions/ positions, first select all desired tile regions/
positions that should be grouped in the same category.
4. Under the Tile Regions/Positions list, in the Properties section Category, click on the
Options button and select New from the dropdown list.
à The New Category window opens.
5. Enter a Name and add a Description for the selected tile regions/ positions.
6. Assign a Color for the new category by clicking on the color bar and choosing a preferred
color.
7. Click on OK to create the new category.
à The New Category window closes and the new category is created.
8. As Category choose the desired category for the selected tile regions/ positions from the
dropdown list.
The chosen category is now assigned to the selected tile regions/ positions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 355


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Info
4 To display the name of your Tile Region/ Position later in your acquired image(s), go to
Graphics > Frequent Annotations > More… and select Image.Scene.Name from the
metadata list.
4 Note that a predefined category can also be applied to a differentiated selection of Tile Re-
gions/ Positions from more than one well.
Note also, that the assigned color is only used as a feature in the Tiles tab (Left Tool Bar
Area).
4 To display a Tile Region/ Position Category feature (Name and/or Description) in your ac-
quired image, you go to Graphics > Frequent Annotations > More…. Type “category”
in the search bar and select the desired feature to be displayed. (Although the option
"Color" is given, no reasonable element will be displayed by the software.)
4 To adjust parameters of your annotations (e.g. font size), right-click on it and go to For-
mat > Graphical Elements.

Displaying categories in the Tiles/ Positions List (Left Tool Area)

Prerequisite ü You have selected several different positions or tile regions and assigned different categories.
1. Under Positions or Tile Regions of the Tiles tool, select a position or tile region.
2. Right-click on the selected position/ tile, choose Sort and select By Category
The positions/ tiles will be sorted alphabetically according to the assigned categories.

5.7.12 Using Sample Carriers

Use a sample carrier template to display the size and appearance of your sample carrier (e.g. slide
or multiwell plate) in Advanced Setup. This allows you to distribute tile regions or positions eas-
ily across your sample carrier. For the use of sample carriers, you need to have licensed the Tiles
& Positions module and activated it in Tools > Modules Manager.

5.7.12.1 Selecting a Sample Carrier Template

Prerequisite ü You have configured the general settings for setting up a tile experiment (experiment created,
at least one channel defined, Tiles dimension activated).
ü You are on the Acquisition tab in the Tiles tool.
1. Open the Sample Carrier section and click on the Select... button.
à The Select Sample Carrier Template dialog opens.

2. Select an existing sample carrier template or generate a new template by clicking on .


3. To close the dialog, click on OK.
4. Calibrate the sample carrier by clicking on the Calibrate button.
à The Sample Carrier Calibration Wizard opens.
5. Follow the wizard until you have fully calibrated the sample carrier.
à The information The sample carrier is calibrated appears in the Sample Carrier sec-
tion.
You have successfully selected a sample carrier.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 356


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.12.2 Customizing a Sample Carrier Template

If you want work with a sample carrier that is not listed in the template database, you will need to
apply the following workflow in order to create a new template.

Prerequisite ü You have done all prerequisites for a Tiles & Positions experiment
ü You have defined at least one channel.
ü You have activated the Tiles checkbox.
1. Go to the Acquisition tab.
2. Open the Tiles tool and activate the Show All mode.
3. Open the Sample Carrier section and click on the Select… button.
à The Select Template dialog opens.

4. Click on the Options and select New Template.


à The New Sample Carrier Template dialog opens.
5. Choose a Category that corresponds to the type of your carrier and assign a Name to your
template.
6. For example if you select Slide, you can now configure the Width and Height of the slide
and adjust the location of a Reference Point.
7. If you select a Multislide, Petri Dish, Multiwell or Multichamber template, you can con-
figure and adjust additional parameters of your carrier.
8. In case you need to modify one of the above depicted templates even further, first select
the Category that appears closest to your carrier, go again to the Category tab and then
choose Custom.
You have customized a sample carrier template or set up a custom one.

5.7.12.3 Re-positioning Sample Carrier after Incubation

When you want to take images of positions/ tile regions on a sample carrier, that has to be taken
off the stage, e.g. for incubation purposes or changes of the immersion medium, proceed as fol-
lows to re-position your sample carrier.

Starting the Experiment

Prerequisite ü You have run the stage calibration and have located your sample, see chapter Calibrating the
Stage and Selecting the Channel [} 343].
ü You have set up at least one channel and adjusted the light/ camera exposure time.
ü You have activated the Tiles checkbox and the Show All mode
1. In the Tiles tool, open the Sample Carrier section and click on Select.
à The Select Template dialog opens.

2. Select the template of your choice.


3. Adjust the surface of the sample carrier. Refer to the chapter Creating a Global Focus Sur-
face [} 353].
4. Click on OK.
à The Select Template dialog closes.
5. Click on Calibrate.
à The Sample Carrier Calibration Wizard opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 357


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

6. Move a sample reference point into the middle of the crosshair. This reference point can be
any unique, identifiable point on the slide and does not have to in the middle of the slide.
7. Click on Next.
8. Under X/Y Position click on Set Zero.
9. Click on Next.
10. As Calibration Method, select Search Reference Point
11. Click on Next.
12. Click on Set Current X/Y.
13. In the Tiles tool, click on Show Viewer and add positions/tile regions at your locations of
interest.
14. Once you have defined all your positions/ tile regions, click on Options on the Ac-
quisition tab to in the Experiment Manager.
15. Save your experimental settings, including the lists of positions/ tile regions, by selecting ei-
ther the Save As or Export entry.
16. Start your experiment and record images from your selected positions/ tile regions.
17. Remove your sample off the stage and e.g. put it back into the incubation chamber.
18. Close the software.
You have done all settings for a successful re-positioning of your sample carrier after the experi-
ment.

Info
4 For demo purposes, select a standard slide that can mimic your test sample.
4 Regarding calibration of your template, you can customize your own carrier see the chap-
ter Customizing a Sample Carrier Template [} 357], but for slides with one coverslip or
well, there is only the option for Single Reference Point Calibration. For Multi-well plates,
you will have the option for 7-point, 4-point, 3-point or 1-point calibration. This becomes
important for adjusting for the rotation of the sample.
4 It is assumed that you just use a conventional glass slide with some cells or tissue that is
positioned in the center.
4 You can zoom in and out using the mouse scroller, and move the stage in the Center
Screen Area to a point of interest with a double-click on the sample carrier.
4 With Save As the settings will be saved directly in the Experiment Manager. With Export
the settings will be saved in a folder of your choice.

Re-Positioning of the Sample Carrier after the experiment

Info
If you cycle the power on the microscope the software will prompt you, to calibrate the stage
and/ or focus drives. Thus, if the calibration of the multi-well plate was performed under the
same conditions, then the sample carrier calibration will still be valid. You must however en-
sure that other parameters like plate orientation and placement on the microscope have not
changed.

1. Restart the software.


2. In the Acquisition tab go to the Experiment Manager and Reload or Import your exper-
imental settings including your list of positions/ tile regions.

3. In Tiles tool under Sample Carrier, click on Calibrate.


à The Sample Carrier Calibration Wizard opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 358


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

4. Move your previously chosen sample reference point into the middle of the crosshair.
5. Click on Next.
6. Under X/Y Position click on Set Zero.
7. Click on Next.
8. As Calibration Method, select Search Reference Point.
9. Click on Next.
10. Click on Set Current X/Y.
11. Now, you still need to verify the Z-offset of your positions. Therefore, follow the corre-
sponding instructions given in the chapters Adjusting Z-Values of Tile Regions [} 341] and
Adjusting Z-Values of Positions [} 342].
All of your selected positions/tile regions are now re-assigned to the correct X/Y/Z-values in rela-
tion to your (unique identifiable) reference point.
You can re-start your experiment and record images from your selected positions/tile regions.

5.7.13 Tiles Tool

Info
The basic Tiles tool is only visible if you have a motorized stage configured with your micro-
scope. The Tiles Advanced Setup and many other functions are only available if you own the
Tiles & Positions module and when it is activated in the Modules Manager. Additionally,
you must activate the corresponding checkbox on the Acquisition tab in the Experiment
Manager. This tool is part of the basic license for LSM.

In the Tiles tool you configure the acquisition of images that consist of several image fields.
Therefore you define Tile Regions or Positions. In addition you can set up focus surfaces and
sample carrier templates here.
The Tiles tool is located in the Left Tool Area under Multidimensional Acquisition.

Parameter Description
Show Viewer Only available if you have the license for the Tiles & Positions func-
tionality.
Opens the Tiles Advanced Setup [} 372] view in the Center Screen
Area.

Info
The Sample Carrier, Focus Surface and Options sections are only visible if the Show All
mode is activated.
If you have no license for the Tiles module you will only find Tile Regions, Positions and Op-
tions sections here.

The different sections of the tool are described in the next chapters.

5.7.13.1 Tile Regions Section

Here you can define the desired tile regions and add it to the image.
Note: The first section with controls is only visible if you have no license for the Tiles & Positions
module. With a license, these controls are selected from the Left Toolbar [} 375] in the Tiles Ad-
vanced Setup.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 359


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Contour This parameter is only visible if the Show All is activated.
Here you select the shape or contour of the tile region that you are
adding. Simply click on the corresponding button to select the desired
contour. The selected contour is highlighted in blue color.

- Rectangle If selected, you can create rectangular tile regions.

- Circle When selected, you can create circular tile regions.

Mode

- Tiles If selected, you have to enter the number of tiles as a reference for
the size of the tile region.
Enter the number of tiles in the X/Y input fields. If you are adding a
circular tile region, enter the number of tiles for the diameter in the
Diameter input field.

- Size If selected, you have to enter the size as a reference for the size of the
tile region.
Enter the size of the tile region in the X/Y input fields. If you are
adding a circular tile region, enter the diameter of the tile region in
the Diameter input field.

- Stake If selected, you can define a tile region by the placement of at least
two markers (user defined X/Y stage coordinates). If you want to
modify the tile region (expand/reduce) you have to adjust the tile re-
gion to the desired size. To complete the tile region press Done. Cir-
cular or rectangular tile region can be created in this manner by selec-
tion of the appropriate contour.

- Add Adds the tile region to the image. The added tile region will also ap-
pear in the Tile Regions List and is activated for acquisition.
Added tile regions are displayed in the form of red grids in the stage
view of the Advanced Tiles Setup.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 360


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Tile Region List Options

Parameter Description
Tile Regions List Displays the added tile regions. The list contains the following col-
umns:

- Checkbox Activates the relevant list entry for acquisition.

- Name Here you can edit the name of the tile region.

- Category Displays the category of the tile region. Categories can be defined in
the view options of the advanced tiles setup on the properties tab.

- Tiles Displays the number of tiles of the tile region.

- Z Displays the z-position of the tile region.

- Size Displays the size of the tile region along its x and y axes in microme-
ters.

With the Up/Down buttons you can shift the selected list entry one
Up and position up or down in the tile regions list. This allows you to modify
Down the acquisition order. Note that the order in the list will only be re-
spected if the sorting of tile regions/ positions is deactivated in the
Options section (Stage Travel Optimization)!

Deletes the selected list entry.


Delete

If you click on the button, you see the following options:


Options

- Set Current Z Sets the current z-position for all selected tile regions.
for Selected
Tile Regions

- Set Current X/ Sets the current X/Y/Z-Position for all selected tile regions.
Y/Z for Se-
lected Tile Re-
gions

- Delete Deletes the current tile region.

- Delete All Deletes all tile regions.

- Activate Activates the current tile region for acquisition.

- Deactivate Deactivates the current tile region for acquisition.

- Unlock Unlocks the current tile region. The tile regions or positions are only
locked if created in carrier mode.

- Unlock All Unlocks all locked tile region.

- Sort By Center Position (Y -> X) sorts all tile regions according to their
overall Y position.
By Center Position (X -> Y) sorts all tile regions according to their
overall X position.
By Category sorts all tile regions according to their category.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 361


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Note that the order in the list will only be respected if the sorting of
tile regions/positions is deactivated in the Options section (Stage
Travel Optimization)!

- Convert to Po- Converts a selected tile region into Positions or a Position Array.
sitions…

Properties Tile Re- Only visible if you have license for the Tiles & Positions module.
gion Displays the name of the currently selected tile region if one region is
selected.

Category Only visible if you have license for the Tiles & Positions module.
Shows the currently assigned category of the selected tile region. The
Default category is set for all new tile regions.

Only visible if you have license for the Tiles & Positions module.
Options Opens the options for editing and creating categories.

- New Opens the New Category dialog to create a new category.

- Edit Opens the Edit Category dialog to edit the selected category.

- Delete Deletes the selected category and sets the category of the tile region
to Default.

X Only visible if you have license for the Tiles & Positions module.
Displays and sets the x-value of the selected tile region.

Y Only visible if you have license for the Tiles & Positions module.
Displays and sets the y-value of the selected tile region.

Z Only visible if you have license for the Tiles & Positions module.
Displays and sets the z-value of the selected tile region.

Set Current Z Only visible if you have license for the Tiles & Positions module.
Sets the Z dimension at the current Z position of the focus drive.

Width Only visible if you have license for the Tiles & Positions module.
Displays and sets the width of the selected tile region.

Height Only visible if you have license for the Tiles & Positions module.
Displays and sets the height of the selected tile region.

Verify Only visible if you have license for the Tiles & Positions module.
Opens the Verify Tile Regions dialog. There you can verify each
point of the tile region according focus und position.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 362


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.13.2 Positions Section

Current Position section


Displays the current stage position.
Note: The first section is only visible if you have no license for the Tiles & Positions module.
With a license, this functionality is visible in the Left Toolbar [} 375] of the Tiles Advanced
Setup.

Parameter Description
X Position Displays the x coordinate of the current position.

Y Position Displays the y coordinate of the current position.

Adds the current position to the Positions List and activates it for ac-
quisition.
Add

Display mode section

Parameter Description
Single Positions Shows the Single Positions List.
To learn more about single positions see glossary "Position".

Position Arrays Shows the Position Arrays List and the Positions of selected Ar-
ray List, that shows a full Single Positions List for the selected posi-
tion array.
To learn more about position arrays see glossary "Position".

Single Position Displays the added positions/ position arrays. The list contains the fol-
List/Position Array lowing columns and buttons.
List

– Checkbox Activates the relevant list entry for acquisition.

– Name Displays and edits the name of the single position.

– Category Displays the category of the single position. Categories can be defined
in the view options of the advanced tiles setup on the properties tab.

– Contour Only visible if you have selected Position Arrays.


Displays the contour of the position array.

– Positions Only visible if you have selected Position Arrays.


Displays the number of positions of the position array.

– Size Only visible if you have selected Position Arrays.


Displays the size of the position array.

– X Displays the x-position of the single position.

– Y Displays the y-position of the single position.

– Z Displays and edits the z-position of the single position.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 363


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
– With the buttons you can shift selected list entry one position up or
and down in the tile regions list. This allows you to modify the acquisition
order.
Note that the Tile Regions/Positions checkbox has to be deacti-
vated in Tiles Options [} 384].
Note that the order in the list will only be respected if the sorting of
tile regions/ positions is deactivated in the Options section (Stage
Travel Optimization)!

– Deletes the selected list entry.


Delete

– Opens the Options for Editing Single Positions [} 364] or Options


Options for Editing Position Arrays [} 365] respectively.

Verify Opens the Verify Tile Regions or Verify Positions Dialog [} 371].

Properties Position Only visible if you have license for the Tiles & Positions module.
Displays the name of the currently selected position.

Category Only visible if you have license for the Tiles & Positions module.
Shows the currently assigned category of the selected tile region. The
Default category is set for all new tile regions.

Only visible if you have license for the Tiles & Positions module.
Options Opens the options for editing and creating categories.

- New... Opens the New Category dialog to create a new category.

- Edit… Opens the Edit Category dialog to edit the selected category.

- Delete Deletes the selected category and sets the category of the tile region
to Default.

X Only visible if you have license for the Tiles & Positions module.
Displays and sets the x-value of the selected tile region.

Y Only visible if you have license for the Tiles & Positions module.
Displays and sets the y-value of the selected tile region.

Z Only visible if you have license for the Tiles & Positions module.
Displays and sets the z-value of the selected tile region.

Set Current Z Only visible if you have license for the Tiles & Positions module.
Sets the Z dimension at the current Z position of the focus drive.

5.7.13.2.1 Options for Editing Single Positions

Parameter Description
Set Current Z for Sets the current Z-Position for all selected positions.
Selected Positions

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 364


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Set Current XYZ Sets the current X-Y-Z-Position for the selected position.
for Selected Posi-
tion

Delete Deletes the current position.

Delete All Deletes all positions.

Activate Activates the current position for acquisition.

Deactivate Deactivates the current position for acquisition.

Sort Sorts the list entries according to the chosen parameter.

- By Center Po- Sorts all positions according to their overall Y position.


sition (Y -> X)

- By Center Po- Sorts all positions according to their overall X position.


sition (X -> Y)

- By Category Sorts all positions according to their category.

Import stage Only visible if you have license for the Tiles & Positions module.
marks as positions
Imports the marks from the Stage tool as positions.

5.7.13.2.2 Options for Editing Position Arrays

Parameter Description
Set Current Z for Sets the current z-position for all positions in the selected arrays.
all Positions in se-
lected Arrays

Delete Deletes the current position array.

Delete All Deletes all position arrays.

Activate Activates the current position array for acquisition.

Deactivate Deactivates the current position array for acquisition.

Unlock Unlocks the current position array.

Unlock All Unlocks all locked position arrays.

Sort Sorts the list entries according to the chosen parameter.

- By Center Po- Sorts all positions according to their overall Y position.


sition (Y -> X)

- By Center Po- Sorts all positions according to their overall X position.


sition (X -> Y)

5.7.13.3 Sample Carrier Section

Only visible if the Show All mode is activated and only available with a license for the Tiles & Po-
sition functionality.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 365


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Sample Carrier Displays the selected sample carrier template. If no template is se-
lected it will display None.

Select... Not available for the Cell discoverer.


Opens a dialog to select the sample carrier template.

Opens the sample carrier selection/editor dialog where you can edit
and add global support points to the selected sample carrier.
(Edit Support
Points)

Deletes the selected sample carrier from the sample carrier field. The
template will still be available in the Select Sample Carrier Tem-
Delete
plate dialog.

Calibrate... Only available if a suitable channel is configured for the experiment.


Opens the wizard which guides you through the sample carrier cali-
bration.

Move Focus Drive Activated: Moves the focus drive to the loading position during the
to Load Position movement of the stage to another container of the sample carrier
Between Contain- (e.g. a well or slide). This prevents possible damage. Note that this be-
ers havior is only applied during an experiment.

See also
2 Select Template Dialog [} 386]

5.7.13.4 Focus Surface and Support Points Section

Only visible if the Show All mode is activated.

Parameter Description
Selected Tile Re- Displays the number of currently selected tile regions.
gion

Current Position Adds a support point at the current stage and focus position. Only
available if the stage is positioned within the yellow bounding of the
selected tile region.

Center of Tile Re- Adds a support point at the center of the currently selected tile re-
gion gion.

Method Selects which method is used to add multiple support points.

- Generic Distribution method with a simple column and row approach. ZEISS
recommends using this method for smaller tile regions (<200 tiles) of
a regular shape, e.g. quadratic, rectangular, and circular.

- Onion Skin Distribution method for mid- or larger tile regions (>200 tiles) of an ir-
regular shape like you might use to image large area tissue specimens,
e.g. brain slices.

Columns Only available with Generic.


Sets the number of columns of support points within the selected tile
region.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 366


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Rows Only available with Generic. Sets the number of rows of support
points within the selected tile region.

Density Only available with Onion Skin.


Determines the number of support points (up to a preset maximum
number) that are used to cover the tile region.
Example: A square tile region with 400 tiles has 20 support points
with the default parameters. The parameter density is set with a stan-
dard value of 5%. This means that in an approximately square tile re-
gion of 400 tiles about 20 support points are created.

Margin Only available with Onion Skin.


This parameter allows you to control how close support points can be
placed along the edges of your tile region. The value defines the dis-
tance to the tile regions boundary as a number of tiles. The default is
1 and allows support points to be placed in the outer most "layer" of
tiles. A value of 2 allows support points only from 2 "layer" of tiles
from the boundary, etc. This feature is useful if a software autofocus
(SWAF) is used to determine the z-values of your support points.
Sometimes tiles in the boundary regions might not contain any struc-
ture. Thus, the SWAF cannot adjust the support points z-value.

Max. Only available with Onion Skin.


Determines the maximum number of support points for a tile region.
As the density parameter is set to 5%, this would necessitate for very
large specimens that the number can get very large. But a larger num-
ber of focus points does not always mean a better quality calculation
of the focus surface. For this reason, you can define a maximum num-
ber of focus points in the range of 24 to 36 points.

Distribute Distributes the entered number of support points defined in the col-
umn and row input fields within the tile region. Previously defined
support points will be deleted.

Auto-Distribute for Activated: Automatically adds and distributes support points for all
New Tile Regions newly created tile regions.
Deactivated: Support points are distributed only via the Distribute
button.

Local (per Tile Re- Displays a list with local or global support points. You have the fol-
gion)/Global (on lowing columns and options:
Carrier) tab

- X Displays and edits the x coordinate of the focus reference point.

- Y Displays and edits the y coordinate of the focus reference point.

- Z Displays and edits the z coordinate of the focus reference point.

- Container Allows you to sort the global support points according to their con-
tainer on the sample carrier.

- Only visible on the Global (on Carrier) tab.


Adds a new support point to the selected tile region at the current
Add
stage and focus position.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 367


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
- Deletes the selected list entry.
Delete

-
Options

– Add Support Adds a new support point at the current stage and focus position.
Point at Cur-
rent Stage
and Focus Po-
sition

– Set Current Z Sets the current Z-Position for all selected support points.
for Selected
Support
Points

– Set Current X/ Sets the current X-Y-Z-Position for the selected support point.
Y/Z for Se-
lected Support
Points

– Delete Deletes the current support point.

– Delete All Deletes all support points from the current tile region.

– Delete all Sup- Deletes all support points from the selected tile regions.
port Points
from Selected
Tile Regions

– Delete all Sup- Deletes all support points from all tile regions.
port Points
from all Tile
Regions

– Set Current Z Only visible on the Global (on Carrier) tab.


for Selected Sets the current z-position for all selected support points.
Support
Points

Verify Opens the dialog to verify the support points.

Set current XYZ Sets the current x/y/z position for the selected support point.

Set current Z Sets the current z-position for all selected support points.

Interpolation De- Displays the selected degree of interpolation.


gree Selects a degree of interpolation from the dropdown list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 368


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Info
Focus Surface (Verify)
The more variable the surface of your specimen, the higher you should choose the interpola-
tion degree. For higher degrees you need more support points. The minimum number of sup-
port points required for each interpolation degree is given in the dropdown list. As an over-
achievement of this minimum number ensures a solid calculation, we recommend minimizing
the interpolation degree even if you added more support points. Increase the interpolation de-
gree only so far as the surface condition of your specimen demands. If the number of support
points is too low for the selected interpolation degree, the next lower level for which the mini-
mum is fulfilled is used. By default, ZEN uses the second order parabolic saddle surface that re-
quires at least 9 support points. For most applications you will not need to adjust this setting.

Info
Properties of Global Support Points
The properties of a selected global support point slightly differ from those of a local one, as
you cannot edit the X/Y dimensions because they are fixed by the sample carrier template you
have selected. Therefore there is no Set Current X/Y/Z button for global support points. If
you want to edit the number and XY dimension of your global support points, this can be
done directly via the Sample Carrier section of the Tiles tool.

5.7.13.5 Options Section

Only visible if the Show All mode is activated.


Here you can set options like acquisition and stage travel behavior during the experiment.
Changes in this section of the tool affect all elements, tile acquisitions, positions and position ar-
rays.

Parameter Description
Tile Overlap Defines the overlap in percent of individual tiles of the tile regions.
The value is set to 10% by default.
Note that lower overlap might cause artifacts when stitching the im-
age as there is less information for a robust correlation. No overlap
will not allow the images to be stitched correctly.

Stage Travel Opti- In this section you can adjust settings for stage traveling during an ex-
mization periment or preview scan ( only with Tiles & Positions module). Note
that in some cases the preview scan function will automatically select
a travel mode for the stage that is more appropriate.

Travel in Tile Re-


gions

- Meander Acquires tile regions following a meander pattern – alternately from


both travel directions (left -> right; right -> left). This scan movement
is faster.

- Comb Acquires tile regions following a comb pattern – always from one
travel direction only (left -> right). This scan movement is more pre-
cise.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 369


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
- Spiral Acquires tile regions following a spiral pattern – from the center of
the region to the outer bounds in a clockwise motion. This mode
works only for regions with rectangular or elliptical contours.

Tile Regions/Posi- Activated: Individual positions and tile regions are not acquired in
tions the sequence in which they are defined in the Tile Regions list.
The stage movement will be automatically adapted to the location of
the individual tile regions and positions. If you add or remove tile re-
gions or positions, the sequence of acquisition therefore also changes.

- Sort by X, The tile regions and positions are sorted by their absolute position
then Y (first x, then y).

- Sort by Y, The tile regions and positions are sorted by their absolute position
then X (first y, then x).

Carrier Wells/Con- Activated: Applies the selected travel patterns (meander or comb)
tainer when acquiring tiles in sample carriers with wells/containers. When,
for example meander is used, the stage travel between wells will be
e.g. A1, A2 ....A4 --> B4, B3 .....B1 etc.

- Meander Acquires tile regions following a meander pattern – alternately from


both travel directions (left -> right; right -> left). This scan movement
is faster.

- Comb Acquires tile regions following a comb pattern – always from one
travel direction only (left -> right). This scan movement is more pre-
cise.

Use Stage Speed This function is only visible if the corresponding option is activated in
from Stage Tool Tools > Options > Acquisition > Tiles & Positions. By default,
backlash correction will be used during stage movement.
Activated: The software uses the stage travel speed which is set in
the Stage tool (Right Tool Area).

Stage and Focus Activated: Stage and focus positioning is done with a backlash cor-
Backlash Correc- rection which is more precise but slightly slower.
tion

Move Focus to Activated: The focus drive is moved to the load position while mov-
Load Position Be- ing to another tile region, position, or well.
tween Regions/Po-
sitions

Split Scenes into Activated: The scenes (e.g. tile regions and positions) are stored into
Separate Files separate physical files. They are still combined into one logical image
file.

Image Pyramid Activated: An image pyramid is generated during the acquisition.


During Acquisition This optimizes the image for fast display. If this option is not acti-
vated, the acquired image will not be shown and updated in the doc-
ument area while the acquisition is running.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 370


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.13.6 Verify Tile Regions or Verify Positions Dialog

Note that the z values of positions, tile regions (unless they have at least one support point), local
support points, and global support points are verified in a separate dialog accessed via the Focus
Surface and Support Points section. As the dialog contains the same items and options for veri-
fying the Z values it is described here once.

Parameter Description
Tile Regions/Posi- Displays all the tile regions (TR), positions (P), or support points (SP)
tions List currently active in your experiment. The list contains the following col-
umns and buttons:

- Status Here you can see if the Z-Position is already verified. Then a green
checkmark will appear in the corresponding row.

- Name Displays the name of the selected object.

- Z (µm) Displays the z-position of the tile region, position, or support point.

- Tile Region Shows the tile region to which the local support point belongs.

- Array Shows if the position is part of a Position Array.

- Opens the options menu for verifying tile regions/positions, see de-
scription below.
Options

Verification Helper
Method

- None If selected, you need to manually adjust the focus for each point to be
(manual ad- verified.
justment)

- Autofocus Only available if your system has a motorized focus drive (z-axis) and
(AF) the software autofocus module.
If selected, you can use the software autofocus for adjusting the focus
for each point to be verified. The corresponding buttons will then ap-
pear in the dialog.

- Reflex Autofo- Only available for Lattice Lightsheet.


cus (AF) If selected, you can use the reflex autofocus for adjusting the focus
for each point to be verified. The corresponding buttons will then ap-
pear in the dialog.

- Definite Focus Only available if your system has a Definite Focus device.
(AF)
If selected, you can use the definite focus for adjusting the focus for
each point to be verified. The corresponding buttons will then appear
in the dialog further below.

Move to Current Moves the stage to the selected object.


Point

Include Z when Activated: ZEN moves to the selected object and adjusts the position
Moving to Points of the z-drive to the currently assigned z-value.

Set Z & Move to Sets the current z value for the selected support point and sets the
Next status to verified. Then the software moves the stage to the next sup-
port point.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 371


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Run AF (or DF) and This button is only visible if you have selected Autofocus (AF), Re-
Set Z flex Autofocus (AF), or Definite Focus (DF) as Helper Method.
Runs the software autofocus/definite focus and sets the current z po-
sition to verified.

Use AF (or DF) to This button is only visible if you have selected Autofocus (AF), Re-
Verify the Remain- flex Autofocus (AF), or Definite Focus (DF) as Helper Method.
ing
Automatically moves to the remaining points and determines the z
value using the selected autofocus option for each point.

Options for verifying tile regions/positions

Parameter Description
Current Point Veri- Here you can change the status of the selected support point from
fied verified to unverified (or vice versa).

Set all Points as Changes the status of all points to verified.


Verified

Reset Verification Changes the status of all points to unverified.


State of all Points

Set Current Z for The current z value is set for all selected points. You can press Ctrl
Selected Points and the left mouse button to select multiple points, or Ctrl + A to se-
lect all.

Set Current Z for The current z value is set for all points.
all Points

Apply Z-Offset... Opens al dialog to apply a z-offset for all or the selected points.

5.7.14 Tiles Advanced Setup

Here you can visualize and plan your Tiles and Positions experiment. The advanced tiles setup
opens by clicking on the Show Viewer button in the Tiles tool on the Acquisition tab of the
Left Tool Area. In the Center Screen Area you can see the Stage view [} 373]. When the Tiles
Advanced Setup opens, the stage view is zoomed to a predefined factor. You can change the
Zoom in the Dimensions tab, or by scrolling the mouse wheel.
To navigate around you have the following options:

§ Move the mouse pointer of the live navigator, then press and hold the left mouse button and
drag the live navigator to the desired location. Release the left mouse button to finish.
§ Place the mouse pointer at a location where you want to move the stage and double click.
§ Use the software joystick in the Stage tool of the Right Tool Area to navigate. Alternatively
use the hardware joystick of your stage controller.
§ In each corner and along each edge with the arrowheads, you can click to move the view in
this direction. Additional settings and tools relating to tile regions or positions can be found in
the specific view options.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 372


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

1 2

1 Left Toolbar
Here you select which setup you use to set tile regions or position. for more information,
see Left Toolbar [} 375].

2 Top Toolbar
Depending on what you have selected on the Left Toolbar, different features to create
tiles or positions are displayed here. For more information, see Top Toolbar [} 376].

3 Stage View
The Stage View shows the full travel range of the microscope stage, along with the cur-
rent stage position, the graphical display of sample carriers, and your acquired mosaic
images. For more information, see Stage View [} 373].

4 View Options
General and tiles specific [} 382] view options are displayed here.
Note that the functionalities between activated and deactivated Show All layout might
differ.

5.7.15 Stage View

The Center Screen Area shows the full travel range of the microscope stage, along with the cur-
rent stage position, the graphical display of sample carriers and your acquired mosaic images. You
can control the stage view using the arrow icons at the edges of the image area. The view can be
enlarged, reduced or moved using the general control elements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 373


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Symbol Parameter Description


Selected/Active Represents the Selected/Active container/well by a
blue border.

Live Navigator Shows the current stage position including the live im-
age as a frame outlined in blue. To move the frame,
double-click on the position to which you want to
move it. Alternatively hold the left mouse button on
the live navigator tool while dragging the mouse.
The frame can also be used to control acquisition. If
you click on one of the frame's blue arrow icons, an
image is acquired. The Live Navigator tool is moved
one frame width in the relevant direction. You can cre-
ate tile images of your sample easily in this way.

Tile Region Represents the tile regions in the stage view by a red
grid.

Positions Represents positions in the stage view by a yellow plus


symbol with a red frame.

Position Array Represents the position arrays in the stage view by the
corresponding position symbols surrounded by a
dashed line.

Local Support Represents local support points in the stage view by a


Point yellow circle with a dot in the middle.

Global Support Represents global support points in the stage view by a


Point white circle with a dot in the middle.

A right-click in the Stage View displays a context menu with Tiles & Positions specific options
[} 374].

5.7.15.1 Specific Tiles & Positions Context Menu Options

When you right click in the Stage View of the Tiles Advanced Setup, you have the following
Tiles & Positions specific options:

Parameter Description
Show Images Activated: Displays images in the Stage View.

Remove Images Displays the options of what images are removed from the Stage
View.

– All Removes all images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 374


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
– All Manual Removes all manually taken snap images.
Snap Images

– All Preview Removes all preview scan images including preview images imported
Scan Images into the Stage View.

Import Preview Opens the file browser to select an image which gets imported into
Image the Stage View.

Save Preview Im- Opens the preview images in separate image documents in ZEN,
ages which allows you to save them or work with them if necessary.

Bring Navigator Re-centers the Stage View onto the current stage position coordi-
into View nates at the preset zoom level. You can also activate this function
with Ctrl + B.

Show Tile Regions Activated: Displays the names of the of the tile regions in the Stage
Name View.

Show Tile Rectan- Activated: Displays a red rectangle around the individual positions in
gle for Positions the Stage View.

5.7.16 Tiles Toolbars

In the Tiles - Advanced Setup your main features to create regions and positions are in two
toolbars on top and on the left of the viewer. The options available in the top toolbar depend on
what is selected in the left toolbar.

5.7.16.1 Left Toolbar

Here you select which setup you use to set tile regions or positions.

Parameter Description
Displays the tools to define the settings for a preview scan, see Pre-
view Scan Toolbar [} 376]. Typically a low magnification objective
Preview and a channel which protects your sample (e.g. transmitted light) is
used. This gives you a low resolution overview of the sample to mark
tile regions and/or positions.

Tiles Here you can select which setup you want to use to set the tile re-
gions. The corresponding tools are displayed in the top toolbar, see
Top Toolbar [} 376].

– Displays the tools to define tile regions by means of contour, see Con-
tour Toolbar [} 377].
Setup by con-
tour

– Displays the tools to define tile regions by means of number or size,


see Predefined Toolbar [} 377].
Setup by pre-
defined

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 375


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
– Displays the tools to define tile regions by specifying two or more
marker positions, see also Stake Toolbar [} 378].
Setup by
stakes

– Displays the tools to define tile regions automatically by means of the


fill factor of the sample carrier, see also Tiles Carrier Toolbar [} 379].
Setup by car-
rier

Positions Here you can select which setup you want to be used to set the posi-
tions. The corresponding tools are displayed in the top toolbar, see
Top Toolbar [} 376].

– Displays the tools to define positions by means of the location, see


Positions Location Toolbar [} 380]. You can add various positions in
Setup by loca- the Stage View using the mouse.
tion

– Displays the tools to define positions by means of position arrays, see


Position Array Toolbar [} 380]. You can add various contours for po-
Setup by array sition arrays in the stage view.

– Displays the tools to define positions automatically on the relevant


sample carrier, see also Positions Carrier Toolbar [} 381].
Setup by car-
rier

5.7.16.2 Top Toolbar

Depending on what you have selected on the left toolbar of the Tiles - Advanced Setup, differ-
ent features to create tiles or positions are displayed. For information on the various top toolbars,
see the list below.

See also
2 Left Toolbar [} 375]

5.7.16.2.1 Preview Scan Toolbar

Here you can define the settings for a preview scan. Typically a low magnification objective and a
channel which protects your sample (e.g. transmitted light) is used. This will give you a low resolu-
tion overview of the sample to mark tile regions and/or positions.

Parameter Description
Use Experiment Uses the settings of the experiment for the preview scan.
Settings

Channel Only available if Use Experiment Settings is deactivated.


Displays the channels for the preview scan. If you deactivate Use Ex-
periment Settings, you can deselect individual channels here.

Camera Binning Only available if Use Experiment Settings is deactivated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 376


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Sets the binning of the camera for the preview scan experiment only.
The exposure time will be compensated automatically for the preview
scan. Note that higher binning will reduce the scan time (due to
shorter exposures of the camera), but reduce the image resolution.

Delete existing Activated: Deletes the already existing preview images before the
preview images preview scan is started.

Start Starts the preview scan to acquire the overview image.

See also
2 Generating a Preview Scan [} 345]

5.7.16.2.2 Contour Toolbar

Here you can define the tile regions by means of the contour.

Parameter Description
With this tool you can select an already created tile region by clicking
on it to move or edit it.
Selection Mode

With this tool you can draw a rectangle tile region.


Rectangle

With this tool you can draw an elliptical tile region.


Ellipse

With this tool you can draw a polygonal tile region.


Polygon

Keep Tool Activated: Keeps the selected tool active. You can use the tool sev-
eral times in succession without having to reselect it.

See also
2 Creating Tile Regions by Contour [} 346]

5.7.16.2.3 Predefined Toolbar

Here you can define the tile regions by means of the number or size.

Parameter Description
Draws a rectangular tile region.
Rectangle

Draws a circular tile region


Circle

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 377


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Tiles Using this mode you have to enter the number of tiles as a reference
for the size of the tile region.
Enter the number of tiles in the X/Y input fields. If you are adding a
circular tile region, enter the number of tiles for the diameter in the
Diameter input field.

Size Using this mode you have to enter the size as a reference for the size
of the tile region. Enter the size of the tile region in the X/Y input
fields. If you are adding a circular tile region, enter the diameter of
the tile region in the Diameter input field.

The anchor of the defined shape is at the top left.

Top left anchor


position

The anchor of the defined shape is centered.

Center anchor po-


sition

The anchor of the defined shape is at the bottom right.

Bottom right an-


chor position

Add Tile Region Adds the tile region to the Tile Regions List and activates it for ac-
quisition.
Added tile regions are displayed in the form of red grids in the stage
view of the Advanced Tiles Setup.

Select an element in the stage view to edit or move it.


Selection

Adds the current tile definition in the image area.


Add Tile Region

Keep Tool Activated: Keeps the selected tool active. You can use the tool sev-
eral times in succession without having to reselect it.

See also
2 Creating Tile Regions by Predefined [} 347]

5.7.16.2.4 Stake Toolbar

Here you can define the tile regions with stake markers.

Parameter Description
Adds a marker position to the current stage and focus position.
Add Marker Posi-
tion

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 378


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Removes the last marker position.
Remove Marker
Position

Draws a rectangular tile region.


Rectangle

Draws a circular tile region


Circle

Draws a polygonal tile region


Polygon

Done Saves the current tile regions setup and resets the marker positions.

5.7.16.2.5 Tiles Carrier Toolbar

Here you can define the tile regions automatically by means of the fill factor of the sample carrier.

Info
4 A sample carrier must have been selected in the Sample Carrier section of the Tiles tool.
4 Manually created tile regions and positions (setup by Contour and setup by Predefined)
will be deleted if you switch to the setup by Carrier. If you want to combine manual and
automatic setup, first use setup by Carrier and then switch to a manual setup. Tile regions
that are created automatically by setup by Carrier, are defined to a container and perma-
nently assigned and locked by default, against manual editing. You can unlock the tile re-
gions in the Tiles tool by selecting the desired tile region and unlocking it via the options
menu in the tile regions list. You can also unlock all tile regions here if necessary.

Parameter Description
Select Sample Car- Only visible if no sample carrier is currently selected.
rier
Opens the dialog to select a sample carrier template.

Creates a tile region for every selected sample carrier container.


Create

Removes the tile region in every selected sample carrier container.


Remove

Fill Factor Here you can enter the fill factor used to fill the selected container.

Columns/Rows Here you can add single tile regions to a container by defining the
number of columns and rows of the tile. The tile region is always
placed at the center of the well container.

See also
2 Tiles Carrier Toolbar [} 379]
2 Sample Carrier Section [} 365]
2 Tiles Tool [} 359]
2 Creating Tile Regions by Carrier [} 347]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 379


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.16.2.6 Positions Location Toolbar

Here, you can define the positions by means of the location. You can add various positions in the
Stage View using the mouse.

Parameter Description
Selects an element in the stage view to edit or move it.
Selection

Adds a new position on the stage view.


Add

Keep Tool Activated: Keeps the selected tool active. You can use the tool sev-
eral times without having to reselect it.

Current X/Y Displays the current stage position (X/Y).

Add Position Adds a new position at the current stage position.

See also
2 Creating Positions by Location [} 348]

5.7.16.2.7 Position Array Toolbar

Here you can define the positions by means of position arrays. You can add various contours for
position arrays in the stage view.

Parameter Description
With this tool you can select an already created position array to
move or edit it.
Selection

With this tool you can draw a rectangular position array.


Rectangle

With this tool you can draw an elliptical position array.


Ellipse

Keep Tool Activated: Keeps the selected tool active. You can use the tool sev-
eral times in succession without having to reselect it.

Distribute Posi-
tions by

– Number Activates the input for Number and Bias.

– Grid Activates the input field for an Overlap.

Number Only visible if Number is selected.


Shows the current number of positions that are distributed to newly
created position array. Change the number to increase or decrease
the number of single positions obtained by a position array.

Bias Only visible if Number is selected.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 380


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Adjusts the overall position of the single positions in the position ar-
ray.

- None The single positions of the position array will be distributed evenly
within the array.

- Center The single positions of the position array will mainly be distributed
near to the center of the position array. Less positions will be at the
edges of the array.

- Edge The positions of the position array will be distributed to the edges of
the array. Less positions will be in the center of the array.

Random Only visible if Number is selected.


Activated: The single positions will be distributed randomly within
the position array. The overall bias will still be taken into account.

Overlap Only visible if Grid is selected.


Shows the current degree of overlap in % of each position in the ar-
ray relative to its neighbors. Both positive and negative values are
possible.

See also
2 Creating Positions by Array [} 348]

5.7.16.2.8 Positions Carrier Toolbar

Here you can define the positions automatically on the relevant sample carrier.

Info
4 A sample carrier must have been selected in the Sample Carrier [} 365] section of the
Tiles tool.
4 Manually created tile regions and positions (setup by Contour and setup by Predefined)
will be deleted if you switch to the setup by Carrier. If you want to combine manual and
automatic setup, first use setup by Carrier and then switch to a manual setup. Tile regions
that are created automatically by setup by Carrier, are defined to a container and perma-
nently assigned and locked by default, against manual editing. You can unlock the tile re-
gions in the Tiles tool by selecting the desired tile region and unlocking it via the options
menu in the tile regions list. You can also unlock all tile regions here if necessary.

Parameter Description
Select Sample Car- Only visible if no sample carrier is currently selected.
rier
Opens the dialog to select a sample carrier template.

Creates a position array for every selected container of the sample


carrier.
Create

Removes the position array for every selected container of the sample
Remove carrier.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 381


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Distribute Posi-
tions by

– Number Activates the input for Number and Bias.

– Grid Activates the input field for an Overlap.

Number Only visible if Number is selected.


Shows the current number of positions that are distributed to newly
created position array. Change the number to increase or decrease
the number of single positions obtained by a position array.

Bias Only visible if Number is selected.


Adjusts the overall position of the single positions in the position ar-
ray.

- None The single positions will be distributed evenly within the array.

- Center The single positions will mainly be distributed near to the center of
the position array. Less positions will be at the edges of the array.

- Edge The positions will be distributed to the edges of the array. Less posi-
tions will be in the center of the array.

Random Only visible if Number is selected.


Activated: The single positions will be distributed randomly within
the position array. The overall bias will still be taken into account.

Columns Only visible if Grid is selected.


Sets the number of columns of the position array in each container of
the sample carrier.

Rows Only visible if Grid is selected.


Sets the number of rows of the position array in each container of the
sample carrier.

Overlap Only visible if Grid is selected.


Shows the current degree of overlap in % of each position in the ar-
ray relative to its neighbors. Both positive and negative values are
possible.

See also
2 Creating Positions by Carrier [} 349]

5.7.17 Tiles View Options

This view options are specific for the Tiles & Positions module.

5.7.17.1 Tiles Tab

Here you can define how the software behaves when the live image is started and the Tiles - Ad-
vanced Setup is open.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 382


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
New Tab Opens the live or continuous image into a new image container.

Separate Container Opens a live or continuous image into a separate container. Both the
Tiles - Advanced Setup and the live or continuous images are visible
in parallel. We recommend activating this checkbox, especially if you
use two separate monitors. You may also want to use the Automatic
Contanier Layout setting found in the view option dropdown list of
the Document Bar [} 28] in the Center Screen Area [} 26].

Tiles View Displays the live or continuous image in place in the Stage View of
the Tiles - Advanced Setup.

Center to Stage You can use this function if you need quickly to re-find your current
Position location. Re-centers the Stage View onto the current stage position
coordinates at the preset zoom level. You can also activate this func-
tion with Ctrl + B. You can call the function to focus the image with
the mouse wheel by pressing and holding the Ctrl key when the
mouse cursor is over the stage view.

5.7.17.2 Carrier Tab

Only visible if a sample carrier is selected.


Here you can see a graphical preview of the sample carrier being used.

Info
Only the containers/wells whose tile regions and positions were set up with the Tiles Carrier
Toolbar [} 379] or the Positions Carrier Toolbar [} 381] will be taken into account.

Please note the following features of the display:

Symbol Description
Empty containers/wells, meaning that no tile regions or positions
were set up with the Carrier option, are represented by a grey con-
/ tainer/well.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 383


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Symbol Description
The currently Active container/well is represented by a blue border.

A container/well only filled with Tile Regions is represented by a yel-


low filled container/well.
/

A container/well only filled with Positions is represented by an or-


ange filled container/well.
/

A container/well filled with Tile Regions and Positions is repre-


sented by a half yellow, half orange filled container/well.
/

Info
Right-click opens a small context menu. Here you can copy the contents of the selected well,
or paste the contents to the selected or all wells.

5.7.18 Tiles Options

The additional options for the tiles module allow to set up several options for image acquisition
and additional information. The tiles options dialog can be found in the menu bar under Tools >
Options > Acquisition > Tiles & Positions.
Note: For the changes to be effective you might need to close and reopen the advanced setup
viewer.

Parameter Description
Automatically Activated: Automatically starts the Live mode in the Center Screen
Start Live Mode in Area if you klick in the Acquisition tab in the Tiles tool on the Ad-
the Advanced vanced Setup button.
Setup View
Uncheck this option to prevent unnecessary specimen bleaching. The
default is not activated.

Automatic Snap by Activated: Acquires an image if you click on one of the frame's blue
Clicking the Live arrow icons. The Live Navigator tool moves one frame width in the
Navigator Buttons relevant direction. You can create tile images of your sample easily in
this way.

Enable Stage In the Live navigator tool the current stage position including the live
Movement with image is shown as a frame outlined in blue. To move the frame, dou-
Live Navigator ble-click on the position to which you want to move it. Alternatively,
place the mouse cursor over the blue frame, press and hold the left
mouse button and drag the live navigator to the desired location.
Activated: Allows you to move the Live Navigator tool by dragging
it to a new location.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 384


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Show Stage and Activated: In the Tiles option, the setting to switch the backlash cor-
Focus Backlash rection on or off is shown. Per default it is hidden.
Correction Setting
in the Options

Delimiter for CSV Specifies the delimiter for a CSV export or import. Select Comma (de-
Export/Import fault), Semicolon or Tab.

Ask Whether Sup- When the support points and/or positions are determined by a soft-
port Points/Posi- ware autofocus run the existing points can be overwritten with the
tions Should be new Z values.
Overwritten
Activated: Shows a message box asking if the points should be over-
written if there is a autofocus Z value.

Focus Surface Out- Ignores support points that are significantly outside the interpolated
lier Determination focus surface.
You have the following setting options available:

- Maximum Inter- This value can be 0 or 1. If 1 then a linear fit is used to detect the out-
polation Degree lier support points. This is the default. If 0 a simple average value is
for Outlier De- used to detect outliers.
tection

- Threshold in This parameter defines a threshold value to determine which of the


Terms of the support points are outliers from the fitting process. This is defined by
Standard Devia- the standard deviation (sigma value) set in the spin box. Support
tion (Sigma) points not meeting this criteria are subsequently ignored when the fo-
cus surface is determined.

Delay Time After Defines a delay period which is used for all stage movements in a tiles
Stage Movements and position experiment or movements controlled in the advanced tile
setup. The delay helps prevent movement in samples where, for ex-
ample, a large volume of liquid is present in the sample holder. It can
be used with the stage speed and acceleration options to optimise ex-
periments with this type of sample.

Binning Compen- Defines the power to which the binning ratio is modified to automati-
sation of Exposure cally determine the exposure time value used for a preview scan were
Time in Preview the binning setting between the experiment and preview scan differs.
Scans The default value is 2.0 i.e. quadratic. Thus, for example the exposure
time would be reduced by a factor of four if the experiment binning is
1x1 and the preview scan binning is 2x2. The value can be varied be-
tween 1.0 and 2.0 in steps of 0.1.

Live Image in Sam-


ple Carrier Calibra-
tion Wizard (rele-
vant only for sys-
tems with camera)

- Use Imaging Activated: Default setting for the live image that allows navigation
Device from and focus interaction during the carrier calibration wizard.
Selected
Channel with
"Acquisition"
Settings

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 385


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
- Use Active This option is only relevant for systems with a wide field (camera
Camera with based) detector.
"Locate" Set- Activated: Allows you to alternatively apply locate camera settings
tings for use in the carrier calibration wizard (live image). By default the ex-
periment settings for the currently selected channel/track will be used.

5.7.19 Select Template Dialog

In this dialog you can select a sample carrier or enter a dialog to create a custom carrier. A pre-
view of the selected carrier is shown on the right side of the list.

Parameter Description
Workgroup Tem- Displays a list of all custom sample carrier templates.
plates

Program Tem- Displays a list of predefined sample carrier templates for several sam-
plates ple carriers. When working with ZEN celldiscoverer, the available tem-
plates are grouped based on their type.

Opens the New Sample Carrier Template dialog [} 387] to create a


Add new template.

Deletes the selected sample carrier template.


Delete

Options

– New Tem- Opens the New Sample Carrier Template dialog [} 387] to create a
plate... new template.

– Show/Edit... Opens the selected template in the Edit Sample Carrier Template di-
alog [} 387] and allows editing.
ZEISS templates are read only. If you want to edit a ZEISS template,
you have to use the Copy and Edit... option.

– Copy Copies the selected template.

– Copy and Copies the selected template and opens it in the Edit Sample Carrier
Edit... Template dialog [} 387] dialog for editing.

– Import Imports a template.

– Export Exports the selected template.

– Delete Deletes the selected template.

– Refresh Tem- Refreshes the list of templates after creating a new one.
plates

OK Opens the selected sample carrier and closes the dialog.

Cancel Closes the dialog without opening a sample carrier.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 386


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

5.7.20 Edit Sample Carrier Template dialog

The dialog for editing a template and creating a new one is the same. If you create a new tem-
plate the dialog fields are empty. On the right you see a live template preview of the setting for
the template and global support points.
1

1 Basic Template Settings


Here you have the basic settings for the sample carrier templates. For more information,
see Basic Template Settings [} 387].

2 Preview
Here you can see a preview of the sample carrier.

3 Global Support Points


Here you have the settings for global support points. For more information, see Global
Support Points Settings [} 389].

5.7.20.1 Basic Template Settings

Parameter Description
Name Shows the name of your template. You can enter/ edit the name.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 387


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
Category Shows which sample carrier category the template uses. You can
choose between Slide, Multislide, Petri Dish, Multiwell, Multi-
chamber and Custom. The category defines the overall appearance
of the template and affects the further editing possibilities of the tem-
plate.

Size

– Width Sets the width of the sample carrier template.

– Height Sets the height of the sample carrier template.

Container Depending on the category of the template you have different op-
tions for editing in this section.

– Type Shows if the containers of the template are rectangles or circles. If the
category is Custom, you can manually set the type of containers.

– Columns Shows how many columns of containers the template contains.


You cannot edit this field if the templates category is Slide or Petri
Dish

– Rows Shows how many rows of containers the template contains.


You cannot edit this field if the templates category is Slide or Petri
Dish

– Width Only available for rectangular containers.


Height Determines the width and height of the containers. Not active for
Slide.

– Diameter Only available for circular containers.


Determines the diameter of the containers. Not active for Slide.

– Distance X Determines the distance in x direction between the containers from


center to center. Not active for Slide and Petri Dish.

– Distance Y Determines the distance in x direction between the containers from


center to center. Not active for Slide and Petri Dish.

Area

– Centered in X Activated: The containers will be positioned centered in X direction


on the sample carrier template.

– Centered in Y Activated: The containers will be positioned centered in Y direction


on the sample carrier template.

Reference Point The reference point is marked by a Yellow X in the preview.

– Location Defines the position of the templates reference point. You can choose
Mode between Center, Top Left, Top Right, Bottom Left, Bottom Right
and Custom. With Custom you can modify the position directly in
the schematic by dragging the yellow reference point X with the
mouse cursor.
The default position of the reference point varies with the type of car-
rier.

– Position X Only active if you have selected Custom location mode.


Sets a custom x position for the reference point of the template.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 388


5 Acquisition Toolkits | 5.7 Tiles & Positions ZEISS

Parameter Description
– Position Y Only active if you have selected Custom location mode.
Sets a custom y position for the reference point of the template.

5.7.20.2 Global Support Points Settings

To show the section in full, click on the arrow button .

Parameter Description
Global Support
Points list

– X column Displays the X coordinate of the support point.

– Y column Displays the Y coordinate of the support point.

– Z column Displays the Z coordinate of the support point.

– Container col- Shows the container of the support point.


umn

Deletes the selected list entry.


Delete

Opens the Options for editing global support points.


Options

– Set Current Z Sets the current z-value for the selected support points.
for Selected
Support
Points

– Delete Deletes the selected support points.

– Delete All Deletes all support points.

Properties of Se-
lected Support
Points

– X Sets the X coordinate of the selected support point.

– Y Sets the Y coordinate of the selected support point.

– Z Sets the Z coordinate of the selected support point.

– Set Current Z Sets the Z dimension to the current z position of the stage.

Distribute Support
Points

– Columns Sets the number of columns of support points within the template.

– Rows Sets the number of rows of support points within the template.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 389


5 Acquisition Toolkits | 5.8 Time Series ZEISS

Parameter Description
– Distribute Distributes the entered number of support points defined in the col-
umn and row input fields within the template. Previously defined sup-
port points will be deleted.

– Distribute One Sets one support point in the center of the selected containers. Previ-
Support Point ously defined support points will be deleted.
for each Se-
lected Con-
tainer

Add by Clicking

– Select a support point to move it.


Support points distributed by the Distribute One Support Point for
Selection
each Selected Container button cannot be moved.

– Add a new support point on the template preview.


Add

– Keep Tool Activated: Keeps the selected tool active.

5.8 Time Series

This modules enables the acquisition of time series (time-lapse) images with definition of intervals
between images, total acquisition duration and number of time points. Time series can be started
and stopped manually, at fixed times, after a waiting period or by input (trigger) signal, to analyze
images already acquired or change the experiment parameters. The experiment size is limited only
by free space on the hard drive and the images are acquired at maximum possible speed.

5.8.1 Acquiring Time Series Images

Prerequisite ü To set up Time Series experiments, you need to license the Time Series module and activate
it in Tools > Modules Manager. For LSM systems, the Time Series module is part of the
system license.
ü You have set up a new experiment with at least one defined channel and adjusted focus and
exposure time correctly, see also Setting Up a New Experiment [} 51] and Acquiring Multi-
Channel Images with Cameras [} 51].
ü You are on Acquisition tab.
1. In the Acquisition Dimensions section, activate Time Series .
à The Time Series tool is displayed in the Left Tool Area.
2. Open the Time Series tool.
3. Set the Duration of your time series. You are able to select an interval (days, hours, min-
utes, seconds, milliseconds) or cycles (1-n), e.g. 10 cycles.
4. Set the Interval of your time series.
5. Click Start Experiment.
The time series experiment starts. You have successfully set up a time series experiment.

Info
You can display the individual images via the Time slider on the Dimensions tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 390


5 Acquisition Toolkits | 5.8 Time Series ZEISS

5.8.2 Time Series Tool

Info
The shortest possible interval is calculated by performing a blind experiment. The camera expo-
sure time, number of steps of a z-stack and the number of acquisition channels are taken into
consideration in the calculation. Depending on the number of z-stacks and channels and
whether long exposure times have been set, it may take some time to calculate the shortest
time interval.

Use time series to acquire an image series consisting of a number of time points. Define, for ex-
ample, the acquisition interval, the length of the experiment and other specifications to control
the experiment.

Parameter Description
Duration Defines the minimum duration of your experiment with the slider or
the input field.
The dropdown list defines the number of cycles or the duration:

– Cycles Defines the duration in number of cycles.

– ms Defines the duration in milliseconds.

– s Defines the duration in seconds.

– m Defines the duration in minutes.

– h Defines the duration in hours.

– d Defines the duration in days.

As Long as Possi- Activated: The acquisition of the time series continues as long as
ble possible, depending on the free disk space of the hard disk.
§ For hard disks with more than 20 GB free disk space the acqui-
sition always runs until 2 GB disk space is left.
Example: An experiment using a hard disk with 250 GB of free
disk space will run until 2 GB are left. The calculated/required disk
space for the experiment is 248 GB.
§ For hard disks with less than 20 GB free disk space, at least
10% disk space will be always left free.
Example: An experiment using a hard disk with 15 GB of free disk
space will run until 1,5 GB are left. The calculated/required disk
space for the experiment is 13,5 GB.

Interval Defines the interval from individual image to individual image in an


image series. You can specify the interval to set the gap between indi-
vidual time points in milliseconds, minutes, hours or days. For LSM it is
possible to change the interval during time series acquisition with the
parameter Interval Time.

Use Camera Only visible in Camera/Widefield Mode.


Streaming if Possi- Activated: The software tries to use the free running/streaming mode
ble of the active camera.

Use Burst Mode if Only visible in Camera/Widefield Mode.


Possible Activated: The system buffers acquisition data in the main memory.
For more information, see Burst Mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 391


5 Acquisition Toolkits | 5.8 Time Series ZEISS

Parameter Description
Measure Speed Not available for LSM acquisition.
Checks whether the experiment can be performed using the interval
which is set. If the interval is too small, the shortest possible value is
defined automatically for the interval.

Start/Start Next Defines the Start, Stop and Pause conditions of your experiment. Se-
Time Slice/Stop/ lect the parameters for the corresponding condition from the Mode
Pause Begin/Pause dropdown list.
End

– Manual The experiment is started immediately when clicking on the Start Ex-
periment button in the Experiment Manager.

– At Time of The experiment is started, stopped or paused at the entered time. En-
Day ter the desired time in the spin box/input field below the dropdown
list.

– After Delay The experiment is only started, stopped or paused once the length of
time entered has passed.

– On Trigger The experiment is started, stopped or paused once a TTL signal has
been received.

– After Cycles Only available for Pause Begin.


The experiment is paused after the defined number of cycles. If this
function is used for a LSM time series, the acquisition will no longer
be executed by the real time electronics and will be markedly slower
overall.

Interval Time Only available for LSM.


Interactively changes the interval during a running time series acquisi-
tion.

– Interval Displays the interval value which is taken over from the current set in-
terval.

– Trigger In Assigns a TriggerIN signal to change the interval.

– Trigger Out Assigns a TriggerOUT signal for each interval change.

– Adds a new interval.


Add

– Deletes the selected interval.


Delete

Set Marker Only available for LSM.


Marks events during the time series acquisition.

– Description Sets the name of the marker.

– Set Sets a marker during time series acquisition.

– Trigger In Selects the TriggerIn signal for setting a marker.

– Trigger Out If necessary, assign a TriggerOUT signal for every set marker.
Note that the TriggerOut signal for the marker function consists of a
high spike followed by a 3 second long TTL pulse. Within the duration
of the pulse a further low spike is delivered.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 392


5 Acquisition Toolkits | 5.8 Time Series ZEISS

Parameter Description
– Adds a new marker.
Add

– Deletes the selected marker.


Delete

Interactive Adds and configures switches that can be used to execute certain ac-
Switches
tions during your experiment. To add a new switch, click .
The Switch button opens a dialog to configure an interactive switch,
see Interactive Switches Section [} 394].

5.8.2.1 Experiment Conditions Section

Info
If you define times as time series acquisition conditions, these apply once for the entire experi-
ment. This also applies to experiments that use the Experiment Designer.

The following functions are only visible if the Show All mode is activated:
You can define the Start, Stop, Pause Begin and Pause End conditions for your experiment.
Start Next Time slice can only be used with trigger functionality of LSM 980. Select the parame-
ters for the corresponding condition from the dropdown list:

Parameter Description
Manual The experiment is started immediately when clicking on the Start Ex-
periment button in the Experiment Manager.

At Time of Day The experiment is started, stopped or paused at the entered time. En-
ter the desired time in the spin box/input field to the right of the
dropdown list.

After Delay The experiment is only started, stopped or paused once the length of
time entered has passed.

On Trigger The experiment is started, stopped or paused once a TTL signal has
been received.

Interval Time Only available for LSM. Use this function to interactively change the
interval during a running time series acquisition. Use the + button to
add a new interval value which is taken over from the current set in-
terval. Add another interval first before changing the current interval.
Highlight the desired interval during the experiment to change the in-
terval before the next image frame is scanned or assign a TriggerIN
signal to change the interval. You can always assign a TriggerOUT
signal for each interval change.
The change of the interval is also marked in the time series acquisi-
tion. The marker is visible next to image (2D view, Gallery view, Mean-
ROI) when the change occurred.

Set Marker Only available for LSM. Use this function to mark events during the
time series acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 393


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

Parameter Description
Predefine the marker by typing in the marker name into the editing
box. Either click Set or use TriggerIN to set a marker during time se-
ries acquisition. You can also assign a TriggerOUT signal for every set
marker. The Set button becomes active when the acquisition is run-
ning. The marker is visible next to image (2D view, Gallery view,
MeanROI) when the marker was set.

5.8.2.2 Interactive Switches Section

The following functions are only visible if the Show All mode is activated:
Here you can add and configure switches that can be used to execute certain actions during your
experiment.
Left-click on a new or existing switch to open the dialog in which you can configure the button
parameters:

Parameter Description
Name Here you can enter a name for the button.

Description Here you can enter a description for the button.

Color Activated: Shows a colored line at the left edge of the switch.

Color Selection Opens the Color Selection dialog. Here you can select a color for the
line at the left edge of the switch.

Action Here you can select one of the following actions. This action will be
executed when you click on the button:
§ None
§ Set Interval
§ As Fast as Possible
§ Trigger
§ Hardware Setting
§ Jump to previous block
§ Jump to next block
§ Jump to block #

Delete Switch Deletes the selected switch.

5.9 Z-Stack

This module enables the acquisition of z-stacks with the aid of a motorized focus drive, where the
z-stack is limited only by the travel range of the system and minimum increments. It also offers
functionality to set the correct increment to satisfy the Nyquist criterion, an integrated z-drive
backlash compensation for maximum precision and the z-stack acquisition at relative or absolute
focus positions in the experiment.

5.9.1 Acquiring Z-Stack Images

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 394


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

Prerequisite ü You have switched on and configured your microscope system including all components.
ü You have set up a new experiment, at least defined one channel and adjusted focus and ex-
posure time correctly, see Setting Up a New Experiment [} 51].
ü You are on the Acquisition tab.
1. In the Acquisition dimensions section activate the Z-Stack checkbox.

à The All Tracks per Slice selection box is displayed.


à The Z-Stack tool appears in the Multidimensional Acquisition tool group.
2. Use the All Tracks per Slice option or select the Full Z-Stack per Track option in the se-
lection box.
3. Click on the blue bar to open the Z-Stack tool.
You have successfully completed the general preparations. You can now set up z-stack experi-
ments automatically or manually.

5.9.1.1 Configuring a Z-Stack Automatically

Info
Before you perform automatic configuration, the current focus position has to be at the center
of the sample. The camera's current field of view must always be at a position on the sample
that shows a signal in the selected channel.

Info
Automatic z-stack configuration only works with microscopes and systems that do not use an
optical sectioning technique. If you use an LSM, ApoTome, VivaTome, Spinning Disc (CSU)
or another technique for generating optical sections, the z-stack has to be configured manu-
ally.

1. Make sure that you have placed a sample in the visual field of the camera and that the
sample is roughly in focus. Set the exposure time of the camera fair enough for receiving a
good signal.
2. On the Acquisition tab, in the Z-Stack tool, click Start Auto Configuration.
3. Confirm the system message by clicking OK.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 395


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

à The automatic configuration starts. The auto configuration can last for a few seconds up
to half a minute depending on the acquisition settings. You can check the status on the
Progress bar in the Status bar.
à The auto configuration sets the focus position for the first, last and center slice of the z-
stack, the number of slices and the interval automatically. The z-stack experiment is set
up successfully now.
4. Click Start Experiment to start the experiment.
You have successfully set up and performed an z-stack experiment.

Info
You can change the area of the sample (z direction in %) covered by the z-stack auto configu-
ration under Tools > Options > Acquisition > Z-Stack. Smaller values enlarge the z-stack,
higher values make the z-stack smaller.

5.9.1.2 Configuring a Z-Stack Manually (First/Last Mode)

By using this mode, you set the first and the last plane of the z-stack. This mode is suitable if you
do not know the thickness of your sample exactly.

Prerequisite ü You are in the Z-Stack tool.


1. Activate the First/Last mode by clicking the First/Last button. This button is selected by
default.
2. In the Live mode, adjust the z-drive until you have reached the upper plane of the z-stack.
The blue plane in the illustration shows the actual focus plane.
3. Click Set First to set the adjusted z-position as first position of the z-stack.
4. In the Live mode, adjust the z-drive until you have reached the lower plane of the z-stack.
5. Click Set Last to set the adjusted z-position as last position of the z-stack.
à You have set the upper and lower boundaries of the z-stack.
6. Click Optimal to adjust the number of slices and the best interval according to the Nyquist
criteria. Alternatively, you can set the desired interval and number of slices in the input
fields manually.
à Depending on which option is selected in the Keep section either the Interval or the
Slices will be held constant.
7. Click Start Experiment to start the experiment.
You have successfully set up and performed an z-stack experiment using First/Last mode.

5.9.1.3 Configuring a Z-Stack Manually (Center Mode)

By using this mode, you set the center plane of the z-stack. This mode is suitable if you know the
thickness of your sample. In this case, it will be the fastest method to set up a z-stack.

Prerequisite ü You are in the Z-Stack tool.


1. Activate the Center mode by clicking Center on the top of the tool.
2. In the Live mode, adjust the z-drive until you have exactly focused the center of the sam-
ple. The blue plane in the illustration shows the actual focus plane.
3. Click Center under the settings section to set the actual focus position as center of the z-
stack.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 396


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

4. Click Optimal to adjust the number of slices and the best interval according to the Nyquist
criteria. Alternatively, you can set the desired interval and number of slices in the input
fields manually.
à Depending on which option is selected in the Keep section, either the Interval or the
Slices will be held constant.
5. Click Start Experiment to start the experiment.
You have successfully set up and performed a z-stack experiment using the Center mode.

5.9.2 Z-Stack Tool

In the Z-Stack tool you can configure acquisitions that comprise several z-planes of your sample.
You can set all the parameters manually using two different modes or have configuration per-
formed automatically.

Info
Automatic z-stack configuration only works with microscopes and systems that do not use an
optical sectioning technique. If you use an LSM, ApoTome, VivaTome, Spinning Disc (CSU)
or another technique for generating optical sections, the z-stack has to be configured manu-
ally.

Parameter Description
First/Last Activated: Displays the controls to configure the z-stack by setting
the first and the last position of the z-stack, see Configuring a Z-
Stack Manually (First/Last Mode) [} 396].

Center Activated: Displays the controls to configure the z-stack by setting


the center plane of the z-stack, see Configuring a Z-Stack Manually
(Center Mode) [} 396].

Z-Stack Graphical The graphical display in the left area of the tool represents the config-
Display ured z-stack. In the case of inverse microscopes the objective appears
in stylized form at the bottom of the z-stack. In the case of upright
systems it appears at the top. The blue plane indicates the current
section plane and the values at the top and bottom of the measure-
ment scale on the right-hand side of the graphic indicate the distance
to the center of the z-stack.

- L Marks the last plane of the z-stack. A click on the button changes the
current z-position to this plane.

- C Marks the center plane of the z-stack. A click on the button changes
the current z-position to this plane.

- F Marks the first plane of the z-stack. A click on the button changes the
current z-position to this plane.

- Position Displays the z-position at which the current section plane is located.
Here you can navigate precisely to the relevant z-positions.

- Slice # Displays and selects the number of the current slice.

Set Last/Set First Only visible for First/Last mode.


Sets the current position as last or first position of the z-stack.

Range Displays the range of the configured z-stack from the last to the first
section plane.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 397


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

Parameter Description
Slices Defines the number of z-slices of the z-stack.

Interval Sets the distance between the z-slices.

Optimal The number on this button shows the distance calculated for the set
channels and the current microscope according to the Nyquist crite-
ria. If you click on the button, this value is automatically adopted into
the Interval input field.
When you click this button once, it changes its color to blue. This indi-
cates that the system always uses the optimal interval as you continue
to change acquisition parameters. Click the button again or manually
edit the interval to deactivate this permanently active state.
Note: If you change the objective while the button is activated, the
value might not be updated correctly!
For structured illumination microscopy, you can select between
Nyquist sampling and Leap mode. Nyquist sampling gives the opti-
mal sampling rate for highest resolution. In Leap mode only every
third plane of the stack will be imaged, so the stack would be three-
fold under-sampled. However, special SIM algorithms can be used to
restore the information of the skipped planes.

Keep

- Interval Keeps the set interval between the section planes constant if you
change configuration parameters in the tool.

- Slice Keeps the set number of z-slices constant.

Center Only visible for Center mode.


Sets the current position for the central z-plane. You can also enter
the value in the input field to the right of the button.

Offset Only visible for Center mode.


Defines an offset, if necessary.

Optimize Section- Only visible for LSM.


ing and Step
Allows to set the pinhole of each track to a diameter where the sec-
tion thickness of each track is identical. This can only be achieved if
the tracks are switched in Frame mode during acquisition, allowing
hardware to be changed between tracks.
Each channel is represented by a graphical display of two z-slices. The

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 398


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

Parameter Description
channel name, the z-slice thickness and the current overlap of two z-
slices in percent are given above the graphic.

- Match Pinhole Changes the pinhole of the tracks to match the set interval.
Hence to go for a specific section thickness identical for all tracks, set
the pinhole of one track to achieve the desired section thickness and
open up the pinhole of all other tracks to maximum. Then click on
Match Pinhole to get the right settings for all tracks.
In case the step interval is subsequently changed to lower or higher
settings, clicking Match Pinhole changes the pinhole size for all
tracks to achieve again 50% overlap between the single steps in each
track.

- Optimal Sets the interval for all tracks to the optimal value. The optimal value
is based on the current smallest available section thickness of the cur-
rent tracks which is defined by the pinhole settings.

- Undo Resets all parameters to the default values.

- X:Y:Z = 1 Matches the settings in Z to the settings in X and Y. This produces a


cubical voxel. This can be useful for later import into third party soft-
ware for rendering.

Auto Z Brightness Only visible for LSM.


Correction
Activated: Certain acquisition parameters (Laser power, Master gain,
Digital offset and Digital gain) are automatically adjusted according to
the predefined settings while the z-stack is acquired.
Note that Z Piezo is not used for z-stack acquisition when the master
gain should be adjusted with z-position. The gain adaptions take too
long to be set between z slices. When indicating a change in master
gain the slower z focus function of the microscope is used instead.
The settings are typically adjusted while focusing through the sample
when the system is in continuous scan mode. Activate the option En-
able Test to allow an update of the settings during focusing either
with the focus control of the microscope or using ZEN. ZEN does not
show the update of the values during the acquisition of the experi-

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 399


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

Parameter Description
ment.
Note that resetting the focus position in the Focus tool does not af-
fect or shift the absolute position values in the list.
For additional information, see Auto Z Brightness Correction with
LSM [} 400].

- Add Adds the current z-position to the list and stores the currently config-
ured settings. If the position is already in the list, the values are up-
dated. The positions do not need to be added in a certain order.

- Move to Changes the focus position to the selection in the list. This can also be
done by a double click on the list item. If Enable Test is activated,
the parameters are immediately applied during a continuous scan.

- Remove Removes the currently selected position from the list.

- Remove All Removes all positions from the list.

- Load../Save.. Loads or saves the stored position parameters to/from a *.ABC file.

- Spline Interpo- If activated, a spline interpolation instead of a linear interpolation is


lation used. Note that spline interpolation with only few positions in be-
tween the neighboring images can show an overshoot of the applied
acquisition settings and hence lead to very bright or dim images.

- Extrapolate If activated, the interpolation between the Positions in the list can be
extrapolated to the actual first and last slice of a z-stack in case if
those are not part of the defined range of positions.

- Enable Test If activated, the parameters are updated while changing the current z-
position either with the SW focus or with the handwheel of the stand.
This allows to quickly check the parameters during a continuous scan.
The changes of the parameters are not indicated during the actual ex-
periment.

Start Auto Config- Automatically configures the z stack using the current sample, see
uration Configuring a Z-Stack Automatically [} 395].
The following parameters are set automatically:
§ z position of the central plane
§ Distance between the individual planes
§ Number of section planes

Before you perform automatic configuration, the current focus posi-


tion has to be at the center of the sample. The camera's current field
of view must always be at a position on the sample that shows a sig-
nal in the selected channel.

5.9.2.1 Auto Z Brightness Correction with LSM

The settings of Auto Z Brightness Correction are part of the image acquisition and are reused
with other settings of an image. They are also part of an experiment setting. However, the func-
tion is not activated for reuse or when loading an experiment as the settings apply to the absolute
z-position in µm used when the (previous) image was acquired. If the new stack is acquired in a

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 400


5 Acquisition Toolkits | 5.9 Z-Stack ZEISS

different position, using the previously defined settings (extrapolate) can lead to a an extreme
overexposure of the sample. Enable test is always deactivated when an image stack is reused, or
an experiment is loaded.
Worflow:
In order to reuse the Auto Z Brightness parameters for subsequent z-stacks, make sure to manu-
ally set the center (or first or last) position of the first z-stack to zero (Focus TW, Z-position: Set
Zero) before defining the Auto Z parameters. Set the center (or first or last) position of all follow-
ing Z-Stacks also to zero to be able to reuse the Auto Z Brightness parameters accordingly. When
saving and loading the parameters, the same logic applies. When switching between linear and
spline interpolation during continuos scan, the current acquisition parameters are not updated un-
til the z-position is changed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 401


6 General Toolkits | 6.1 Image Analysis ZEISS

6 General Toolkits
Toolkit Functionality
2D Toolkit § Image Analysis [} 402]
§ Advanced Processing [} 471]

3D Toolkit § 3Dxl [} 529]


§ 3Dxl Plus [} 545]
§ 3D Image Analysis [} 525]
§ Advanced Processing [} 471]

AI Toolkit § Intellesis [} 483]


§ Intellesis Object Classification [} 517]
§ Intellesis Denoising [} 511]

Connect Toolkit § Connect [} 619]


§ Connect 2D Add-on [} 619]
§ Connect 3D Add-on [} 619]
§ Third Party Import [} 269]

Developer Toolkit § Macro Environment [} 549]

Molecular Quantifi- § Physiology (Dynamics) [} 551]


cation Toolkit § FRAP Efficiency Analysis [} 574]
§ Automated Photomanipulation [} 577]
§ FRET [} 580]

Deconvolution Tool- § Deconvolution [} 588]


kit

Apotome Plus Tool- § Apotome Plus [} 608]


kit

6.1 Image Analysis

This module enables you to create automatic measurement routines very easily. The Image Analy-
sis wizard guides you through the steps to create an automatic measurement program. It allows
you to set up even complex measurement tasks easily. The steps of the wizard include image seg-
mentation, object separation and measurement of geometrical or intensity features. After you
have completed the setup, you can apply these settings to the data to be analyzed and obtain
precise measurement results. You can display the results in table and list form and export them to
csv-format.
For more information, see the following examples:

§ Measuring Fluorescence Intensity in a Multichannel Image [} 404]


§ Counting Number of Fluorescence Signals per Nuclei [} 409]
§ Measuring Mean Fluorescence Intensity on a Ring around the Primary Object [} 416]
§ Counting the Number of Objects in a Ring around the Nucleus [} 423]
See also the following descriptions:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 402


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Image Analysis Tool [} 940]


§ Image Analysis Wizard [} 941]

6.1.1 Creating a New Image Analysis Setting

When creating a new analysis setting for your images, you can select the following segmentation
methods:

§ Segment Region Classes Independently: This method allows you to define several classes
and subclasses. With this method, you can define the segmentation algorithm for each class
independently.
§ ZOI (Zones of Influence): This method constructs a zone of influence (ZOIs) and a ring
around each primary object. The primary objects are generated by segmenting the selected
image channel with the selected class segmenter. The ring is defined by its width and distance
from the primary object. The distance from the ZOI border from the ring can be specified. The
ZOI area also incorporates the primary object and ring area.

1. On the Analysis tab, in the Image Analysis tool, click and select New from the
dropdown.
2. In the Settings field, enter a name for your image analysis setting and click Save.
à A new *.czias file is created and saved in the ...\ZEN\Documents\Image Analysis Set-
tings folder.
à You have created a new image analysis setting. As default the method Segment region
classes independently is used.
3. For Method, click .
à The Segmentation Method Selection dialog opens.
4. From the Method drop down menu, select a method and click OK.
à You have created a new image analysis setting using the method of your choice.
5. In the Image Analysis tool, click Edit Image Analysis Setting.
The Image Analysis Wizard opens with the Classes step and includes already a predefined set
of classes, depending on the selected method. Follow the steps in the wizard to define your im-
age analysis. Each method comes with a predefined set of steps which allows you to make all
necessary settings for image analysis.
§ Classes: Allows you to add classes and subclasses.
§ Frame: Allows you to define a measurement frame. Only the area of the frame will be ana-
lyzed.
§ Region Filter: Allows you to define simple or complex conditions to filter the detected ob-
jects according to their parameters.
§ Automatic Segmentation: Allows you to set the parameters for the automatic segmenta-
tion.
§ Interactive Segmentation: Allows you to modify the results of the automatic segmentation
or draw/delete objects. Note: this step only generates relevant results in Start Interactive
Analysis run.
§ Features: Allows you to select measurement features from an extensive list and to define
measurement features for classes and subclasses independently.
§ Statistics: Allows you to define custom statistical features for your regions or objects.
§ Results Preview: Shows a preview of your measurement results for the current view port.
For more information, see the following examples:

§ Measuring Fluorescence Intensity in a Multichannel Image [} 404]


§ Counting Number of Fluorescence Signals per Nuclei [} 409]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 403


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Measuring Mean Fluorescence Intensity on a Ring around the Primary Object [} 416]
§ Counting the Number of Objects in a Ring around the Nucleus [} 423]

6.1.2 Measuring Fluorescence Intensity in a Multichannel Image

This topic will show you how to set-up a measurement program using the Image Analysis Wiz-
ard. After the setup is successfully completed, the program will be used to measure fluorescence
intensity in a multichannel image.
In this example we are using a multichannel image with 2 channels (1st channel blue, (DAPI) ),
2nd channel red (mRFP1)) of fluorescence-stained cells. First, we detect the blue-stained cell nuclei
in the first channel. Then we measure the fluorescence intensity for both channels for the de-
tected nuclei.

See also
2 Creating a New Image Analysis Setting [} 403]

6.1.2.1 Step 1: Classes

Prerequisite ü You have created a new image analysis setting with the Segment region classes indepen-
dently method and opened the Image Analysis Wizard, see Creating a New Image Analy-
sis Setting [} 403].
1. In the Classes step, click on Class 2 in the list and enter DAPI Individual Nuclei in the
Name input field.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 404


6 General Toolkits | 6.1 Image Analysis ZEISS

2. Click on Classes1 in the list and enter DAPI All Nuclei in the Name input field.

3. Click Next.

6.1.2.2 Step 2: (Measurement frame)

1. Deactivate the Interactive checkbox.


2. Click on Next.

6.1.2.3 Step 3: Automatic Segmentation

1. Click on DAPI Individual Nuclei entry in the list.


2. In the Threshold section set the Tolerance parameter to 1%.

3. Click in the image on the blue-stained cell nuclei.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 405


6 General Toolkits | 6.1 Image Analysis ZEISS

à The detected nuclei are overlaid in blue. The threshold values are displayed in the
Threshold section in the Lower/Upper input fields.

4. Click on the areas of the blue cell nuclei that have not yet been detected until these have
been completely overlaid.
5. Activate the Fill Holes checkbox.
à This fills any holes in the detected cell nuclei.
6. Select the Watersheds entry from the dropdown list in the Separate section and set the
number to 3.
à Clear separation lines are now visible between the cell nuclei.

7. Click on Next.

6.1.2.4 Step 4: Region Filter

1. Deactivate the Execute checkbox.


2. Click on Next.

6.1.2.5 Step 5: Interactive Segmentation

1. Deactivate the Interactive checkbox.


2. Click on Next.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 406


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.2.6 Step 6: Features

1. Click on the DAPI Individual Nuclei entry in the list.


2. Click on the Edit button in the Region Features section.
à The Feature Selection dialog is opened.
3. Double-click on Intensity Mean Value of channel "DAPI" and Intensity Mean Value of
channel "mRFP1" features, one after another.
à The features are displayed in the Selected Features list on the left.
4. Remove superfluous features (e.g. Area, Perimeter) from the list. Select the feature and click
on the Delete button .
5. Activate the Display checkbox for the features.

6. Click on OK.
à The selected features are displayed in the Region Features section.
7. In the section Annotation Options, activate the checkbox Color.
8. Select Yellow from the drop-down list.
9. Click on Next.

6.1.2.7 Step 7: Results Preview

1. Click on DAPI All Nuclei in the list.


à The number of measured cell nuclei is displayed in the data table to the right of the im-
age.
2. Click on DAPI Individual Nuclei in the list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 407


6 General Toolkits | 6.1 Image Analysis ZEISS

à The object ID and the values for the average fluorescence intensities per channel are dis-
played in the image at the cell nuclei in question and in the data list to the right of the
image.

3. Click on the Finish button.


à This saves the measurement program.

6.1.2.8 Executing the Analysis Setting

Prerequisite ü You are in the Image Analysis tool.


ü You have loaded the analysis setting that you have generated.
1. Click Start Analysis.
à The analysis setting is applied to the image.
à The Analysis View is displayed in the Center Screen Area.
2. In the Analysis View you can see your image with the measured cell nuclei overlaid in blue
and, to the right of this, the data list containing the individual measurements.
3. Deactivate the Fill checkbox in the Analysis control element.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 408


6 General Toolkits | 6.1 Image Analysis ZEISS

à The selected cell nuclei are displayed as contours.

4. Click on a row in the data list or alternatively on a cell nucleus in the image.
à The row in the data list containing the measurement values is highlighted. The associated
cell nucleus is surrounded by a red rectangle.
There is a direct link between the measured cell nuclei in the image and the measured values in
the data table. You can either click on a measured cell nucleus in the image or on a row in the
data table.

6.1.3 Counting Number of Fluorescence Signals per Nuclei

This topic will show you how to set-up a measurement program using the Image Analysis Wiz-
ard. After this the program will be used to count the number of fluorescence spots in a multi-
channel image.
In this example we are using a multichannel image with 2 channels (1st channel blue (DAPI), 2nd
channel green (GFP)) of fluorescence-stained cell nuclei. First, we detect the blue-stained cell nu-
clei in the first channel and then the green stained signals in the second channel. Then we mea-
sure the number of green fluorescence signals per nucleus.

See also
2 Creating a New Image Analysis Setting [} 403]

6.1.3.1 Step 1: Classes

Prerequisite ü You have created a new image analysis setting with the Segment region classes indepen-
dently method and opened the Image Analysis Wizard, see Creating a New Image Analy-
sis Setting [} 403].
1. In the Classes step, click on Classes1 in the list and enter Nuclei in the Name input field.
2. Select a blue color from the dropdown list in the Color section.
3. Click on the Class 2 entry in the list and enter Individual Nucleus in the Name input field.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 409


6 General Toolkits | 6.1 Image Analysis ZEISS

4. Click on the blue channel icon in the Channel section.


5. For Object Color, click Fixed and select the blue color from the dropdown list.

à You have now setup a class pair for the nuclei.


6. Click Add Subclass.
7. Click on Classes 3 in the list and enter Signals in the Name input field.
8. Select a green color from the dropdown list in the Color section
9. Click on the Class 4 entry in the list and enter Individual Signal in the Name input field.
10. Click on the green channel icon in the Channel section.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 410


6 General Toolkits | 6.1 Image Analysis ZEISS

11. For Object Color, click Fixed and select the green color from the dropdown list.

à You have now setup a subclass for the signals inside the individual nucleus class (parent
class).
12. Click Next.

6.1.3.2 Step 2: Measurement Frame

1. Deactivate the Interactive checkbox.


2. Click on Next.

6.1.3.3 Step 3: Automatic Segmentation

1. Click on the Individual Nucleus entry in the list.


à The segmentation parameters (Smooth, Sharpen, Minimum Area, etc.) are displayed
below the list.
2. In the Smooth section select Gauss from the dropdown list and set the parameter Sigma
to 1.5.
3. Click on the blue-stained cell nuclei in the image.
à The detected nuclei are overlaid in blue. The threshold values are displayed in the
Threshold section in the Lower/Upper input fields.
4. Click on the areas of the blue cell nuclei that have not yet been detected until these have
been completely overlaid.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 411


6 General Toolkits | 6.1 Image Analysis ZEISS

5. Select the Watersheds entry from the dropdown list in the Separate section and set the
number to 17.
à Clear separation lines are now visible between the cell nuclei.

6. Click on the Individual Signal entry in the list.


à The segmentation parameters (Smooth, Image Sharpness, Minimum Area, etc.) are
displayed below the list.
7. In the Smooth section select Gauss from the dropdown list and set the parameter Sigma
to 1.5.
8. Click in the image on the green-stained signals.
à The detected signals are overlaid in green. The threshold values are displayed in the
Threshold section in the Lower/Upper input fields.
9. Click on the areas of the green signals that have not yet been detected until these have
been completely overlaid.
10. Activate the Fill Holes checkbox.
11. This fills any holes in the detected signals.
12. In the Separate section select the Watersheds entry from the dropdown list and set the
number to 17.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 412


6 General Toolkits | 6.1 Image Analysis ZEISS

à Clear separation lines are now visible between the signals.

13. Click on Next.

6.1.3.4 Step 4: Region Filter

1. Deactivate the Execute checkbox.


2. Click on Next.

6.1.3.5 Step 5: Interactive Segmentation

1. Deactivate the Interactive checkbox.


2. Click on Next.

6.1.3.6 Step 6: Features

1. Click on the Nuclei entry in the list.


2. Click on the Edit button in the Regions Features section.
à The Feature Selection dialog is opened.
3. Double-click in the right-hand list on the ID.
à The features are displayed in the Selected Features list on the left.

4. Remove superfluous features from the list. Select the feature and click on the
Delete button.
5. Click on the Individual Nucleus entry in the list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 413


6 General Toolkits | 6.1 Image Analysis ZEISS

6. Click on the Edit button in the Features of individual regions section.


à The Feature Selection dialog opens.
7. Double-click in the right-hand list on the ID of the parent.
à The features are displayed in the Selected Features list on the left.
8. Remove superfluous features (e.g. Area, Perimeter) from the list. Select the feature and click
on the Delete button.
9. Click on the Signals entry in the list. This list contains the statistical features of the individ-
ual signals.
10. Click on the Edit button in the Regions Features section.
à The Feature Selection dialog opens.
11. Double-click in the right-hand list on the ID, Count.
à The features are displayed in the Selected Features list on the left.
12. For the newly added feature Count, open the Copy drop-down menu and select Copy to
the parent single region.
à The feature is copied to the results table of the parent, in this case the individual nucleus.

13. Remove superfluous features from the list. Select the feature and click on the
Delete button.
14. Click on the Individual Signal entry in the list.
15. Click on the Edit button in the Features of individual regions section.
à The Feature Selection dialog opens.
16. Remove superfluous features (e.g. Area, Perimeter) from the list. Select the feature and click
on the Delete button.
17. Click on the OK button.
à The selected features are displayed in the Regions Features section.
18. Click on Next.

6.1.3.7 Step 7: Results Preview

1. Click on Nuclei in the list.


à The number of measured nuclei is displayed in the data table to the right of the image.

2. Click on Individual Nucleus in the list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 414


6 General Toolkits | 6.1 Image Analysis ZEISS

à The ID of the parent, the ID and Signals Count (the number of green signals) of the mea-
sured nuclei is displayed in the data list to the right of the image.

3. Click on Signals in the list.


à The ID of the parent (corresponds to the ID of the nucleus) and the number of mea-
sured signals are displayed in the data table to the right of the image.

4. Click on the Finish button.


à This saves the measurement program.

6.1.3.8 Executing the Analysis Setting

Prerequisite ü You are in the Image Analysis tool.


ü You have loaded the analysis setting that you have generated.
1. Click Start Analysis.
à The analysis setting is applied to the image.
à The Analysis View is displayed in the Center Screen Area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 415


6 General Toolkits | 6.1 Image Analysis ZEISS

à In the Analysis View you see your image with the measured cell nuclei overlaid in blue
and the signals overlaid in green. Right of this, you see the data list containing the num-
ber of signals per nucleus.

à Only the number of signals of measured nuclei is displayed. Nuclei touching the frame
are not taken into account.

6.1.4 Measuring Mean Fluorescence Intensity on a Ring around the Primary Object

The following example shows how to use the Zone of Influence (ZOI) method to measure intensi-
ties within a ring that is associated to the main object, e.g. the cell nucleus. An application exam-
ple are transport assays where the intensities of a certain fluorescent marker in the cytoplasm are
compared to the intensities within the nucleus.
In this example we use a multichannel image of fluorescence-stained cells. The cell nuclei are
stained with AF568 and the mitochondria are stained with AF488. First, we detect the nuclei in
the AF568-channel as primary object. A zone of influence is generated around each detected pri-
mary object. In this area, we can define a ring and specify its thickness and distance from the
main object. You can use this ring to measure intensities or to detect further sub-objects on it. For
more information, see Counting the Number of Objects in a Ring around the Nucleus [} 423].

See also
2 Creating a New Image Analysis Setting [} 403]

6.1.4.1 Step 1: Classes

Prerequisite ü You have set up the image analysis setting with the method ZOI (Zones of Influence) and
have opened the Image Analysis Wizard, see Creating a New Image Analysis Setting
[} 403]. This has created the classes ZOIs/ZOI, Primary Objects/Primary Object, and Rings/
Ring by default.
1. If you want to extend the predefined list of classes, click Add Subclass in the Classes step.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 416


6 General Toolkits | 6.1 Image Analysis ZEISS

à You can find an example how to detect objects on the ring in Counting the Number of
Objects in a Ring around the Nucleus [} 423].
2. If necessary, click Add Class to extend the predefined list by another independent class of
objects.
Note that you cannot add further rings.
3. Select the image channel which you want to use for object detection. In this example, the
primary objects (the nuclei) are in the AF568 channel. Therefore, click on the class Primary
Object and select the channel containing the nuclei.

Parameter Description
ZOIs Class of all zones of influences.

ZOI Individual zone of influence.

Primary Objects Class of all primary objects.

Primary Object Individual primary object.

Ring Individual ring.

Ring Segment Part of a ring (a ring often consists of only one ring segment).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 417


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.4.2 Step 2: Frame

Optionally, you can define the area to be analyzed of each image. In case there are shading ef-
fects or other reasons that make you want to include only a certain area of each image for analy-
sis, you can define a frame (rectangle, circle or polygon). Only the area within this frame will be
further analyzed.
With the Mode parameter, you can furthermore choose how the analysis treats objects that are
cut by the border of the image or the frame:

§ Cut at frame: Cuts the objects at the frame.


§ Inside only: Discards all objects that are cut by the frame.
Note that the whole ZOI is taken into account for the decision if the object is inside the frame or
not (not only the primary object). This means there are cases where the primary object might lie
completely within the image/frame, but the Ring or ZOI is cut by the border. If you select Inside
only, these objects will be discarded.
Comparison of image analysis results for Cut at frame compared to Inside only:

Fig. 17: Cut at frame

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 418


6 General Toolkits | 6.1 Image Analysis ZEISS

Fig. 18: Inside only

6.1.4.3 Step 3: Automatic Segmentation

1. Select Primary Object and set up suitable parameters to detect the objects, i.e. threshold,
area, separation.
à As soon as objects are detected, the ZOI and Ring are automatically created around each
primary object with the preset parameters.
2. To modify Ring Distance and Width, select the Ring Element class.
à Now, you can define the location and dimension of the ring flexibly. You can set it at the
edge of the main object or inside the main object. You can also define an arbitrary dis-
tance.
3. Define the following parameters:
à Ring Distance: Distance from surface of the primary object. Negative values means that
the ring starts at the defined distance within the primary object. Ring Width: Defines the
width of the ring.
à The ZOI is automatically adapted to exceed the class with the larger diameter, i.e. either
ring or primary object, by at least 3 pixels (default setting).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 419


6 General Toolkits | 6.1 Image Analysis ZEISS

Fig. 19: Ring distance: 0 pixel; Ring width: 10 pixel

Fig. 20: Ring distance: 5 pixel; Ring width: 10 pixel

Fig. 21: Ring distance: -5 pixel; Ring width: 5 pixel


Modifying the ZOI Width

1. Select ZOI-class, and with the ZOI Width slider, set the distance. You can set the distance
between the outer border of the ZOI and the outer border of either ring or primary object,
respectively. The ZOI Width is at least 3 pixels larger than either the ring or the primary ob-
ject, whichever is larger. The ZOI area incorporates also the area of the ring and the primary
object, and thus can serve for example for measuring features over the complete cell.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 420


6 General Toolkits | 6.1 Image Analysis ZEISS

Fig. 22: ZOI Width set to 30 pixel

6.1.4.4 Step 4: Region Filter

You can define conditions for the primary objects (and additionally defined subclasses) to be mea-
sured, e.g. include only objects of a certain size, shape, intensity or other parameters. You can de-
fine suitable parameters for each of the defined objects.

1. Select the Primary Object and click Edit. From the list of features on the right, you can
add features via double-click. Once you have added all desired features, click OK.
à The selected conditions appear in the left tool area.
2. Set the minimum and maximum values by clicking on the objects with the desired features,
or by entering the numbers directly.
The following figure is an example and shows the result if a certain condition of the circularity of
each primary object needs to be fulfilled.

Fig. 23: Region Filter based on the circularity of the primary object

6.1.4.5 Step 5: Features

You can define individual measurement features for each class. You can copy the measurement
features defined for one class to the other classes via Copy to all.

1. Select the class for which you want to define measurement features, and click Edit. From
the list of features on the right you can add features to the selected features list on the left.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 421


6 General Toolkits | 6.1 Image Analysis ZEISS

à These features are automatically calculated for every object during image analysis. All
classes have the ID of the parent and ID as default features. With these IDs you can later
group the associated parameters from the result excel lists, if necessary.
à The class Ring additionally has Area and Count as default parameters.
à To attribute the mean intensity for channel AF488 (the mitochondria) measured on the
Ring to the Primary Object, select Ring and click Edit. The Feature Selection window
opens.

2. From the feature list on the right select Intensity Mean Value of channel AF488 and
add it to the selected features on the left. In the Copy column, from the drop-down menu

in the Intensity Mean Value of channel AF488 row, click .


à This measurement feature is copied to the corresponding Primary Object.

6.1.4.6 Step 6: Result Preview

In this step you see a preliminary result of the image analysis.

1. Click on the different objects in the Analysis tab to get the preliminary measurement result
for all objects.
2. Click Finish, to save the analysis settings and close the wizard.
à The wizard closes. The analysis settings are saved.

6.1.4.7 Executing the Analysis Setting

You have the following options to run a predefined image analysis setting on your data set:

§ Start Interactive Analysis: Analyze interactively with all steps that have been selected with
the checkbox Interactive during setup of the image analysis.
§ Start Analysis: Runs the image analysis setting without dialog.
When the analysis is finished, the main view switches to the Analysis tab and displays the seg-
mented image along with the results of the analysis.
Select the different objects to display the corresponding measurement tables. The data in the ta-
bles and the regions in the image are interlinked. A click on the object in the image highlights the
corresponding line in the data table and vice versa.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 422


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.5 Counting the Number of Objects in a Ring around the Nucleus

This example is similar to Measuring Mean Fluorescence Intensity on a Ring around the pri-
mary Object [} 416] and also uses the same data. This example shows how to count the number
of objects on a ring that is associated with the main object, e.g. the cell nucleus. The images are
taken from AF568 stained nuclei. The mitochondria are stained with AF488. The channel of the
nuclei is used for image segmentation. The ZOI-segmentation method attributes a zone of influ-
ence (ZOI) and a ring to each detected nucleus. This area is used as a search range to detect sub-
objects, in this case the mitochondria.

See also
2 Creating a New Image Analysis Setting [} 403]

6.1.5.1 Step 1: Classes

Prerequisite ü You have set up the image analysis setting with the method ZOI (Zones of Influence) and
have opened the Image Analysis Wizard, see Creating a New Image Analysis Setting
[} 403]
1. In the Classes step, select Ring or Ring Element and click Add Subclass to extend the
predefined set of classes with a subclass of the Ring Element.
à Another class below the Ring Element is added.
2. Give this class a meaningful name, e.g. Mitochondria/Mitochondrion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 423


6 General Toolkits | 6.1 Image Analysis ZEISS

3. The cell nuclei (primary objects) are stained with AF568 (red channel), therefore you need
to select this channel to segment the cell nuclei. Select Primary Object and for Channel
select AF568.

4. Click on Mitochondrion and select AF488 in the Channel field.


à The mitochondria are stained with AF488, therefore you need to use this channel for im-
age segmentation.

6.1.5.2 Step 2: Frame

For more information, see Step 2: Frame [} 418].

6.1.5.3 Step 3: Automatic Segmentation

Prerequisite ü For more information, see Step 3: Automatic Segmentation [} 419].


1. Additionally, you need to set the segmentation parameters for the object Mitochondrion.
Choose suitable parameters to segment the objects.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 424


6 General Toolkits | 6.1 Image Analysis ZEISS

à You have detected the mitochondria on the ring.

6.1.5.4 Step 4: Region Filter

For more information, see Step 3: Automatic Segmentation [} 419].

See also
2 Measuring Mean Fluorescence Intensity on a Ring around the Primary Object [} 416]

6.1.5.5 Step 5: Features

You can define individual measurement features for each class. The measurement features de-
fined for one class you can copy to the other classes via Copy to all.

1. Select the class for which you want to define measurement features, and click Edit. From
the list of features on the right you can add features to the selected features list on the left.
à These features are automatically defined for every object during image analysis. All
classes have ID of the parent and ID as default features. This allows you to later to
group the associated parameters from the excel lists, if necessary.
à The class Ring additionally has Area and Count as default parameters.
2. In this example, we count the number of objects (the number of mitochondria fragments)
within each ring. To attribute the number of mitochondria fragments to the Primary Ob-
ject, select Mitochondria and click Edit.
à The Feature Selection dialog opens.
3. In the parameter list on the right, select the feature Count. In the Copy drop-down menu,

click .
à This measurement feature is copied to the corresponding Primary Object.

6.1.5.6 Step 6: Preview Result

In this step you see a preliminary result of the image analysis.

1. Click on the different objects in the Analysis tab to get the preliminary measurement result
for all objects.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 425


6 General Toolkits | 6.1 Image Analysis ZEISS

2. Select the Primary Object to get a list with preliminary measurement results with the fea-
tures ID of the parent, ID, Area, and Ring Mitochondria Counts. Note that the results are
preliminary and only include the part of the image you see in the viewport.

à The result of the image analysis shows Ring Mitochondria Counts as a feature of Pri-
mary Object.
3. In the table, click on column Ring Mitochondria Counts to sort the entries in increasing
or decreasing order.
4. Click on Finish to save the analysis settings and to close the wizard.
You can now run the analysis as described in Measuring Mean Fluorescence Intensity on a Ring
around the Primary Object [} 416].

6.1.6 Creating a Measurement Data Table

1. Click on the Create Measurement Data Table button on the Analysis tab.
à The two data lists are now separate documents.
2. Save each of the data lists via the File menu > Save As. Allocate a name and select .csv as
the file type.
à The measurement data tables are saved in CSV format and can therefore be opened di-
rectly in Excel.
3. Click on the image and save it via the File menu > Save As. Allocate a name and select .czi
as the file type.
The image is saved with the measurement results. If you open the image, the measurement re-
sults can be viewed in the Analysis View.

6.1.7 Creating an Image Analysis Setting from an Analyzed Image

It is possible to create or extract an image analysis setting from an image which has already been
analyzed. This allows you to ensure that a new data set is analyzed exactly in the same way as a
previously analyzed data set.

Prerequisite ü You have an already analyzed image.


1. Open your already analyzed image in ZEN.
2. On the Analysis tab, in the Image Analysis tool, click on Options .
3. In the drop-down list, select Create setting from analyzed image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 426


6 General Toolkits | 6.1 Image Analysis ZEISS

4. Type in the name you want to give the analysis setting.


5. Press Enter on your keyboard or click on .
You have now created and saved an image analysis setting from an already analyzed image.

6.1.8 Performing an Interactive Analysis

The Image Analysis tool allows you to perform an analysis interactively. It runs the selected anal-
ysis setting with all the steps that have been marked as interactive in the setup. Steps that you
have not marked as interactive in the Image Analysis Wizard are run with the values predefined
in the image analysis setting. The setting does not pause to allow you to change these values in-
teractively.
Start Interactive Analysis also allows you to directly execute an image analysis on a czi image
without predefining an image analysis setting. For that you need to have an image analysis setting
where all steps are marked as interactive. Then it is possible to modify every step of the Image
Analysis Wizard during the interactive analysis and do a one-time image analysis on the dataset
without creating a new setting. In order to retrieve an image analysis setting from an already ana-
lyzed dataset, see Creating an Image Analysis Setting from an Analyzed Image [} 426].
Note: When you analyze an image interactively, the modifications of the settings during the inter-
active analysis are not saved.

Prerequisite ü You have defined an image analysis setting where all analysis steps you want to adjust inter-
actively are marked as interactive.
1. On the Analysis tab, open the Image Analysis tool.
2. For Setting, select your image analysis setting.
3. Click on Start Interactive Analysis.
à The Image Analysis Wizard opens with all the steps that are defined as interactive in
the setting.
4. Modify your settings for each step and click Next to get to the following step in the wiz-
ard.
5. At the end, click Finish to close the wizard.
You have now analyzed your image interactively and the results of this analysis are displayed.

6.1.9 Creating Custom Features

Prerequisite ü You are in the Features step of the image analysis wizard.
1. Select a class in the list and click Custom Feature.
à The Custom Feature Editor opens. All already defined features are displayed in the list,
or on initial opening an empty default entry is already created.
2. In the Custom Features list, click to add a new entry. Alternatively, if no feature has
been defined yet, select the automatically displayed default entry.
à A new entry is added to the list.
3. Under Define Custom Feature, define the Name for your feature and optionally specify a
Unit, if applicable.
4. In the Define Operands list, click to add a new operand. Alternatively, if no feature
has been defined yet, select the automatically displayed default entry
à A new operand entry is created.
5. Select the Class which is used to generate the operand.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 427


6 General Toolkits | 6.1 Image Analysis ZEISS

6. In the Features dropdown list, select the measurement feature that you want to use to de-
fine the operand.
à The selected class and measurement feature are displayed as Expression.
7. Repeat the previous steps to define all operands you need to calculate your custom feature.
à All defined operands are displayed in the Define Operands list.
8. Under Define Custom Expression, enter your operands and use the mathematical opera-
tors to define the calculation for your custom feature, e.g. 100*(a/b+Math.Pow(c,2)).
9. Click Verify Expression.
à The syntax of your expression is checked and verified. In case the expression is not valid,
an error message is displayed.
10. Repeat this whole workflow to create all custom features required for your image analysis.
à All created features are displayed in the Custom Features list of the respective class.
11. Click OK.
à The editor closes and saves the defined custom features. They are displayed in the list of
the Features step of the wizard.
à After analyzing an image with the setting, the custom features are displayed in the result
table of the respective class and are also available for the charts in the Analysis view,
just as for any other features.

See also
2 Examples for Custom Features [} 438]

6.1.10 Creating Custom Statistical Features

Prerequisite ü You are in the Statistics step of the image analysis wizard.
1. Select a class in the list and click Define Custom Feature.
à The Custom Statistic Feature Editor opens. All already defined features are displayed
in the list, or on initial opening an empty default entry is already created.
2. In the Custom Features list, click to add a new entry. Alternatively, if no feature has
been defined yet, select the automatically displayed default entry.
à A new entry is added to the list.
3. Under Define Custom Feature, define the Name for your feature and optionally specify a
Unit, if applicable.
4. In the Define Operands list, click to add a new operand. Alternatively, if no feature
has been defined yet, select the automatically displayed default entry
à A new operand entry is created.
5. Select the Class which is used to generate the operand.
6. In the Features dropdown list, select the measurement feature that you want to use to de-
fine the operand.
7. Select the Statistical Operation the operand is used for.
à The selected class and measurement feature are displayed as Expression.
8. Repeat the previous steps to define all operands you need to calculate your custom statisti-
cal feature.
à All defined operands are displayed in the Define Operands list.
9. Under Define Custom Expression, enter your operands and click on the mathematical op-
erators to define the calculation for your custom statistical feature, e.g.
100*(a/b+Math.Pow(c,2)).
10. Click Verify Expression.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 428


6 General Toolkits | 6.1 Image Analysis ZEISS

à The syntax of your expression is checked and verified. In case the expression is not valid,
an error message is displayed.
11. Repeat this whole workflow to create all custom statistical features required for the image
analysis.
à All created features are displayed in the Custom Features list of the respective class.
12. Click OK.
à The editor closes and saves the defined custom features. They are displayed in the list of
the Statistics step of the analysis wizard.

See also
2 Examples for Custom Statistical Features [} 439]

6.1.11 Creating an Image Analysis Setting From an AI Model

Once you have downloaded an AI model, you can use it for image analysis by creating an image
analysis setting.

Prerequisite ü You have downloaded or imported an AI model trained on one or multiple channels, see
Downloading AI Models [} 71] or Importing AI Models [} 72].
1. On the Applications tab, open the AI Model Store tool and click Open AI Model Store.
Alternatively, click for a model in the Available Models list and select Create Anal-
ysis Setting.
à The AI Model Store dialog opens to display all available AI models.
2. Select the model in the list.
à The Properties section on the right displays more detailed information about your se-
lected model.
3. In the Properties section, click Create Analysis Setting.
à A file browser opens.
4. Enter a name for the setting and click Save.
à The setting is saved as *.czias file in the respective folder.
You can now use the setting for image analysis in ZEN and select it in the Image Analysis tool.
Note that some parameters are pre-defined in this setting based on the model and cannot be
changed, e.g. the number of classes and the segmentation method. If you need to create a more
complex hierarchy level of classes (e.g. define sub-classes or Zone-of influence), set up an ordinary
image analysis setting. In the Automatic Segmentation step of the setup, you can then select
models trained on single channel images for the segmentation of the individual classes.

See also
2 AI Model Store Tool [} 888]

6.1.12 Analysis View

Only visible if an image analysis has been performed.


The Analysis view displays the following:

§ the image from the analysis


§ the table containing the analysis results
§ a scatter chart or histogram

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 429


6 General Toolkits | 6.1 Image Analysis ZEISS

Info
4 To highlight the row of the table containing the measured values of an object, click on a
segmented object in the image or in the chart. To highlight multiple rows, press Ctrl and
click on multiple object/ data points.
4 To highlight the corresponding segmented object in the image, click on a row in the table
or on the data point in the chart. To highlight multiple objects, press Ctrl and click on mul-
tiple rows/ data points.
4 To highlight the measured value of an object in the scatter chart or in the histogram, click
on one or more rows in the table. The corresponding data point in the chart turns red. To
change the chart type, on the Custom Chart tab, click on the corresponding Chart Type
button. To highlight multiple objects, press Ctrl and click on multiple rows/ objects.

You can also move your stage in the Analysis view if you click on the Stage button in the Di-
mensions tab and then on a position in the image. The stage is displayed as a red crosshair. This
allows you to move your stage to particular points of interest which your analysis detected but
would have been very hard to identify in the original image in the 2D view.

CAUTION
Risk of Crushing Fingers
The drive of a microscope stage with a motorized horizontal stage axis (stage drive) is strong
enough to crush fingers or objects between the stage and nearby objects (e.g. a wall).
4 Remove your fingers or any objects from the danger area before moving the stage drive.
4 Release the joystick immediately to stop the movement.

See also
2 Charts and Tables of the Analysis View [} 434]

6.1.12.1 Analysis Tab

On the Analysis tab you can define how the measured objects are displayed in an image.

Parameter Description
Show Objects Activated: Displays the measured objects in the graphics plane.

Fill Activated: Displays the objects in filled form.


Deactivated: Displays only the contours of the objects.

Opacity Here you can set the opacity with which the measured objects are dis-
played in the graphics plane.

Delete Measure- Deletes all objects and measurement data from the image.
ment Data

Show All Classes Activated: Displays the objects of all classes.


Deactivated: Displays the objects of the selected class.

Create Table(s) Creates data tables

- <Classname> Create data table for selected class.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 430


6 General Toolkits | 6.1 Image Analysis ZEISS

Parameter Description
- All classes Create individual data tables for all classes.
(separately)

- All class/ Create concatenated data tables for all class/classes.


classes (con-
catenated)

Classes section In the classes section, you can select the class for which the measure-
ment features should be displayed in the data table. For each class
there are two entries: the first entry concerns all the objects belonging
to the class (field features) and the second represents an individual
object (object features).

Segmentation Only visible, if you have executed an object classification.


Displays the initial segmentation results from the image analysis (see
description for the classes section above).

Object Classifica- Only visible, if you have executed an object classification (see Using a
tion Trained Model for Object Classification [} 523]).
Displays a table with the predicted objects for a specific class.

6.1.12.2 Chart Export Tab

Here you can export the currently displayed custom chart as an image (with the file format PNG,
TIF, BMP, or JPG).

Parameter Description
Screen Resolution Exports the chart with a resolution suitable for screens.
(96ppi)

Printing Resolution Exports the chart with a resolution suitable for printing.
(300ppi)

– Width (inch) Adjusts and displays the width.

– Height (inch) Adjusts and displays the height.

– Maintain as- Activated: If height or width is changed, the other parameter is


pect ratio changed automatically to maintain the aspect ratio.
Deactivated: Height and/or width can be changed without an auto-
matic adjustment of the other parameter. The aspect ratio is not
maintained.

Transparent Back- Activated: The chart is exported with a transparent background. Pos-
ground sible file formats for this kind of export are PNG and TIF.

Export Opens a dialog to select the folder and path for export.

Export Data Available for histogram charts and the heatmap.


Exports the data of the histogram or the heatmap as a *.csv file.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 431


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.12.3 Sample Carrier Tab

On this tab you select the data which is shown in the multiple scenes chart of the Analysis view.
Filled wells which contain objects (images) are displayed in yellow color, unfilled/ empty wells are
transparent.

See also
2 Selecting Data for the Multiple Scenes Chart [} 436]

6.1.12.4 Table Export Tab

This tab allows you to export the currently opened table. The table is exported in csv format.

Parameter Description
Export Table Opens an explorer to select the location for export.

6.1.12.5 Custom Chart tab

You can display a histogram or visualize the relationship between two quantitative variables by
scatter chart and adapt the zoom factor to optimize the display. Draw a rectangle into the his-
togram/scatter chart to zoom in. Double click into the histogram/scatter chart to zoom out.

Parameter Description
Enable chart Activated: Displays the chart in the Analysis View.
Deactivated: Displays no chart in the Analysis View. Deactivates all
controls described below to edit the chart.

Chart Type

– Scatter Chart Displays a 2D scatter chart in the Analysis View.

– Histogram Displays a histogram in the Analysis View.


Chart

X-Axis Selects the feature that is displayed on the x-axis of the chart.
The elements displayed in the dropdown menu depend on the previ-
ously defined measurement features in the image analysis setting.

Y-Axis Only available for the scatter chart.


Selects the feature that is displayed on the y-axis of the chart. The ele-
ments displayed in the dropdown menu depend on the previously de-
fined measurement features in the image analysis setting.

Histogram Bin Only available for the histogram chart.


Count
Creates the amount of bins to be displayed.

Adapt Zoom Fac- Activated: Automatically zooms the chart when selecting items from
tor the data table or the image.

Multiple Scenes Only available for multi-scene images.


Activated: Displays a histogram/ scatter chart that contains the data
points from all scenes.
Deselect to go back to single-scene results.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 432


6 General Toolkits | 6.1 Image Analysis ZEISS

Parameter Description
Time Series Only available for time series images.
Activated: Displays the analysis results of the selected class in a time
series chart.

Heatmap Only available for experiments with multi well/multi chamber plates.
Activated: Displays a heatmap of the well plate.

See also
2 Analysis View [} 429]

6.1.13 Copy Operations for Features

In the feature selection dialogs for individual or all regions, you can define where a selected fea-
ture is copied to. The following copy operations are available:

§ Copies the selected feature also in the result table of CLASSES in the next higher hi-
erarchy level.

§ Copies the selected feature also in the data table of CLASS in the next higher hierar-
chy level.

§ Copies the selected feature also to the data table of the first CLASSES element of the
same hierarchy level.

§ Copies the selected feature also to the data table of the first CLASS element of the
same hierarchy level.

§ Copies the selected feature also in the data table of the first CLASSES element on the
next higher hierarchy level.

§ Copies the selected feature also in the data table of the first CLASS element on the
next higher hierarchy level.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 433


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.14 Charts and Tables of the Analysis View

The Analysis View shows different charts and tables depending on the analysis, the experiment,
and the selected options in the Custom Chart tab [} 432]. The axes of the charts are configured
in the Custom Chart tab and the shown analysis results are always those of the class selected in
the Analysis tab. An image of the charts can be exported with the Chart Export Tab [} 431]. You
can zoom into a chart by using the mouse wheel or drawing a zoom rectangle. To zoom out to
the original view, double-click on the background of the plot.

Info
4 To highlight the row of the table containing the measured values of an object, click on a
segmented object in the image or in the chart. To highlight multiple rows, press Ctrl on
your keyboard and click on multiple object/data points.
4 To highlight the corresponding segmented object in the image, click on a row in the table
or on the data point in the chart. To highlight multiple objects, press Ctrl on your key-
board and click on multiple rows/data points.
4 To highlight the measured value of an object in the scatter chart or in the histogram, click
on one or more rows in the table. The corresponding data point in the chart turns red. To
change the chart type, on the Custom Chart tab, click on the corresponding Chart Type
button. To highlight multiple objects, press Ctrl on your keyboard and click on multiple
rows/objects.

Standard table and chart


As a standard, a table with all analysis results and a chart configured according to the input in the
Custom Chart tab are shown besides the analyzed image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 434


6 General Toolkits | 6.1 Image Analysis ZEISS

Multiple Scenes chart


For experiments containing multiple scenes, the Analysis View offers a chart which shows the re-
sults of all or multiple scenes. To see this chart, activate the checkbox Multiple Scenes in the
Custom Chart tab. You can customize the displayed results with the Sample Carrier tab. For
more information, see Selecting Data for the Multiple Scenes Chart [} 436].

Time Series chart


For time series experiments, the Analysis View offers a chart and table which display the analysis
results over time. To see this chart, activate the checkbox Time Series in the Custom Chart tab.
You can use the slider (the blue box) to browse through the individual points in time, which high-
lights the respective data in the table, and vice versa.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 435


6 General Toolkits | 6.1 Image Analysis ZEISS

Heatmap
For multi well or multi chamber experiments, the Analysis View offers a heatmap to display the
measurement results on a well or chamber level. To see this map, activate the checkbox
Heatmap in the Custom Chart tab.

6.1.14.1 Selecting Data for the Multiple Scenes Chart

Prerequisite ü In the Custom Chart tab, the Multiple Scenes checkbox must be activated.
1. Click on the Sample Carrier tab.
2. Select the desired well or scene. To select multiple wells or scenes, press Ctrl on your key-
board and click on the individual wells. Alternatively, select the desired wells with the
pressed left mouse key. To select a specific region of wells, press Shift on your keyboard
and click on the two wells which mark the corners of the region.
The chart displays the data of the selected wells or scenes.

See also
2 Custom Chart tab [} 432]
2 Sample Carrier Tab [} 432]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 436


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.14.2 Heatmap Calculation

The heatmap displayed in the Analysis View is calculated based on statistical features which you
add in the Features step of the Image Analysis Wizard.
The statistical measurement is done on the basis of the top class objects of your analysis setting.
Consider the following example:

To calculate, for example, the Mean Area of the Classes 1, the area of all Class 2 objects is
summed up and then the total area is divided by the count of objects.
This table shows the offered statistical parameters and the calculation description:

Parameter Description
Area Calculates the total area of all objects found in a well or chamber.

Area Percentage Calculates the percentage that the area of all objects has in respect to
the whole frame area (area of all objects divided by the whole frame
area).

Count Calculates the count of objects.

Intensity Std Calculates the intensity standard deviation divided by the number of
objects.

§ sn = Number of the scenes in a well or chamber


§ os = Number of objects found in the scene s
§ xi = Intensity standard deviation of the object i

Mean Intensity Calculates the mean value of the mean of the intensity and divides it
by the number all objects in all scenes.

§ sn = Number of the scenes in a well or chamber


§ os = Number of objects found in the scene s
§ xi = Intensity mean value of the object i

Mean Area Calculates the mean value of the mean of the area and divides it by
the number of all objects in all scenes.

§ sn = Number of the scenes in a well or chamber

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 437


6 General Toolkits | 6.1 Image Analysis ZEISS

Parameter Description
§ os = Number of objects found in the scene s
§ xi = Mean area of the object i

6.1.15 Examples for Custom Features

The following examples illustrate the functionality of creating custom features in the image analy-
sis wizard, see also Creating Custom Features [} 427].

6.1.15.1 Example 1: Number of Spots per Cell

This custom feature calculates the number of spots in each cell and is based on an analysis setup
for an image with cells (DAPI) and spots (EGFP). The class tree could look like this:

To create this custom feature you have to define the following operand and expression for the
class Cell:

§ Operand a:
– Class: All Spots per Cell
– Feature: Count
§ Define Custom Expression: a
The subsequent run of the analysis setting will add your custom feature as another column to the
analysis table for the class Cell.

6.1.15.2 Example 2: Average Area per Spot

This custom feature calculates the average area per spot in a cell by dividing the area of the cell
through the number of spots in that cell. It is based on an analysis setup for an image with cells
and spots. The class tree could look like this:

To create this custom feature you have to define the following operands and expression for the
class Cell:

§ Operand a:
– Class: Cell
– Feature: Area
§ Operand b:
– Class: All Spots per Cell
– Feature: Count
§ Define Custom Expression: a/b

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 438


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.16 Examples for Custom Statistical Features

The following examples illustrate the functionality of creating custom statistical features in the im-
age analysis wizard, see also Creating Custom Statistical Features [} 428].

6.1.16.1 Example 1: Percentage of Positive Cells

This custom statistical feature calculates the percentage of positive cells. For this, your analysis
setting needs to have two classes, one for all cells and one for positive cells, for example:

Use identical segmentation parameters for both classes. In the Region Filter step you need to
add a filter to define the positive cells (e.g. on mean intensity) and set the filter to include only
positive cells. In the Statistics step, you then have to create this custom statistical feature with
the following operands and expression:

§ Operand a:
– Class: Red Positive Cell
– Feature: None
– Statistical Operation: Count
§ Operand b:
– Class: All Cells
– Feature: None
– Statistical Operation: Count
§ Define Custom Expression: a/b*100
After running the analysis setting containing this custom statistical feature, select the Base of the
classes tree in the Analysis view tab and then you can display the percentage of red positive cells
in the heatmap plot.

6.1.16.2 Example 2: Nuclear Cytoplasmic Transport

This custom statistical feature calculates the mean translocation ratio of cells in a well. For this,
your analysis setting has to use the method ZOI (Zones of Influence) and needs to be set up to
detect cell nuclei with a definition of an appropriate width for the ring to cover the cytoplasm
near the nucleus.

In the Statistics step, define the feature Translocation Ratio and calculate the mean intensity in
the second channel in the nuclei divided by the mean intensity in the same channel in the ring.
Therefore, define the following operands and expression:

§ Operand a:
– Class: Primary Object
– Feature: Intensity Mean Value of Channel 'EGFP'
– Statistical Operation: Mean

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 439


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Operand b:
– Class: Ring Element
– Feature: Intensity Mean Value of Channel 'EGFP'
– Statistical Operation: Mean
§ Define Custom Expression: a/b

6.1.17 Measurement Features

Info
Coordinate System
Some feature descriptions contain images with a coordinate system for illustrative purposes.
Note that the actual coordinate system in the software is different and has its point of origin
(0/0) in the top left corner of the image.

The software can automatically detect and measure various properties of objects.
Some general terms relevant for several feature descriptions are the following:

§ Filled: A measurement feature with Filled in its name takes the entire region for the respec-
tive calculation, i.e. any holes the region might contain are included in the calculation.
§ Unscaled: For features that are titled as Unscaled, the scaling of the image is not taken into
account for the measurement. The values returned by these features have the unit pixel.

6.1.17.1 ACP X Unscaled

The x coordinate of the last pixel in the last line of a region.


To identify measurement objects, the image is scanned from bottom left to top right. The so-
called ACP (anti-coincidence point) is the last point that has been identified for a new object. The
parameter ACP X indicates the x-coordinate of this point.

§ Unit: pixels
§ Value range: 1 ... image size in x-direction

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 440


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.2 ACP X Unscaled WCS

The x coordinate of the last pixel in the last line of a region.


To identify measurement objects, the image is scanned from bottom left to top right. The so-
called ACP (anti-coincidence point) is the last point that has been identified for a new object. The
parameter ACP X indicates the x-coordinate of this point in the world coordinate system (WCS).

§ Unit: pixels
§ Value range: 1 ... image size in x-direction

6.1.17.3 ACP Y Unscaled

The y coordinate of the last pixel in the last line of a region.


To identify measurement objects, the image is scanned from bottom left to top right. The so-
called ACP (anti-coincidence point) is the last point that has been identified for a new object. The
parameter ACP Y indicates the y-coordinate of this point.

§ Unit: pixels
§ Value range: 1 ... image size in y-direction

6.1.17.4 ACP Y Unscaled WCS

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 441


6 General Toolkits | 6.1 Image Analysis ZEISS

The y coordinate of the last pixel in the last line of a region.


To identify measurement objects, the image is scanned from bottom left to top right. The so-
called ACP (anti-coincidence point) is the last point that has been identified for a new object. The
parameter ACP Y indicates the y-coordinate of this point in the world coordinate system (WCS).

§ Unit: pixels
§ Value range: 1 ... world coordinate size in y-direction

6.1.17.5 Area

Area of a region.
Area of a region excluding any holes it may contain. The areas of the holes are not included in the
measurement. If you want to include them, use the Area filled parameter.

§ Unit: Unit of area of the scaling assigned to the image (e.g. μm²)

6.1.17.6 Area Convex

Area of convex hull of a region.


The current region is surrounded by a convex polyline. The (filled!) area of the resulting region is
then measured.

§ Unit: Unit of area of the scaling assigned to the image (e.g. μm²)

6.1.17.7 Area Cut

Area of a region including the parts cut by a frame. Note that if you define Cut at Frame in the
Frame step of the image analysis, the value of this parameter is identical to the value delivered by
the Area feature.

§ Unit: Unit of area of the scaling assigned to the image (e.g. μm²)

6.1.17.8 Area Cut Unscaled

Unscaled area of a region including the parts cut by a frame. Note that if you define Cut at
Frame in the Frame step of the image analysis, the value of this parameter is identical to the
value delivered by the Area Unscaled feature.

§ Unit: pixels

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 442


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.9 Area Filled

Area of filled region.


Area of a region including any holes it contains. The holes are interpreted as belonging to the re-
gion or are filled prior to the measurement. If you do not want the holes to be measured, use the
Area parameter.

§ Unit: Unit of area of the scaling assigned to the image (e.g. μm²)

6.1.17.10 Area Filled Unscaled

Area of filled region.


Area of a region including any holes it contains. The holes are interpreted as belonging to the re-
gion or are filled prior to the measurement. If you do not want the holes to be measured, use the
Area parameter.

§ Unit: pixels²

6.1.17.11 Area Frame

Returns the area of the measurement frame used in the image. If a ROI is defined in the Frame
step of the wizard, this area is displayed, otherwise the area of the entire image is indicated. This
also includes image areas without pixel values.

§ Unit: µm2

6.1.17.12 Area Frame Unscaled

Returns the area of the measurement frame used in the image. If a ROI is defined in the Frame
step of the wizard, this area is displayed, otherwise the area of the entire image is indicated. This
also includes image areas without pixel values.

§ Unit: pixels

6.1.17.13 Area Percentage

The percentage of the area of all regions in relation to the area of all frames. This also includes
image areas without pixel values.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 443


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.14 Area Percentage Cut

The percentage of the area of all regions including regions that are cut by the frame in relation to
the area of all frames. This also includes image areas without pixel values.

6.1.17.15 Area Percentage of Holes

Area of the holes as a percentage of the overall area, i.e. the area of holes divided by the area of
the segmented region.

6.1.17.16 Area Unscaled

Area of a region unscaled.


The Area unscaled parameter corresponds to the Area parameter. However, the scaling of the
image is not taken into account for the measurement. The (unfilled!) area of a region is displayed
in pixels in each case.

§ Unit: pixels²

6.1.17.17 Bound Back

Indicates the back coordinate (highest value in z-direction) of the bounding box of a region. The
box is drawn in parallel to the x, y and z axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.18 Bound Back Unscaled

Indicates the back coordinate (highest value in z-direction) of the unscaled bounding box of a re-
gion. The box is drawn in parallel to the x, y and z axis.

§ Unit: pixels

6.1.17.19 Bound Back Unscaled WCS

Indicates the back coordinate (highest value in z-direction) of the unscaled bounding box of a re-
gion in the world coordinate system (WCS). The box is drawn in parallel to the x, y and z axis.

§ Unit: pixels

6.1.17.20 Bound Back WCS

Indicates the back coordinate (highest value in z-direction) of the bounding box of a region in the
world coordinate system (WCS). The box is drawn in parallel to the x, y and z axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 444


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.21 Bound Bottom

Minimum y-coordinate of the bounding box of a region.


Indicates the y-coordinate of the bottom edge of a bounding box for a region. The box is drawn
in parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.22 Bound Bottom Unscaled

Minimum y-coordinate of the bounding box of a region.


Indicates the y-coordinate of the bottom edge of a bounding box for a region. The box is drawn
in parallel to the x and y axis.

§ Unit: pixels

6.1.17.23 Bound Bottom Unscaled WCS

Minimum y-coordinate of the bounding box of a region.


Indicates the y-coordinate in the world coordinate system (WCS) of the bottom edge of a bound-
ing box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: pixels

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 445


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.24 Bound Bottom WCS

Minimum y-coordinate of the bounding box of a region.


Indicates the y-coordinate in the world coordinate system (WCS) of the bottom edge of a bound-
ing box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.25 Bound Center

Bound Center X/Y/Z.


Indicates the x, y or z coordinate of the center of the bounding box for a region.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.26 Bound Center Unscaled

Bound Center X/Y/Z Unscaled.


Indicates the x, y or z coordinate of the unscaled center of the bounding box for a region.

§ Unit: pixels

6.1.17.27 Bound Center Unscaled WCS

Bound Center X/Y/Z Unscaled WCS.


Indicates the x, y or z coordinate of the unscaled center of the bounding box for a region in the
world coordinate system (WCS).

§ Unit: pixels

6.1.17.28 Bound Center WCS

Bound Center X/Y/Z WCS.


Indicates the x, y or z coordinate of the center of the bounding box for a region in the world co-
ordinate system (WCS).

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.29 Bound Depth

Indicates the depth of the bounding box of a region, i.e. the "length" of the bounding box in z.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 446


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.30 Bound Depth Unscaled

Indicates the depth of the unscaled bounding box of a region, i.e. the "length" of the bounding
box in z.

§ Unit: pixels

6.1.17.31 Bound Front

Indicates the front coordinate (smallest value in z-direction) of the bounding box of a region. The
box is drawn in parallel to the x, y and z axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.32 Bound Front Unscaled

Indicates the front coordinate (smallest value in z-direction) of the unscaled bounding box of a re-
gion. The box is drawn in parallel to the x, y and z axis.

§ Unit: pixels

6.1.17.33 Bound Front Unscaled WCS

Indicates the front coordinate (smallest value in z-direction) of the unscaled bounding box of a re-
gion in the world coordinate system (WCS). The box is drawn in parallel to the x, y and z axis.

§ Unit: pixels

6.1.17.34 Bound Front WCS

Indicates the front coordinate (smallest value in z-direction) of the bounding box of a region in the
world coordinate system (WCS). The box is drawn in parallel to the x, y and z axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.35 Bound Height

Indicates the height (size in y-direction) of a bounding box for a region. The box is drawn in paral-
lel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)


§ Formula: Bound top - Bound bottom

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 447


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.36 Bound Height Unscaled

Indicates the height (size in y-direction) of a bounding box for a region. The box is drawn in paral-
lel to the x and y axis.

§ Unit: pixels
§ Formula: Bound top - Bound bottom

6.1.17.37 Bound Left

Minimum x-coordinate of the bounding box of a region.


Indicates the x coordinate of the left-hand edge of a bounding box for a region. The box is drawn
in parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.38 Bound Left Unscaled

Minimum x-coordinate of the bounding box of a region.


Indicates the x coordinate of the left-hand edge of a bounding box for a region. The box is drawn
in parallel to the x and y axis.

§ Unit: pixels

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 448


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.39 Bound Left Unscaled WCS

Minimum x-coordinate of the bounding box of a region.


Indicates the x coordinate in the world coordinate system (WCS) of the left-hand edge of a
bounding box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: pixels

6.1.17.40 Bound Left WCS

Minimum x-coordinate of the bounding box of a region.


Indicates the x coordinate in the world coordinate system (WCS) of the left-hand edge of a
bounding box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.41 Bound Right

Maximum x-coordinate of the bounding box of a region.


Indicates the x coordinate of the right-hand edge of a bounding box for a region. The box is
drawn in parallel to the x and y axis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 449


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.42 Bound Right Unscaled

Maximum x-coordinate of the bounding box of a region.


Indicates the x coordinate of the right-hand edge of a bounding box for a region. The box is
drawn in parallel to the x and y axis.

§ Unit: pixels

6.1.17.43 Bound Right Unscaled WCS

Maximum x-coordinate of the bounding box of a region.


Indicates the x coordinate in the world coordinate system (WCS) of the right-hand edge of a
bounding box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: pixels

6.1.17.44 Bound Right WCS

Maximum x-coordinate of the bounding box of a region.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 450


6 General Toolkits | 6.1 Image Analysis ZEISS

Indicates the x coordinate in the world coordinate system (WCS) of the right-hand edge of a
bounding box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.45 Bound Top

Maximum y-coordinate of the bounding box of a region.


Indicates the y-coordinate of the top edge of a bounding box for a region. The box is drawn in
parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.46 Bound Top Unscaled

Maximum y-coordinate of the bounding box of a region.


Indicates the y-coordinate of the top edge of a bounding box for a region. The box is drawn in
parallel to the x and y axis.

§ Unit: pixels

6.1.17.47 Bound Top Unscaled WCS

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 451


6 General Toolkits | 6.1 Image Analysis ZEISS

Maximum y-coordinate of the bounding box of a region.


Indicates the y coordinate in the world coordinate system (WCS) of the top edge of a bounding
box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: pixels

6.1.17.48 Bound Top WCS

Maximum y-coordinate of the bounding box of a region.


Indicates the y coordinate in the world coordinate system (WCS) of the top edge of a bounding
box for a region. The box is drawn in parallel to the x and y axis.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.49 Bound Width

Indicates the width (size in x-direction) of a bounding box for a region. The box is drawn in paral-
lel to the x and y axis.

§ Formula: Bound right - Bound left


§ Unit: Unit of the scaling assigned to the image (e.g. μm)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 452


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.50 Bound Width Unscaled

Indicates the width (size in x-direction) of a bounding box for a region. The box is drawn in paral-
lel to the x and y axis.

§ Formula: Bound right - Bound left


§ Unit: pixels

6.1.17.51 Center X

The x coordinate of the geometric center of gravity of a region.


Depending on the shape of the object, this point may also lie outside a region. The associated y-
coordinate is determined via the Center Y parameter.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.52 Center X Unscaled

The x coordinate of the geometric center of gravity of a region.


Depending on the shape of the object, this point may also lie outside a region. The associated y-
coordinate is determined via the Center Y parameter.

§ Unit: pixels

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 453


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.53 Center X Unscaled WCS

The x coordinate in the world coordinate system (WCS) of the geometric center of gravity of a re-
gion.
Depending on the shape of the object, this point may also lie outside a region. The associated y-
coordinate is determined via the Center Y parameter.

§ Unit: pixels

6.1.17.54 Center X WCS

The x coordinate in the world coordinate system (WCS) of the geometric center of gravity of a re-
gion.
Depending on the shape of the object, this point may also lie outside a region. The associated y-
coordinate is determined via the Center Y parameter.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.55 Center Y

The y coordinate of the geometric center of gravity of a region.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 454


6 General Toolkits | 6.1 Image Analysis ZEISS

Depending on the shape of the object, this point may also lie outside a region. The associated x
coordinate is determined via the Center X parameter.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.56 Center Y Unscaled

The y coordinate of the geometric center of gravity of a region.


Depending on the shape of the object, this point may also lie outside a region. The associated x
coordinate is determined via the Center X parameter.

§ Unit: pixels

6.1.17.57 Center Y Unscaled WCS

The y coordinate in the world coordinate system (WCS) of the geometric center of gravity of a re-
gion.
Depending on the shape of the object, this point may also lie outside a region. The associated x
coordinate is determined via the Center X parameter.

§ Unit: pixels

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 455


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.58 Center Y WCS

The y coordinate in the world coordinate system (WCS) of the geometric center of gravity of a re-
gion.
Depending on the shape of the object, this point may also lie outside a region. The associated x
coordinate is determined via the Center X parameter.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.59 Center Z

Indicates the z coordinate of the geometric center of gravity of a region.


Depending on the shape of the object, this point can also lie outside a region. The associated x
and y coordinates are determined by the Center X and Center Y features.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.60 Center Z Unscaled

Indicates the z coordinate of the unscaled geometric center of gravity of a region.


Depending on the shape of the object, this point can also lie outside a region. The associated x
and y coordinates are determined by the Center X Unscaled and Center Y Unscaled features.

§ Unit: pixels

6.1.17.61 Center Z Unscaled WCS

Indicates the z coordinate of the unscaled geometric center of gravity of a region in the world co-
ordinate system (WCS).
Depending on the shape of the object, this point can also lie outside a region. The associated x
and y coordinates are determined by the Center X Unscaled WCS and Center Y Unscaled WCS
features.

§ Unit: pixels

6.1.17.62 Center Z WCS

Indicates the z coordinate of the geometric center of gravity of a region in the world coordinate
system (WCS).
Depending on the shape of the object, this point can also lie outside a region. The associated x
and y coordinates are determined by the Center X WCS and Center Y WCS features.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 456


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.63 Circularity

Sqrt(Roundness) = Sqrt(4 × Area / (π × Feret Maximum²))

6.1.17.64 Compactness

4 × π × Area / Perimeter Convex²

6.1.17.65 Convexity

(Perimeter Convex / Perimeter Crofton)2

6.1.17.66 Count

Returns the count of analyzed objects.

6.1.17.67 Count Objects Direct Subclasses

Returns the count of analyzed objects in the direct subclasses.


Note that this feature only considers values of direct subclasses of a class, i.e. subclasses that are
directly on the next lower hierarchy level in the class list. Values of subclasses on lower hierarchy
levels ("subclass of a subclass") are not considered.

6.1.17.68 Count per mm2

Returns the count of analyzed objects per mm2.

6.1.17.69 Diameter

Diameter of a circle/sphere with an area/volume equal to that of the object.


The object is measured using the Area feature. A circle with the same area as the object is cre-
ated. The diameter of this circle is returned.
In case of a three dimensional analysis, the equivalent sphere with the Volume of the region is
measured and the diameter of the sphere is returned.

§ Formula 2D: Sqrt ((4/π)*Area)


§ Formula 3D: Pow(6*Volume/π, 1/3)
§ Unit: Unit of the scaling assigned to the image (e.g. μm)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 457


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.70 Diameter Unscaled

Unscaled diameter of a circle/sphere with an area/volume equal to that of the object.


The object is measured using the Area Unscaled feature. A circle with the same area as the ob-
ject is created. The diameter of this circle is returned.
In case of a three dimensional analysis, the equivalent sphere with the Volume Unscaled of the
region is measured and the diameter of the sphere is returned.

§ Formula 2D: Sqrt ((4/π)*Area Unscaled)


§ Formula 3D: Pow(6*Volume Unscaled/π, 1/3)
§ Unit: pixels

6.1.17.71 Ellipse Angle

Angle of the major axis of the ellipse.


The major axis of an ellipse with the same geometric moment of inertia as the current region is
determined in accordance with the Ellipse major parameter. The angle to the x-axis is then de-
termined. The indication of the angle always relates to a counterclockwise direction.

§ Unit: degrees
§ Value range: 0 ... 180°

6.1.17.72 Ellipse Angle Unscaled

Angle of the major axis of the ellipse.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 458


6 General Toolkits | 6.1 Image Analysis ZEISS

The major axis of an ellipse with the same geometric moment of inertia as the current region is
determined in accordance with the Ellipse major parameter. The angle to the x-axis is then de-
termined. The indication of the angle always relates to a counterclockwise direction.

§ Unit: degrees
§ Value range: 0 ... 180°
This tool uses unscaled pixels for calculating the angle. The results may differ from the results of
Ellipse Angle.

6.1.17.73 Ellipse Semi-Major

Length of the semi-major axis of the ellipse.


Length of the semi-major axis of an ellipse with the same geometric moment of inertia as the re-
gion. The moment of inertia is calculated about the center of gravity of the region.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.74 Ellipse Semi-Major Unscaled

Length of the semi-major axis of the ellipse.


Length of the semi-major axis of an ellipse with the same geometric moment of inertia as the re-
gion. The moment of inertia is calculated about the center of gravity of the region.

§ Unit: pixels

6.1.17.75 Ellipse Semi-Minor

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 459


6 General Toolkits | 6.1 Image Analysis ZEISS

Length of the semi-minor axis of the ellipse.


Length of the semi-minor axis of an ellipse with the same geometric moment of inertia as the re-
gion. The moment of inertia is calculated about the center of gravity of the region.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.76 Ellipse Semi-Minor Unscaled

Length of the semi-minor axis of the ellipse.


Length of the semi-minor axis of an ellipse with the same geometric moment of inertia as the re-
gion. The moment of inertia is calculated about the center of gravity of the region.

§ Unit: pixels

6.1.17.77 Ellipsoid Semi-Major

Calculates the length of the semi-major axis of the equivalent ellipsoid of the region.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.78 Ellipsoid Semi-Major Unscaled

Calculates the length of the semi-major axis of the equivalent unscaled ellipsoid of the region.

§ Unit: pixels

6.1.17.79 Ellipsoid Semi-Mean

Calculates the length of the semi-mean axis of the equivalent ellipsoid of the region, i.e. half the
length of the medium/middle axis of the three dimensional ellipsoid.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 460


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.80 Ellipsoid Semi-Mean Unscaled

Calculates the length of the semi-mean axis of the equivalent unscaled ellipsoid of the region, i.e.
half the length of the medium/middle axis of the three dimensional ellipsoid.

§ Unit: pixels

6.1.17.81 Ellipsoid Semi-Minor

Calculates the length of the semi-minor axis of the equivalent ellipsoid of the region.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.82 Ellipsoid Semi-Minor Unscaled

Calculates the length of the semi-minor axis of the equivalent unscaled ellipsoid of the region.

§ Unit: pixels

6.1.17.83 Feret Maximum

Maximum feret of a region.


The maximum feret of a region is determined on the basis of distance measurements. Two
straight lines are positioned on opposite sides of the object, like a sliding caliper, at 128 angle po-
sitions. The corresponding distance is measured for each angle position. The maximum value de-
termined is the maximum feret.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 461


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.84 Feret Maximum Angle

Angle of the maximum feret of a region in relation to the x-axis.


The maximum feret is determined as described in Feret Maximum. The angle of the maximum
feret in relation to the x-axis is then determined. The indication of the angle always relates to a
counterclockwise direction.

§ Unit: degrees
§ Value range: 0 ... 180°

6.1.17.85 Feret Maximum Unscaled

Maximum feret of a region.


The maximum feret of a region is determined on the basis of distance measurements. Two
straight lines are positioned on opposite sides of the object, like a sliding caliper, at 128 angle po-
sitions. The corresponding distance is measured for each angle position. The maximum value de-
termined is the maximum feret.

§ Unit: pixels

6.1.17.86 Feret Minimum

Minimum feret of a region.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 462


6 General Toolkits | 6.1 Image Analysis ZEISS

The minimum feret of a region is determined on the basis of distance measurements. Two straight
lines are positioned on opposite sides of the object, like a sliding caliper, at 128 angle positions.
The corresponding distance is measured for each angle position. The minimum value determined
is the minimum feret.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.87 Feret Minimum Angle

Angle of the minimum feret of a region in relation to the x-axis.


The minimum feret is determined as described in Feret Minimum. The angle of the minimum
feret in relation to the x-axis is then determined. The indication of the angle always relates to a
counterclockwise direction.

§ Unit: degrees
§ Value range: 0 ... 180°

6.1.17.88 Feret Minimum Unscaled

Minimum feret of a region.


The minimum feret of a region is determined on the basis of distance measurements. Two straight
lines are positioned on opposite sides of the object, like a sliding caliper, at 128 angle positions.
The corresponding distance is measured for each angle position. The minimum value determined
is the minimum feret.

§ Unit: pixels

6.1.17.89 Feret Ratio

a:b

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 463


6 General Toolkits | 6.1 Image Analysis ZEISS

Feret ratio.
The ratio of Feret Minimum to Feret Maximum is calculated. This ratio makes it possible to
make statements on the form of the measured objects. If the feret ratio has a low value, long,
elongated objects are present. Values approaching 1 indicate the presence of compact or circular
objects, as in this case Feret Minimum and Feret Maximum have very similar values. The Form
Circle is also suitable for making statements on the circularity of an object.

§ Formula: Feret Minimum / Feret Maximum (a / b)


§ Unit: none
§ Value range: 0 ... 1

6.1.17.90 Feret Vertical to Maximum

The feret perpendicular to the maximum feret of a region.

§ Unit: Unit of the scaling assigned to the image (e.g. µm)

6.1.17.91 Fiber Length

Length of a fiber-like region.


To calculate the fiber length, a structure that is actually similar to a fiber is required. Here it is not
the distance between a start and end point that is determined. The check can be done using the
Form circle, among other things.

§ Formula: ¼ × (Perimeter + (Sqrt (Perimeter² - 16 × Area))


§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.92 Fiber Length Unscaled

Length of a fiber-like region.


To calculate the fiber length, a structure that is actually similar to a fiber is required. Here it is not
the distance between a start and end point that is determined. The check can be done using the
Form Circle, among other things.

§ Formula: ¼ × (Perimeter Unscaled + (Sqrt (Perimeter Unscaled² - 16 × Area Unscaled))


§ Unit: pixels

6.1.17.93 Form Circle

Form factor of a region.


Describes the form of a region on the basis of its circularity. A perfect circle is given the value 1.
The more elongated the region is, the smaller the form factor. The calculation is based on the
Area filled and Perimeter Crofton parameters.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 464


6 General Toolkits | 6.1 Image Analysis ZEISS

§ Formula: 4 × π × Area / PerimeterCrofton²


§ Unit: none
§ Value range: 0...1

6.1.17.94 ID

Sequential ID of the object.

6.1.17.95 ID Object Storage

Returns the ID of the segmented object that is saved in the object store.

6.1.17.96 ID of the Parent

Sequential ID of the object's parent.

6.1.17.97 Image Acquisition Time

Returns the time stamp (date and time) of the image acquisition. This value is not equivalent to
the time stamp of the image file, i.e. it does not change when saving, copying, re-saving the im-
age files. It is formatted according to the settings of the operating system, e.g. mm/dd/yyyy would
be typical in US based systems, whereas dd/mm/yyyy would be typical in EU based systems.

6.1.17.98 Image Area Percentage

The percentage of the area of all regions in relation to the image area of all frames. This only in-
corporates image areas which contain pixel values.

6.1.17.99 Image Channel Name

Indicates the name of the channel as selected by the user.

6.1.17.100 Image Container Category

Returns the container category (e.g. sample, control) of the current scene (well).

6.1.17.101 Image Focus Position

Indicates the position of the z-motor (in µm) at the time of image acquisition.

6.1.17.102 Image Frame Area

Returns the area of the measurement frame used in the image. If a ROI is defined in the Frame
step of the wizard, this area is displayed, otherwise the area of the entire image is indicated. This
only incorporates image areas which contain pixel values.

§ Unit: Unit of area of the scaling assigned to the image (e.g. μm2)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 465


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.103 Image Frame Area Unscaled

Returns the unscaled area of the measurement frame used in the image. If a ROI is defined in the
Frame step of the wizard, this area is displayed, otherwise the area of the entire image is indi-
cated. This only incorporates image areas which contain pixel values.

§ Unit: pixels

6.1.17.104 Image Height

Returns the total distance across the y-axis of the image, i.e. the height of the image.

§ Unit: µm

6.1.17.105 Image Height Unscaled

Returns the total distance across the y-axis of the image, i.e. the height of the image.

§ Unit: pixels

6.1.17.106 Image Index Block

Index for the individual image slices of a multi-block image.


Multi-block images are composed of blocks of different dimensions.

6.1.17.107 Image Index Position

Index for the individual image slices of a Position List image.


If the image was acquired using the Position List tool, the Image Index Position returns the
number of the image that contains the object.
In contrast, the ID parameter is a global counter, i.e. the number of the object.
The Index Position can be used to guarantee unambiguous assignment between measured re-
gions in the image and the individual lines of a data table, especially in cases where several im-
ages are measured, as automatic assignment is then no longer possible. To achieve this, the In-
dex Region parameter must also be selected as a region feature and also be inserted into the
graphics plane as an annotation (Draw Features). It is also advisable to activate the Image name
parameter as a region feature so that the correct original image can be reloaded.

§ Restriction: This value is only available for images that have previously been acquired with Ax-
ioVision or saved in AxioVision ZVI format.

6.1.17.108 Image Index Scene

Index for the individual image slices of a scene image.


Indicates the unambiguous number of the scene in an image. The word Scene refers to a coher-
ent object on a slide that contains several objects for examination. The Index Scene can be used
to guarantee unambiguous assignment between measured regions in the image and the individ-
ual lines of a data table, especially in cases where several images are measured, as automatic as-
signment is then no longer possible. To achieve this, the Index Region parameter must also be
selected as a region parameter and must also be inserted into the graphics plane as an annotation
(Draw Features). It is also advisable to activate the Image name parameter as a region parameter
so that the correct original image can be reloaded.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 466


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.109 Image Index Time

Returns the time point (frame) in which the object was segmented.

6.1.17.110 Image Index Z

Returns the z-section (slice) at which an object was segmented.

6.1.17.111 Image Name

Returns the file name of the image.

6.1.17.112 Image Scene Name

Returns the name of the scene (well).

6.1.17.113 Image Width

Returns the total distance across the x-axis of the image, i.e. the width of the image.

§ Unit: µm

6.1.17.114 Image Width Unscaled

Returns the total distance across the x-axis of the image, i.e. the width of the image.

§ Unit: pixels

6.1.17.115 Index

A running number of the object, in the order it was measured on the image. This is different from
ID, which is a global identifier in the sense that it takes also into account the ID of the Classes Col-
lections (i.e. the topmost "Classes" has the ID 1, and the "Base" has ID 0, and therefore the first
detected object of the first class starts with 2). The index instead starts at 1 for every region, refer-
ring to the order of appearance of an object.

6.1.17.116 Intensity Maximum of channel "C1"

The pixel value of the brightest pixel in the object.

6.1.17.117 Intensity Mean Value of channel "C1"

The average brightness (pixel value) of the pixels in the object.

6.1.17.118 Intensity Minimum of channel "C1"

The pixel value of the darkest pixel in the object.

6.1.17.119 Intensity Range of channel "C1"

The difference between the pixel value of the brightest and darkest pixels in the object, i.e. Inten-
sity Maximum of channel "C1"-Intensity Minimum of channel "C1".

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 467


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.120 Intensity Standard Deviation of channel "C1"

The standard deviation of the brightness (pixel value) of the pixels in the object.

6.1.17.121 Number of the region holes

Calculates the number of holes enclosed by the object.

6.1.17.122 Perimeter

Perimeter of a region.
This parameter is specially optimized for measuring the perimeters of circles. If the measured re-
gion contains holes, the total perimeter including the perimeters of the hole structures is deter-
mined. If you only want the perimeter of the outside contour to be determined, use the Perime-
ter filled parameter.

§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.123 Perimeter Unscaled

Perimeter of a region.
This parameter is specially optimized for measuring the perimeters of circles. If the measured re-
gion contains holes, the total perimeter including the perimeters of the hole structures is deter-
mined. If you only want the perimeter of the outside contour to be determined, use the Perime-
ter filled parameter.

§ Unit: pixels

6.1.17.124 Radius

Radius of a circle/sphere with an area/volume equal to that of the object.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 468


6 General Toolkits | 6.1 Image Analysis ZEISS

The object is measured using the Area feature. A circle with the same area as the object is cre-
ated. The radius of this circle is returned.
In case of a three dimensional analysis, the equivalent sphere with the Volume of the region is
measured and the radius of the sphere is returned.

§ Formula 2D: Sqrt((1/π)*Area)


§ Formula 3D: 0.5*Pow(6*Volume/π, 1/3)
§ Unit: Unit of the scaling assigned to the image (e.g. μm)

6.1.17.125 Radius Unscaled

Radius of a circle/sphere with an area/volume equal to that of the object.


The object is measured using the Area Unscaled feature. A circle with the same area as the ob-
ject is created. The radius of this circle is returned.
In case of a three dimensional analysis, the equivalent sphere with the Volume Unscaled of the
region is measured and the radius of the sphere is returned.

§ Formula 2D: Sqrt((1/π)*Area Unscaled)


§ Formula 3D: 0.5*Pow(6*Volume Unscaled/π, 1/3)
§ Unit: pixels

6.1.17.126 Region Class Color

Returns the color of the class to which the object is assigned.

6.1.17.127 Region Class ID

Returns the ID of the region class which is assigned to the object according to the class tree.

6.1.17.128 Region Class Name

Returns the name of the region class to which the object is assigned and that was defined in the
Classes step of the wizard.

6.1.17.129 Region Class Name Parent

Returns the name of the parent class to which the object is assigned and that was defined in the
Classes step of the wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 469


6 General Toolkits | 6.1 Image Analysis ZEISS

6.1.17.130 Roundness

Calculates a value for the roundness (between 0 and 1) of the region based on the Area and the
Feret Maximum (FeretMax) features. In case of a three dimensional analysis, the roundness value
is calculated based on the Volume feature of the region.

§ Formula 2D: 4*Area/(π*FeretMax2)


§ Formula 3D: 6*Volume/(π*FeretMax3)

6.1.17.131 Sphericity

Calculates and returns the value for sphericity of a region.


Formula: 6*Sqrt(π)*Volume/(SurfaceArea*Sqrt(SurfaceArea))

6.1.17.132 Surface Area

Calculates the surface area of a region excluding any holes it may contain. The areas of the holes
are not included in the measurement. If you want to include them, use the Surface Area Filled
feature.

§ Unit: Based on the unit of the scaling assigned to the image (e.g. μm2)

6.1.17.133 Surface Area Filled

Calculates the surface area of a region including any holes it contains. The holes are interpreted as
if they belong to the region or are filled prior to the measurement. If you do not want the holes to
be measured, use the Surface Area feature.

§ Unit: Based on the unit of the scaling assigned to the image (e.g. μm2)

6.1.17.134 Surface Area Filled Unscaled

Calculates the surface area of an unscaled region including any holes it contains. The holes are in-
terpreted as if they belong to the region or are filled prior to the measurement. If you do not
want the holes to be measured, use the Surface Area Unscaled feature.

§ Unit: pixels2

6.1.17.135 Surface Area Unscaled

Calculates the surface area of an unscaled region excluding any holes it may contain. The areas of
the holes are not included in the measurement. If you want to include them, use the Surface
Area Filled Unscaled feature.

§ Unit: pixels2

6.1.17.136 Total Area Direct Subclasses

Area of all regions of the direct subclasses.


Note that this feature only considers values of direct subclasses of a class, i.e. subclasses that are
directly on the next lower hierarchy level in the class list. Values of subclasses on lower hierarchy
levels ("subclass of a subclass") are not considered.

§ Unit: Unit of area of the scaling assigned to the image (e.g. μm²)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 470


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.1.17.137 Total Area Direct Subclasses Percentage

The area of all regions of the direct subclasses in relation to the area of the "parent" class, i.e. the
area of all regions of the subclass divided by the area of the "parent" class.
Note that this feature only considers values of direct subclasses of a class, i.e. subclasses that are
directly on the next lower hierarchy level in the class list. Values of subclasses on lower hierarchy
levels ("subclass of a subclass") are not considered.

6.1.17.138 Total Area Direct Subclasses Unscaled

Unscaled area of all regions of the subclasses.


Note that this feature only considers values of direct subclasses of a class, i.e. subclasses that are
directly on the next lower hierarchy level in the class list. Values of subclasses on lower hierarchy
levels ("subclass of a subclass") are not considered.

§ Unit: pixels

6.1.17.139 Volume

Calculates the volume of a region.

§ Unit: Based on the unit of the scaling assigned to the image (e.g. μm3)

6.1.17.140 Volume Frame

Calculates the volume of the measurement frame used in the image. If a ROI is defined in the
Frame step of the wizard, this area is displayed, otherwise the volume of the entire image area is
returned.

§ Unit: Based on the unit of the scaling assigned to the image (e.g. μm3)

6.1.17.141 Volume Frame Unscaled

Calculates the unscaled volume of the measurement frame used in the image. If a ROI is defined
in the Frame step of the wizard, this area is displayed, otherwise the volume of the entire image
area is returned.

§ Unit: pixels3

6.1.17.142 Volume Percentage

Calculates the percentage of the volume of the regions according to the frame volume.

6.1.17.143 Volume Unscaled

Calculates the volume of an unscaled region.

§ Unit: pixels3

6.2 Advanced Processing

This module provides the following additional processing functions:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 471


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.2.1 Edges

6.2.1.1 Gradient Max

This method performs a gradient filtering. Based on the sum of a 2 x 2 matrix in the X-and Y-di-
rection, a gradient image is calculated and using the larger of the two components. The edges are
darker than that of the method Gradient Sum.

6.2.1.2 Gradient Sum

This method performs a gradient filtering. Based on the sum of a 2 x 2 matrix in the X-and Y-di-
rection, a gradient image is calculated. The edges are brighter than that of the method Gradient
Max.

6.2.1.3 Highpass

This method performs high-pass filtering. The high pass filter is defined as the difference between
the original image and the low-pass filtered original.

Parameter Description
Normalization Depending on the image processing function you have selected not
all choices are available in the list.

- Clip Gray levels that exceed or fall below the specified gray value range
are automatically set to the lowest/highest gray value (black or white).
The effect corresponds to underexposure or overexposure. This means
that in some cases information is lost.

- Automatic Automatic normalization of gray values to the available gray value


range.

- Wrap If the result is greater than the maximum gray value of the image, the
value maximum gray value +1 is subtracted from it.

- Shift Normalizes the output to the value gray value + max. gray value/2.

- Absolute Values are used positive only.

Count Here you set the number of repetitions. I.e. the number of times the
function is applied sequentially to the respective result of the filtering.
The effect is increased correspondingly.

Kernel Size You can set the filter size in the x-, y- and z-direction, symmetrically
around the subject pixel. This should be the size of the transition re-
gion between objects and background match.

6.2.1.4 Laplace

This function performs a Laplace highpass filter on an image.


The calculation is based on a 3 x 3 x 3 Laplace operator in all directions. The function does not
show smooth gray value changes very well.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 472


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.2.1.5 Local variance

This method is an edge filter, which calculates the variance of each pixel with its neighboring pix-
els by the lateral filter size.

Parameter
Kernel Size in X/Y
Here you set the matrix size in XY symmetrically around the pixel. This determines the degree of
smoothing effect in the X/Y direction.

6.2.1.6 Roberts

This method calculates a gradient image using the Roberts filter matrix. Large gray value differ-
ences between neighbors are shown as light gray values​​. No changes are indicated by a value of 0
(black). Edges are thinner than with the Sobel method.

6.2.1.7 Sobel

Sobel calculates a gradient image using a Sobel filter.


This method indicates gray value changes in the image. Large differences between neighbors are
displayed as bright gray values, no changes are indicated by a value of 0 (zero). The pixels in the
output image are calculated with the Sobel differential operator on the basis of a 3 x 3 x 3 fold of
the input image.

6.2.2 Arithmetics

6.2.2.1 Add

This function adds the two images Input1 and Input2 pixel by pixel and generates the Output
image. Note that a resulting gray value may be greater than the maximum gray value of the im-
age.

Parameter

Parameter Description
Normalization Depending on the IP function you have selected not all choices are
available in the list.

- Automatic Automatic normalization of gray values to the available gray value


range.

- Clip Automatically sets the gray levels that exceed or fall below the speci-
fied gray value range to the lowest/highest gray value (black or
white). The effect corresponds to underexposure or overexposure.
This means that in some cases information is lost.

- Shift Normalizes the output to the value gray value + max. gray value/2.

- Wrap If the result is greater than the maximum gray value of the image, the
value maximum gray value +1 is subtracted from it.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 473


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.2.2.2 Add Constant

This function adds the factor Addend to each pixel of the Input image and generates the Output
image.
To work useful with this function, the pixel values of the input image must be in float format. If
images of type 8 bit, 16 bit, 24 bit and 48 bit are used as input image, the output images are of
the same type, i.e. the output value will be clipped to an integer value. Negative values are set to
0, values higher than the maximum gray value are set to the maximum possible gray value of the
image.

Parameter

Parameter Description
Addend Here you adjust the addend.

6.2.2.3 Average

The function calculates the average of the two images Input1 and Input2 pixel by pixel and gen-
erates the Output image.

6.2.2.4 Combine

This function calculates the linear combination of two images on a pixel basis.
Both Input images are first multiplied by the specified factor and then added together. The
brightness of the Output image can then be adjusted. The combination of two images can be
used to reduce noise, for example. This is achieved by acquiring several images of the same scene
and subsequently combining them.

Parameters

Parameter Description
Factor 1 Weighting factor for input image 1.
Value range: -1,00 ... +1,00

Factor 2 Weighting factor for input image 2.


Value range: -1,00 ... +1,00

Offset Offset between input images 1 and 2.

6.2.2.5 Divide

This function divides the images Input1 by Input2 pixel by pixel and generates the Output im-
age.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 474


6 General Toolkits | 6.2 Advanced Processing ZEISS

Parameter

Parameter Description
Factor Here you adjust the scaling factor by which the result of the division is
multiplied. Using this factor it is possible to keep the gray values of
the output image within the range of 0 to the maximum gray value.
Values that are greater than the maximum gray value are in any case
limited to the maximum gray value. Negative values are set to 0.
Value range: -20.000 ... +20.000

6.2.2.6 Exponential

This function calculates the exponential function of the Input image pixel by pixel and generates
the Output image.
To work useful with this function, the pixel values of the input image must be in float format. If
images of type 8 bit, 16 bit, 24 bit and 48 bit are used as input image, the output images are of
the same type, i.e. the output value will be clipped to an integer value. Negative values are set to
0, values higher than the maximum gray value are set to the maximum possible gray value of the
image.

6.2.2.7 Invert

This function additively inverts the gray values of the input image into the output image. Bright
pixels will become darker and vice versa. To adjust the output range the parameter Operand is
used. The actual mathematical operation is then: output-gray value = constant - input-gray value.
Negative results are clipped to 0 and overflow results are clipped to the maximum possible gray
value.

6.2.2.8 Logarithm

This function calculates the logarithm of the Input image pixel by pixel and generates the Output
image.
To work useful with this function, the pixel values of the input image must be in float format. If
images of type 8 bit, 16 bit, 24 bit and 48 bit are used as input image, the output images are of
the same type, i.e. the output value will be clipped to an integer value. Negative values are set to
0, values higher than the maximum gray value are set to the maximum possible gray value of the
image.

6.2.2.9 Maximum

The function calculates the maximum values of the two images Input1 and Input2 pixel by pixel.

6.2.2.10 Minimum

The function calculates the minimum values of the two images Input1 and Input2 pixel by pixel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 475


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.2.2.11 Multiply

This function multiplies the two images Input1 and Input2 pixel by pixel and generates the Out-
put image.

Parameter

Parameter Description
Factor Here you adjust the scaling factor by which the result of the multipli-
cation is divided. Using this factor it is possible to keep the gray values
of the Output image within the range of 0 to the maximum gray
value. Values that are greater than the maximum gray value are in any
case limited to the maximum gray value. Negative values are set to 0.
Value range: -20,000 ... +20,000

6.2.2.12 Multiply Constant

This function multiplies each pixel of the Input image with an adjustable Factor and generates
the Output image.
To work useful with this function, the pixel values of the input image must be in float format. If
images of type 8 bit, 16 bit, 24 bit and 48 bit are used as input image, the output images are of
the same type, i.e. the output value will be clipped to an integer value. Negative values are set to
0, values higher than the maximum gray value are set to the maximum possible gray value of the
image.

Parameter

Parameter Description
Factor Here you adjust the factor to be multiplied.

6.2.2.13 Reciprocal

This function computes the reciprocals of the gray values in the input image into the output im-
age. Bright pixels will become darker and vice versa. To adjust the output range the parameter
"factor" is used. The actual mathematical operation is then: output-gray value = factor/input-gray
value. Negative results are clipped to 0 and overflow results are clipped to the maximum possible
gray value.

6.2.2.14 Square

This function calculates the square of the Input image pixel by pixel and generates the Output
image.
To work useful with this function, the pixel values of the input image must be in float format. If
images of type 8 bit, 16 bit, 24 bit and 48 bit are used as input image, the output images are of
the same type, i.e. the output value will be clipped to an integer value. Negative values are set to
0, values higher than the maximum gray value are set to the maximum possible gray value of the
image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 476


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.2.2.15 Square Root

This function calculates the square root of the Input image pixel by pixel and generates the Out-
put image.
To work useful with this function, the pixel values of the input image must be in float format. If
images of type 8 bit, 16 bit, 24 bit and 48 bit are used as input image, the output images are of
the same type, i.e. the output value will be clipped to an integer value. Negative values are set to
0, values higher than the maximum gray value are set to the maximum possible gray value of the
image.

6.2.2.16 Subtract

This function subtracts the two images Input1 and Input2 pixel by pixel and generates the Out-
put image. Note that a resulting gray value may be less than 0.

Parameter

Parameter Description
Normalization Depending on the IP function you have selected not all choices are
available in the list.

- Automatic Automatic normalization of gray values to the available gray value


range.

- Clip Automatically sets the gray levels that exceed or fall below the speci-
fied gray value range to the lowest/highest gray value (black or
white). The effect corresponds to underexposure or overexposure.
This means that in some cases information is lost.

- Shift Normalizes the output to the value gray value + max. gray value/2.

- Wrap If the result is greater than the maximum gray value of the image, the
value maximum gray value +1 is subtracted from it.

6.2.3 Binary

6.2.3.1 And

This method performs a bit-by-bit AND calculation for the input images (Input1 and Input2). This
function is particularly useful for the masking of images. All the pixels that are white in input im-
age 1 AND input image 2 are set to white in the resulting image. Pixels that are white in only one
of the two input images become black.

6.2.3.2 Apply Mask

This tool enables you to isolate features in an image and to suppress image areas not of interest
using a mask image.

Parameter Description
Input The input image from which you wish to isolate features or suppress
areas not of interest.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 477


6 General Toolkits | 6.2 Advanced Processing ZEISS

Parameter Description
Mask The mask image that is applied to the input image.
The mask is laid on top of the input image. Image regions of the input
image in1 where the mask is white remain unchanged, image regions
where the mask is black are blacked out and suppressed.
Both images are aligned at the upper left corner. If the mask image is
smaller than the input image in1, the mask is applied only to part of
the input image, beginning at the upper left corner. The rest of the in-
put image remains unchanged.

6.2.3.3 Distance

This method creates a distance-transformed image (distance map, distance image) from a binary
image. The Euclidean distance to the next background pixel (gray value 0) is calculated for each
pixel within the white regions of the binary image (input image), and coded as a gray value. Bright
pixels (high gray values) indicate a long distance to the background.

6.2.3.4 Exoskeleton

This method generates an image with the skeleton of the influence zone of regions. The back-
ground in the Input image is analyzed, and the skeleton of the influence zones of the objects is
determined. This is then saved as a binary image in the Output image.

6.2.3.5 Fill Holes

This method fills holes in regions. Holes are structures that have the gray scale value 0, and is
completely surrounded by pixels with a gray value equal to 0. Of regions outside of the image, it
is assumed that they are black. Black areas that touch the edge of the image are preserved, there-
fore, even if they are surrounded by a contour.

6.2.3.6 Label Image

Assigns a gray value to each object in a binary image.

Parameters

Parameter Description
Label Background Activated: Assigns gray values to the background objects with con-
nectivity 4.
Deactivated: Assigns gray values to the background objects with
Connectivity 8.

6.2.3.7 Mark Regions

This function marks binary regions of the input image. For each region in the input image, a check
is performed to establish whether a pixel has been set in the marker image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 478


6 General Toolkits | 6.2 Advanced Processing ZEISS

Parameters

Parameter Description
Select Marked Activated: Copies the marked region into the output image.
Deactivated: Copies the unmarked region into the output image.

6.2.3.8 Not

This function performs a binary "not" operation on all bits of the binary representation of an input
pixel's gray value. A 0-bit in the input pixel results in an 1-bit in the corresponding output pixel, an
1-bit in the input gets a 0-bit in the output. For integral image types, the resulting output gray
value is the difference of the maximum possible gray value minus the input gray value, but for
float image type the results are strange due to the inhomogeneous float format.

6.2.3.9 Or

This method performs a bit-by-bit OR calculation for the Input1 and Input2 images. This function
can be used to combine binary masks or regions. All the pixels that are white in input image 1 OR
input image 2 are set to white in the resulting image. This means that all the white pixels in the
two input images are white in the resulting image.

6.2.3.10 Scrap

This method removes regions within a certain area.

Parameters

Parameter Description
Minimum Area Here you adjust the minimum area in Px.

Maximum Area Here you adjust the maximum area in Px.

Select in Range

6.2.3.11 Separation

Using this function you can attempt to separate objects that are touching (and that you have
been unable to separate using segmentation) automatically.

Parameters

Parameter Description
Separation Mode

- Morphology This method separates objects by first reducing and then enlarging
them, making sure that once objects have been separated they do not
merge together again.

- Watersheds With this method you can separate objects that are roughly the same
shape. This method may however result in the splitting of elongated
objects.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 479


6 General Toolkits | 6.2 Advanced Processing ZEISS

Parameter Description
Count Enter how often the method is applied successively to the result at the
location of the separation, using the slider or input field.

6.2.3.12 Thinning

This method thins objects to a line of single pixel thickness.

Parameters

Parameter Description
Thinning Element Select the desired thinning method here.

- Arcelli Applies thinning in accordance with the Arcelli method.

- Levialdi Applies thinning in accordance with the Levialdi method.

Count Sets the number of repetitions.


This means that the function is applied a number of times in succes-
sion to the filtering result. This increases the effect accordingly. The
value range is from 1...256.

Prune Cuts off the ends of the thinned lines.

Converge If activated, the function is automatically repeated until all regions will
be deleted by the next erosion step.

AxioVision Com- Performs the function exactly like in AxioVision to achieve identical re-
patibility sults.

6.2.3.13 Ultimate Erode

This function works in the same way as normal erosion. Structures in the input image are re-
duced. Thin connections between regions are separated. The difference between this function
and normal erosion is that structures are eroded until they would be deleted by the next erosion
step. With erosion, the pixel in question is set to the gray value 0 (black) in the resulting image.
For regions (pixels) at the image edge, the assumption is that the pixels outside the image are
white.

Parameters

Parameter Description
Structure Element Here you select the preferred direction of morphological change (e.g.
Cross, Diagonal).

Count Here you set the number of repetitions. This means that the function
is applied a number of times in succession to the filtering result. This
increases the effect accordingly.

Converge If activated, the function is automatically repeated until all regions will
be deleted by the next erosion step.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 480


6 General Toolkits | 6.2 Advanced Processing ZEISS

6.2.3.14 Xor

This method performs a bit-by-bit Xor calculation for the Input1 and Input2 images. This func-
tion can be used to combine binary masks or regions. All the pixels that are white in input image
1 or input image 2 are set to white in the resulting image. Pixels that are white in both input im-
ages are set to black.

6.2.4 Morphology

Morphology functions apply structure elements to images. A structure element is like a stencil
with holes. When the stencil is placed on an image then only some pixels are visible through the
holes. The gray values of these pixels are collected and their external gray value (minimum or
maximum) is computed.
This external gray value is assigned to that pixel of the resulting image which corresponds to the
place of the origin of the stencil on the input image. When the stencil is placed at all positions of
the input image, all pixels of the resulting image are thus assigned. When bigger structure ele-
ments are required than those which are provided, these can be achieved by iterating the small el-
ements using the Count parameter.
The following functions are available:

Function Description
Erode Shrinks bright structures on a darker background in the input image.
Thin connections between structures and small structures itself will
disappear.

Dilate Expands bright structures on a darker background in the input image.


Small gaps between structures are filled and those structures become
connected.

Open First erodes (Erode class) the bright structures on a darker background
in the input image, then it dilates (Dilate class) the result by the same
number of steps. Thus it separates bright structures on a darker back-
ground, but approximately keeps the size of the structures.

Close First dilates (Dilate class) the bright structures on a darker background
in the input image, then it erodes (Erode class) the result by the same
number of steps. Thus it connects bright structures on a darker back-
ground, but approximately keeps the size of the structures.

Top Hat (White) Computes the difference between the original image and the image
produced by an open operation (Open class). Bright structures which
were flattened by the opening are strengthened in the result. This is
like putting a top hat with the size of the open operation upon the
structure and keep only the part inside the hat.

Top Hat (Black) Computes the difference between the original image and the image
produced by a close operation (Close class). Dark structures which
were flattened by the closing are strengthened in the result. This is
like lifting a top hat with the size of the close operation beneath the
structure from the dark side and keep only the part inside the hat.

Gradient Computes the difference between the dilated image and the eroded
image (Dilate and Erode class). Since a point in the dilated image has
the maximum gray value and the corresponding point in the eroded

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 481


6 General Toolkits | 6.2 Advanced Processing ZEISS

Function Description
image has the minimum gray value within the structure element the
difference is zero for regions of constant gray values and gets bigger
for steeper gray value ramps or edges.

Watersheds Computes the barriers between catchment basins of local minima in


the gray valued input image. A local minimum is a connected plateau
of points from which it is impossible to reach a point of lower gray
value without first climbing up to higher gray values. A catchment
basin of a local minimum is a connected component which contains
that minimum and all downstream points to it. A downstream is a
path of points along which gray values are monotonically descending.
Thus all catchment basins of local minima are expanded until they col-
lide with another catchment basins. At those point barriers (water-
sheds) are built up. The output image is binary and contains all water-
sheds. If the "Basins" flag is set, the catchment basins themselves are
in the output image as uniquely labeled connected components with-
out any border lines.

Grey Reconstruc- Works mainly as an iterated dilation (Dilate class) of the image, but
tion with a constraint image as a second input image. After every dilation
step the pixel wise minimum of the dilated image and the constraint
image is computed and gives the next image to be dilated. The com-
putation stops automatically when all the just dilated pixels are bigger
than the corresponding ones in the constraint image.

Parameters

Parameter Description
Structure Element Here you select the desired structure element. Following elements are
available: Horizontal, Diagonal 45°, Vertical, Diagonal 135°, Cross,
Square, Octagon.

Count Here you can adjust the number of repetitions to define the size of
the structure element.

Binary Only available for Erode, Dilate, Open and Close function.
Activated: Creates a binary image. The calculation will be faster.

6.2.5 Smooth

6.2.5.1 Rank

This method performs a rank order filtering. The gray levels of the resulting image is determined
by calculating the ranking within the matrix of the filter size in the X and Y directions. Even num-
bers are automatically set to the next odd number. A low value for the rank value enlarges dark
areas, a higher value will increase bright areas of the image.

6.2.6 Utilities

6.2.6.1 Combine HLS

With this method a HLS image can be generated of the single color extractions H, L, S.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 482


6 General Toolkits | 6.3 Intellesis ZEISS

6.2.6.2 Impose Noise

This function imposes an image with a defined noise for testing purposes.

Parameter Description
Signal to Noise Ra- Adjusts the signal to noise ratio.
tio Range 0.10 - 100.00.

Distribution

- Poisson Imposes a Poisson distributed noise.

- Gauss Imposes a Gauss distributed noise.

6.2.6.3 Split into HLS

This method generates the individual color extractions for a HLS input image. The resulting images
for hue, lightness and saturation take the form of gray images.

6.3 Intellesis

This module enables you to use machine-learning algorithms for segmenting images using pixel-
classification. It uses different feature extractors to classify pixels inside an image based on the
training data and the labeling provided by the user. There are a variety of use cases because the
functionality itself is "data-agnostic", meaning it can be used basically with every kind of image
data.
The extension has the following main functionality:

§ Any user can intuitively perform image segmentation without advanced training by simply la-
beling what shall be segmented.
§ Import of any image format readable by the software, incl. CZI, OME-TIFF, TIFF, JPG, PNG
and TXM (special import required).
§ Creation of pre-defined image analysis settings (*.czias) using machine-learning based seg-
mentation that can be used inside the ZEN measurement framework.
§ Integration of the Trainable Segmentation processing function within the OAD environment.
Application XRM (X-Ray Microscopy) image from sandstone showing the main steps when working with the
Example: Intellesis Trainable Segmentation module.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 483


6 General Toolkits | 6.3 Intellesis ZEISS

1 Original Image 2 Labeled Image

3 Overlay of Original Image and Segmentation 4 Segmented Image


Result
Application Cells image with Phase Gradient Contrast on the Celldiscoverer 7 and segmented using Intellesis
Example: Trainable Segmentation.

1 Original Image 2 Labeled Image

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 484


6 General Toolkits | 6.3 Intellesis ZEISS

3 Overlay of Original Image and Segmentation 4 Segmented Image


Result
Note:
The training of Intellesis models is CPU/GPU specific. A model trained on GPU only runs on a GPU
machine. If a model trained on GPU is transferred to a CPU-only machine, the model has to be re-
trained to run on this machine.

6.3.1 Fact Sheet

§ Simple User Interface for Labelling and Training


§ Integration into ZEN Measurement Framework
§ Support for multi-dimensional datasets
§ Machine-Learning Tool for Pixel Classification powered by Python
– Scikit-Learn
– Tensorflow
– Dask
§ Client/Server Architecture with REST-API
§ Engineered Default Feature Sets (CPU)
– 25 or 33 Features
§ Neural Network (vgg19) Layers for Feature Extraction (GPU)
– 64, 128 (red. 50) or 256 (red. 70) Features for 1st, 2nd or 3rd layer
§ Random Forest Classifier for Pixel Classification (CPU)
§ Option to download pre-trained DNNs (Deep neural Networks) for specific sample types (sub-
ject of change)
§ Post Processing: Conditional Random Field (CRF)
§ IP-Functions for creating masks and confidence maps
§ Python Scripting Integration able for advanced automation
§ SW Trial License available

6.3.2 FAQ/Terminology

Question/Term Description
Machine Learning The Intellesis Trainable Segmentation module uses machine learn-
ing to automatically identify objects within an image according to a
pre-defined set of rules (the model). This enables any microscopy user

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 485


6 General Toolkits | 6.3 Intellesis ZEISS

Question/Term Description
to perform image segmentation even on complex data sets without
programming experience or advanced knowledge on how to set up
an image segmentation.

What is a "Model" ? A model is a collection of rules according to which the software at-
tributes the pixels to a class. Such a class is mutually exclusive for a
given pixel, i.e. a pixel can only belong to one class. The model is the
result of (repeated) labeling and training a subset of the data. After
the model is trained (the labels provided by the user were used to
"train" the classifier), it can be applied to the full data set in image
processing, or it can be used to create an image analysis setting
(*.czias) to be used with the ZEN image analysis module.
In image processing the trained model can be applied to an image or
data set and perform segmentation automatically. As result you will
get two images, the segmented image on the one hand and a confi-
dence map on the other.

What is a "Class" ? A class is a group of objects (consisting of individual pixels) with simi-
lar features. According to the selected model the pixels of the image
will be attributed as belonging to a certain class, e.g. cell nuclei, inclu-
sions in metals, etc.
Every model has by default already two classes built-in, because at
least two classes are needed (e.g. cells and background or steel and
inclusions). Of course, more classes can be defined if necessary.

What is "Labeling" ? Instead of using a series of complex image processing steps in order
to extract the features of the image, you just need to label some ob-
jects in the image that belong to the same class. Based on this manual
labeling the software will attribute the pixels of the image as belong-
ing to a certain class. In order to refine the result, you can re-label
wrongly attributed pixels to assign them to another class.

What is "Training" ? During the training process (within the training user interface) you can
repeatedly label structures as belonging to one class, run the training,
check if the result matches your expectation and if necessary, refine
the labeling in order to improve the result. The result is a trained
model (a set of rules) which produce the desired result when applied
to the training data.
With the labeled pixels and their classes a classifier will be trained. The
classifier will then try to automatically assign single pixels to classes.

Training UI The user interface for training is the starting point of the automatic
(User Interface) image segmentation process. Here you import images, label, and train
the model which you can later use for automatic image segmentation.
Within this interface you can load the training data, define the classes
of objects found in your data and train the classifier to assign the ob-
jects to the correct classes.

What is "Segment- In general segmentation is the combination of pixels of the same class
ing" or "Segmenta- within an image. Before you can perform segmentation, the segmen-
tion"? tation model has to be trained. Within the Training UI you train the
software by labeling specific objects or structures that belong to dif-
ferent classes. A pseudo-segmentation is performed each time you
train the model so that you see if the feature extractor works for your
image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 486


6 General Toolkits | 6.3 Intellesis ZEISS

Question/Term Description
One output of the Intellesis Trainable Segmentation processing
function is the fully segmented image or data set using the trained
model. The second output is the confidence map.

Confidence Map The confidence map is one of two resulting images when you apply a
trained model to an image by using the processing function Intellesis
Trainable Segmentation.
The (resulting) grayscale image encodes the reliability of the segmen-
tation. Areas which can be addressed to a certain class with a high
confidence will appear bright, whereas areas which have a lower con-
fidence to belong to a certain class will appear dark. The confidence is
represented by a percentage value, where 0 means "Not confident at
all" (dark) and 100 "Very confident" (bright).

What is a "Feature"? A feature is a specific property of an image, which will be calculated


by using a pre-defined set of filters and processing functions. This
process results a so-called "Feature Vector" for every pixel. This is the
information that will be used for training the model.

What is a "Feature A feature extractor is a pre-defined set of processing functions that is


Extractor"? used to create the feature vector for every pixel. A specific layer of a
pre-trained neuronal network can be used as feature extractor as
well.

Prediction When the model that was trained on example data is applied to a
new unlabeled data set the result is called a prediction.

Multi-Channel Im- The Intellesis Trainable Segmentation module supports multi-


ages channel data sets. It is important to understand that in case of multi-
channel images every pixel can still only belong to one class, i. e. the
classes are mutually exclusive.
The additional information of having more than one intensity value
per pixel (e.g. one for every channel) is also used for classification.
Example: If you have overlapping regions A and B in the image you
want to classify, consider labeling three independent classes:
§ Class 1: A
§ Class 2: B
§ Class 3: A overlapping with B

If you want to segment an individual channel from a multi-channel


image, use the Create Subset IP function first to extract the desired
channel.

6.3.3 Operating Concept

The operating concept can generally be split in three parts:

The Training User Interface which is accessed via the Intellesis Train-
able Segmentation tool on Analysis tab. Within the training user inter-
face you can label the images to be used as input for training a specific
model, see User Interface - Training [} 489].

Training

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 487


6 General Toolkits | 6.3 Intellesis ZEISS

The Image Processing (IP) function Intellesis Trainable Segmenta-


tion, which can be used to segment images resulting in binary masks.
Those masks can be used in subsequent ZEN workflows, such as 2D or
3D analytics or they can be exported for further use in external 3rd party
software packages. You will find more details under Using a Trained
Model for Image Processing [} 501].
Processing
The automatic creation of Image Analysis (IA) settings (*.czias), which
allows to use a trained model for automated segmentation and mea-
surement of image data within the ZEN Image Analysis Wizard. To fa-
miliarize with the basic steps take a look at our step-by-step guide in the
chapter Using a Trained Model for Image Analysis [} 502].
Analyzing

6.3.4 Workflow Overview

ZEN Intellesis Trainable Segmentation offers three main workflows. The general workflows
and the basic steps involved are shown inside the diagram.

§ Labeling and Training your images -> results in a Trained Model.


§ Using the Trained Model to segment images -> results in Binary Masks.
§ Using the Trained Model for image analysis -> results in classified pixel for subsequent seg-
mentation and measurements of objects.

Fig. 24: Process description of the Intellesis workflow

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 488


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.5 User Interface - Training

The Training user interface is accessed via the Analysis tab. Open the Intellesis Trainable Seg-
mentation tool, select or create a new a model and click on Start Image Training. The user in-
terface for training will be visible:
1 2 3

Fig. 25: User Interface for Training


1 Labeling and Training Settings
On the left side you find elements for managing the classes. You can add and delete
classes and select them for labeling an image.
You can change the label opacity and the segmentation opacity by adjusting the corre-
sponding slider. Opacity determines to what degree it obscures or reveals labels or seg-
mentations. Opacity of 1% appears nearly transparent, whereas 100% opacity appears
completely opaque. Additionally, you can hide all segmented pixels where the confidence
value is below a certain threshold set by the Min. Confidence (%) slider.
With the different parameters of the Segmentation options and the Postprocessing
options it is possible to further improve the results of the training and the (pseudo-)seg-
mentation. The Train & Segment button starts the automatic training algorithm and
then performs the pseudo-segmentation of the defined classes in the image.

2 Center Screen Area


This area shows the sample image. You can directly start labeling the classes within the
image.
When you are inside the image, the actual brush size for labeling is represented by a
square. If the brush size is very small, the square is changed into a dotted circle with a
small point inside.

3 Image Gallery
On the right side you can import and select the images you want to use for training and
segmenting.

4 Labeling Options
Below the center screen area you can adjust the Labeling Mode or Brush Size.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 489


6 General Toolkits | 6.3 Intellesis ZEISS

Info
When you use images with large X/Y dimensions, e.g. large tile images, the segmentation will
be only performed on a subset of the whole image in order to avoid long waiting periods. The
current image subset maximum size in X/Y is 5000 pixels and is centered on the current view
port. Nevertheless, all labels inside the complete image will be used for training, but the seg-
mentation preview (pseudo-segmentation) will be only applied to that subset.

6.3.5.1 Segmentation Options

Selects the set of feature extractors used for segmentation. For more information, see Feature Ex-
tractors [} 506].

Parameter Description
Basic Features 25 A predefined feature set using 25 features. For more detailed informa-
tion, see Basic Features 25 [} 506].

Basic Features 33 A predefined feature set using 33 features. For more detailed informa-
tion, see Basic Features 33 [} 507].

Deep Features 50 The complete or reduced feature set from either the 1st, 2nd or 3rd
layer of a pre-trained network is used to extract the respective num-
Deep Features 64
ber of features. For more detailed information, see Intellesis Deep
Deep Features 70 Features [} 508].
Deep Features 128
Deep Features 256

For the selection of the parameters note the following:

§ There is no "right" selection. We recommend to always try different parameters for the same
image to see which one works best.

6.3.5.2 Postprocessing Options

Parameter Description
No Postprocessing This parameter is set by default. No further postprocessing will be ap-
plied on the images.

Conditional Ran- If selected, this post processing function is applied to the output of
dom Field (CRF) the pixel classification. This can improve the segmentation results, de-
pending on your sample. The CRF algorithm tries to create smoother
and shaper borders between objects by re-classifying pixels based on
confidence levels in their neighborhood.
Note: If CRF is activated, the returned confidence map does not re-
flect the outcome of the majority votes of all decision trees of a spe-
cific class anymore. Therefore, a map containing only ones will be re-
turned when the CRF postprocessing option is activated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 490


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.5.3 Labeling Options

Parameter Description
Undo/Redo When you click on the arrows you can undo/redo the last actions you
have performed.

Labeling Mode Here you can select between labeling and erase mode.

Brush Size Here you can set the brush size of the labeling/erasing tool.
Note that the brush size can be changed alternatively by pressing the
Ctrl key and using the mouse wheel (when the cursor is inside the im-
age area.)

All Labels When you click on Clear, all labels in the active image will be deleted.

6.3.5.4 Image Gallery

In the right tool area under Images & Documents you find the area for handling the images to
be used for training. Here you can load and select the images you want to use for training. When
you click on a loaded image, the image will be visible in the Center Screen Area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 491


6 General Toolkits | 6.3 Intellesis ZEISS

Fig. 26: Image Gallery with additional info


In the list of images you have certain possibilities to gain advanced information about the image.
If you load a new image only the preview image, file name and type of image are displayed.
When you have started to label an image of a larger data set, a small arrow appears on the left
side of the preview image. If you click on the arrow, a list of the images that contain labels will be
displayed, containing dimension and image number (e.g. for a Z-stack, Z:400 indicates that the
slice number 400 contains labels).
If you click on this information the corresponding image will be automatically displayed in the
center screen area. This is very helpful when you are working with large data sets such as z-
stacks, scenes or time-series and you want to quickly load the image which you have already la-
beled.

6.3.5.5 Select Channel Dialog

This dialog is only displayed if a multi-channel image is imported.

Parameter Description
Training Mode Here you can select the mode for training.

– Single Channel Only one channel of the image is imported for training.
Such models trained on one channel can only be used inside the Im-
age Analysis Wizard for the Intellesis Class Segmenter.

– Multispectral All channels of the image are imported for training.

Select Channel Only visible if Single Channel is chosen as the training mode.
In the dropdown list you can choose the channel you want to import
for training.

OK Confirms the settings and imports the image accordingly.

Cancel Cancels the image import and closes the dialog.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 492


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.6 Intellesis Models

6.3.6.1 Creating a New Model

Info
For a good training result always note the following:
4 The more accurate you perform the labeling the better the result will be. You can start
with a coarse labeling and then check the result for problematic areas where you should
refine the labeling.
4 Accurate labeling is generally preferred over "just labeling everything" roughly.
4 Take care to also label some areas which contain edges of objects and transitions between
two classes.
4 Really use an iterative approach: check the segmentation/training results before labeling
huge amounts of pixels.

Prerequisite ü You have completed the general preparations.

1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click and se-
lect New.
2. Enter a name and a description for the new model and click
3. Click Start Training.
à The user interface for training opens.
4. In the Right Tool Area under Open Images click Import Images.
5. Select the image for training from the file system and click Open.
à The image is displayed in the list. Note that all imported images will be included in your
training model.
6. Select the image from the list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 493


6 General Toolkits | 6.3 Intellesis ZEISS

à The image is displayed in the Center Screen Area. Note that on a later stage you can
add more images via Import Images to refine the training.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 494


6 General Toolkits | 6.3 Intellesis ZEISS

7. Go to the Left Tool Area and define the classes. Depending on your image and what you
want to segment, you can define a certain amount of classes. When you start with a new
model you always have two predefined classes Object and Background. If you click on
Add Class a new class is added. You can rename these classes by a double-click and enter-
ing a new name. Note that you must not use the name Root for one of your classes as this
a reserved keyword from the image analysis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 495


6 General Toolkits | 6.3 Intellesis ZEISS

8. Move the courser inside the image and start labeling the areas which you want to assign to
the selected class. To label within the image simply hold down the left mouse key and
move the mouse.

9. After labeling a few areas with different classes, click Train & Segment.
à The software starts the training. The system tries to automatically recognize other areas
of the same classes. Depending on the image, the pixel classification can take a while.
When finished the image has the additional channel Seg (menation) containing the seg-
mentation preview.
10. If you are not satisfied with the result, you can label more details of the corresponding
classes. For this you can zoom into the image or change the brush size of the courser. The
more accurate you label the different classes within the image, the better the recognition
will be. When you finished the labeling, you have to click on Train & Segment again. You
can repeat that process until you are satisfied with the segmentation result.
Note that at this point as a result you will only see a pseudo segmented image and only the
area visible in the main window is segmented (max. area 5000x5000 px). The full segmen-
tation of an image/data set is performed on the Processing tab by using the trained model
within the Trainable Segmentation processing function.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 496


6 General Toolkits | 6.3 Intellesis ZEISS

Fig. 27: Trained model with refined labeling and pseudo segmentation results

6.3.6.2 Importing Models

Prerequisite ü You have completed the general preparations.


ü You have a trained model or a pre-trained neural network available for import.
ü You are on the Analysis tab.

1. In the Intellesis Trainable Segmentation tool, click and select Import.

2. In the file browser, select the model file or your network from the file system. The network
can also be imported by selecting the respective JSON file.
3. Click Open.
à The model will now be available in the dropdown list.
4. Select the model and click Start Training to work with the model, e.g. if you want to train
more details.
If you want to use the model for image processing switch to the Processing tab. In the
Trainable Segmentation processing function you can select the imported model and ap-
ply it to the desired images/data sets.

See also
2 Using a Trained Model for Image Processing [} 501]
2 Using a Trained Model for Image Analysis [} 502]

6.3.6.3 Exporting a Model

Prerequisite ü You have created and selected a model for advanced image segmentation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 497


6 General Toolkits | 6.3 Intellesis ZEISS

1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click and se-
lect Export.
If you want to export the full model containing all images select Export with Images (see
also Exporting with Images [} 498]).
2. Select the file location and click Save.
The model with the trained segmenting routine is exported. Note that only the model file itself is
exported. Such a model is meant to be used for segmentation purposes or to create an image
analysis setting, but not for the training process.

6.3.6.4 Exporting with Images

Prerequisite ü You have selected a trained model with images.

1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click and se-
lect Export With Images.
à The file explorer opens.
2. Navigate to the folder where you want to store the training model and click Save.
The model with the trained segmenting routine and all images used for training are exported.

6.3.6.5 Renaming a Model

Prerequisite ü You have selected a training model.


1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click on Options
and select Rename.
à The Model field is editable.
2. Enter a new name for the model and save it.

6.3.6.6 Cloning a Model

Prerequisite ü You have selected a training model.


1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click on Options
and select Clone.
à The name of the currently loaded model disappears and the Model field is editable.
2. Enter a new name for the model and save it.
You have cloned an existing model.

6.3.6.7 Creating Analysis Setting

1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click on Options
and select Create Analysis Setting.
à The file browser opens with the default location for image analysis settings.
2. If you want to change the location, select a new path for saving the setting.
3. Click on Save.
You have now created and saved an image analysis setting.
For more information, see also Using a Trained Model for Image Analysis [} 502].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 498


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.6.8 Deleting a Model

Prerequisite ü You have selected a training model.

1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, click Options
and select Delete.
à The Deleting Model dialog opens.
2. Click on Yes to confirm that you want to delete the model.
You have deleted the model. The model you worked with before is selected.

6.3.7 Editing Classes

1. To add a new class to the Classes list, click Add Class.


à The classes have a random color by default.

2. To change the color of a class, select the class and click on the colored rectangle next to
Color.
à You see the Color Selection dialog.
3. Select a new color from the list.
4. To change the opacity of the labels within the image, adjust the Opacity slider.
5. To rename a class double click on the class entry and enter a new name. Press Enter or
click the Save icon to save the new name. Note that you must not use the name Root for
one of your classes as this a reserved keyword from the image analysis.
6. To delete the selected class, click Delete Class.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 499


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.8 Importing Labels from Binary Mask

With this class specific function you can import binary images from an external source as labels
for the current selected class. This is helpful when the "ground truth" for a specific image is avail-
able or when you want to use an image obtained by a different modality.

Info
Be aware that this function overwrites existing labels for this class and that this functionality
can possibly create a huge number of labels that might lead to memory issues depending on
the system configuration and the selected feature extractor.

Prerequisite ü The label image to be imported has exactly the same dimension in XY as the currently se-
lected training image.
ü You have opened the Intellesis Trainable Segmentation Wizard. For more information, see
Creating a New Model [} 493].
1. Right-click a class and select Import Labels from Binary Mask.
à The Explorer opens.
2. Navigate to the label image you want to import, and click Open.
The imported image is displayed in the Image view. The displayed labels have the color of the se-
lected class and fit exactly with the class of the loaded image.

6.3.9 Converting Segmentations to Labels

With this function you can convert the result of a segmentation directly to labels and thereby in-
crease the number of labels for the next training step.

Prerequisite ü You have opened the Training user interface. For more information, see Creating a New
Model [} 493].
ü You have performed a segmentation.
1. Right-click a class and select Segmentation to Labels.
The segmentations are converted to labels.

6.3.10 Using Neural Networks for Intellesis

In ZEN you can use pre-trained neural networks as models for image segmentation. You can use
networks provided by Zeiss or load your own networks. Each network has to be imported to ZEN
via the Intellesis Trainable Segmentation tool as a model. For more information, see Importing
Models [} 497].
After the import the network can be used as a normal segmentation model for the following
workflows:

§ Segment single channel images using the respective image processing function, see also Us-
ing a Trained Model for Image Processing [} 501].
§ Create an image analysis setting based on the network (no hierarchy), see also Using a
Trained Model for Image Analysis [} 502].
§ segment a specific class in the Automatic Segmentation [} 944] step of the Image Analysis
Wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 500


6 General Toolkits | 6.3 Intellesis ZEISS

Using networks provided by Zeiss


Zeiss provides some pre-trained networks for you to use (subject to change without notice). These
networks are available for download on the ZEISS GitHub page for Open Application Develop-
ment (OAD) and can be found inside the Machine-Learning section.
Note: These networks are copyright protected!
Condition of Use
These pre-trained networks were trained with "best-effort" on the available training data and is
provided "as is" without warranty of any kind. The licensor assumes no responsibility for the func-
tionality and fault-free condition of the pre-trained network under conditions which are not in the
described scope. Be aware that no pre-trained network will perform equally good on any sample,
especially not on samples it was not trained for. Therefore, use such pre-trained networks at your
own risk and it is up to the user to evaluate and decide if the obtained segmentation results are
valid for the images currently segmented using such a network. By downloading you agree to the
above terms.
Detailed Information about pre-trained DNNs
Such networks are specific for the application they have been trained for. Detailed information
can be provided on demand.

Using your own networks


You can also train and use your own networks. To be able to use your own networks in ZEN, your
networks have to fulfill certain specifications detailed in the ANN Model Specification.
Additional information about ZEISS machine learning, including an example of how to train a
model and convert it into a czmodel can be found in this Readme on GitHub. It also explains the
usage of the PyPi package which is free to use for everybody.

6.3.11 Using a Trained Model for Image Processing

Prerequisite ü You have a trained model available for automatic image segmentation.
ü You have opened the image which you want to segment under Images & Documents.
1. On the Processing tab under Method open the group Intellesis Trainable Segmenta-
tion and select the Segmentation entry.
2. Open the Method Parameters and select the trained model from the Model list. Note
that the model must be trained on images with similar features otherwise the segmentation
will not work properly.
3. Select the desired Output Format.
If you select Multi-Channel, the result will be a multi-channel image, where every class
that was defined in the trained model will be in their own channel. This output format can
be easily viewed inside the ZEN 3D view and can be combined with the original image
data easily.
If you select Labels, you will get an image with one channel, where the pixels belonging to
the different classes will be labeled with different colors and will be represented by distinct
pixel values.
4. Under Input Parameters select the image which you want to segment. Note that it must
be already opened in the ZEN software, otherwise it will not be available in the list.
5. Click on Apply.
à The automatic image segmentation using the trained model is performed.
à After a short while you will get two resulting images, depending on the output format:
- the multi-channel or labels image and
- the confidence map.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 501


6 General Toolkits | 6.3 Intellesis ZEISS

Fig. 28: The image shows (from left to right): original image, segmented image, confidence
map

See also
2 Segmentation [} 508]

6.3.12 Using a Trained Model for Image Analysis

Once having trained a model for segmentation you can use it also in the Image Analysis wizard
of the software for further analysis. In order to use the trained model, you must first create a new
image analysis (IA) setting (*.CZIAS format) first.

Prerequisite ü You are in the Trainable Segmentation tool.


1. Select the trained model of which you want to create an analysis setting.
2. Click on the Options and select Create Analysis Setting.
à The dialog for saving the setting opens. The setting will be saved as *.czias file in the ZEN
default folder for image analysis settings (usually under User/Documents/Carl Zeiss/
ZEN/Documents/Image Analysis Settings).
3. Click on Save.
4. Now change to the Image Analysis tool and select the setting from the dropdown-list.
Note that the setting will be only available in the dropdown list when you have used the
default folder for saving. Otherwise the setting must be loaded from the file system (spe-
cific location) via the Import option (see Importing Models [} 497]).
à The model will be loaded with its predefined classes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 502


6 General Toolkits | 6.3 Intellesis ZEISS

5. You can now continue with setting up an image analysis. For more information about the
Image Analysis Wizard, see Image Analysis Wizard [} 941].

à Sandstone Dataset segmented using Intellesis inside the Image Analysis Wizard show-
ing the actual segmentation step. Instead of conventional thresholds, the classifier will be
used to identify pixels.
à It is possible to allow only for pixel above a certain classification confidence (valid for all
classes) using the Min. Confidence (%) parameters.
à The binary functions Fill Holes and Separate will be only applied on the resulting binary
masks from the classification and are therefore independent from the actual classification
process.

à Sandstone Dataset segmented using Intellesis inside the Image Analysis Wizard show-
ing the measurement results for one particular class (shown in green).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 503


6 General Toolkits | 6.3 Intellesis ZEISS

à You can also use the IP function inside the ZEN Blue Batch Tool similar to all the other
functions to segment several images using different models at once in one run.

6.3.13 Changing the Tile Border Size for Neural Networks

Info
Undo Border Size Changes
There is no way to undo the change of the border size unless you remember the original value
and change it back with the same workflow described here.

Prerequisite ü You have imported a neural network, see Importing Models [} 497].
1. On the Analysis tab, in the Intellesis Trainable Segmentation tool, select the network
as your Model.
2. Click and select Change Border Size.
à The Change Border Size dialog opens.
3. Change the Border Size to fit your need. Note while increasing the border size reduces
segmentation artifacts in the output, it also decreases the tiling speed.
4. Click OK.
You have changed the border size for tiling. If there are still tiling artifacts with the maximum bor-
der size, consider retraining the model with larger tiles.

See also
2 Tile Border Size Example [} 510]

6.3.14 Using Intellesis within OAD

The Intellesis Trainable Segmentation module allows to use the Trainable Segmentation
processing function within the ZEN Open Application Development (OAD) environment.

Method/Command Description
Zen.Processing.Segmentation.TrainableSegmen- Function to segment an image using a
tation trained model.
(Input, Model, Output Format) The output result is an image.

§ Input ZenImage - Defines the input image to


be segmented.

§ Model ModelName - Defines the name of the


model.

§ Output Format: Function to segment an image using a


SegmentationFormat.MultiChannel trained model.
SegmentationFormat.Labels The output result is an array of images
containing the segmented image and
the confidence map.

Zen.Processing.Segmentation.TrainableSegmen- Addresses the Trainable Segmentation


tationWithConfidenceMap function including a confidence map.

§ Input ZenImage - Defines the input image to


be segmented.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 504


6 General Toolkits | 6.3 Intellesis ZEISS

Method/Command Description
§ Model ModelName - Defines the name of the
model.

§ Output Format: SegmentationFormat - Optional argu-


SegmentationFormat.MultiChannel ment; Defines the desired output for-
SegmentationFormat.Labels mat, e.g. Multi-Channel or Labels

Zen.Processing.Segmentation.MinimumConfi- Addresses the Minimum Confidence


dence function.

§ Input ZenImage - Defines the input image to


be segmented.

§ Model ZenImage - Confidence map containing


the confidence values in %.

§ Threshold Minimum Threshold – value in % - only


pixel inside mask >= this values will be
kept.

ZenIntellesis.GetAvailableFeatureSets() Returns all available feature sets as an


array of strings.

ZenIntellesis.GetAvailablePostProcessings() Returns all available post-processing op-


tions as an array of strings.

ZenIntellesis.ImportModel (modelfile, allowOver- Imports a model file into the model


write) repository and overwrites an existing
one, if the option was set to True. Re-
turns a ZenIntellesisModel.

§ modelfile File path to modelfile to be imported.

§ allowOverwrite Allows overwriting an existing model.

ZenIntellesis.ListAvailableSegmentationMod- Lists all available segmentation models.


els() Returns an array of ZenIntellesisModels.

6.3.15 Remarks and Additional Information

§ Segmentation performance in general depends among other factors on the system perfor-
mance, the available and free RAM and GPU memory.
§ Whenever using ZEN Intellesis Trainable Segmentation it is strongly recommend not
to use other memory- or GPU-intensive applications at the same time.
§ Deep Feature Extraction uses the GPU (NVIDIA only) if present on the system. It is recom-
mended to use an GPU with at least 8GB of RAM.
§ When installing the GPU libraries it is required to use the latest drivers which can be obtained
from the NVIDIA homepage (https://www.nvidia.com/Download/index.aspx?lang=en-us).
§ In case of using an approved ZEISS workstation, the latest drivers can be found on the in-
staller.
§ When using Deep Feature Extractor on a GPU system, Tensorflow will occupy only as much as
GPU RAM as needed to ensure system stability. When the segmentation is finished this GPU
memory is released automatically (with the current version).
§ Therefore, when starting another GPU-intensive application, for example GPU-DCV, the GPU
memory cannot be used by this new process and a CPU fallback will be used or performance
issues may occur.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 505


6 General Toolkits | 6.3 Intellesis ZEISS

§ In this case, restart ZEN to free all possible GPU memory and then start using GPU-DCV (or
similar applications).

6.3.16 Feature Extractors

6.3.16.1 Intellesis Basic Features

§ For calculating the features various filters with various filter sizes and parameters are applied
to the region around this pixel (2D Kernels).
§ Results are concatenated and yield the final feature vector describing the pixel.

6.3.16.1.1 Basic Features 25

Used Filters:

§ Gaussian filter (5 different sigma) = 5 feature dimensions


§ Sobel filter (5 sigma) = 5 feature dimension
§ Gabor filter (6 theta, 1 different sigma, 2 different frequencies) = 12 feature dimensions
§ Hessian filter (1 sigma) = 3 feature dimensions (one for derivative in direction xx, one for de-
rivative in direction xy and one for derivative in direction yy)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 506


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.16.1.2 Basic Features 33

Used Filters:

§ Gaussian filter (20 different sigma) = 20 feature dimensions


§ Sobel filter (1 sigma) = 1 feature dimension
§ Gabor filter (1 theta, 2 different sigma, 2 different frequencies) = 4 feature dimensions
§ Mean filter (5 different sizes) = 5 feature dimensions
§ Hessian filter (1 sigma) = 3 feature dimensions (one for derivative in direction xx, one for de-
rivative in direction xy and one for derivative in direction yy)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 507


6 General Toolkits | 6.3 Intellesis ZEISS

6.3.16.2 Intellesis Deep Features

§ Entire image as input for pre-trained network.


§ Note: If you use the CPU for segmentation with Deep Feature sets, the results can be differ-
ent on different machines because they are hardware (CPU) dependent.
§ Take the output from an intermediate layer of that network as feature vector, e.g. output
from layer 3 was processed by preceding layers 1 and 2.
– Deep Features 50: Using layer 2 with reduced feature dimension = 50
– Deep Features 64: Using layer 1 with full feature dimension = 64
– Deep Features 70: Using layer 3 with reduced feature dimension = 70
– Deep Features 128: Using layer 2 with full feature dimension = 128
– Deep Features 256: Using layer 3 with full feature dimension = 256

6.3.17 Image Processing Functions

6.3.17.1 Minimum Confidence

Parameter Description
Threshold slider Adjusts the minimum confidence level in %.

6.3.17.2 Segmentation

Using the Segmentation image processing function you can apply a trained segmentation model
to an image/data set.

Parameter Description
Model Select the trained model here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 508


6 General Toolkits | 6.3 Intellesis ZEISS

Parameter Description
Output Format When applying the Segmentation processing function to an image
you will always get two output images. The processed image and the
confidence map.
The following output formats for the processed image are available.

- Multi-Channel If selected, the output image will be a multi-channel image.


Each class which is defined within the model will result in a separate
channel.

- Labels If selected, the output image will be a single-channel image.

See also
2 Using a Trained Model for Image Processing [} 501]

6.3.17.3 Utilities

Here you can convert an output image generated with the Segmentation IP function according
to your needs:

Parameter Description
Labels to Channels Converts the resulting image with the output format "Labels" to a
multi-channel image.

Channels to Labels Converts the resulting image with the output format "Multi-Chan-
nel" to an image containing a single channel image with labels.
Under Parameters you can additionally adjust the Unlabeled Pixel
Value and the Output Pixel Type (8 Bit B/W or 16 Bit B/W).

6.3.18 Intellesis Trainable Segmentation Tool

Parameter Description
Model Shows the selected model. If you have several models available, you
can select the corresponding model from the drop-down list.

Options

– New Creates a new, empty model, see Creating a New Model [} 493].

– Rename Renames an existing model, see Renaming a Model [} 498].

– Clone Clones (duplicates) an existing model, see Cloning a Model [} 498].

– Create Analy- Creates and stores a *.czias file in the specific folder for image analysis
sis Setting settings, see Creating Analysis Setting [} 498]. The file can then be
used in the Analysis Wizard.

– Import Imports a model to the ZEN software, see Importing Models [} 497].

– Export Exports the model to the file system, see Exporting a Model [} 497].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 509


6 General Toolkits | 6.3 Intellesis ZEISS

Parameter Description
– Export With Exports the model including all images to the file system, see Export-
Images ing with Images [} 498].

– Delete Deletes an existing model, see Deleting a Model [} 499].

– Change Bor- Only available for neural networks.


der Size Opens a dialog to change the border size for the network, see Chang-
ing the Tile Border Size for Neural Networks [} 504].

Description Displays a description of the selected model.

Postprocessing Selects a postprocessing, see Postprocessing Options [} 490]

– No Postpro- No postprocessing will be applied on the images.


cessing

– Conditional If selected, this post processing function is applied to the output of


Random Field the pixel classification. The CRF algorithm tries to create smoother
and shaper borders between objects by re-classifying pixels based on
confidence levels in their neighborhood.
Note: If CRF is activated, the returned confidence map does not re-
flect the outcome of the majority votes of all decision trees of a spe-
cific class anymore. Therefore, a map containing only ones will be re-
turned when the CRF postprocessing option is activated.

Start Training Opens the Training UI, see User Interface - Training [} 489]

6.3.19 Change Border Size Dialog

Parameter Description
Total Tile Width Displays the total tile width used by the network.

Total Tile Height Displays the total tile height used by the network.

Border Size Sets the border size of the tiles. The lower limit of the border size is
zero and the upper limit is a quarter of the smallest dimension of the
tile.

Tile Overlap Displays the tile overlap which is the is the sum of the overlap on the
left and right side, see Tile Border Size Example [} 510]. It is updated
according to changes of the border size.

See also
2 Changing the Tile Border Size for Neural Networks [} 504]

6.3.19.1 Tile Border Size Example

The tile overlaps in % is the is the sum of the overlap on the left and right side. Consider the fol-
lowing two examples as illustration for the overlap:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 510


6 General Toolkits | 6.4 Intellesis Denoising ZEISS

Border Size of 10 % with a resulting overlap of 20 %

Border Size of 25 % with a resulting overlap of 50 %

6.4 Intellesis Denoising

This module allows you to train and use deep learning based models for the denoising of images.
This method can be applied to any type on image and any dimensions and it is not dedicated to a
special field of application. It should be used before applying processing functions that modify the
pixel values to that image.
Denoising is an operation to reduce noise in an image, in case of ZEN Intellesis Denoising with the
help of deep learning methods. In general, there are different ways to train a denoising model. In-
tellesis Denoising uses the approach called Noise2Void (N2V), which requires only a noisy input
image for the training of a model and can thus be trained directly on the data that should be de-
noised. To give a simplistic explanation, this N2V method replaces pixels by masked pixel data
randomly selected within a certain window/surrounding area. With this approach, the model is
then trained to reconstruct the original pixels and to discard the implicit noise in the image. For
detailed information on Noise2Void , see the paper "Noise2Void - Learning Denoising from Single
Noisy Images" written by Alexander Krull, Tim-Oliver Buchhol and Florian Jug, see also https://
arxiv.org/abs/1811.10980.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 511


6 General Toolkits | 6.4 Intellesis Denoising ZEISS

6.4.1 User Interface Training Intellesis Denoising

1 2 3

1 Denoising Parameters
Here you have the parameters to configure your denoising training, see Denoising Pa-
rameter Section [} 512].

2 Input Image
Displays the image that is selected in the Image Gallery.

3 Prediction Image
Displays the prediction for the image with the current settings made in the Denoising
Parameters section.

4 Image Gallery
Here you can import and select the images you want to use for training the denoising. A
click on an image opens it the left image container in the image view.

5 View Options
Here you have some general view options on the Dimensions and Display tab to adapt
the image display.

6.4.1.1 Denoising Parameter Section

Info
Advanced Parameters
The parameters Batch Size, Window Size and Masking Ratio are three advanced parame-
ters to adjust the NOISE2VOID (N2V) based training. For general information on denoising and
N2V, see Intellesis Denoising [} 511].

Parameter Description
Model Displays the name of the current model.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 512


6 General Toolkits | 6.4 Intellesis Denoising ZEISS

Parameter Description
Number of Epochs Defines the number of times that the model is trained with the im-
ages.
The "number of epochs" refers to the number of times the training
dataset is passed through the neural network during the training
process. Each pass through the dataset is called an epoch (an epoch
consists of a fixed number of samples drawn from the dataset). In
N2V, the number of epochs is a user-defined parameter that deter-
mines how many times the neural network will be trained on the full
dataset. If the number of epochs is too short, the model may not be
able to learn the underlying patterns in the data, resulting in underfit-
ting. On the other hand, if the number of epochs is too long, the
model may start to memorize the training data, resulting in overfit-
ting, which makes it less effective at denoising new images.

Batch Size Only visible if Show All is activated


Defines the batch size, a number of optimization steps that are exe-
cuted simultaneously. Note that the higher you set the batch size, the
higher is the memory usage.
The "batch size" refers to the number of samples (image patches) that
are processed by the neural network at once. During each epoch, the
training data set is typically divided into several smaller batches, and
the neural network is updated based on the average loss across the
batch. The batch size is another user-defined parameter that controls
how many samples are processed in each batch. If the batch size is
too small, the model may converge slowly and can result in poor gen-
eralization. If the batch size is too large, it may result in the model be-
ing unable to fit into memory, slowing down the training process, and
potentially leading to poor generalization. The default batch size in
ZEN is 64, but it is advisable to experiment with smaller sizes, such as
32 or 16, if memory errors occur.

Window Size Only visible if Show All is activated


Defines the size of the window from which the pixels are taken.
Given a pixel to be masked, the "window size" parameter determines
the size of the surrounding area to sample replacement pixel. Specifi-
cally, N2V divides the input image into overlapping patches of a fixed
size (determined by the window size parameter) and trains a neural
network to predict the central pixel of each patch based on the other
pixels in the patch. During inference (denoising), N2V processes the
input image in a sliding-window fashion, applying the trained neural
network to each patch in turn to produce a denoised output image. If
the window size is too small, it may not capture enough information
to properly denoise the image. If the window size is too large, it may
include too much information, leading to overfitting, increased com-
putation time, and reduced performance. The default window size of
5 is optimal for most images.

Masking Ratio Only visible if Show All is activated


Defines the ratio between pixels that are replaced and the overall
number of pixels.
The "masking ratio" parameter determines the proportion of pixels
within each patch that are randomly masked during N2V training. The
best denoising performance is achieved by using sampling replace-
ment pixels from the areas surrounding the masked pixels (not by re-
placing the masked pixel with zero) and N2V forces the neural net-

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 513


6 General Toolkits | 6.4 Intellesis Denoising ZEISS

Parameter Description
work to learn a more robust representation of the underlying image
structure, rather than simply memorizing the specific noise patterns in
the input image. The masking ratio controls the level of noise injec-
tion during training, with higher values leading to more aggressive
masking and generally better performance on noisy datasets. If the
masking ratio is too small, the model may not be able to learn the
noise distribution effectively, which can lead to poor denoising perfor-
mance. In general, the optimal values for these parameters will de-
pend on the specific characteristics of the input image and the
amount and type of noise present in the data. It is often necessary to
experiment with different values to determine the best combination
for a given task.

Defaults Resets all parameters to their default values.

Train and Denoise Trains the model based on the current parameter settings.

Finish Saves the model and all changes and closes the wizard.

Cancel Closes the wizard without saving.

See also
2 Intellesis Denoising [} 511]

6.4.2 Creating and Training an Intellesis Denoising Model

Prerequisite ü If required, you have pre-processed your image(s) with the Whitening function, see Whiten-
ing [} 181].

1. On the Analysis tab, in the Intellesis Denoising tool, click and select New.
2. Enter a name for the new model and click . Alternatively, enter the name and press
Enter.
à A new setting with the name is created and automatically selected as Model.
3. Click Start Training.
à The user interface for training opens.
4. In the Images and Documents section on the right, click Import Images.
à A file browser opens.
5. Select the image(s) you want to use for classification and click Open.
à For images with multiple channels, a dialog opens to select the channel for denoising.
6. Select the channel you want to use for denoising and click OK.
à The image is displayed in the list in the Images and Documents section. Note that all
imported images are included to your model.
7. Select the image from the list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 514


6 General Toolkits | 6.4 Intellesis Denoising ZEISS

à The image is displayed in the left image container.

8. In the parameter section, set the Number of Epochs and adapt the more advanced pa-
rameters, if necessary.
9. Click Train and Denoise.
à Your model is trained based on the settings and the prediction is displayed in the right
image container.
10. If you are satisfied with the result, click Finish.
à All changes are saved and the wizard is closed.
You have successfully created and trained a model for denoising. You can now use it to denoise
your images with the Intellesis Denoising image processing function, see Using a Trained
Model for Denoising [} 516], or use it during a continuous acquisition, see Using Denoising Dur-
ing Continuous Acquisition [} 62]..

6.4.3 Importing a Denoising Model

Prerequisite ü You have a trained model available which you want to import.
ü You are on the Analysis tab.

1. In the Intellesis Denoising tool, click and select Import.


à A file browser opens.
2. In the file browser, select the model file from the file system and click Open.
à The model is now available in the dropdown list.
You have imported a model for denoising. You can now use it to denoise your images with the
Intellesis Denoising processing function, see Using a Trained Model for Denoising [} 516].

6.4.4 Exporting an Intellesis Denoising Model

Prerequisite ü You have a denoising model available.


1. On the Analysis tab, in the Intellesis Denoising tool, select the model you want to export
in the dropdown.
2. Click and select Export.
à A file browser opens.
3. Select the file location and click Save.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 515


6 General Toolkits | 6.4 Intellesis Denoising ZEISS

The model is exported. It contains the trained routine to denoise an image and is not intended for
the training process anymore.

6.4.5 Using a Trained Model for Denoising

Prerequisite ü You have a denoising model available.


ü You have opened the image(s) for which you want to use the model.
ü If required, you have pre-processed your image(s) with the Whitening function, see Whiten-
ing [} 181].
1. On the Processing tab, select the Intellesis Denoising method.
à The settings are displayed in the Parameters tool.
2. In the Parameters tool, select the Model you want to use.
3. If you have several CUDA capable GPUs, select the GPU that should be used for running
the denoising model.
4. Click Apply.
à The objects in your image are denoised based on the trained model.

6.4.6 Intellesis Denoising Tool

Parameter Description
Model Displays the selected model. If you have several models available, you
can select the corresponding model from the dropdown list.

Options

– New Creates a new, empty model.

– Rename Renames the selected model.

– Clone Clones (duplicates) the selected model.

– Import Imports a denoising model to ZEN, see Importing a Denoising Model


[} 515].

– Export Exports the selected model to the file system, see Exporting an In-
tellesis Denoising Model [} 515].

– Delete Deletes the selected model.

Description Displays and sets a description for the selected model.

Start Training Opens the user interface for training.

See also
2 Intellesis Denoising [} 511]
2 Creating and Training an Intellesis Denoising Model [} 514]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 516


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

6.4.7 IP Function

6.4.7.1 Intellesis Denoising

Info
Use in Direct Processing
If you are using this function in Direct Processing, the denoising model has to be placed/avail-
able on the processing workstation. Additionally note that the feature to automatically select a
remote processing PC is not possible when Intellesis Denoising is used in Direct Processing.

Parameter Description
GPU Only available if you have several CUDA capable GPUs. If you have
only one, the selection is fixed.
Selects the GPU used for running the denoising model. Running the
model on several GPUs in parallel is currently not possible.

Model Selects the trained model for image denoising.

See also
2 Using Direct Processing [} 230]
2 Intellesis Denoising [} 511]
2 Using a Trained Model for Denoising [} 516]

6.5 Intellesis Object Classification

This module offers the functionality to classify objects based on measured parameters of an ana-
lyzed image using machine-learning algorithms and to create and to train such a model for object
classification. Since the input for the object classification is an analyzed image containing a result
table, the functionality of the Image Analysis module is also required for the complete workflow.

6.5.1 Workflows Overview

For the object classification functionality in ZEN there are three main workflows:

§ Analyzing an image (see Image Analysis [} 402])


§ Training an object classification model (see Creating and Training an Object Classification
Model [} 521])
§ Using the trained model to classify objects in analyzed images (see Using a Trained Model
for Object Classification [} 523])

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 517


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

6.5.2 User Interface

1 2 3

1 Classification Settings
Here you can set the classes for labeling/ classifying the objects. For more information,
see Classification Settings [} 519].

2 Image View
Here you have your analyzed image and can label the objects by clicking on them.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 518


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

3 Table
This table displays your analysis results and can be used for labeling the objects in your
image. For additional information, see Object Classification Table [} 520].

4 Image Gallery
Here you can import and select the images you want to use for classification. For more
information, see Image Gallery (Object Classification) [} 519].

5 View Options
Here you have some general view options of the Dimensions Tab [} 1029] and Display
Tab [} 1043] as well as specific labeling options on the Labeling Options Tab [} 520].

See also
2 Creating and Training an Object Classification Model [} 521]

6.5.2.1 Classification Settings

Parameter Description
Model Displays the model name.

Selected Region Displays the region class selected for classification.


Class

Selected Channels Displays the channels selected for classification.

Classes list Displays all the classes for classifying the objects. The color of the
class can be changed by clicking on the color field. Renaming of a
class is possible by right click menu.

Add Class Adds a new class to the Classes list.

Delete Class Deletes the currently selected class from the list.

Train & Classify Starts the training for the object classification setting.

Display

– Label Displays the labels in the image.

– Prediction Only available after a training has been performed.


Displays the predictions in the image.

Finish Saves the classification setting and closes the setup.

Cancel Closes the setup without saving the changes.

See also
2 Creating and Training an Object Classification Model [} 521]

6.5.2.2 Image Gallery (Object Classification)

On the right under Images & Documents, you find the area for handling the images. Here you
can load and select the images you want to use for classification. When you click on a loaded im-
age, the image is displayed in the Center Screen Area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 519


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

In the list of images you have certain possibilities to gain advanced information about the image.
If you load a new image, only the preview image, file name and type of image are displayed.
When you have labeled certain slices (for example), they are listed under the image entry. If you
click on this information the corresponding image (slice) is automatically displayed in the center
screen area. This is very helpful when you are working with large data sets such as z-stacks,
scenes or time-series and you want to quickly load the image which you have already labeled.

Parameter Description
Import Images Opens the file browser to select the images for import.

6.5.2.3 Labeling Options Tab

Parameter Description
Mode

– Activates the selection mode. You can select objects in the image
without labeling them.
Selection

– Activates the labeling mode. You can label the objects in your image.
Labeling

– Activates the erasing mode. You can erase the labels in your image.
Erase

Object Display Sets how the label are displayed in the image.

– Fill Displays the label as filled objects.

– Outline Displays the label as an outline.

Opacity Sets the opacity of the label in the image.

6.5.2.4 Object Classification Table

Here the analyzed objects of the image are displayed. You can also use the table to label the ob-
jects, see Creating and Training an Object Classification Model [} 521]. This table is linked to
the image, which means selecting a row in the table centers the view on the respective object in
the image and vice versa. If the image is not zoomed to extent, a click on an object in the table
centers this object in the image view and adapts the zoom level if necessary (by zooming out). The
table can be sorted by each column by simply clicking on the header.
The table only displays the measurements features selected inside the image analysis, not the
ones that are used internally to classify the objects.

Parameter Description
ID Displays the unique ID of the objects in the analyzed image.

Label Displays the label class attributed to the respective object.

Prediction Displays the predicted label using all labels from all available images.

Confidence The confidence value in % for the predicted label of every individual
object.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 520


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

Parameter Description
Measurement fea- Additionally to ID and Label, the values of the various Measurement
tures Features [} 440] are displayed in the table.

6.5.3 Creating and Training an Object Classification Model

Prerequisite ü You have an analyzed image. For detailed information on analysis, see the chapter Image
Analysis [} 402].

1. On the Analysis tab, in the Trainable Object Classification tool, click and select
New.
2. Enter a name for the new model and click . Alternatively, enter the name and press
Enter.
à A new setting with the name is created and automatically selected as Model.
3. Click Start Training.
à The User Interface [} 518] opens.
4. In the Image Gallery on the right, click Import Images.
à A file browser opens.
5. Select the image(s) you want to use for classification and click Open.
à The Select Region Class and Channel dialog opens.
6. Select the Region Class and the channels you want to use for classification and click OK.
à The image(s) is/are imported into the wizard.
7. In the Open Images tool on the right, click on the image you want to label.
à The image is displayed and the table shows the data of the analysis result.
8. On the left side, add the classes you need for you object classification by clicking Add
Class.
à You have created the classes that you want to distinguish.

9. To change the label color for a class, click on the color field of the list entry and select one
from the window.
10. To change the name of a class, right click on the entry, select Rename, enter a new name
and click . Alternatively, double click the name entry, enter a new one and click
, or press Enter.
11. In the Labeling Options tab, click .
à You are now in labeling mode.
12. In the classes list, select a class and click on an object that belong to this class in the image
or in the table.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 521


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

à You have labeled the object and assigned it a class.

13. Repeat the labeling for the objects of the different classes you created.
14. Click Train & Classify.
à Your model is trained based on the labeling and a prediction is displayed.

15. If you are not satisfied with the result, you can label more objects.
16. If you are satisfied with the result, click Finish.
à All changes are saved, and the wizard is closed.
You have successfully created and trained a model for object classification. You can now use it to
classify objects in your analyzed images with the processing function Object Classification
[} 525]. For more information, see also Using a Trained Model for Object Classification [} 523].

6.5.4 Importing an Object Classification Model

Prerequisite ü You have a trained model available which you want to import.
ü You are on the Analysis tab.

1. In the Trainable Object Classification tool, click and select Import.


à A file browser opens.
2. In the file browser, select the model file from the file system.
3. Click Open.
à The model is now available in the dropdown list.
You have imported a model for object classification. If you want to use the model for image pro-
cessing switch to the Processing tab. In the Object Classification [} 525] function you can select
the imported model and apply it to the desired images/data sets. See also Using a Trained Model
for Object Classification [} 523].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 522


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

6.5.5 Exporting an Object Classification Model

Prerequisite ü You have created and selected a model for object classification.
1. On the Analysis tab, in the Trainable Object Classification tool, select the model you
want to export in the dropdown.
2. Click and select Export.
à A file browser opens.
3. Select the file location and click Save.
The model with the trained classification routine is exported. Such a model is meant to be used
for classifying objects in an analyzed image, but not for the training process.

NOTICE
Necessary retraining of models
In case of changes in Python libraries, trained models can stop working on a new version of
ZEN and need to be retrained first. Retraining is only possible if the model contains the images,
or the images are generally still available. To be able to retrain your model, consider the fol-
lowing solutions:
4 Export your model with your images (see Exporting an Object Classification Model with
Images [} 523]).
4 Make a backup of the images used for training the model, e.g. on your (external) hard
drive.

6.5.6 Exporting an Object Classification Model with Images

Prerequisite ü You have selected a trained model with images.

1. On the Analysis tab, in the Trainable Object Classification tool, click and select
Export With Images.
à The file explorer opens.
2. Navigate to the folder where you want to store the training model and click Save.
You have exported your model with the trained classification routine as well as the images that
were used for training. Such a model is meant to be used for classifying objects in an analyzed im-
age, but not for the training process anymore.

6.5.7 Using a Trained Model for Object Classification

Prerequisite ü You have created and trained an object classification model. For more information, see Creat-
ing and Training an Object Classification Model [} 521].
ü You have opened the analyzed image(s) for which you want to use the classification model.
1. On the Processing tab, under Trainable Object Classification, select the function Object
Classification.
2. Make sure that in the Input tool the correct image is selected.
3. In the Parameter tool, select the Model you want to use for object classification.
4. Click Apply.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 523


6 General Toolkits | 6.5 Intellesis Object Classification ZEISS

The objects in your image are now classified based on the trained model. To view the result (ta-
ble) you can switch to the Analysis View [} 429]. There you can see all measurement values in the
table and adapt the chart to display your object classification results with the Custom Chart tab
[} 432] as well as select your objects in the Analysis Tab [} 430].

6.5.8 Intellesis Trainable Object Classification Tool

Parameter Description
Model Displays the selected model. If you have several models available, you
can select the corresponding model from the dropdown list.

Options

– New Creates a new, empty model, see Creating and Training an Object
Classification Model [} 521]

– Rename Renames the currently selected model.

– Clone Clones (duplicates) the currently selected model.

– Import Imports a model to the ZEN software, see Importing an Object Clas-
sification Model [} 522].

– Export Exports the model to the file system, see Exporting an Object Classi-
fication Model [} 523].

– Export With Exports the model including all images to the file system, see Export-
Images ing an Object Classification Model with Images [} 523].

– Delete Deletes the currently selected model.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 524


6 General Toolkits | 6.6 3D Image Analysis ZEISS

Parameter Description
Description Displays and sets a description for the selected model.

Start Training Opens the user interface for training.

6.5.9 IP Function

6.5.9.1 Trainable Object Classification

6.5.9.1.1 Object Classification

With this image processing function you can classify the objects of your analyzed image based on
a trained model.

Parameter Description
Model Selects the objects classification model.

Append Classifica- Activated: Displays all statistical features in the result table.
tion Features to Deactivated: Displays only the features that were selected in the im-
Result Table age analysis.

See also
2 Intellesis Object Classification [} 517]
2 Creating and Training an Object Classification Model [} 521]
2 Using a Trained Model for Object Classification [} 523]

6.6 3D Image Analysis

This module offers functionality to analyze and quantify 3D image data. The image analysis wiz-
ard, optimized for 3D functionality, guides you through the segmentation steps to setup a fast
and easy-to-use quantification of segmented objects. The resulting objects are visualized using the
3D viewer and with the help of a table, the objects can be sorted and exported. You need a valid
license that includes the 3Dxl and 3D Image Analysis functionality.

6.6.1 Creating a 3D Image Analysis Setting

1. On the Analysis tab, in the Image Analysis tool, click and select New from the
dropdown.
2. In the Settings field, enter a name for your image analysis setting and click . Alterna-
tively, enter the name and press Enter.
à A new image analysis setting is created and saved.
3. For Method, click .
à The Segmentation Method Selection dialog opens.
4. From the Method drop down menu, select 3D Segmentation and click OK.
à A dialog is displayed to ask if you want to overwrite existing settings to create the 3D
setting.
5. Click Yes.
6. In the Image Analysis tool, click Edit Image Analysis Setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 525


6 General Toolkits | 6.6 3D Image Analysis ZEISS

à The Image Analysis Wizard opens in the Classes step with a default class already cre-
ated.
7. If you want to extend the predefined list of classes, click Add Class to add a new class or
Add Subclass to add a subclass to the currently selected class.
8. If you want to change the name for the classes, select a class and change the text in the
Name field.
9. Select your class(es) and define the Channel you want to use for segmentation and define
a Color for the segmentation mask.
10. Click Next.
à The Frame step opens.
11. If you only want to analyze a specific volume of the image, you can use the parameters in
this step to create one or more measurement frames. For a description of the parameters,
see Frame [} 942].
12. Click Next.
à The Automatic Segmentation step opens.
13. Select one of your classes and click Select.
à The Class Segmentation Method dialog opens.
14. For Method, select the segmentation method you want to use for your current class and
click OK.
à The dialog closes and the displayed parameters are updated according to the selected
method. Parameters that work only on the 2D slices of the volume are grouped under
2D Parameters, whereas parameters that work on the 3D dataset are grouped under
3D Parameters. For a description of the parameters, see Automatic Segmentation
[} 944].
à Additionally, the section for 3D Preview is displayed.
15. Set the parameters for the segmentation of the currently selected class according to your
needs.
16. Repeat the previous three steps to select a segmentation method and set the parameters
for each of your classes.
17. To see your image in 3D, change to the 3D view in the center view of the wizard.
18. Use the parameters in the 3D Preview section to generate three dimensional slices around
the current z position.
19. Click Next.
à The Region Filter step opens.
20. If you want to use conditions to filter out unwanted segmented regions, you can use the
parameters of this step. For a description of the parameters, see Region Filter [} 954].
21. Click Next.
à The Features step opens.
22. Select one of your classes and, under Features of Individual Regions, click Select.
à The dialog for measurement feature selection opens.
23. In the list of features on the right, select a measurement feature you want to use and click
.
à The feature is added to the Selected Features list on the left.
24. Add all the measurement features you want to use for the regions of the current class and
click OK.
25. To define measurement features for all regions, under Features of All Regions, click Se-
lect.
à The feature selection dialog opens.
26. In the list of features on the right, select a measurement feature you want to use and click
.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 526


6 General Toolkits | 6.6 3D Image Analysis ZEISS

à The feature is added to the Selected Features list on the left.


27. Add all the measurement features you want to use for all the regions and click OK.
28. Click Next.
à The Results Preview step opens.
29. Check the preview and go back and adapt the parameters in previous steps, if necessary.
30. Click Finish.
à The wizard closes and the changes to the setting are saved.

6.6.2 Performing and Saving a 3D Analysis

Prerequisite ü You have created an analysis setting for a 3D analysis, see Creating a 3D Image Analysis Set-
ting [} 525].
ü You have opened the image you want to analyze.
1. On the Analysis tab, open the Image Analysis tool.
2. For Setting, select the setting you have created for your 3D analysis.
3. Click Start Analysis.
à Your image is analyzed based on your setting.
à The 3D view opens to display your 3D volume and the objects resulting from the image
analysis, with the Analysis Objects Table containing the data for the analyzed objects.
The objects are displayed in the color that was assigned to the respective class in the
analysis wizard.
4. Click File > Save. Alternatively, press Ctrl + S.
à The analyzed image is saved under its current name. The resulting objects are saved in
the czi file as well.

6.6.3 Viewing and Exporting the Results of a 3D Analysis

Prerequisite ü You have opened an image where a 3D analysis has been performed, see Performing and
Saving a 3D Analysis [} 527].
1. Open the 3D view for your image.
à The 3D view opens to display your 3D volume and the objects resulting from the image
analysis, with the Analysis Objects Table containing the data for the analyzed objects.
The objects are displayed in the color that was assigned to the respective class in the
analysis wizard.
2. If you do not see the result table, in the Analysis tab below the image, activate Show
Analysis Objects Table. To be able to see the objects, also make sure that is acti-
vated in the bottom tool bar of the viewer, see Tool Bar (Bottom) [} 532].
3. In the Analysis Objects Table on the right, in the Classes dropdown, select the object
class you want to examine.
à The table and view are updated accordingly.
4. If you want to highlight certain objects in the view, activate the checkbox for the respective
entry in the Analysis Objects Table.
5. Use the controls of the tool bars and 3D specific view options to interact with the image.
6. To export your result table, in the Analysis Objects Table, click Export Table.
à A file browser opens.
7. Navigate to the desired location and click Save.
à The currently displayed entries of the Analysis Objects Table are exported and saved as
a .csv file.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 527


6 General Toolkits | 6.6 3D Image Analysis ZEISS

8. To export the image to arivis Pro, in the bottom tool bar click .
à The image is exported to arivis Pro and is displayed with almost identical rendering set-
tings.

6.6.4 Analysis Tab

This tab is only available if you have opened an image with objects from the 3D Image Analysis.

Parameter Description
Show Analysis Ob- Activated: Displays the analysis objects table on the right side of the
jects Table 3D view.

Delete Analysis Re- Deletes the analysis results of the image.


sults

6.6.5 Analysis Objects Table

This table is only available if you have opened an image with objects from the 3D Image Analy-
sis, or if you have run an 3D image analysis and is displayed by default. It can be switched off by
deactivating Show Analysis Objects Table in the Analysis tab. The table displays the resulting
objects of an image analysis and allows you to manipulate, filter and export the objects. The table
can be sorted by one column when clicking into the table header. A little arrow in the header indi-
cates if the sorting order is ascending or descending.
When you select an entry, the respective object is highlighted in the 3D view, and vice versa. You
can also select multiple entries when pressing the Ctrl key while clicking, or you can select a
range of entries by pressing the Shift key while clicking on the first and last entry of the range. All
corresponding objects are highlighted in the viewer. You can also undock the table by clicking the
undock icon in the top right and then move the table freely on your screen.

Parameter Description
Classes Selects the class for which the objects are displayed in the table.

Export Table Opens a file browser to export the objects table.

Objects Table

– Checkbox Activated: Highlights the respective analysis object in the 3D view. If


you activate the checkbox in the table header, all objects are activated
and highlighted.

– ID Displays the ID of the respective object.

– Features The various features you added in the Features step of the analysis
wizard are displayed in this table, like the Volume and Parent ID.

See also
2 Undocking/Docking Tool Windows [} 40]
2 Analysis Tab [} 528]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 528


6 General Toolkits | 6.7 3Dxl ZEISS

6.7 3Dxl

This module enables you to visualize 3D or 4D image data. It provides up to three clipping planes
and features five different rendering methods, including an improved transparency mode for bet-
ter visualization of dense structures, such as EM, XRM and dense fluorescent data. Time series
(4D) movies, the generation and export of movies as well as tools for interactive 3D measure-
ments are also included. 3Dxl offers a bridge functionality and sample pipelines to send data to
arivis Pro with saved settings for fast and easy 3D analysis. For full functionality, the 3Dxl module
requires a dedicated current graphic card with full OpenGL support (NVIDIA recommended, AMD
possible).

6.7.1 Animating the 3D Volume

Prerequisite
ü The Rotation mode in the left tool bar is selected.

1. Click for the spin mode.


2. Move the mouse inside the image area.
3. Hold down the left mouse button and move the mouse slightly to the left or right.
4. Release the left mouse button again.
The 3D volume rotates continuously in the direction in which you moved the mouse. If you move
the mouse quickly, the 3D volume rotates quickly. If you move the mouse slowly, the 3D volume
rotates slowly.
To stop the animation, left-click again in the image area.

6.7.2 3D View

This view is only available if:

§ you have loaded or acquired a z-stack image.


§ a suitable NVIDIA or AMD graphics card with full OpenGL 4.3 or higher functionality is
present.
3D View employs 3D rendering technology which requires access to advanced OpenGL functional-
ity. For full functionality this means that a modern dedicated graphic card (NVIDIA or AMD tech-
nology) has to be present.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 529


6 General Toolkits | 6.7 3Dxl ZEISS

1 2

1 Tool Bars
With the toolbars on the left, right and bottom of the image area you can directly con-
trol and move the 3D volume, see Tool Bars [} 530].

2 3D View
The 3D view displays z-stack images three-dimensionally as a 3D volume and objects re-
sulting from a 3D image analysis (if you have the required license for 3D Image Analysis
and toggled their visibility). Selecting an analysis object in the view highlights the respec-
tive row in the table. You can also select multiple objects by pressing Ctrl while clicking
on the objects.

3 Analysis Object Table


This table is only visible if you have opened an image with objects from the 3D Image
Analysis. It displays the objects resulting from the image analysis and allows you to
highlight them in the viewer, see Analysis Objects Table [} 528].

4 Summary Table
This table is only visible if you have opened an image with objects from the 3D Image
Analysis. This table displays a summary of information about the objects of the class se-
lected in the Analysis Object Table. The displayed features are the ones selected for all
regions in the Feature step of the analysis wizard.

5 View Options
In this area you have your 3D specific view options with parameters to adjust the appear-
ance and further settings of the 3D volume.

6.7.2.1 Tool Bars

The tool bars are arranged to the left and right of the image area and underneath it. You can use
the tools to control and adjust the display of the 3D volumes in the image area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 530


6 General Toolkits | 6.7 3Dxl ZEISS

6.7.2.1.1 Tool Bar (Left)

Parameter Description
Zooms in or out of the 3D image.

Top Thumb Wheel

Enables you to select end points of measurement tools that have been
drawn into the 3D image (Measurement tab). You can then edit the
Select position of the end points.

Enables you to rotate the 3D image in any way you wish within the
space. This is the default mode when you switch to 3D view for the
Rotate first time.

Enables you to increase or reduce the zoom factor of the image area.

Zoom

Enables you to move the 3D image.

Move

Enables the flight mode. This mode allows you to virtually fly through
Fly the 3D image. Use the keys from the list below to control your flight.

Rotates the 3D image around the horizontal (X) axis.

Bottom Thumb
Wheel

Flight Mode Key Layout/Controls

Key Function
W Forward

S Backward

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 531


6 General Toolkits | 6.7 3Dxl ZEISS

Key Function
A Left

D Right

Space Up

C Down

E Rotate (clockwise)

Q Rotate (counter-clockwise)

X Precision Mode, enables slower movement

6.7.2.1.2 Tool Bar (Right)

Parameter Description
Toggles the visibility of the X/Y clipping plane.

Toggle X/Y Clip-


ping Plane (Blue)

Toggles the visibility of the X/Z clipping plane.

Toggle X/Z Clip-


ping Plane (Green)

Toggles the visibility of the Y/Z clipping plane.

Toggle Y/Z Clip-


ping Plane (Red)

Creates a 2D image of the current view. The image is a 24 bit color


image. All annotations are burned in automatically.
Snap

Adds the current view to a position list as a new position.


With the help of position lists you can have your view calculated as a
Add series of individual images. This series can then be exported as a
movie, for example.

Only active if a position list containing at least two saved positions ex-
ists.
Play Plays back a preview of the series that is calculated. To stop the pre-
view, click on the button again.

6.7.2.1.3 Tool Bar (Bottom)

Control element Description


Rotates the 3D volume around the vertical (Y) axis.

Left Thumb Wheel

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 532


6 General Toolkits | 6.7 3Dxl ZEISS

Control element Description


Switches back to the start view from any view.
A top view of the 3D volume is displayed. Lateral movements and the
Home View
zoom factor are adjusted so that the 3D volume can be seen at the
center of the image area.

Shows or hides measurements.


If measurements are drawn in, a table of the measurements appears
Show Measure-
at the right side of the image area.
ments

Shows or hides a bounding box around the 3D volume.


Show Bounding
Box

Toggles the visibility of the coordinate axes.


Show Coordinate § X axis = red
Axes § Y axis = green
§ Z axis = blue

Toggles the visibility of the scaling on each axis.


Show Scaling

Only available if you have licensed the 3D Image Analysis functional-


ity.
Show Objects
Toggles the visibility of the analysis objects in the 3D volume.

Enables the spin mode. This allows to set the 3D volume in continu-
ous motion. For a short description on how to use the spin mode, see
Spin Mode
Animating the 3D Volume [} 529].

Only available if you have licensed the 3D Image Analysis functional-


ity.
Glass Visualization
Switches to glass visualization of the analysis objects in the 3D vol-
ume.

Only available if you have licensed the 3D Image Analysis functional-


ity.
Opaque Visualiza-
Switches to opaque visualization of the analysis objects in the 3D vol-
tion
ume.

Only active, if arivis Pro is installed and licensed on the system.


Starts arivis Pro and imports the image. The image will be displayed
Send to arivis Pro
with almost identical rendering settings as in the 3D view of ZEN.
Note: Not all render methods produce absolutely identical settings
between the two applications. This is due to additional functionalities
available for arivis Pro.

Rotates the 3D volume around the (Z) axis perpendicular to the screen
plane.
Right Thumb
Wheel

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 533


6 General Toolkits | 6.7 3Dxl ZEISS

6.7.2.2 3D Tab

Here you can specify which projection/rendering mode you want to use to display the 3D volume.
There are 5 view modes available. To activate the desired view mode, click on the corresponding
button. An activated button (respectively the mode) appears in blue color.

Fig. 29: Mode Buttons

Parameter Description
Transparency Activates the Transparency rendering mode.

Volume Activates the Volume mode.

Maximum Activates the Maximum intensity projection mode.

Surface Activates the Surface reconstruction mode

Mixed Activates a combination of transparency rendering and surface re-


construction mode

Precise/Fast Adjust the level of detail of the 3d volume here.


§ If you select the Precise setting, all the information present in the
image is used to achieve the best possible display. The calculation
time can increase accordingly.
§ If you select the Fast setting, the image data are significantly re-
duced before the calculation. The calculation is fast, but only a very
coarse 3D display of the volume is achieved.

Update on com- Only available, if Follow Acquisition on the Dimensions tab is acti-
pleted frame vated.
Activated: During acquisition, the 3D View is only updated after the
acquisition of a stack has been completed.
Deactivated: While the acquisition of a stack is still ongoing, the 3D
View is continuously updated. However, with very fast acquisition this
update cannot be guaranteed.

Depth coding Only active if Transparency, Maximum or Mixed mode is activated.


Activated: Replaces the channel colors of the volume with a rainbow
color table where the color represents the depth of the stack. A pal-
ette is shown which matches the colors to a given depth (in scaled
units).

Toggle Clipping By activating or deactivating the buttons you can show or hide the
Planes corresponding clipping planes in the 3D volume.
If you right-click on an activated button, a shortcut menu opens. Here
you can select whether you want the back (Clip Back), front (Clip
Front) or both sides of the 3D volume to be clipped. You can also
specify the Style of the clipping plane. Under each button is a slider.
You can use this to move the relevant clipping plane within the vol-
ume.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 534


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
Wedge Activated: Activates two texture planes. Only the sector between the
planes is cut out. You can select which planes you want to be used
for the wedge function from the dropdown list. The selection is also
visible in the relevant buttons.

Stored Here you can select saved 3D settings.

Opens the options menu.


Options

– New Creates a new settings file that is given a name automatically and has
the file extension *.cz3dr. The settings file can be found in the user
path under \My Documents\Carl Zeiss\ZEN\Documents\3Dxl render
settings.

– Delete Deletes the selected settings file from the hard drive.

– Rename Renames the selected settings file. Enter a new name in the input field
and confirm with OK.

– Save As Saves the selected settings file under a different name.

– Import Imports a *.cz3dr file and applies it to the current image.

– Export Exports a *.cz3dr file to a different location.

Create Image Creates a new image from the current view. This image is a 24 bit
RGB color image. All graphic elements, such as annotations, are burnt
in. In the dropdown left of the button you can select the resolution
for the image that is created.

6.7.2.3 Appearance Tab

Here you can define the appearance of the 3D volume. On the tabs available on this tab, select
the setting that you want to change (e.g. Transparency). Depending on which mode you have ac-
tivated on the 3D tab, different tabs and parameters are available.

6.7.2.3.1 Transparency Tab

Parameter Description
Here you can select the channel of a multichannel image for which
you want to set the transparency.

Channel selection

Threshold Sets the lower threshold value in percent of the gray levels displayed.
With this setting you specify the gray value range for the relevant
channel that you want to be included in the rendered image.

Ramp Sets the extent of the transition from completely transparent to com-
pletely opaque (0-100 percent).

Maximum Sets the level of opacity (0-100 percent).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 535


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
Histogram Displays the settings that you enter using the sliders schematically.
The X axis represents the gray level values and the Y axis the opacity.
You can also change the position of the curve using the mouse.

Reset Resets all parameters to the original values.

6.7.2.3.2 Surface Tab

Only visible if Surface or Mixed view mode is activated on the 3D tab.

Parameter Description
Here you can select the channel of a multichannel image for which
you want to adjust the surface settings.

Channel selection

Threshold Sets the lower threshold value in percent of the gray levels displayed.
With this setting you specify the gray value range for the relevant
channel that you want to be included in the rendered image.

Ambient Light Sets the ambient light on a scale from 0 to 100%.

Spectacular Light Sets the spectacular light from 0 to 100%. This value influences the
differences between bright and dark structures.

Shininess Sets the surface shininess.

Reset Resets all parameters to the original values.

6.7.2.3.3 Channels Tab

Only visible if Mixed view mode is activated on the 3D tab.


Here you can specify how Transparency and Surface settings are mixed. In the case of multi-
channel images you can also configure these settings differently for each channel.
Activate the corresponding checkboxes for Transparency and Surface in the list.

6.7.2.3.4 Background Tab

Parameter Description
Background Color Sets the background color for the 3D view. To do this, click on the
color field and select the desired color.

Reset Resets the background color.

6.7.2.3.5 Light Tab

Parameter Description
Brightness Sets the brightness of the light source (from 0 - 100 %).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 536


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
Azimuth Here you can enter the angle of the light source above the virtual
horizon.

Elongation Here you can enter the light source's horizontal angle of incidence.

Light source As an alternative to the slider or input field, you can set the Azimuth
and Elongation together by using the mouse to move the point
within the light source display.

Enable Directional Activated: Enables full lighting for volumetric rendering. A directional
Light light illuminates all structures in a scene with parallel light rays from a
specific direction, similar to sun light. The light disregards the distance
between the light itself and the structures, so the light does not di-
minish with distance.

Enable Tone Map- Activated: Enables tone mapping during the rendering of the image
ping data. Tone mapping refers to the compression of the dynamic range
of high contrast images (HDR). The contrast range is reduced in order
to display digital HDR images on output devices with a more limited
dynamic range. In most cases, tone mapping increases brightness and
contrast of the rendering result and makes colors more vibrant.

Reset Resets all parameters to the original values.

6.7.2.3.6 Projection Tab

Parameter Description
View angle Sets the projection angle at which you want to view the scene freely
between 0° and 80°. The effect of this on the perspective display is as
if you are viewing the 3D image through a telephoto or wide-angle
lens.

Scale Z Here you can set the scaling of the volume in the Z direction (value
range 10% - 600%).

Stereo anaglyph Activated: Displays the 3D volume as anaglyphs. You can choose be-
tween a
§ Red/Green display, or a
§ Red/Cyan display.

Camera separation Sets the distance between the two virtual cameras (0-20%).

Parallax shift Sets the degree of movement that is necessary to bring the two cam-
era images back into line (-100 to +100%).

Reset Resets all parameters to the original values.

6.7.2.4 Clipping Tab

Only visible if the Show All mode is activated.


Here you can edit clipping planes. To select a clipping plane, click on the corresponding button.
The editing functions which you can use to modify the selected clipping plane become visible
when you activate the specific clipping plane.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 537


6 General Toolkits | 6.7 3Dxl ZEISS

Info
On the Clipping tab you can edit the clipping planes. On the 3D tab you can activate or deac-
tivate the relevant clipping planes in the 3D volume.

Parameter Description
Show All Clipping Activated: Automatically inserts all 3 clipping planes into the 3D
Planes volume. Additionally the editing functions for each clipping plane
were activated automatically.

Activates the editing functions for the X/Y clipping plane.

X/Y

Activates the editing functions for the X/Z clipping plane.

X/Z

Activates the editing functions for the Y/Z clipping plane.

Y/Z

Activate Activated: Activates the selected clipping plane in the 3D vol-


ume. The corresponding settings become visible. You will find a
detailed description of the settings in the list below.
Note: Each plane is positioned at the center of the 3D volume
and aligned orthogonally (in the X/Y, X/Z, Y/Z direction).

Reset All Resets all parameters to the original values.

The following parameters are only visible if the Activate checkbox is activated and a clipping
plane has been selected.

Parameter Description
Clipping Plane Style Change the display of the selected clipping plane using the drop-
down list to the right of the Activate checkbox. The following
settings are available:

- Invisible The plane is invisible.

- Colored The plane is displayed in color. The frame color is used with 50%
transparency here.

- Binary The data above the threshold value that are touched by the clip-
ping plane are displayed in binary form as a white area. Black
pixels are non-transparent.

- Transparent The data that are touched by the clipping plane are displayed as
they are in Transparent view mode, but in 2 dimensions. The
ramp for the transparency is linear here. Black pixels are trans-
parent.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 538


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
- Textured opaque The display appears as it does with the Textured setting. Black
pixels do not let any light through, however, meaning that the
render data behind them are not displayed.

Outline Activated: Displays the frame of the selected clipping plane. En-
ter the frame color via the color field.

Clip Front Activated: Clips the front of the 3D volume.

Clip Back Activated: Clips the back of the 3D volume.

Clip Transparency Only active if Mixed view mode is activated.


Activated: In addition to the surface data, also clips the trans-
parency data.

Clip Surface Channels Only visible if Surface or Mixed view mode is activated.
Here you can enter which channel you want to be clipped using
the channel buttons.

Position Here you can enter the position of the selected clipping plane.

<X Here you can enter the X angle for the selected clipping plane.
(X Angle)

<Y Here you can enter the Y angle for the selected clipping plane.
(Y Angle)

Reset Orientation Resets the selected clipping plane to the original position.

6.7.2.5 Series Tab

Here you can create render series of individual views, which you can later view and export as a
movie. The tab contains different control elements depending on the Render Series type. The fol-
lowing parameters are the same for all render series types: Render Series section, Stored sec-
tion, Apply button and Fixed Resolution checkbox.

Parameter Description
Render Series Here you can select the desired series mode. Depending on the cho-
sen render series type, different parameters are displayed.

- Turn Around Define the start/stop angle and the rotation direction around the X
X axis.

- Turn Around Y Only visible in the 3D view.


Define the start/stop angle and the rotation direction around the Y
axis.

- Turn Around Z Define the start/stop angle and the rotation direction around the Z
axis.

- Start/Stop Define the angle and zoom settings for the start and end position of
your series. The intermediate positions are interpolated evenly.

- Position List Define any number of positions. The positions can each have com-
pletely different rotation, zoom and illumination settings.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 539


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
- Over Time Only visible in the 2.5D view.
Define the start time point and end time point for a series. All other
settings (rotation, zoom, etc.) remain unchanged.

Apply Calculates the series. A new image document is opened in the Center
Screen Area. You can view the series by clicking on the Play button
in the Dimensions tab.

Stored Only visible if Show All is activated.


Here you manage your series settings. Via the dropdown list you can
select a saved settings file.

Clicking on the button opens a shortcut menu with the following op-
tions:
Options

- New Creates a new settings file (*.czsht).


This file can be found in the user's local document path (e.g. \My Doc-
uments\Carl Zeiss\ZEN\Documents, in a corresponding subfolder).

- Delete Deletes the selected settings file.

- Rename Opens a dialog to rename the selected settings file.

- Save As Saves a copy of the currently selected settings file under a different
name.

- Save Saves changes to a currently selected settings file.

- Import Imports a setting files from the hard disk.

- Export Exports a setting files to the hard disk.

Preview
Shows a preview of the series to be created. Use the Play/
Stop button to start or stop the preview.

Frames Sets the number of individual frames that the series consist of after
the calculation. The more individual images that you specify here, the
more fluidly the scene transitions will be displayed later. Select prede-
fined values from the dropdown list (e.g. 20 or 100 frames).

Fixed Resolution Only visible if Show All is activated.


As a rule, the image series is calculated using the current screen reso-
lution. If you want to set a different format for the series, activate the
checkbox.
In the input fields that are now visible you can enter the width and
height in pixels with which you want the series to be created.

The following parameters are only available if you have selected Turn Around X/Y/Z under Ren-
der Series:

Info
4 The X rotation, Y rotation and Z render series types all have the same control elements and
differ only in the axis around which the rotation is calculated.
4 The preview function is not available for these types of series.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 540


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
360° Panorama Select 360° panorama, if you want to generate a complete rotation
series.

Partial Panorama If you select partial panorama, you can specify the starting angle and
stopping angle that you want to use for the series. To do this, enter
the desired values in the input fields or adjust it in the graphical repre-
sentation of the rotation circle at the right of the input fields.

- Start Angle Determines the starting angle.

- Stop Angle Determines the stop angle.

- Direction Determines the direction of rotation.

- When you are configuring a partial panorama, the desired angles can
also be determined easily using the circular control element:
Grab the white start/stop points with the mouse and position these
accordingly on the circle. The number of individual images is also dis-
played here.
Angle Definition

The following parameters are only available if you have selected Start/Stop under Render Se-
ries:

Parameter Description
Start Position You can position the volume in the image area as required using the
mouse. The geometric parameters are displayed in the input fields.
You can also determine the Camera Position and the Look At pa-
rameters for X, Y or Z and the angle directly using the input fields or
the slider. All changes are displayed immediately in the image area.

Stop Position You can position the volume in the image area as required using the
mouse. The geometric parameters are displayed in the input fields.
You can also determine the Camera Position and the Look At pa-
rameters for X, Y or Z and the angle directly using the input fields or
the slider. All changes are displayed immediately in the image area.

The following parameters are only available if you have selected Position list under Render Se-
ries:

Parameter Description
Add Adds the current position to the position list.

Insert Inserts a new position between two existing positions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 541


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
Position list Each position is displayed in the list with its X, Y, Z angle and zoom
level.

Using the control elements at the bottom of the list you can change
the order of the positions (Arrow buttons), cut positions (Scissors
icon) or copy and paste them again at another position (Copy/Paste
icons).
If you want to delete all positions, click Clear List.

Additional Param- You can determine which of the following parameters you want to be
eters taken into consideration when the series is calculated.
To do this, activate the corresponding checkbox:

- Light Includes illumination parameters.

- Transparency Includes transparency settings (not active in Surface mode).

- Background Includes color and distance of the background.

- Time Includes time series parameters (only active for time series images).

- Camera Includes camera settings, e.g. viewing angle (from the 3D/virtual cam-
era).

- Planes Includes planes settings (not active in Shadow mode).

- Surface Includes surface settings (only active in Surface and Mixed mode).

6.7.2.6 Measurements Tab

Only visible if the Show All mode is activated.


Here you can perform interactive measurements in the 3D volume. Note that measurements are
not possible in Shadow projection mode. The measurements can be drawn in directly in the 3D
volume using different tools. The measurement results are displayed in a list at the right of the im-
age area.

Parameter Description
Tool bar

Using the tools you can perform interactive measurements in the 3D


volume. The following tools are available:

- Changes the mouse pointer to Selection mode. Use this to select mea-
surements in the 3D volume in order to change them.
Select

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 542


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
- Use this to measure the length of a line in µm. Click once on the start-
ing point and hold down the mouse button. Then drag the mouse to
Line
the end point and release the mouse button again. The measurement
is complete. The result of the measurement is displayed in the list to
the right of the image area.

- Use this to measure the angle between two connected legs. First de-
fine the starting point. Then use the mouse to drag the first leg to the
Angle
desired first end point. Define the second leg by clicking on the sec-
ond end point. The angle measurement ends with a display of the an-
gle measured (in degrees). The result of the measurement is displayed
in the list to the right of the image area.

- Use this to measure along a line with any number of segments. Click
from corner point to corner point. Complete the measurement by
Polygon Curve
right-clicking. The result of the measurement is displayed in the list to
the right of the image area.

- Color selec- Here you can select a color for the tool you want to draw in. Simply
tion click on the colored rectangle and choose a color from the list.

- Keep Tool Activated: Keeps the selected tool active.

- Auto Color Activated: Automatically changes the color of the drawn-in tool.

Parameter Description
Show Measure- Activated: Shows the measurements in the 3D volume or in the list
ments of measured values at the right of the image area.

- On top Activated: All drawn-in measurement tools appear in the foreground,


even if these are in fact obscured by image structures.

Display Values

- on the objects Activated: Displays the measured values in the 3D volume.

- as list Activated: Displays the measured values in the measurement data ta-
ble.

Delete Selected Only active if a measurement tool has been selected in the 3D vol-
ume.
Deletes selected measurement tools from the 3D volume.

Delete All Deletes all measurement tools from the 3D volume.

6.7.2.7 3D Graphics Tab

Only visible if the Show All mode is activated.

Parameter Description
Tool bar

Using the tools you can perform interactive measurements in the 3D


volume. The following tools are available:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 543


6 General Toolkits | 6.7 3Dxl ZEISS

Parameter Description
- Changes the mouse pointer to Selection mode. Use this to select mea-
surements in the 3D volume in order to change them.
Select

- Use this to measure the length of a line in µm. Click once on the start-
ing point and hold down the mouse button. Then drag the mouse to
Line
the end point and release the mouse button again. The measurement
is complete. The result of the measurement is displayed in the list to
the right of the image area.

- Use this to measure the angle between two connected legs. First de-
fine the starting point. Then use the mouse to drag the first leg to the
Angle
desired first end point. Define the second leg by clicking on the sec-
ond end point. The angle measurement ends with a display of the an-
gle measured (in degrees). The result of the measurement is displayed
in the list to the right of the image area.

- Use this to measure along a line with any number of segments. Click
from corner point to corner point. Complete the measurement by
Polygon Curve
right-clicking. The result of the measurement is displayed in the list to
the right of the image area.

- Color selec- Here you can select a color for the tool you want to draw in. Simply
tion click on the colored rectangle and choose a color from the list.

- Keep Tool Activated: Keeps the selected tool active.

- Auto Color Activated: Automatically changes the color of the drawn-in tool.

Parameter Description
3D Measurements All measurement contained in the 3D volume are displayed here. The
list contains the following columns:

- Eye icon Here you can select whether or not a measurement tool is displayed
in the image. If you click in the title field of the column, the setting is
made simultaneously for all entries.

- Lock icon Not activated for the 3D view.

- Type Displays the type of a tool. If you click on the icon, you can change
the color of the tool.

- ID Displays the unique identification number of the measurement tool.

- A No function.

- M Activated: Displays the measurement data in the image. This setting


is applied to all entries simultaneously, i.e. the data of all entries is dis-
played.

- Name Displays the name of the tool. To change the name, double-click on
the entry, enter a new name and confirm by pressing Enter.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 544


6 General Toolkits | 6.8 3Dxl Plus ZEISS

6.8 3Dxl Plus

This module offers functionality to combine 3D and 2D visualization in one screen, enabling the
user to render up to three 2D and one 3D view panes together in one new viewer (Tomo3D view).
The 3D view features ray-casting-based volume rendering with transparency, volume and maxi-
mum intensity modes, flexible channel-wise adjustment of 3D view, background color and light-
ing. The position of the three orthogonal 2D view panes are synchronized with the 3D view, can
be interactively positioned and are indicated by colored cut lines.

6.8.1 Tomo3D View

The Tomo3D view combines a 3D viewer with up to three orthogonal 2D views. The Tomo3D is
only available if you have loaded or acquired a z-stack.
1 2

1 Left Toolbar
Toolbar to manipulate the image display. For more information, see Left Toolbar (To-
mo3D) [} 546].

2 Image View
Area where you interact with the image views and set the cut lines with the mouse. You
can display up to four different views, including a 3D and different 2D views. The num-
ber of image views can be set in the Ortho Display tab, the type can be set by the drop-
down in the top left corner of each view. The individual views can be synchronized with
the Synchronize View Area of 2D Panes checkbox in the Dimensions tab.

3 Snap button
Creates a 2D image of the currently displayed image views. All annotations are burned in
automatically.

4 Bottom Toolbar
Toolbar to manipulate the image display, see Bottom Toolbar (Tomo3D) [} 546].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 545


6 General Toolkits | 6.8 3Dxl Plus ZEISS

5 View Options
Area for general and specific view options.

6.8.1.1 Left Toolbar (Tomo3D)

Parameter Description
Zooms in or out of the image.

Top thumb wheel

Enables you to rotate the 3D image in any way you wish within the
space.
Rotate

Enables you to increase or reduce the zoom factor of the image area.

Zoom

Enables you to pan the 3D image.

Panning

Rotates the 3D image around the horizontal (X) axis.

Bottom thumb
wheel

6.8.1.2 Bottom Toolbar (Tomo3D)

Control element Description


Rotates the 3D volume around the vertical (Y) axis.

Left thumb wheel

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 546


6 General Toolkits | 6.8 3Dxl Plus ZEISS

Control element Description


Switches back to the start view from any view.
Home view A top view of the 3D volume is displayed. Lateral movements and the
zoom factor are adjusted so that the 3D volume can be seen at the
center of the image area.

Shows or hides a bounding box around the 3D volume.


Show bounding
box

Activated: Displays the cutlines in the 3D viewer.


Draw cutlines Deactivated: The cutlines are not displayed in the 3D viewer.

Rotates the 3D volume around the (Z) axis perpendicular to the screen
plane.
Right thumb wheel

6.8.1.3 Ortho Display Tab (Tomo3D)

Parameter Description
Cut Lines Sets the positions (pixel values) for the section lines using the X/Y/Z
sliders or input fields.
Alternatively you can also adjust the positions directly in the image
area. To adjust the positions, move the mouse over a section line in
the image. Hold down the left mouse button and move the mouse.

- Mid Positions the relevant slider at the center of the view.

Line Width Only visible if the Show All mode is activated.


Enter the thickness of the section lines in pixels using the sliders or in-
put fields. This results in a maximum intensity projection being dis-
played over the selected pixel width.
You can also adjust the width directly in the image area. To adjust the
width, move the mouse over a section line in the image until a small
arrow is displayed. Hold down the left mouse button and move the
mouse.

Cut Line Opacity Only visible if the Show All mode is activated.
Here you can enter the degree of opacity of the section lines from 0%
(invisible) to 100% (completely opaque).

Views Only visible if the Show All mode is activated.


Sets the number and allocation of views in the Image View.

- Displays four views.

- Displays one view.

- Displays two vertically separated views.

- Displays two horizontally separated views.

- Displays three vertically separated views.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 547


6 General Toolkits | 6.8 3Dxl Plus ZEISS

Parameter Description
- Displays three horizontally separated views.

6.8.1.4 Appearance Tab (Tomo3D)

Here you can define the appearance of the 3D volume. On the tabs available on this tab, select
the setting that you want to change (e.g. Transparency).

6.8.1.4.1 Transparency Tab (Tomo3D)

Parameter Description
Here you can select the channel of a multichannel image for which
you want to set the transparency.

Channel selection

Threshold Sets the lower threshold value in percent of the gray levels displayed.
With this setting you specify the gray value range for the relevant
channel that you want to be included in the rendered image.

Ramp Sets the extent of the transition from completely transparent to com-
pletely opaque (0-100 percent).

Maximum Sets the level of opacity (0-100 percent).

Histogram Displays the settings that you enter using the sliders schematically.
The x axis represents the gray level values and the y axis the opacity.
You can also change the position of the curve using the mouse.

Reset Resets all parameters to the original values.

Opacity 2D Sets the opacity of the selected volume in the 2D views.

6.8.1.4.2 Background Tab

Parameter Description
Background Color Sets the background color for the 3D view. To do this, click on the
color field and select the desired color.

Reset Resets the background color.

6.8.1.4.3 Light Tab

Parameter Description
Brightness Sets the brightness of the light source.

Reset Resets the brightness.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 548


6 General Toolkits | 6.9 Macro Environment ZEISS

6.8.1.5 3D Tab (Tomo3D)

Here you can specify which projection/rendering mode you want to use to display the 3D volume.
There are three view modes available. To activate the desired view mode, click on the correspond-
ing button.

Parameter Description
Transparency Activates the Transparency rendering mode where the structures in
the image are rendered in a similar fashion as in the Volume mode.
This render mode is particularly suitable for dense image data. The
key difference is an applied edge enhancement filter to allow more
focus on relevant structures within the data while simultaneously fad-
ing out homogenous and less important areas.

Volume Activates the Volume mode where the structures in the image are
rendered as three-dimensional objects and illuminated by means of a
virtual light source. This allows a realistic and, in contrast to the maxi-
mum projection mode, a quantitative display of the volume.

Maximum Activates the Maximum intensity projection mode where only the
pixels with the highest intensity are displayed along the observation
axis.

6.8.1.6 Create Image Tab

This tab enables you to create an image of the current view(s).

Parameter Description
Resolution Selects the resolution for the image. You have the following options:
§ Current Resolution
§ 720 x 576 (SD)
(SD = Standard Definition)
§ 1024 x 768
§ 1920 x 1080 (HD)
(HD = High Definition)
§ 4096 x 3072 (4K)

Create Creates an image of the current view and opens it in ZEN.

6.9 Macro Environment

The acronym OAD for Open Application Development is a term describing both the OAD platform
on ZEN as well as the process of developing applications on it. The platform has been made avail-
able for our customers to enhance the functionality of ZEN in a flexible way. With OAD typical mi-
croscopy workflows can be integrated into the ZEN software. A short list of OAD highlights:
Macro Interface to access the major functionality of ZEN and its objects and the access to external
libraries like the .Net Framework to significantly enlarge the field of application.
The software offers the following components which we regard as main parts for Open Applica-
tion Development (OAD):

§ Macro Runtime Environment (integrated)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 549


6 General Toolkits | 6.9 Macro Environment ZEISS

§ Macro Recorder
§ Macro Editor
§ Macro Debugger
§ Macro Interface (Object Library)
§ ImageJ Extension

Basic functionality
All ZEN products (ZEN lite excluded) come with a basic macro functionality which allows to play
existing macros within the software (using the Macro tool).

Info
Within the software you can only run .czmac macro files which are recorded or saved in the
ZEN macro environment. To run your own macros later on they must be located in the folder:
…/User/Documents/Carl Zeiss/ZEN/Documents/Macros.

Licensed functionality
When you have licensed the Macro Environment functionality you will get the:

§ Macro Recorder,
§ Macro Editor and
§ Macro Debugger.
In the Right Tool Area you find the Macro tool [} 979]. The Macro Editor dialog allows you to
generate and work with macros similar to Excel/Word macros. The macro interface is part of ZEN
software and therefore not a separate product. The ImageJ Extension is the first extension for
ZEN and will be free of charge.

User forum
A user forum was established to allow users to exchange macros and to discuss solutions. You
will find a lot of example macros and further documentation there. The user forum can be
reached under www.zeiss.com/ZEN-OAD.

6.9.1 Running an Existing Macro

Prerequisite ü You run a licensed version of ZEN software. Note that the macro environment is not available
for the free of charge version ZEN lite.
ü You have a macro file available that you want to run in the software.
1. Copy your macro file in the following folder:
.../User/My Documents/Carl Zeiss/ZEN/Documents/Macros.
2. Start the software.
3. In the Right Tool Area open the Macro tool.
à You see your macro in the list under User Documents.
4. Select your macro.
5. Click on the Run button.
Your macro is executed. You have successfully played a macro in ZEN.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 550


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

6.9.2 Recording a Macro

This guide shows how to record a macro of a simple processing workflow.

Prerequisite ü You have licensed the Macro Environment module.


ü You are in the Right Tool Area in the Macro tool.
1. Click on the Record button.
2. Load a color image via the menu File > Open…
3. Go to the Processing tab.
4. Under Method select Edges > Sobel.
5. Under Method Parameters > Normalization select the entry Clip.
6. Under Image Parameters set your color image as Input Image.
7. At the top of the Processing tab, click on the Apply button.
à The Sobel method will be applied to your image. The output image will be generated
and opened in a new image container.
8. In the Macro tool click on the Stop button.
You have successfully recorded a macro for a simple processing workflow. The workflow can now
be repeated automatically just by playing the recorded macro file.

6.10 Physiology (Dynamics)

This module enables the analysis of physiological time series data with Ca2+calibration, including
mean ROI measurement. It supports imaging with single wavelength (e.g. Fluo-4) and dual wave-
length dyes (e.g. Fura-2) allows ratio calculations and flexible charting and image display as well
as data table display with data export functionality. It also offers the use of definable switches for
online annotations, changing of acquisition speed and freely configurable TTL triggers. Some
functionality is generally available, for the full set of features you need the dedicated license for
the module, see Licensing and Functionalities of Physiology [} 551].

See also
2 Acquiring Time Series Images [} 390]

6.10.1 Licensing and Functionalities of Physiology

Some basic functionality for physiology experiments is generally available in the software, but the
full Physiology (Dynamics) functionality requires a license.

Basic functionality
The basic functionality is available for time series images and time series with z-stack images
opened in the software (excluded ZEN lite), or multi-positions (scenes) where a full time series is
collected sequentially at each position (Full time series per tile Region). Note that for acquiring
time series images, you also need the license for the Time Series module. The functionality gen-
erally available in ZEN includes:

§ Using the MeanROI offline functions to specify user-defined measurement regions (ROIs) af-
ter acquisition of your time lapse experiment and analyze their time-dependent changes in in-
tensity.
§ The functionality to display the intensity curves in charts or export the values in the form of
tables.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 551


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

§ Definable switches for online annotations and change of acquisition speed. Pausing and refo-
cusing are possible via a live camera view.

Licensed Functionality
If you have licensed the module Physiology (Dynamics) and activated it in Tools > Modules
Manager, the additional functionality includes:

§ The option to calculate online/offline (during/post acquisition) ratios and display a ratio image.
§ Additional display layouts and analysis functions (ROI tracing etc.).

6.10.2 Opening the MeanROI View

Prerequisite ü You have acquired a time series experiment with one or more channels. The experiment is
open and the first time point is displayed in the 2D view.
1. Select the MeanROI tab from the image view tabs in the Center Screen Area.
à The MeanROI view opens.
You are now prepared to start working with the MeanROI view. The following chapters will
show you the first steps.

6.10.3 Workflow MeanROI View (Offline)

6.10.3.1 Drawing in ROIs

Prerequisite ü You are in the MeanROI View or in the MeanROI Setup on Acquisition tab.
1. Go to the Graphics tab in the View Options.
2. Select a tool for drawing in ROIs, e.g. the Polygon tool.
3. Activate the Keep tool checkbox.
à The selected tool remains active after you have drawn in an ROI. This means you can
draw in several ROIs without having to re-select the tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 552


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

4. Using the selected tool, in the image view draw in the objects or regions (ROIs) for which
intensity measurements are required.

à The ROIs are displayed in the list (Annotations/ Measurements Layer) on the Graphics
tab.
à Intensity measurements are performed for each ROI and displayed in the chart area to
the right of the image view.
You have successfully defined measurement regions for the intensity measurement.

Info
Measurement time
Note that the time taken to initially create measurements will vary as some date is cached to
memory. Thus, when a long time series image is opened that already contains ROIs, you might
have to wait briefly until ZEN completes its measurements. The duration depends on e.g. num-
ber of ROIs, number of time points, image size, number of pixels etc.

6.10.3.2 Adjusting ROIs for Time Points

If objects move laterally in the course of the time series, you can adjust the ROIs at each Time
Point in order to follow the objects.

Prerequisite ü You have defined at least one ROI.


ü You are in the MeanROI view.
1. Open the Dimensions tab in the general view options.
2. Use the Time slider to scroll through the time points. Stop at the first time point at which
you want to adjust a ROI.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 553


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

3. Open the ROI Tracing tab and activate the Enable ROI Tracing checkbox. To edit the po-
sition of a single Key frame change the Key Frame Edit Mode to single mode .
Note that you can only select the key frame edit mode if the frame number is set to a value
>1.
4. Adjust the position of the ROI using drag & drop. To do this, select the ROI in the image
area by pressing the left mouse button. Then move the ROI to the new position and release
the mouse button. Note that rectangular or contour ROIs can also be rotated.
5. If necessary, you can change the shape of a ROI, by right-clicking on a ROI and selecting
Edit Points (e.g. for polygon contours). It is also possible to rotate a ROI if necessary.
Note that if the area of the ROI changes, the mean intensity value will change. For ratio val-
ues in which thresholding is applied, only "valid" pixels will be respected (see Basics of Cal-
culation of Intensity and Ratio Values [} 557]). Ratios can only be performed if you have
the module Physiology (Dynamics).
6. Adjust the shape/ rotation of the ROI, by drag & drop the contour points/ via the rotation
handle.
à Changes to the position and shape of the ROIs are adopted for all subsequent time
points.
7. Repeat the previous steps for all other time points for which you want to adjust an ROI.
For a selected ROI you can see a list of the time points in which its position/shape was
modified. As the distance (in frames) between each key frame can vary, a linear interpola-
tion is used to smoothly progress the ROI through the time points. Alternatively, deactivate
this (constant) or set it to a spline method that may better describe the progression of the
object you are tracing.
You have successfully adjusted the measurement regions to the course of the experiment.

6.10.3.3 Adjusting the Display

Here you will find out how to adjust the display of the measured intensity values in charts and ta-
bles according to your wishes.

Prerequisite ü You are in the MeanROI view or MeanROI Setup.


ü You have defined at least one ROI.
1. Select the Layout tab in the view options.
2. To adjust the layout of the image and diagram display, select the desired display mode un-
der Image and Chart.
3. If you also want your data to be displayed in table form (note for MeanROI setup the table
is only displayed after the acquisition is completed), select the desired display mode under
Image and Chart with Table. With the Export tab, you can export the data table directly
as a comma separated values file or create a separate data table document.
Tables created in this manner contain additional information, for details see Basics of Cal-
culation of Intensity and Ratio Values [} 557]. The table in the MeanROI view only shows
two values per ROI and time point, the mean intensity of pixels above the set threshold per
channel and the mean ratio value derived from (common) "valid" pixels.
4. In the MeanROI view (not the MeanROI setup) you can interact with a table in various
ways. See Interaction with a Table in MeanROI View [} 558].
5. You can determine the zoom (range) of the charts of all given channels (including Ratio
charts) by clicking on the chart, selecting it, and scrolling with the mouse wheel.
6. For Offline Analysis only: Select a suitable layout for the image, chart and table display.
7. If you want to adjust the axis scaling (range), go to the Charts tab in the view options.
8. To define the minimum and maximum values of the axes manually, click on the Fixed but-
ton under X-/Y-Axis.
à The Min and Max input fields for the axis are activated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 554


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

9. Enter the desired values first into the Max and then the Min input fields.
à The minimum and maximum axis values of the diagrams are adjusted. Note that the Y-
axis scaling can be adjusted individually for each chart.
10. To change the unit of the X axis, click on the Fixed button under X Units.
à The dropdown menu for the units is activated. You can now select the desired unit.
11. On the Layout tab, it is also possible to determine if a given channel view and/ or chart
panel should be hidden. This is useful if these do not contain information that needs to be
visible, thus increasing space on the screen for the remaining items. For example, in many
applications transmitted light is used to monitor the specimen, but the intensity information
(chart) is not required. The controls behave in a similar manner to the channel toggles on
Dimensions tab.
You have successfully adjusted the display of the intensity values.

6.10.3.4 Using Background Correction

Use this function to subtract background values from the measurement values. A background cor-
rection will allow you to make a better comparison of the magnitude of any fluorescent intensity
changes observed over the time course of an experiment. Determine the background value with
the help of a Background ROI or define a fixed value. Note that the background correction for ROI
is only available if there are at least two ROI defined in the image!
If the ratio calculations are enabled, the background correction parameters are defined on the Ra-
tio tab. The background correction values on MeanROI tab are disabled, i.e. not used in this
case.

Defining a Background ROI

Prerequisite ü You are in the MeanROI view or MeanROI setup.


1. At the desired time point of the time series, draw a ROI into a part of the image that con-
tains only background signal in all channels.
2. Go to the MeanROI tab > Background Correction section and activate the radio button
ROI. Note that this function is only available if two or more ROIs are present.
3. In the drop down, select the ROI-ID of the ROI that you defined in the first step.
4. To edit the Background ROI, simply draw a new ROI and select it from the dropdown list.
You have successfully defined a Background ROI. The mean intensity of the background ROI is
subtracted from the measured values of the ROIs in a channel- and time-point-specific manner.
The corrected values are adopted into all diagrams and tables.

Defining a fixed background value

Prerequisite ü You are in the MeanROI View or MeanROI Setup.


1. On the MeanROI tab in the Background Correction section select the Constant option.
à The associated input field is activated.
2. Enter a fixed background value into the Constant input field.
3. Press Enter to update the measurements.
The defined background value is subtracted from all measured values of the ROIs in a time-point-
specific manner.

6.10.3.5 Exporting a Data Table

Prerequisite ü You are in the MeanROI view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 555


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

ü You have defined at least one ROI.


1. Select the Export tab in the View Options.
2. In the Data Table section click on the Save As (*.csv) button.
à The Save As dialog opens.
3. Enter a suitable file name, navigate to the desired folder and click on Save.
à All the measurement data are saved as comma-separated values in a csv file. This con-
tains the time information, marker events, the geometric area of the ROIs, the area of
ROI adjusted by threshold (only with Physiology (Dynamics) module), the mean inten-
sity of the ROI, the mean intensity of the ROI adjusted by threshold (only with Physiol-
ogy (Dynamics) module), mean ratio value (only with Physiology (Dynamics) module),
focus position, and incubation events/ values (if configured) for each channel and each
ROI.

6.10.3.6 Calculating a Ratio for One Wavelength

Prerequisite ü To calculate ratios (quotient of two fluorescence intensities) and display ratio images, you
need the Physiology (Dynamics) module.
ü You have a suitable image data set open.
ü You are in the MeanROI view on the Ratio tab (view option).
1. Activate the checkbox Enable Ratio Calculation.
2. In the Method dropdown list, select the Single Wavelength (F/F0) entry.
3. In the Calculation dropdown list select the channel for calculating the ratio.
4. In the Reference image (Ft0) setup, define the frames of the time series image from which
you want the reference value Ft 0 to be calculated.
5. Click on the Update button.
à The ratio values are calculated. The ratio image and a diagram for the ratio values are
displayed in the MeanROI view. For very large images (pixels and time points) it might
be necessary to use the Cache Ratio Image function on the Ratio tab, as this will elimi-
nate flickering when playing through the images at speed.
You have successfully calculated a ratio for a single wavelength dye such as Fluo-4.

6.10.3.7 Calculating a Ratio for Two Wavelengths

Prerequisite ü To calculate ratios (quotient of two fluorescence intensities) and display ratio images, you
need the Physiology (Dynamics) module.
ü You have a suitable image date set open.
ü You are in the MeanROI View on the Ratio tab (view option).
1. In the Method dropdown list select the Dual Wavelength or any other of the Ratio Type
formulas present. entry.
2. In the Calculation dropdown lists select the channels for calculating the ratio.
à The ratio values are calculated automatically.
3. Click on the Cache ratio image button to cache all the ratio images of the current time se-
ries with the given ratio calculation parameters.
à The ratio values are calculated. The ratio image and a ratio diagram are displayed on the
MeanROI view. For very large images (pixels and time points) it might be necessary to
use the Cache Ratio Image function on the Ratio tab, as this will eliminate flickering
when playing through the images at speed.
You have successfully calculated a ratio for a dual wavelength dye such as Fura-2.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 556


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

6.10.3.8 Basics of Calculation of Intensity and Ratio Values

The ratio calculation in ZEN blue MeanROI/Physiology functions in the following manner:
After you have set up the ratio to your satisfaction (background correction/thresholding), you can
gather/ view all the results using the export functions found on the export tab in MeanROI view.
You can also view a smaller table within the MeanROI view itself by activating the appropriate
layout.
How are your threshold and background values handled for intensity and ratio measurements?
The threshold value will be applied prior to background subtraction if both are active. If this is this
is the case, then for charts/tables the intensity values of any given ROI are handled this way: if a
pixel in the ROI is under the threshold value, it will be ignored for the calculation of the mean
value of the ROI. After that the background is subtracted from the mean value to get the cor-
rected intensity value of the ROI (note if no pixel remains valid in the ROI after the application of
the threshold, the corrected mean intensity is always 0 and hence the ratio is also 0). In the case
of the ratio image, each pixel is "validated" based on the threshold value. If the pixel is above the
threshold, then the pixel value is kept (i.e. is valid), otherwise it is set as NaN (Not a Number,
which is not the same as zero) and is considered invalid). As before, background correction is
done after threshold. If the pixel value is NaN, the ratio pixel value is NaN. If the pixel is still valid
then use pixel value - background value in the ratio calculation. If a negative value results, it is
clipped to 0.
The following example shows how a ratio value is generated based on the applied background
and thresholding values:
Consider a region of interest that is 6 pixels wide by 1 pixel high. The pixels of the region in the
Wavelength 1 image are as follows:
[50, 75, 100, 125, 150, 175].
For the purpose of this example, assume the threshold = 60 for wavelength 1.
ZEN thresholds Wavelength 1 to obtain:
[--, 75, 100, 125, 150, 175].
The pixels of the region in the Wavelength 2 image are as follows:
[25, 25, 25, 25, 100, 100].
For the purpose of the example, assume the threshold = 50. ZEN thresholds Wavelength 2 to ob-
tain:
[---, ---, --- , ---, 100, 100].
ZEN computes the Ratio by only rationing the averaged values for the valid pixels in each individ-
ual wavelength. To recap, the pixels for each wavelength were:
[--, 75, 100, 125, 150, 175] (Wavelength 1)
[---, ---, --- , ---, 100, 100] (Wavelength 2)
The ratio value of this region is calculated by taking into account only the common area, which
corresponds to the area of the sum of the valid pixels common to the two wavelengths (which in
this example is only 2 “valid” pixels).
Using the threshold values as above, the pixels that are used to calculate the ratio average are:
150/100
175/100
which gives a ratio of 1.625.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 557


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

To get an overview of all the results, including the original values not corrected for their validity in
this manner, use the data table creation function in the MeanROI export tab. This opens, for ex-
ample, a new document or allows you to export the results as a *.csv file. This data table/ *.csv in-
cludes for each ROI the following information/measurements:

Value in ID in table header Description


<Channel name>_<Region Geometric area of ROI (constant for both chan-
ID>_Area nels).

<Channel name>_<Region ID>_In- Threshold corrected area within ROI for given
tensityAreaThrs channel.

<Channel name>_<Region ID>_In- Mean intensity of pixels within the geometric area
tensityMean of the ROI.

<Channel name>_<Region ID>_In- Mean intensity of pixels above the set threshold
tensityMeanThrs for the given channel.

Ratio <Region ID> Mean Ratio value derived from common “valid”
pixels.

This is repeated for the second channel, and at the very end you will find the Ratio value. Thus,
the threshold corrected values are provided for each channel (mean intensity and the correspond-
ing area from which this is derived) as well as the ratio value for the common valid pixels. Relative
time, markers, focus values and parameters from the incubation (if configured) are also listed. In
the embedded table in Mean ROI view you will find a summary that gives the following values:
Mean intensity of pixels above the set threshold for each channel (wavelength) and the corre-
sponding ratio values. No Area values are given here.

6.10.3.9 Interaction with a Table in MeanROI View

In the MeanROI view (not the MeanROI setup) you can interact with a table in the following
ways:

§ Scroll up or down or left to right. Time values are given at the far left and at the far right any
markers are shown at the time point they were created. In between you find the values for
each ROI in the first channel, then the second and so on, then the ratio values.
§ If you click on the column header you select the entire column and in your charts, you will see
the trace corresponding to this ROI is highlighted by a thicker line. Multiple columns can be
selected by pressing and holding shift key.
§ If you click any given value in a column, not only will the trace of the corresponding ROI be
highlighted, the images that correspond to this time point will be displayed, and the playhead
(vertical blue line) of all charts will synchronise to this time point. This allows quick and easy
examination of the data/ events.

6.10.4 Workflow Physiology (Dynamics) Experiments

If you own the Physiology (Dynamics) module you can use the MeanROI setup to specify user-
defined measurement regions (ROIs) before the acquisition of your time lapse experiment and an-
alyze their time‑dependent changes in intensity online during acquisition. Ratios can also be calcu-
lated and displayed online - these are the typical functions used in physiology/ calcium Fura-2 ap-
plications.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 558


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

Before the experiment


A precondition for a physiology experiment is a Time Series experiment (which can include a z-
stack acquisition), which is set up in the Time Series tool. Adding a time dimension to your ex-
periment allows you to activate the optional tool Dynamics. This tool contains the button for
opening MeanROI Setup. Here you can draw in ROIs and adjust the display layout of the mea-
surement results. Note that when the setup is opened a snap is automatically acquired, on the ba-
sis of which you can configure the settings for the subsequent experiment, like for example the
ratio parameters. The structure of the MeanROI setup is based on the MeanROI view [} 566],
making it easier to learn. Note that online measurements on tiles and positions experiments are
not possible, but you can perform measurements on tiles or position data collected over time (i.e.
multi-scene time series) in MeanROI view post-acquisition.

During the experiment


After being started, physiology experiments are displayed in the online mode of the MeanROI
View. This allows you to analyze and follow the experiment during acquisition. The structure and
options largely correspond to the offline mode of the MeanROI View. We therefore recommend
that you familiarize yourself with the MeanROI View (offline) [} 552] before performing your
Physiology experiment.

After the experiment


After you have performed your Physiology experiment the data are displayed in the offline mode
of the MeanROI view and can be analyzed, processed and exported there. For more information,
see also Workflow MeanROI View (Offline) [} 552].

Prerequisite ü To perform physiology experiments, you need the Physiology (Dynamics) module.
ü You have created a new experiment, defined at least one channel and adjusted the focus and
exposure time, see also Setting Up a New Experiment [} 51] and Acquiring Multi-Channel
Images with Cameras [} 51].
ü You have licensed the Time Series module and activated it in Tools > Modules Manager.
ü You are on the Acquisition tab.
1. Activate Time Series in the Acquisition Dimensions section.
à The Time Series tool is displayed in the Left Tool Area under Multidimensional Ac-
quisition.
2. Activate Dynamics in the experiment manager.
à The Dynamics tool now is displayed in the in the Left Tool Area under Applications.
à Note that the tool is not available if the Tiles or Panorama dimensions are activated.
Deactivate these dimensions to make the tool available.
3. Set up a time series experiment, see Acquiring Time Series Images [} 390].
4. Open the Dynamics tool.
5. Click MeanROI Setup.
You have completed the general prerequisites for Physiology experiments.

6.10.4.1 Setting up the Online Ratio Calculation

Prerequisite ü You have read the Workflow Physiology (Dynamics) Experiments [} 558] chapter.
1. In the MeanROI setup, select the Online Ratio tab in the view options .
2. Activate the Activate Live Ratio Generation checkbox.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 559


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

3. In the Method dropdown list select a method for the ratio calculation. If you select the
Single wavelength (F/F0) method for the calculation of the online ratio, you need to de-
fine a reference image. See Calculating the Online Ratio for Single Wavelength [} 560].
4. If you want to use background correction for the calculation of the online ratio, activate the
desired entry under Background Correction. Note that activating Ratio fruitions in Online
Ratio/ Ratio tab deactivates the background correction settings on MeanROI tab, i.e. the
background functions of these tabs are mutually exclusive.
à To allow you to apply a constant background value (Constant entry), an input field, in
which you can enter the desired value, appears in the formula for the ratio calculation.
à The ROI entry can only be selected once you have defined at least two ROI in your im-
age.
5. Under Calculate complete the formula for calculating the online ratio by selecting the de-
sired entries from the dropdown lists and indicating values in the input fields.
6. Activate the Threshold checkbox, if you want to set a threshold in your experiment. For
information on the calculation of the ratio value R in relation to thresholds, see Calculation
of the Ratio Value R [} 560].
7. You can adjust the settings for the ratio calculation as required and the preview image on
the MeanROI setup is adapted accordingly. Press the Snap button if you need to update
the images.
You have successfully activated/adjusted the calculation of the online ratio.

6.10.4.1.1 Calculating the Online Ratio for Single Wavelength

If you set up your online ratio calculation and select the Single wavelength (F/F0) method for
the calculation of the online ratio, you need to define a reference image.

Prerequisite ü You are setting up an online ratio calculation (see also Setting up the Online Ratio Calcula-
tion [} 559]).
ü You have selected the Single wavelength (F/F0) as the calculation method.
1. In the Online Ratio tab, in the input field of Reference Image Set-up, enter the number
of images from which the reference image should be averaged.
2. Click on Define.
The images are acquired, and a reference image is calculated from them. You can now continue
to set up the online ratio calculation [} 559].

6.10.4.1.2 Calculation of the Ratio Value R

In ZEN the calculation of the ratio value R of an individual pixel xy in case of a dual wavelength
dye is determined as followed:

where:
Ch1xy = 0 if (Ch1xy - background of Ch1) < Threshold of Ch1
Ch1xy = Ch1xy - background of Ch1 if (Ch1xy - background of Ch1) > Threshold of Ch1
The same is true for Ch2xy using the corresponding values for background and threshold.

6.10.4.2 Setting up an Experiment in MeanROI Setup

Prerequisite ü You have read the Workflow Physiology (Dynamics) Experiments [} 558] chapter.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 560


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

1. Activate the Dynamics checkbox in the Experiment Manager.


2. In the Dynamics tool, click on the MeanROI Setup button.
à MeanROI setup opens.
à An image is acquired automatically on the basis of which you can configure your set-
tings. You can click on Snap at any time to update the image.

6.10.4.2.1 Drawing in ROIs

Prerequisite ü You are in the MeanROI View or in the MeanROI Setup on Acquisition tab.
1. Go to the Graphics tab in the View Options.
2. Select a tool for drawing in ROIs, e.g. the Polygon tool.
3. Activate the Keep tool checkbox.
à The selected tool remains active after you have drawn in an ROI. This means you can
draw in several ROIs without having to re-select the tool.
4. Using the selected tool, in the image view draw in the objects or regions (ROIs) for which
intensity measurements are required.

à The ROIs are displayed in the list (Annotations/ Measurements Layer) on the Graphics
tab.
à Intensity measurements are performed for each ROI and displayed in the chart area to
the right of the image view.
You have successfully defined measurement regions for the intensity measurement.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 561


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

Info
Measurement time
Note that the time taken to initially create measurements will vary as some date is cached to
memory. Thus, when a long time series image is opened that already contains ROIs, you might
have to wait briefly until ZEN completes its measurements. The duration depends on e.g. num-
ber of ROIs, number of time points, image size, number of pixels etc.

6.10.4.2.2 Adjusting the Display

Here you will find out how to adjust the display of the measured intensity values in charts and ta-
bles according to your wishes.

Prerequisite ü You are in the MeanROI view or MeanROI Setup.


ü You have defined at least one ROI.
1. Select the Layout tab in the view options.
2. To adjust the layout of the image and diagram display, select the desired display mode un-
der Image and Chart.
3. If you also want your data to be displayed in table form (note for MeanROI setup the table
is only displayed after the acquisition is completed), select the desired display mode under
Image and Chart with Table. With the Export tab, you can export the data table directly
as a comma separated values file or create a separate data table document.
Tables created in this manner contain additional information, for details see Basics of Cal-
culation of Intensity and Ratio Values [} 557]. The table in the MeanROI view only shows
two values per ROI and time point, the mean intensity of pixels above the set threshold per
channel and the mean ratio value derived from (common) "valid" pixels.
4. In the MeanROI view (not the MeanROI setup) you can interact with a table in various
ways. See Interaction with a Table in MeanROI View [} 558].
5. You can determine the zoom (range) of the charts of all given channels (including Ratio
charts) by clicking on the chart, selecting it, and scrolling with the mouse wheel.
6. For Offline Analysis only: Select a suitable layout for the image, chart and table display.
7. If you want to adjust the axis scaling (range), go to the Charts tab in the view options.
8. To define the minimum and maximum values of the axes manually, click on the Fixed but-
ton under X-/Y-Axis.
à The Min and Max input fields for the axis are activated.
9. Enter the desired values first into the Max and then the Min input fields.
à The minimum and maximum axis values of the diagrams are adjusted. Note that the Y-
axis scaling can be adjusted individually for each chart.
10. To change the unit of the X axis, click on the Fixed button under X Units.
à The dropdown menu for the units is activated. You can now select the desired unit.
11. On the Layout tab, it is also possible to determine if a given channel view and/ or chart
panel should be hidden. This is useful if these do not contain information that needs to be
visible, thus increasing space on the screen for the remaining items. For example, in many
applications transmitted light is used to monitor the specimen, but the intensity information
(chart) is not required. The controls behave in a similar manner to the channel toggles on
Dimensions tab.
You have successfully adjusted the display of the intensity values.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 562


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

6.10.4.2.3 Using Background Correction

Use this function to subtract background values from the measurement values. A background cor-
rection will allow you to make a better comparison of the magnitude of any fluorescent intensity
changes observed over the time course of an experiment. Determine the background value with
the help of a Background ROI or define a fixed value. Note that the background correction for ROI
is only available if there are at least two ROI defined in the image!
If the ratio calculations are enabled, the background correction parameters are defined on the Ra-
tio tab. The background correction values on MeanROI tab are disabled, i.e. not used in this
case.

Defining a Background ROI

Prerequisite ü You are in the MeanROI view or MeanROI setup.


1. At the desired time point of the time series, draw a ROI into a part of the image that con-
tains only background signal in all channels.
2. Go to the MeanROI tab > Background Correction section and activate the radio button
ROI. Note that this function is only available if two or more ROIs are present.
3. In the drop down, select the ROI-ID of the ROI that you defined in the first step.
4. To edit the Background ROI, simply draw a new ROI and select it from the dropdown list.
You have successfully defined a Background ROI. The mean intensity of the background ROI is
subtracted from the measured values of the ROIs in a channel- and time-point-specific manner.
The corrected values are adopted into all diagrams and tables.

Defining a fixed background value

Prerequisite ü You are in the MeanROI View or MeanROI Setup.


1. On the MeanROI tab in the Background Correction section select the Constant option.
à The associated input field is activated.
2. Enter a fixed background value into the Constant input field.
3. Press Enter to update the measurements.
The defined background value is subtracted from all measured values of the ROIs in a time-point-
specific manner.

6.10.4.3 Starting and Influencing an Experiment

Prerequisite ü You have read the Workflow Physiology (Dynamics) Experiments [} 558] chapter and set up
an experiment in MeanROI Setup.
ü You are on the Acquisition tab.
1. Start your Physiology experiment by clicking on the Start Experiment button.
à The time series experiment is started. The MeanROI View [} 566] (online) opens and dis-
plays the current images and the intensity curves for each ROI measured online. The in-
tensity curves are displayed in the Time Line View and in the diagrams. Note that the
MeanROI view will display at the third time point. This is noticeable when the interval
time is longer. Thus this display delay should fall into the typically base line of this type of
experiments, i.e. prior to the first stimulus of the sample.
2. You can pause the experiment at any time by clicking on the Pause Experiment button
and continue it again by clicking on the Continue Experiment button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 563


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

3. The Focus can be adjusted during the experiment. To prevent images that are not sharp
being acquired, pause your experiment and use the Live acquisition button to adjust the fo-
cus. Then continue the experiment. Note that using the Live view only works with experi-
ments run in interactive mode. In triggered acquisition scenarios this is not possible.
4. Adjust the display of the intensity values during the experiment by changing the settings on
the Layout or Charts tab. The unit of the X-axis cannot be changed during the experi-
ment.
5. You can move and change ROIs during acquisition. The changes are adopted for all time
points, see Drawing in and adjusting ROIs. Note that ROI tracing functions (these allow ob-
jects to be followed in XY) are only available after an acquisition.
6. Activate Switches in the Time Series tool during the experiment to perform the corre-
sponding actions.
à Various events, such as the activation of switches or the pausing of the experiment, are
labeled in the Time Line view by markers.
7. On the Dimensions tab deactivate the Follow Acquisition checkbox to analyze the data
acquired up to that point. To do this, select the corresponding time points using the Time
slider, the diagram sliders or the Time Line view slider in the MeanROI view.
8. Change the size of the area marked in blue in the Time Line View to adjust the section dis-
played in the charts (time axis).
You have successfully started the experiment, analyzed it online and influenced it.

6.10.4.3.1 Adjusting ROIs during Experiments

If objects move laterally in the course of the experiment, you can adjust the ROIs at any time dur-
ing the experiment in order to follow the objects.

Prerequisite ü You have defined at least one ROI.


ü You have started your Physiology experiment.
1. In the Experiment Manger click on Pause experiment button.
2. Adjust the position of the ROI using drag & drop. To do this, select the ROI in the image
area by left-clicking and hold the mouse button down. Then move the ROI to the new po-
sition and release the mouse button.
3. To change the shape of an ROI left click on an ROI and drag the bounds to adjust the size.
à Changes to the position and shape of the ROIs are adopted for all time points.
4. Repeat the previous steps for all subsequent ROIs that you wish to adjust. Note that you
can select multiple ROIs and adjust all the positions simultaneously.
You have successfully adjusted the measurement regions (ROIs) to the course of the experiment.

6.10.5 Sample Experiment Fura-2 with DG4/5

6.10.5.1 Step 1: Creating Channels

Prerequisite ü To perform the experiment, you need the Physiology (Dynamics) module.
ü You have a Sutter DG4/5 with appropriate excitation filters for Fura-2 and a Fura-2 filter
set in the microscope's reflector wheel.
ü You are on the Acquisition tab.
1. Create a new experiment in the Experiment Manager, e.g. "Physiology Fura-2".
2. Add the channel Fura-2 using Smart Setup.
3. Activate the Time Series checkbox in the acquisition dimensions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 564


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

4. Open the Channels tool.


5. Select the Fura-2 channel from the list.
6. Click on Options and select Duplicate.
7. Select the first Fura-2 channel from the list.
8. Click on the Options and select Rename.
à You can now rename the channel, e.g. Fura-2 340 nm.
9. Repeat steps 7 and 8 to rename the second channel, e.g. Fura-2 380 nm.
10. Select the Fura-2 380 nm channel.
11. Select another LUT from the dropdown list, e.g. red.
12. Select the entry 21 HE Ex. FURA 380 from the Excitation dropdown list.
à The excitation filter is used for this channel.
13. Adjust the exposure time and focus for both channels.
You have created the channels for your experiment.

6.10.5.2 Step 2: Setting Up a Time Series and Creating Switches

Prerequisite ü You have licensed the Time Series module and activated it in Tools > Modules Manager.
1. Open the Time Series tool.
2. Using the Duration slider and the dropdown list for the unit, specify the duration of the ex-
periment, e.g. 10 min.
3. Using the Interval slider and the dropdown list for the unit, specify the length of the inter-
val between acquisitions, e.g. 1 second.
4. To create interactive switches open the Interactive Switches section in the Time Series
tool. This section is visible only if the Show All mode is activated.
5. Click .
à A new switch is added.
6. Edit the switch by clicking on the arrow to the right of the switch.
à The switch properties are visible.
7. Enter a name, e.g. Fast. Activate the Color checkbox and select a color, e.g. blue. Define
an action to be performed when you activate the button, e.g. As fast as possible.
You have successfully set up a time series and created a switch.

6.10.5.3 Step 3: Setting Up an Online Ratio

1. Open the MeanROI setup from inside the Dynamics tool.


à Mean ROI definition opens and snaps of the configured channels are acquired automati-
cally and displayed in the Center Screen Area. The diagrams for each image are displayed
to the right of this.
2. Select the Online Ratio tab from the view options and activate live ratio generation.
3. Under Method select the Dual Wavelength entry from the dropdown list.
4. Under Calculation select the Fura-2 340 nm entry from the dropdown list in the numera-
tor of the formula.
5. Under Calculation select the Fura-2 380 nm entry from the dropdown list in the denomi-
nator of the formula.
à A preview of the ratio image, which is calculated according to the ratio settings, is dis-
played.
You have successfully activated the ratio functions and specified the calculation of the ratio.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 565


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

6.10.5.4 Step 4: MeanROI Setup

1. Open the MeanROI setup from inside the Dynamics tool.


2. On the Graphics tab, select a tool for drawing in ROIs, e.g. Circle.
3. Activate the Keep Tool checkbox.
4. Draw your ROIs into one of the images.
5. Deactivate the Keep Tool checkbox and select the selection tool (arrow) again.
6. On the Layouts tab select a layout for the image and diagram display, e.g. multichannel
image and single channel charts.
7. Go to Charts tab and click on the Fixed button under X Units and select a unit from the
dropdown list, e.g. seconds.
8. Click on Exit at the top left of MeanROI Setup.
You have successfully configured and adjusted the MeanROI Setup.

6.10.5.5 Step 5: Starting, Analyzing and Influencing an Experiment

1. Start the experiment by clicking on the Start Experiment button.


à The experiment is started. In our example an image is acquired every second for a period
of 10 minutes. The experiment opens in the online mode of the MeanROI View, which
displays the current images and measurements.
2. Activate the created switch at the desired time point. To do this, open the Switches sec-
tion in the Time Series tool. Click on a switch as soon as you want its action to be per-
formed, e.g. click on the "Fast" switch to acquire the subsequent images as quickly as pos-
sible one after the other. A marker will mark the time point at which the switch was acti-
vated on the X axis in the color of the switch (e.g. blue).
3. Once the time series has been completed you can analyze the experiment in the offline
mode of the MeanROI view, process it and export its values.
You have successfully performed the experiment.

6.10.6 Mean ROI View

In the Mean ROI view you can draw ROIs and measure their intensity profile after acquiring time
series experiments. The intensity profiles are displayed as charts and can be exported to data ta-
bles.

Info
4 The Physiology (Dynamics) module activates additional features to those of MeanROI for
the offline analysis of physiology experiments, e.g. Ratio functions and ROI tracing.
4 In this view the Image area is always to the left, charting area always to the right. Depend-
ing on which Region layout you have selected in Layout tab, the MeanROI view can have
a different appearance.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 566


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

1 2

1 Image area
Here you see the images for each channel of the time series and the ratio image (if the
ratio calculation is enabled). The display of images can be adapted in the Layout tab.

2 Charting Area
Here you see the charts for the values of all channels selected in the Layout tab as well
as for the ratio calculation (if it is enabled on the Ratio tab). If a ROI is selected in the im-
age area on the left, the corresponding plot line is highlighted (the plot line is thicker) in
the charts. The lines in the merged channel image can either have the color of the ROI,
or the color of the channel (option available on the Charts tab).
Playhead (blue line)
Indicates the current frame of the time series visible in the image panel(s). The position is
synchronized with the displayed image frame number and vice versa and it can be moved
via drag & drop. The current time point of the visible frame is displayed to the right of
the playhead line in the same time unit as the x-axis of the chart.

3 Table
Displays the values for all channels and regions at the different time points, as well as the
temperature, focus (if present in the image metadata) and information about markers. If
you deactivate a channel in the Visible Charts section of the Layout tab, the corre-
sponding columns are hidden in the table.
This table is synchronized with the image view and the charts. If you select a field in the
table, the corresponding ROI is selected in the image view and the charts (playheads) are
updated accordingly.

4 Time Line View


This view is activated in the Layout tab. The chart supports similar functions as the other
charts in MeanROI. Here you can limit the time range with the zoom functionality. The
actions in this chart are synchronized with the others in the MeanROI view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 567


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

5 View Options
Here you have your standard view options as well as specific options for MeanROI, for
example for the Layout or the calculation of the Ratio.

Info
Hover over the plot with the mouse (crosshair). A tool tip appears with details of the intensity
value at this position, ROI ID #, Channel, and time point (in currently set time unit of x-axis).
Note these values (intensity and time) are interpolated. You can visualize the time points alone
a plot by activation of the Show Tick marks function on the Chart tab.

6.10.6.1 Time Line View Panel

This chart supports similar functions as detailed for charts in Mean ROI.
1 2 3 4

Fig. 30: Time Line View Panel

1 Intensity data traces from measurement ROIs.

2 Zoom control
The transparent area (blue) is the user definable zoom range. The zoom range translates
into the display range of the x-axis of the other charts displayed above the time line view.
To edit the zoom range hover use the controls at either end. Click and hold the left
mouse to drag and resize the zoom area.

3 The center line (blue line) displays the playhead.

4 Markers with corresponding color code.

5 Chart data/intensity parameter selection check boxes


Depending on the available metadata different check boxes are available on the left side.
Only two parameters can be displayed at a given time. The combination can be chosen
as required.
When intensity parameters are displayed on the right side, it is possible to further select
which of the available channels and/ or ratio should be displayed. Channel intensity and
ratio intensity can be displayed in a mutually exclusive manner.

6.10.6.2 Mean ROI Tab

Parameter Description
Background Cor- If you have activated the Live Ratio Generation in the Online Ratio
rection tab, or the Ratio Calculation in the Ratio tab, the background cor-
rection is disabled here and only visible in the Online Ratio/ Ratio
tab. Also note that the correction for ROI is only available if there are
at least two ROI defined in the image!
The following modes are available:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 568


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

Parameter Description
- None No background correction is performed.

- Constant Allows a user defined numeric value to be entered for both channels
in the spin box.

- ROI Allows to select the background ROI, the determined value will be
channel specific.

Layout and Charts


Default Settings

- Define Default Defines the current layout and chart setup as the default. The layout
and charts can be changed in the Layout tab.

- Apply Default Displays the default setup for layout and charts.

Restart Measure- Only visible if the measurements calculation was canceled.


ments Restarts the measurements calculation.

6.10.6.3 Layout Tab

Parameter Description
MeanROI View Adjusts how the images, charts, and the table will be displayed.
Layouts

- Image and Selects one of three different layouts of how an image together with
Chart a chart will be displayed. If you click on one of the buttons the layout
will be changed.

- Image and Selects one of three different layouts of how an image and a chart to-
Chart with Ta- gether with a table will be displayed. If you click on one of the but-
ble tons the layout will be changed.

Visible Views Selects the channels for which the image should be displayed in the
image area.

- Single Channel Activated: Only one channel can be selected whose image is dis-
View played.
Deactivated: You can manually switch on/off channels whose images
should (not) be displayed.

Visible Charts Selects the channels for which the charts and table columns should be
displayed in the chart area and the table.

- Single Channel Activated: Only one channel can be selected whose chart and infor-
View mation is displayed.
Deactivated: You can manually switch on/off channels whose charts
and information should (not) be displayed.

Synchronize Charts Activated: Synchronizes the chart and channel settings.


and Channels

Show Markers/ Activated: The temporal position of any switches and markers are al-
Switches ways displayed on the charts both during acquisition or post-acquisi-
tion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 569


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

Parameter Description
Show Time Line Only visible if you have licensed the Physiology (Dynamics) module.
View Activated: The Time Line View panel is displayed below the other im-
age chart panels of the Center Screen Area. The Time Line View
panel is designed to provide an overview of the experiment whilst al-
lowing the user to examine the detail displayed in the other chart
panels by means of an integrated zoom tool. The Time Line View can
be hidden by unselecting the check box as required both during or af-
ter an experiment.

Show View Cap- Activated: Displays the channel name clearly with the image of each
tions channel in the multichannel view layout.
Deactivated: Hides the channel name of each image in the image
view.

6.10.6.4 Charts Tab

Parameter Description
All Chart Settings Note that a function is active when the button is highlighted in blue.
(X-/Y-Axis)
The settings for X- and Y-Axis (only if Show All is activated) are the
same, see description below. The Y- axis settings are always applied
to the selected chart. The currently selected chart name (channel) is
displayed above the Y-axis settings.

- Auto The scaling of the respective axis is automatic, allowing for an opti-
mal, and appropriate adjusting display of the all values.

- Fixed The upper and lower limit of the axis can be defined using the min
and max spin boxes.

X-Units

- Auto The units are selected automatically.

- Fixed You can select the desired unit for the x-axis from the dropdown list.

Show Tick Marks Activated: Displays tick marks in the chart. You can set the Form
and Size of the tick marks. The tick marks have to be set per chart.

Show Legend Activated: Displays the chart legend.

Show Axis Cap- Activated: Displays captions of the axis.


tions

Use Channel Color Only visible if you display the merged channels chart.
Activated: Displays the lines in the chart in the colors of the channel.
If a channel has no color defined, the chart line is displayed in white.
The colors are synchronized with the channel settings, i.e. they up-
date accordingly if the channel colors are changed.

6.10.6.5 Export Tab

Parameter Description
Data Table

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 570


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

Parameter Description
- As New Docu- Opens the measurement data table in a new document tab. The table
ment displays all measurement values and area for all ROIs in each channel.
If event markers are present, these are also listed here at the appropri-
ate time points. For a description of the measured parameters, see
Basics of Calculation of Intensity and Ratio Values [} 557].

- Save as *.csv Opens the Save As dialog and allows the measurement data to be
exported as a comma separated value (*.csv) file. The following val-
ues are exported for each ROI and channel: Intensity, area and if
present event markers. The exported values are the raw data without
the subtraction of any background correction.

Ratio image

- As New Docu- Opens the ratio image in a separate new document as a *.czi file (cur-
ment rent Z only).

- Save as Opens the Save As dialogue to save the ratio image directly to a *.czi
file.

6.10.6.6 Ratio Tab

This view option is almost identical to the Online Ratio tab in the MeanROI Setup, see Online
Ratio Tab [} 572]. In fact when an experiment is finished the exact same values used for the dis-
play of the online ratio are transferred to the offline ratio tool of the MeanROI view and are
stored with your image for later reference.
For offline ratio assessment the settings can be changed and are applied to the ratio image and
the measured values. For large data sets (high resolution or many time points), a smooth playback
of the ratio image can be achieved by clicking on the Cache ratio image button. This stores the
ratio images temporarily to the computers memory for very fast playback or adjustments of the
time slider. The following descriptions describe the differences on the Ratio tab:

Parameter Description
Ft0= Average in- Only available if the Single wavelength method is selected.
tensity of frame
Defines the frames of the time series image from which the reference
value Ft 0 should be calculated.
The numbers in the input fields refer to the frame number of the cur-
rent experiment in the MeanROI view. The desired frame numbers
can be entered with the buttons or directly by typing a number into
the field. Typically, your experiment should include a baseline of 5-10
images before and/ or in between a simulation/ activation.

– Update Applies the changes of the frame made with the input fields.

Cache ratio image Caches all the ratio images of the current time series with the given
ratio calculation parameters. This is done to avoid image flickering
when moving through the time series with the slider quickly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 571


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

6.10.6.7 Online Ratio Tab

Parameter Description
Calculation Drop- Selects the ratiometric method you want to use. Single and Dual
down Wavelength dyes are supported with an additional three formulas
for further adapted (online or offline) image ratio calculations. The ra-
tio set-up will change in accordance with your selection.

- Single Wave- Select the channel in the dropdown menu. The Ft0 value is the aver-
length aged fluorescence from the specified number of image frames. The
number of frames to average is defined in the spin box of the refer-
ence image set-up (see 10). The spin box at the far left is a multiplica-
tion factor.

- Dual Wave- Select the channels in the dropdown list required to calculate the ratio
length values/image e.g. for Fura-2, a dual excitation dye, the numerator is
the 340 nm image the denominator the 380 nm image. For dual emis-
sion dyes the function is identical. The spin box at the far right is a
multiplication factor.

- Image Ratio The formula calculates the normalized ratio of the difference between
Type 2 two weighted channel intensities.

- Image Ratio The formula calculates the ratio between the weighted difference and
Type 3 weighted sum of two channel intensities

- Image Ratio The formula calculates the ratio between the intensity difference of
Type 4 two channels in relation to the intensity of one channel.

Background Cor- A background correction can be performed on a channel-by-channel


rection basis. The selection of a background correction method modifies the
ratio set-up formula accordingly. Note that the correction by ROI is
only available if there are at least two ROI defined in the image! The
following modes are available:

- None No background correction is performed.

- Constant Allows a user defined numeric value to be entered for each channel in
the appropriate spin box.

- ROI Allows to select the background ROI defined in the Mean ROI view/
setup.
Note that for dual wavelength protocols the same ROI is used in each
case, but its channel specific values are applied for the correction.
For the ratio types Single Wavelength, Image Ratio Type 2, 3, and
4, no ROI background correction is available.

Ratio Clipping Activated: Sets the factor for ratio clipping.

Color Select the color (LUT) used to display the ratio image. Per default the
Rainbow LUT is used as it allows intensity changes to be followed eas-
ily.

Enable Threshold Activated: Allows the threshold values to be set for the ratio calcula-
tion.

- Channel/ A threshold value can be applied in the form of a constant integer


Threshold value for each channel individually. Thresholds help to reduce noise
anomalies that are cause by pixel-to-pixel variations in areas between

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 572


6 General Toolkits | 6.10 Physiology (Dynamics) ZEISS

Parameter Description
cells or near cell boarders during the ratio calculation. Enter the de-
sired threshold value for each channel into the spin boxes provided.
For more detailed information on how ZEN handles thresholds, see
Basics of Calculation of Intensity and Ratio Values [} 557].

6.10.6.8 ROI Tracing Tab

This tab is only available if you have licensed the Physiology (Dynamics) module.
ROI tracing allows you to adjust the position of your ROI as necessary to accommodate the lateral
movement of an object in an image of which the mean intensity is to be measured. This is done
by defining a series of one or more so called key frames for individual ROIs. In this manner, com-
plex object movements can be corrected.

Parameter Description
Enable ROI Tracing Enables the functionality for ROI tracing.

Selected ROI Displays the number and shape of the currently selected ROI.

Key Frame Edit Only available if you have selected a ROI.


Mode

– Manipulates the ROI for all time points/key frames.


All Key
Frames

– Manipulates the ROI for the currently selected time point and creates
a key frame. Note that a single key frame adjustment can only be per-
Single Key
formed when the frame number (time point) is set to 2 or higher.
Frame

Interpolation Only available if you have selected a ROI.


Selects an interpolation method for the ROI changes between the
time points.

– Constant Does not interpolate the ROI position between the key frames, i.e. the
ROI is only present at the set key frames.

– Linear Determines the ROI position at the time points between key frames
based on linear interpolation.

– Spline Determines the ROI position at the time points between key frames
based on spline interpolation.

Key frame list Displays the key frames of the ROI and the changes compared to the
previous key frame.

– Adds the current position as key frame.


Add

– Deletes the currently selected key frame.


Delete

Show

– Trajectories Activated: Displays the trajectories between the key frames in the
image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 573


6 General Toolkits | 6.11 FRAP Efficiency Analysis ZEISS

Parameter Description
– Ticks Activated: Displays ticks for the (center) position the ROI for each
time point in the image. These ticks are only visible if Linear or Spline
is selected as interpolation method.

– Ghosted key Activated: Displays the shape of the ROI at each key frame.
frames Deactivated: Displays the shape of the ROI only at the currently se-
lected time point.

– All ghosted Only available if Ghosted key frames is activated.


Activated: Displays the shape of the ROI for all time points. This ef-
fect is only visible if Linear or Spline is selected as interpolation
method.

See also
2 Adjusting ROIs for Time Points [} 553]

6.11 FRAP Efficiency Analysis

FRAP (Fluorescence Recovery after Photobleaching) enables you to analyze time series acquisitions
with bleach events to determine the half time of recovery/decrease of fluorescent signals. It sup-
ports mono or bi-exponential fit algorithms, including options for background correction and cor-
rection of imaging-induced photobleaching. You also have the possibility to evaluate grouped re-
gions of interest. Additionally, you can determine the fading factor from a reference region (Ref.)
from the present experiment or a control experiment and reuse it for subsequent experiments.

6.11.1 FRAP View

The FRAP view (FRAP = Fluorescence Recovery after Photobleaching) is only visible for a time se-
ries data set which includes a minimum of one bleach event.
Note: When acquiring Airyscan SR or Airyscan MPLX data, the FRAP view only works as expected
if the complete time series date is processed.
1 2

1 Diagram
Displays the intensity-over-time diagram with the fitted curve per channel.

2 Image
Displays the time series image with the drawn in regions of interest.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 574


6 General Toolkits | 6.11 FRAP Efficiency Analysis ZEISS

3 Data Table
The table displays the fit parameters for each channel and analysis region group (one or
more regions of interest can be grouped for analysis, up to three groups can be ana-
lyzed).
Optionally, you can have a table of the average intensity values of each region group
(corrected for background and reference) for each time point and channel.

6.11.1.1 FRAP Tab

Any changes performed with this tab are immediately updated in the FRAP view (diagram and ta-
ble).

Parameter Description
Toolbar Offers tools to draw regions of interest into the image. These regions
are then used for analysis.

– Activates the selection mode that enables you to select the graphic el-
ements in the image area.
Select

– Activates the cloning mode that you can use to create an identical
copy of the last graphic element drawn in by simply clicking anywhere
Clone
into the image area. To exit this mode, either switch back to the se-
lection mode or press the ESC key.

– Enables you to draw a rectangular region of interest (ROI) into the im-
age.
Draw Rectan-
gle

– Enables you to draw a circle.


Draw Circle

– Enables you to draw a elliptical region.


Draw Ellipse

– Enables you to draw a spline contour. You can either define the cor-
ner points by a series of clicks or you can trace a contour by keeping
Draw Spline
the left mouse key pressed. Close this contour by right-clicking. Cor-
Contour
ners are always rounded with this tool.

– Enables you to draw a polygonal region.


Draw Polygon

Parameter Description
Fit Formula Selects the mathematical model (mono or double exponential model)
for data fitting.

Diagram Line Selects the line thickness of the fit curve(S) in the diagram.

Normalize Activated: Displays normalized values.


Deactivated: Displays the absolute values.
The table of the intensity values and the fit diagram are updated ac-
cordingly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 575


6 General Toolkits | 6.11 FRAP Efficiency Analysis ZEISS

Parameter Description
Table Activated: Displays an additional table which shows the intensity val-
ues (for each channel) per time point. The values are corrected based
on the background and reference region, if applied.

Diagram Marker Selects the time point markers of the fit curve(s) in the fit diagram.

Time Unit Selects the time units of the fit diagram, the fit data table and the in-
tensity table.

Fit Range Defines the data range for the fit algorithm.

Photofading Fac- The photofading factor is either calculated from the current reference
tor region(s) or loaded from a previous experiment. The input field shows
the currently applied value.
The photofading factor = reference(t)/reference(t=0) and then fitted
by: intensity(t) = exp(-kappa * t).

– Use Activated: Uses the photofading factor for the data fitting algorithm.
In the input field, you can enter the photofading factor.

– Load Opens a file browser to load the photofading factor from an .xml file.

– Save Opens a file browser to save the current photofading factor as an .xml
file.

Region Table Displays the regions drawn into the image.

– # Displays the ID of the region.

– Type Displays the type of the region.

– Group 1, 2, 3 Allows you to select more than one region for analysis and to group
them. The mean intensity values for the combined regions are used as
data input.

– Background Activated: Defines the region of interest which represents the mean
background intensity that should be used for data correction. The
mean intensity value of the background region is subtracted from the
data prior to fitting.

– Ref. Activated: Defines the region of interest which represents the fluo-
rescence intensity of a reference area that has not been bleached and
has not been affected by the bleach event. The mean intensity within
this region is used to correct the data at each time point for any
bleaching artifact that occurred during the imaging process. For this
the data is divided by [reference(t)/reference(t=0)].

6.11.1.2 Fit Model

The Fit Model applied provides the following data/parameter:

§ The final signal intensity in the analyzed ROIs following recovery IE (of the fitted curve)
§ The amplitude of the fitted curve (which equals the mobile fraction) I1 mobile fraction
§ The proportion of the mobile fraction: F1 mobile fraction (%)
§ The fitted parameter T1(s)
§ The half time of recovery T1 half (s)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 576


6 General Toolkits | 6.12 Automated Photomanipulation ZEISS

§ The rate constant for the exchange of molecules between the bleached region and the sur-
rounding area K1 (1/s)
§ The part of the immobile fraction of the protein I delta immobile fraction
§ The proportion of the immobile fraction: F1 immobile fraction (%)
A double exponential displays the mean of the fitted values for the two different mobile fractions
as the fit curve. The following (additional) parameters are provided

§ The amplitude of the two curves, displayed as one (which corresponds to each part of the
mobile fractions) I1 and I2.
§ The fitted parameters T1 (s) and T2 (s) for each mobile fraction.
§ The rate constant for the exchange of molecules between the bleached region and the sur-
rounding area K1 (1/S) and K2 (1/s) for each mobile fraction.
§ The half time of recovery for each fraction T1 half (s) and T2 half (s)
The table displays the result of the data fit. The result can be copied to the clipboard (right mouse
click) and directly pasted into excel or saved as text.
The calculation of the parameters is based on the bleached ROI(s) unless other ROIs or selected or
the ROIs are moved.
The analysis is then part of the image and the type of analysis is displayed again when opening
the FRAP view for the image.

6.12 Automated Photomanipulation

This module is exclusively available for the Celldiscoverer 7 and allows automated photoactiva-
tion and bleaching at multiple positions. It is not applicable to Tile Regions. Using this module, the
system executes the following experiment steps without user interaction:

§ Acquisition of a multi-position image as defined in the Tiles Tool [} 359].


§ Identification of the photomanipulation ROIs based on a customized image analysis that was
defined beforehand in the Image Analysis Wizard [} 941].
§ Photomanipulation experiment as defined for Bleaching and in the Time Series Tool [} 391].
For Automated Photomanipulation you need the license the Automated Photomanipulation
and the Image Analysis functionality. The module is activated in Tools > Modules Manager >
Optional Software and the tool for the model is displayed on the Applications tab.

6.12.1 Using Automated Photomanipulation Settings

Automated Photomanipulation offers you the possibility to save your whole experiment setup in a
settings file.

Creating an Automated Photomanipulation setting


1. On the Applications tab, open the Automated Photomanipulation tool.
2. Click on Options and select New.
3. Name the setting and press Enter or click on .
You have created a setting for Automated Photomanipulation.

Saving an Automated Photomanipulation setting


When you have set up your Automated Photomanipulation experiment and created a setting, you
can save the setup as a setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 577


6 General Toolkits | 6.12 Automated Photomanipulation ZEISS

1. Click on Options and select Save.


Your experiment setup is now saved.

Importing and exporting an Automated Photomanipulation setting


1. On the Applications tab, open the Automated Photomanipulation tool.
2. Click on Options and select Import or Export.
à A file browser opens.
3. Select the file you want to import or the folder where you want to export the setting to.
4. Click on Open and/or Save.
You have now imported/exported a setting.

Deleting an Automated Photomanipulation setting


1. On the Applications tab, open the Automated Photomanipulation tool.
2. Select the setting you want to delete in the drop-down list.
3. Click on the Options and select Delete.
4. Confirm that you want to delete the file.
The selected setting is deleted.

See also
2 Automated Photomanipulation Tool [} 579]
2 Performing an Automated Photomanipulation Experiment [} 578]

6.12.2 Performing an Automated Photomanipulation Experiment

For a successful Automated Photomanipulation experiment, you have to prepare a photomanipu-


lation experiment at multiple positions and an image analysis setting.

Prerequisite ü You have activated the Automated Photomanipulation module in Tools > Modules Man-
ager > Automated Photomanipulation.
ü You have defined and saved a suitable experiment for photomanipulation at multiple posi-
tions (including Tiles, Bleaching, and Time Series).
ü You have defined experiment positions in the Positions section of the Tiles tool, see Posi-
tions Section [} 363].
Important: Photomanipulation with Tile Regions is not supported!
ü On the Acquisition tab, you have selected if the photomanipulation should be executed at
All Tile Regions per Time Point (e.g. for photoactivation) or as Full Time Series per Tile
Region (e.g. for photobleaching).
ü You have defined photomanipulation settings in the Timed Bleaching tool, see Timed
Bleaching Tool [} 989].
ü You have defined a suitable image analysis setting using the Image Analysis Wizard or an
OAD macro that detects the regions of interest where the photomanipulation should be exe-
cuted, see Creating a New Image Analysis Setting [} 403].
Important: The classes in the analysis and their corresponding channel names must exactly fit
to the channel names in the experiment!
1. On the Applications tab, open the Automated Photomanipulation tool.
2. Create a setting to save your experiment setup, see Using Automated Photomanipulation
settings [} 577].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 578


6 General Toolkits | 6.12 Automated Photomanipulation ZEISS

3. For Experiment, select the experiment you want to use for photomanipulation. For more
information, see Setting Up a New Experiment [} 51].
Note: You have to acquire a snap and draw one Experiment Region. Bleaching must be
activated. This enables you to define the settings for Timed Bleaching. This Experiment
Region is not used for the photomanipulation experiment.
4. For Analysis, select a suitable setting to analyze the multi-position image.
5. For Class, use the drop-down list to select the appropriate class or channel to identify the
photomanipulation regions of interest.
6. For Sorting Feature, define the acquisition order of the ROIs for photomanipulation. This
step depends on the selected features in the analysis (e.g. ID, mean intensity in channel x,
perimeter, etc.). Per default, the photomanipulation per position is executed in the de-
scending order of the IDs.
7. For Region Type, define the ROI shape and maximum ROI number per position for pho-
tomanipulation.
8. For Output Folder, define the folder where you want to store the experiment data.
The complete experiment including all positions and photomanipulation events is stored as
one .czi file. This folder also contains the first scanned image for ROI identification (Initial-
AnalysisSettingImage.czi) and the table of the ROIs (SingleObjectsTable.csv).
9. Click on Start.
à A InitialAnalysisSettingImage.czi image is acquired to identify the ROIs for photomanipu-
lation and saved to your folder. The ROIs are listed in the SingleObjectsTable.csv table.
They are automatically imported as Experiment Regions for photomanipulation.
à Then the photomanipulation experiment at multiple positions is executed.
à In the Mean ROI tab of the resulting .czi file, the bleach markers are shown.
à To check the ROI selection, you can analyze the InitialAnalysisSettingImage.czi with the
predefined analysis.
à The Start button turns into a Stop button as long as Automated Photomanipulation is
running. Click on Stop to stop the running Automated Photomanipulation workflow.
You have successfully performed an Automated Photomanipulation experiment.

6.12.3 Automated Photomanipulation Tool

Parameter Description
Options

– New Creates a new Automated Photomanipulation setting. Enter a name


for the setting.

– Rename Renames the setting.

– Save Saves the current setting.

– Save as Saves the current setting under a new name. Enter a name for the
setting.

– Import Imports an existing setting.


The setting is shown in the setting drop-down list.

– Export Exports the current setting.

– Delete Deletes the current setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 579


6 General Toolkits | 6.13 FRET ZEISS

Parameter Description
Experiment Selects the experiment setup to execute the photomanipulation in-
cluding Tiles, Time Series and Bleaching.

Analysis Selects the image analysis setting used to analyze the multi-position
image to define the Experiment Regions for photomanipulation.

Class Defines the class/parameter to find the photomanipulation experi-


ment regions.
Important: The classes in the analysis and their corresponding chan-
nel names must exactly fit to the channel names in the experiment.

Sorting Feature Defines the acquisition order of the Experiment Regions for photoma-
nipulation depending on the selected features in the analysis (e.g. ID,
mean intensity in channel x, perimeter, etc.).

Region Type Defines the shape of the photomanipulation area: Polygon, Circle,
Rectangle, Custom Circle/Rectangle (Size and Offset adjustable), Cir-
cle, and Rectangle are bounding/containing the detected photoma-
nipulation regions.

Max. Number Defines how many photomanipulation ROIs per position should be ex-
ecuted.

Offset Only visible if Custom Circle or Custom Rectangle is selected.


Defines the Experiment Regions offset of the Custom Circle/Rectangle
in X and Y direction.

Size Only visible if Custom Circle or Custom Rectangle is selected.


Defines the Experiment Regions size of the Custom Circle/Rectangle in
width and height.

Output Folder Selects the folder where the experiment results are saved. A subfolder
will automatically be created for each run of an Automated Photoma-
nipulation experiment, including the pre-bleach image for Experiment
Regions identification, the table of all Experiment Regions, and the ex-
periment results.

Start Starts the Automated Photomanipulation. The experiment can be


stopped with the Stop button in the Acquisition tab. Click on Stop
to stop the running Automated Photomanipulation workflow.

See also
2 Automated Photomanipulation [} 577]

6.13 FRET

Förster Resonance Energy Transfer (FRET) is a mechanism which describes an energy transfer
between two chromophores, typically fluorescent proteins. Upon excitation with light of suitable
wavelength a donor chromophore, then in its electronic excited state, can transfer energy to an
acceptor chromophore. The efficiency of this energy transfer depends on the distance between
the two molecules. This makes FRET an indicator for even very small changes in the distance be-
tween two molecules.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 580


6 General Toolkits | 6.13 FRET ZEISS

When using confocal or super resolution techniques, FRET is typically used to determine whether
two fluorophores are within a certain distance of each other and whether this distance changes
due to external or internal influences.

6.13.1 Acquisiton Prerequisites

FRET occurs between donor (D) and acceptor (A) dyes when these dyes are within certain proxim-
ity (< ca. 10 nm), resulting in a FRET signal (acceptor fluorescence upon donor excitation). There
are many approaches to quantify FRET signal. In ZEN, the following methods are implemented:

§ Sensitized Emission
§ Acceptor Bleaching
Different acquisition set ups are necessary for each approach to enable the FRET view.
An analysis with Sensitized Emission requires a multichannel (multidimensional) data set (mini-
mum 3 channels). The acquisition settings are determined by the used fluorophores. Refer to sci-
entific papers for more information on sample preparation and necessary controls for sensitized
emission experiments.
An analysis with Acceptor Bleaching requires a time series with a bleach event. The acquisition
settings are determined by the used fluorophores. Refer to scientific papers for more information
on sample preparation for acceptor bleaching.
Depending on the data set, the FRET view provides different parameter sets for image analysis.
To access the FRET view, the data set needs to be loaded or completely acquired. Online calcula-
tion of FRET data is not supported.

6.13.2 Analysis Method for Acceptor Bleaching

Acceptor photobleaching analysis is available when a bleaching event is found in the image meta-
data. In this case the FRET efficiency can be calculated the following way:
E = (Dpost – Dpre)/Dpost
D is the donor signal and subscripts refer to pre- and post-bleach images.
In all cases the FRET values are calculated for every pixel that is considered “valid” and then the
mean value is calculated and presented in the table. In case of acceptor photobleaching, the effi-
ciency is also calculated from the pixel-averaged Dpre and Dpost signals.

6.13.3 Analysis Methods for Sensitized Emission

Sensitized emission analysis is available when the image has at least three channels (donor, accep-
tor, FRET; corresponding measured signals are D, A, and F). The measured intensities are first cor-
rected for crosstalk, for which the following factors are considered: FD/DD; AD/FD; DA/AA; DA/FA; FA/
AA. The capital letters refer to channels and subscripts refer to the D and A dyes; for instance, FD/
DD is the F/D signal ratio measured for a donor-only sample. In addition, unequal detection effi-
ciencies of the donor and FRET channels are considered (G factor).
In all cases the FRET values are calculated for every pixel that is considered “valid” and then the
mean value is calculated and presented in the table.

6.13.3.1 FC or Youvan Method

Youvan et al., Biotechnology et alia 3, 1 (1997)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 581


6 General Toolkits | 6.13 FRET ZEISS

Fc = F - D*(FD/DD) - A*(FA/AA)
Displays the Fc image with intensities converted from the FRET index calculated for each pixel us-
ing the Youvan method. This method assumes that the signal recorded in the FRET channel is the
sum of real FRET signal overlaid by donor crosstalk and acceptor signal induced by direct (donor)
excitation. There is no correction for donor and acceptor concentration levels and as a result the
FRET values tend to be higher for areas with higher intensities.

6.13.3.2 FRETN or Gordon Method

Gordon et al., Biophys J 74, 2702 (1998)


FRETN = Fcorr/(Dcorr*Acorr)
Displays the FRET image with intensities converted from the FRET index calculated for each pixel
using the Gordon method. This method calculates a corrected FRET value and divides by concen-
tration values for donor and acceptor. This method attempts to compensate for variances in fluo-
rochrome concentrations but overdoes it. As a result, cells with higher molecular concentrations
report lower FRET values.

See also
2 Crosstalk Correction for Gordon and Xia Methods [} 582]

6.13.3.3 N-FRET or Xia Method

Xia and Liu, Biophys J 81, 2395 (2001)


NFRET = Fcorr/(Dcorr*Acorr)1/2
Displays an N-FRET image with intensities converted from the FRET index calculated for each
pixel using the Xia method. This method is like the Gordon method with the difference that the
square root of donor and acceptor concentration is used for concentration compensation. The re-
sulting image is properly corrected for variances in the fluorochrome concentration.

See also
2 Crosstalk Correction for Gordon and Xia Methods [} 582]

6.13.3.4 Crosstalk Correction for Gordon and Xia Methods

For the Gordon and Xia methods, crosstalk correction is the same.
Acorr = (A – F*AD/FD) / (1 – FA/AA*AD/FD)
Fcorr = (F – D*FD/DD – Acorr*(FA/AA – FD/DD*DA/AA)) / (1 – DA/FA*FD/DD) / G
Dcorr = D + Fcorr*(1 – G*DA/AA) – Acorr*DA/AA

6.13.4 Determining Donor Coefficient Values

Prerequisite ü You have acquired or opened an image of a sample with a signal of the donor fluorophore
only using the same imaging settings which are later used for imaging the FRET sample.
ü You are in the FRET view.
1. Go to the FRET view options tab and use the controls to define one or more analysis re-
gions in the raw data image.
à The regions are displayed in a table on the FRET tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 582


6 General Toolkits | 6.13 FRET ZEISS

2. Make sure that Object is activated for each region entry in the table.
à The regions are defined as objects that should be analyzed.
3. On the Parameters tab, click Donor.
The donor coefficient values are determined for the defined regions and displayed in the Parame-
ters tab as well as the data table below the images.

6.13.5 Determining Acceptor Coefficient Values

Prerequisite ü You have acquired or opened an image of a sample with a signal of the acceptor fluorophore
only using the same imaging settings which are later used for imaging the FRET sample.
ü You are in the FRET view.
1. Go to the FRET view options tab and use the controls to define one or more analysis re-
gions in the raw data image.
à The regions are displayed in a table on the FRET tab.
2. Make sure that Object is activated for each region entry in the table.
à The regions are defined as objects that should be analyzed.
3. On the Parameters tab, click Acceptor.
The acceptor coefficient values are determined for the defined regions and displayed in the Pa-
rameters tab as well as the data table below the images.

6.13.6 FRET View

In this view you can examine the results of the FRET analysis. The left image is the analyzed FRET
image, the right is the original raw data image. The data table displays the results of the image
analysis and differs whether you use the Sensitized Emission or Acceptor Bleaching method to
measure FRET efficiency. With the view option tabs you can draw analysis regions into the raw
data image and change analysis parameters.

6.13.6.1 Data Table Sensitized Emission

The analysis with the Sensitized Emission methods (all three methods are analyzed) shows the
following parameters in the data table:

Parameter Description
Region Displays the identification number of regions assigned for analysis.
The region zero refers to the whole image.

Time Displays the time point if a time series is analyzed.

D avg. Displays the average intensity of the region in the donor channel.
These values are influenced by the selected settings in the Settings
tab. They can vary from the values of the same regions in the Histo
view.

A avg. Displays the average intensity of the region in the acceptor channel.
These values are influenced by the selected settings in the Settings
tab. They can vary from the values of the same regions in the Histo
view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 583


6 General Toolkits | 6.13 FRET ZEISS

Parameter Description
F avg. Displays the average intensity of the region in the FRET channel. These
values are influenced by the selected settings in the Settings tab.
They can vary from the values of the same regions in the Histo view.

FRETN (p) Displays the result of the analysis with the Gordon method. The
FRETN value is calculated for each pixel, afterwards the average for
the selected region is determined.

Fc (p) Displays the result of the analysis with the Youvan method. The Fc
value is calculated for each pixel, afterwards the average for the se-
lected region is determined.

N-FRET (p) Displays the result of the analysis with the Xia method. The N-FRET
value is calculated for each pixel, afterwards the average for the se-
lected region is determined.

6.13.6.2 Data Table Acceptor Bleaching

The analysis with the Acceptor Bleaching method shows the following parameters in the data
table:

Parameter Description
Region Displays the identification number of regions assigned for analysis.
The region zero refers to the whole image.

FRET(p) Eff. % Displays the FRET efficiency for each pixel. It is calculated and aver-
aged for all pixels of the region. The averaged intensities of the region
are used to calculate an averaged FRET efficiency for this region.
Delta D/D Post * 100.

D Pre Displays the average donor intensity of the region in the pre-bleach
image.

D Post Displays the average donor intensity of the region in the post-bleach
image.

A Pre Displays the average acceptor intensity of the region in the pre-bleach
image.

A Post Displays the average acceptor intensity of the region in the post-
bleach image.

Delta D Displays the change in donor intensity of the region before and after
the bleach event. Delta D = D Post-D Pre.

Delta A Displays the change in acceptor intensity of the region before and af-
ter the bleach event. Delta A = A Post- A Pre.

6.13.6.3 FRET Tab

Parameter Description
Toolbar Offers tools to draw regions of interest into the image. These regions
are then used for analysis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 584


6 General Toolkits | 6.13 FRET ZEISS

Parameter Description
– Activates the selection mode that enables you to select the graphic el-
ements in the image area.
Select

– Activates the cloning mode that you can use to create an identical
copy of the last graphic element drawn in by simply clicking anywhere
Clone
into the image area. To exit this mode, either switch back to the se-
lection mode or press the ESC key.

– Enables you to draw a rectangular region of interest (ROI) into the im-
age.
Draw Rectan-
gle

– Enables you to draw a circle.


Draw Circle

– Enables you to draw a elliptical region.


Draw Ellipse

– Enables you to draw a spline contour. You can either define the cor-
ner points by a series of clicks or you can trace a contour by keeping
Draw Spline
the left mouse key pressed. Close this contour by right-clicking. Cor-
Contour
ners are always rounded with this tool.

– Enables you to draw a polygonal region.


Draw Polygon

Parameter Description
Method Selects the analysis method. The FRET image is updated depending
on the selected method.
For Sensitized Emission, ZEN provides three different methods for
data analysis. The data table displays the results of all three methods.
Using the Acceptor Bleaching method is only possible with an input
of a dual channel time series with a bleach event.

Save Image Opens the FRET image as new image document.

ROI Table Displays the list of regions that are drawn into the raw data image.

– # Displays the identification number of the region.

– Type Displays the type of the region.

– Object Activated: Defines the region as one that should be analyzed.

– Background Activated: Defines the region as background region.

See also
2 Analysis Methods for Sensitized Emission [} 581]
2 Analysis Method for Acceptor Bleaching [} 581]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 585


6 General Toolkits | 6.13 FRET ZEISS

6.13.6.4 Parameters Tab

Parameter Description
Donor Ch Defines the channel which contains the Donor signal.

Acceptor Ch Defines the channel which contains the Acceptor signal.

FRET Ch Only visible for Sensitized Emission.


Defines the channel which contains the FRET signal.

Image After Bleach Only visible for Acceptor Bleaching .


Event
Selects the bleach event that should be analyzed in case of repetitive
bleaching. The post-bleach image number is updated accordingly.

Pre-bleach Image: Only visible for Acceptor Bleaching .


Indicates the image before the bleach event used for analysis.

Post-bleach Image: Only visible for Acceptor Bleaching .


Indicates the image after the bleach event used for analysis.

Analyze Only visible for Sensitized Emission.


Selects the signal that should be analyzed in the present image.

– Donor Analyzes the donor signal of the image.

– Acceptor Analyzes the acceptor signal of the image.

Donor coef. Fd/Dd Only visible for Sensitized Emission.


Shows the value of Donor signal detected in the FRET channel/
Donor signal detected in the Donor channel from the analyzed
present image.

Donor coef. Ad/Fd Only visible for Sensitized Emission.


Shows the value of Donor Signal detected in the Acceptor channel/
Donor signal detected in the FRET channel.

Acceptor coef. Fa/ Only visible for Sensitized Emission.


Aa
Shows the value of Acceptor signal detected in the FRET channel/
Acceptor signal detected in the Acceptor channel.

Acceptor coef. Da/ Only visible for Sensitized Emission.


Aa
Shows the value of Acceptor signal detected in the Donor channel/
Acceptor signal detected in the Acceptor channel.

Acceptor coef. Da/ Only visible for Sensitized Emission.


Fa
Shows the value of Acceptor signal detected in the Donor channel/
Acceptor signal detected in the FRET channel.

G Only visible for Sensitized Emission.


Sets the Gordon Factor which depends on the fluorophores used and
which can be part of the Gordon and Xia analysis. Refer to the origi-
nal publications for further details (Gordon et al., Biophys J 74, 2702
(1998), Xia and Liu, Biophys J 81, 2395 (2001).

Global Coefficients Only visible for Sensitized Emission.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 586


6 General Toolkits | 6.13 FRET ZEISS

Parameter Description
Activated: Applies the current coefficient values to all open image
documents in FRET View.

Drop down selec- Only visible for Sensitized Emission.


tion
Selects the parameter that should be saved or loaded (Acceptor or
Donor).

Save Only visible for Sensitized Emission.


Opens a file browser to save the coefficients of Donor or Acceptor
as .xml file.

Load Only visible for Sensitized Emission.


Opens a file browser to load the coefficients of Donor or Acceptor
for the current analysis.

See also
2 Determining Donor Coefficient Values [} 582]
2 Determining Acceptor Coefficient Values [} 583]

6.13.6.5 Threshold Tab

On this tab, you can manually set the threshold for image analysis using the slider or input fields.
Alternatively, the threshold can be set by defining and enabling a background region in the FRET
tab.
The values for the thresholds are either displayed as grey value levels (Raw Data) or Normalized
data, which is normalized to the value 1.
If you have activated Subtract Background Using Thresholds on the Settings tab, the back-
ground values are subtracted before the image analysis is performed.

Parameter Description
Donor Defines the threshold for the analysis of the donor signal.

Acceptor Defines the threshold for the analysis of the acceptor signal.

FRET Only visible for Sensitized Emission.


Defines the threshold for the analysis of the FRET signal.

All Defines the threshold for the analysis of all signals.

Clear Sets all threshold values to zero and deactivates the background re-
gion.

6.13.6.6 Settings Tab

The tab allows you to select parameters that are used for image analysis. Pixels where the grey
value is zero are not included in any analysis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 587


6 General Toolkits | 6.14 Deconvolution ZEISS

6.13.6.6.1 General Tab

Parameter Description
Subtract Back- Activated: The previously defined grey values of the thresholds
ground Using (Thresholds tab) are subtracted from each pixel prior to analysis.
Thresholds
Deactivated: Pixels below the defined thresholds are displayed in the
FRET image and are not part of the analysis (value and area).

Exclude Saturated Activated: Pixels which are saturated in at least one channel are not
Pixels considered for analysis.

Include Threshold Activated: Pixels with the same grey value as the defined thresholds
Pixels are part of analysis.

Apply Palette Activated: The FRET image is displayed color coded.

Show Palette Activated: Displays a palette of the FRET values within the FRET im-
age and a palette of the channel colors in the raw data image.

6.13.6.6.2 Acceptor Photobleach Tab

Parameter Description
Do Not Show Neg- Activated: Does not display any negative values in the FRET image.
ative Values in
FRET Image

6.13.6.6.3 Sensitized Emission Tab

Parameter Description
FRETN Truncation Activated: Includes only the range of the selected values in result ta-
ble and the displayed image.

N-FRET Truncation Activated: Includes only the range of the selected values in result ta-
ble and the displayed image.

Do Not Show Neg- Activated: Does not display any negative values in the FRET image
ative Values in Fc showing the analysis according to the method of Youvan.
Image

FRETN Normaliza- Activated: Does not display any negative values in the FRET image
tion showing the analysis according to the method of Youvan.

6.14 Deconvolution

This module offers 3D deconvolution algorithms to enhance your 3D image stacks and methods
for theoretical PSF. It uses efficient processing and significant performance gains via GPU accelera-
tion with dedicated CUDA-compatible graphic cards, including support for multi-GPU. It also of-
fers improvements in resolution down to 120 nm (depending on the imaging system) and is com-
patible with conventional widefield, Apotome, Lightsheet, confocal or multiphoton microscopes.
Additionally to four primary methods, more than 15 published methods (e.g., Richardson-Lucy)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 588


6 General Toolkits | 6.14 Deconvolution ZEISS

can be employed by changing the parameters. Some functionality is generally available, for the
full set of features you need the dedicated license for the module, see Licensing and Functionali-
ties of Deconvolution [} 589].

6.14.1 Licensing and Functionalities of Deconvolution

Some basic functionality for deconvolution is generally available in the software, but the full De-
convolution functionality requires a license.

Basic functionality
The functionality generally available in ZEN includes:

§ The 2D background removal function Deblurring which is based on the nearest neighbor al-
gorithm.
§ The Deconvolution (defaults) function, which offers three primary deconvolution methods
that are automatically adapted to the type of instrument used to acquire the image.

Licensed Functionality
If you have licensed the Deconvolution module and activated it in Tools > Modules Manager,
the additional functionality includes:

§ The additional and more advanced deconvolution method Constrained Iterative in the De-
convolution (defaults) function.
§ GPU acceleration with dedicated CUDA-compatible graphic cards, including support for
multi-GPU.
§ The Deconvolution (adjustable) function, which offers access to all available function pa-
rameters and provides the necessary flexibility for demanding samples and sample conditions.
§ The creation of a PSF with the PSF Wizard, a function offering a wizard to guide you
through a series of steps to create a PSF from a z-stack image of multiple fluorescent beads.
This function is recommended to create experimentally measured PSFs.

6.14.2 Basics of Deconvolution

Microscopy creates images of objects which should represent the nature of the object as well as
possible. Fluorescent light, which emanates from the object, passes through the various optical el-
ements of the beampath and eventually gets collected by the detector. Unfortunately, on the way
to the detector the signal is changed in such a way, that the quality of the resulting image suffers.
As a consequence, the image is never a 100% correct representation of the object. This effect is
strongest seen in a classical widefield fluorescence microscopy which does in fact not offer any
optical sectioning capability, but also exists to a different degree in optical sectioning microscope
systems, e.g. Confocal, Lightsheet or ApoTome.
Fortunately, the dominant function which has this deleterious effect on the image, is based on the
optical design principles of the light microscope and therefore well understood. We call this the
point spread function (PSF) of the microscope system.
Deconvolution is a mathematical method which can reverse the effect of the PSF on the image
and can therefore to a large extent restore the image to better represent the object. In the case of
widefield imaging, Deconvolution can even convey optical sectioning properties to the result im-
age allowing true three-dimensional restoration.
The following improvements can be obtained by using deconvolution:

§ Denoising

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 589


6 General Toolkits | 6.14 Deconvolution ZEISS

§ Removal of out of focus light -> deblurring, improved contrast


§ Increasing signal to noise ratio by reassigning photons
§ Restoration of sparsely sampled data
§ Increase of resolution in X, Y and Z
As the object and the way, it was prepared, becomes part of the optical system during imaging,
the largest variable to consider when doing deconvolution is the sample itself. Since the sample
conditions can vary widely, information about the sample needs to be provided to the deconvolu-
tion function. The better the sample conditions are known, the better the outcome will be.

6.14.3 Deconvolution Methods in ZEN

Method Reference Settings Comments


(common name)
Nearest Neighbor K. Castleman, “Digi- Algorithm (default): Ad-hoc “2D de-blur-
tal image process- ring algorithm” fo-
Nearest Neighbor
ing”, Prentice Hall cuses on subtraction
1997 of out of focus blur.

Regularized In- For zero order g-dif- Algorithm (default): Uses difference of
verse ference: observation and esti-
Regularized In-
mate as regulariza-
also known as: Schaefer et al. verse Filter
tion term.
(2001)
Linear Least Squares Advanced settings >
Regularization:
Zero order

Regularized In- For first order regu- Algorithm: Uses Good’s rough-
verse larization, or Good’s ness first derivative
Regularized In-
roughness: of estimate as regu-
also known as: verse
larization term.
Verveer et al. (1997)
Linear Least Squares Advanced settings >
Regularization:
First order

Regularized In- Schaefer et al. Algorithm: Patented method for


verse (2006) maximum exploita-
Regularized In-
tion of ApoTome
also known as: Schaefer et al. (tbs) verse
raw images.
Linear Least Squares Advanced settings >
Regularization:
In conjunction with
structured illumina- Zero/First order
tion microscopy
(ApoTome)

Fast Iterative Meinel (1986) Algorithm (default): Classic, non-regular-


ized Meinel algo-
Also known as: Fast Iterative
rithm.
Meinel Algorithm Advanced settings >
Likelihood:
Gold Meinel
Poisson (Meinel)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 590


6 General Toolkits | 6.14 Deconvolution ZEISS

Method Reference Settings Comments


(common name)
Fast Iterative Meinel (1986), Algorithm: Regularized Meinel
algorithm using g-
Meinel Algorithm + For zero order g-dif- Fast Iterative
difference (differ-
Regularization: ference:
Advanced settings: ence of observation
Schaefer et al. and estimate) term.
- Likelihood:
(2001)
Poisson (Meinel)
- Regularization:
Zero order

Fast Iterative Meinel (1986), Algorithm: Meinel algorithm us-


ing a numerical gra-
Meinel Algorithm + Biggs (1998) Fast Iterative
dient estimator as
Optimization
Advanced settings: proposed by D.
Biggs.
- Likelihood:
Poisson (Meinel)
- Regularization:
None/Zero order
- Optimization:
Numerical Gradi-
ent

Fast Iterative Richardson (1972) Algorithm: Classic, original non-


regularized Richard-
Also known as: Lucy (1974) Fast Iterative
son Lucy algorithm.
Richardson Lucy (RL) Advanced settings > May need many
Algorithm Likelihood: more iterations than
any other algorithm.
Poisson (Richard-
son, Lucy)

Fast Iterative Richardson (1972) Algorithm: Classic, original non-


regularized Richard-
Also known as: Lucy (1974) Fast Iterative
son Lucy algorithm.
Richardson Lucy Al- Biggs (1998) Advanced settings: Improved rate of
gorithm + convergence. About
- Likelihood:
Optimization a factor of 10 faster
Poisson (Richard- than RL using a nu-
son, Lucy) merical gradient esti-
- Optimization: mator as proposed
by D. Biggs.
Numerical Gradi-
ent

Constrained Itera- Verveer et al. (1997) Algorithm (default): Generic conjugate


tive gradient restoration
Schaefer et al. Constrained Itera-
using squared esti-
(2001) tive
mate to impose posi-
Advanced settings: tivity. Uses differ-
ence of observation
- Likelihood:
and estimate as reg-
Poisson ularization term.
- Regularization:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 591


6 General Toolkits | 6.14 Deconvolution ZEISS

Method Reference Settings Comments


(common name)
Zero order

Constrained Itera- Verveer et al. (1997) Algorithm: Generic conjugate


tive gradient restoration
Schaefer et al. Constrained Itera-
using squared esti-
(2001) tive
mate to impose posi-
Advanced settings: tivity. Uses Good’s
roughness derivative
- Likelihood:
operator as regular-
Poisson ization term.
- Regularization:
First order

Constrained Itera- Tikhonov (1977) Algorithm: Generic conjugate


tive gradient restoration
Verveer et al. (1997) Constrained Itera-
using squared esti-
tive
Schaefer et al. mate to impose posi-
(2001) Advanced settings: tivity. Uses Tikhonov
Miller Phillips second
- Likelihood:
derivative operator
Poisson as regularization
- Regularization: term.

Second order

Constrained Itera- Verveer et al. (1997) Algorithm: Generic conjugate


tive gradient restoration
Schaefer et al. Constrained Itera-
using squared esti-
(2001) tive
mate to impose posi-
Advanced settings: tivity. Uses differ-
ence of observation
- Likelihood:
and estimate as reg-
Gauss ularization term.
- Regularization:
Zero order

Constrained Itera- Verveer et al. (1997) Algorithm: Generic conjugate


tive gradient restoration
Schaefer et al. Constrained Itera-
using squared esti-
(2001) tive
mate to impose posi-
Advanced settings: tivity. Uses Good’s
roughness derivative
- Likelihood:
operator as regular-
Gauss ization term.
- Regularization:
First order

Constrained Itera- van der Voort et al. Algorithm: Generic conjugate


tive (1995) Verveer et al. gradient restoration
Constrained Itera-
(1997) using squared esti-
Also known as: ICTM tive
mate to impose posi-
Schaefer et al.
Iterative Constrained Advanced settings: tivity. Uses Tikhonov
(2001)
Tikhonov Miller Miller Phillips second
- Likelihood:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 592


6 General Toolkits | 6.14 Deconvolution ZEISS

Method Reference Settings Comments


(common name)
Gauss derivative operator
as regularization
- Regularization:
term.
Second order

Constrained Itera- Verveer et al. (1997) Algorithm: Generic conjugate


tive gradient restoration
Schaefer et al. Constrained Itera-
using squared esti-
(2001) tive
mate to impose posi-
Advanced settings: tivity.
- Likelihood: Default for opti-
mization is the fast
Poisson/Gauss
analytical (Newton
- Regularization: Raphson) method.
0/1/2nd order Line search may be
more accurate but is
- Optimization: also much slower.
Line search/Analyt-
ical

Bibliography
Schaefer, L.H., Schuster, D. & Herz, H. Generalized accelerated maximum likelihood based image
restoration approach applied to three-dimensional fluorescence microscopy, Journal of Mi-
croscopy, 2004 (2001), Pt. 2, 99-107 (PubMed).
Verveer, P.J. & Jovin, T.M. (1997) Efficient superresolution restoration algorithms using maximum
a posteriori estimations with application to fluorescence microscopy. J. Opt. Soc. Am. A, 14,
1696-1706.
Meinel E.S., Origins of linear and nonlinear recursive restoration algorithms, J. Opt. Soc. Am. A.,
1986, 3 (6): 787-799.
Biggs, D.S.C. 1998. Accelerated Iterative Blind Deconvolution. Ph.D. Thesis, University of Auck-
land, New Zealand.
Schaefer, L.H. & Schuster, D. Structured illumination microscopy: improved spatial resolution us-
ing regularized inverse filtering, Proceedings of the FOM 2006, Perth, Australia.
Lucy L.B., An iterative technique for the rectification of observed distributions, Astron. J., 1974,
79: 745-754.
Richardson W.H., Bayesian-based iterative method of image restoration, J. Opt. Soc. Am., 1972,
62 (6): 55-59.
van der Voort, H. T. M. and Strasters, K. C. (1995) Restoration of confocal images for quantitative
image analysis. J. Microsc., 178, 165–181.
Tikhonov, A.N. & Arsenin, V.Y. (1977) Solutions of Ill Posed Problems. Wiley, New York.

6.14.4 Performing Deconvolution Using Default Values

Successful deconvolution depends mainly on good image quality, knowledge about the optical
parameters of the sample and detailed knowledge about the type of instrument used for image
acquisition. While information about the used instrument type can be easily extracted from the
image metadata, optical parameters of the sample might not be known and the image quality can

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 593


6 General Toolkits | 6.14 Deconvolution ZEISS

vary widely. Many parameters are available for deconvolution which allow you to make correc-
tions to the image quality and adjust the algorithms to match the various optical conditions such
as coverslip type or the medium, in which the sample is embedded. This wide range of parameters
can be overwhelming.
With the Deconvolution (defaults) method, good initial results are achieved by using a carefully
preselected set of default parameters. The parameters are automatically adapted to the following
instrument types: widefield, confocal, lightsheet and ApoTome.
While these parameters usually give nice results, there are cases where further parameter changes
are necessary, e.g., activating and using spherical aberration correction. In such cases, you should
use the Deconvolution (adjustable) method, see Performing Configurable Deconvolution
[} 595].

Prerequisite ü You are on the Processing tab.


ü You have acquired or opened a fluorescence image on which you wish to perform deconvo-
lution.
ü All tools are in Show All mode.
1. In the Method tool, in the Deconvolution group, select Deconvolution (defaults).
2. Open the Parameters tool.
à Four different algorithms for deconvolution are displayed (Nearest Neighbor, Regular-
ized Inverse Filter, Fast Iterative, Constrained Iterative), which you can apply to your
image. Note that the Constrained Iterative algorithm is only available if you have the li-
cense for the Deconvolution module.
3. Select an algorithm.
4. Open the Input tool.
à If Set Input Automatically is activated, the currently active image is loaded as input im-
age automatically. If the checkbox is deactivated, the container for the input image is
empty. In this case continue with the next.
5. Click on the empty image container.
à A list opens with preview images of all currently open images.
6. Click on the image to which you want to apply deconvolution.

à The image is displayed in the image container and is as the input image for processing.
7. Click Apply on the top of the Processing tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 594


6 General Toolkits | 6.14 Deconvolution ZEISS

Deconvolution is performed. A new image file is generated and opened automatically in the cen-
ter screen area after processing. If you are satisfied with the result, save the processed image. Re-
peat deconvolution using the other default values to obtain different results. If you have expert
knowledge, you can configure all the deconvolution settings yourself using the Deconvolution
(adjustable) method.

6.14.5 Performing Configurable Deconvolution

These instructions explain how to deconvolve a z-stack image correctly step by step.
In the described example, the best method Constrained Iterative and a theoretical PSF are
used.

Preparation
To follow these instructions you will need a z-stack image of your sample. You have opened the
software and no images are loaded.

Prerequisites
§ You have licensed the Deconvolution module and activated it in Tools > Modules Man-
ager.
§ You are on the Processing tab.
§ You have acquired or opened a fluorescence image on which you wish to perform deconvolu-
tion.
§ All tools are in Show All mode.

Steps
§ Step 1: Load input image
This section describes how to load an input image in Deconvolution (Configurable).
§ Step 2: Set parameters
This section describes how to set the parameters.
§ Step 3: Process image
This section describes how to process the image and compare it with the input image.
§ Step 4: Reuse deconvolution parameters
This section describes how to reuse the deconvolution parameters from an already processed
image.

6.14.5.1 Step 1: Loading an Input Image for Deconvolution

In this step you will select the image to be processed and load it as an input image for deconvolu-
tion.

1. On the Processing tab, select the Deconvolution (adjustable) method.


2. In the Input tool, select the image that you want to deconvolve. If Set Input Automati-
cally is activated, the currently active image has been loaded as input image automatically.
Since this means, that the output image is then also automatically selected as input, it is
recommended to deactivate this checkbox.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 595


6 General Toolkits | 6.14 Deconvolution ZEISS

3. Select the desired input image.

Info
If a warning appears at this point, it is likely that parameters required for deconvolution are
missing from the image. You can subsequently enter or change these values in the Parame-
ters tool > PSF settings tab > Microscope parameters.

6.14.5.2 Step 2: Set Parameters for Deconvolution

In this step you select the desired algorithm and the associated method parameters.

Prerequisite ü On the Processing tab, you have opened the Parameters tool in the Show All mode. You
can usually leave these parameters alone as they are automatically set to give you a good re-
sult.
1. On the Deconvolution tab, select the desired algorithm. In our example we use the Con-
strained Iterative algorithm, which is the most complex algorithm, but usually the best
one to use.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 596


6 General Toolkits | 6.14 Deconvolution ZEISS

à Additional parameters for the Constrained Iterative method are displayed on the tab.

6.14.5.3 Step 3: Performing Deconvolution

Info
The processing of large y-stack images or long time series can take some time. During process-
ing we recommend that you do not perform any other complex actions in ZEN or in other pro-
grams on the computer, to avoid increasing the processing time unnecessarily.

In this step you perform deconvolution. You can then compare the resulting image to the input
image and details relating to the processing procedure are visible.

1. Go to the Deconvolution tab


2. Click Apply on the top of the Processing tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 597


6 General Toolkits | 6.14 Deconvolution ZEISS

à The progress is displayed in the Convergence History graph, in which the gradual im-
provement is plotted against the number of iterations.

3. Save the resulting image under a meaningful name.


4. Click on the Splitter Mode button in the document bar. This creates a multi-image
(split image).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 598


6 General Toolkits | 6.14 Deconvolution ZEISS

5. The currently active image is loaded automatically into the multi-image. Now drag the input
image from the document gallery in the Right Tool Area into the split document.

6. On the Display tab, change and adjust the display as desired, e.g. Best Fit with 0.01 and
for black and white value with a Gamma of 0.8.
à Both images are adjusted simultaneously.
7. If on the Split Display tab Synchronize Dimensions is activated, you can now zoom syn-
chronously into the images (mouse wheel) and, with the mouse wheel held down, move
the image content as desired to focus on the regions of interest.
8. To create an image of the desired view click on New Image from > Current View > Cre-
ate.
à This creates a new output image document with both images shown side by side.

You have successfully performed deconvolution, observed the processing procedure, and created
an output image to compare the deconvolved with the input image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 599


6 General Toolkits | 6.14 Deconvolution ZEISS

6.14.5.4 Step 4: Info View and Re-Using Deconvolution Parameters from a Processed Image

The Info View contains a section Deconvolution Information, which shows a summary of the
parameters used for deconvolution of the image. It also contains the Convergence History
graph displaying the time it took to get this image processed.
If you like to use the same settings in order to process another image, the following steps show
how to do this:

1. Select the processed image from the previous steps.


2. Select the Info View and scroll down to the Deconvolution Information group:

3. Click Clipboard.
à All deconvolution parameters are copied to the clipboard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 600


6 General Toolkits | 6.14 Deconvolution ZEISS

4. Open the new image you want to deconvolve and select it as input in the Deconvolution
(adjustable) function. Right-click and select Paste to paste the parameters into Deconvolu-
tion.

5. Click Apply to run Deconvolution with the identical function parameters as used for the
previous image.

6.14.6 Creating Deconvolution Settings

You can create settings for Deconvolution which can be saved, exported, and imported.

1. Open the Processing tab and select the method Deconvolution (adjustable).
2. In the Parameters window, activate Show All (if it is not already activated).
3. In the Input window, select the desired image for the Deconvolution.
Note: If you use the settings for Direct Processing, use a test image acquired with the iden-
tical experiment settings you will be using when running the experiment with Direct Pro-
cessing.
4. Click on the context menu button and select New from the drop-down list.
5. Enter a name for your settings and press Enter on your keyboard or click on the save but-
ton .
6. Configure your settings in the Deconvolution or PSF settings tab, see also Deconvolu-
tion Tab [} 95] and PSF Settings Tab [} 99].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 601


6 General Toolkits | 6.14 Deconvolution ZEISS

7. Click on the context menu button and select Save.


You have now created and saved a Deconvolution setting. You can load this setting into the Di-
rect Processing tool to use it for a Direct Processing experiment.

Info
GPU
The setting also saves the status of the GPU. If you create the setting on a machine without a
GPU, export it, and import the setting on machine with GPU, the GPU will not be used. There-
fore, the processing can be considerably slow. In this case, we recommend creating the setting
directly on the machine where the processing is executed.
Exception for Direct Processing:
If you set up your experiment and your setting on an acquisition PC without a GPU, the pro-
cessing PC will ignore the status and use the GPU (if available).

6.14.7 Creating a PSF - With Wizard and Without

The PSF Wizard combines two steps which are necessary for extracting experimental point spread
functions (PSF) from Z-Stacks of subresolution fluorescent beads:

§ A bead averaging step finds individual beads, presents them for inspection, allows you to se-
lect the ones you like and then creates an averaged combination of all selected beads. This
stack shows a single bead which is, as a consequence of the averaging function, fairly free of
noise.
§ The averaged bead stack is then run through the Create PSF function which removes back-
ground and residual noise, correctly scales the PSF and also converts the stack into a 32-bit
floating point format which is better suitable for the mathematical procedures used in decon-
volution.

Prerequisite ü You have acquired a z-stack image. For more information, see Measuring the PSF Using Sub-
resolution Beads [} 603].
ü You have the license for the Deconvolution module.
ü The use of the PSF wizard is activated.
1. On the Processing tab, select the function PSF Wizard.
à Use Wizard and Bad Pixel Correction are activated by default.
2. On the top of the Processing tab, click Apply.
à The PSF wizard opens and guides you through the creation of the PSF.
à If the Use wizard checkbox deactivated, the function displays the parameters for Bead
Averaging. Note that these parameters are only available in Show all mode. We recom-
mend using the PSF wizard.
à The result of the wizard is a PSF file which you can use for deconvolution of images ac-
quired under the same conditions.
This method determines the position of fluorescent beads in a z-stack image. If these beads are
too close to one another, they are excluded from the calculation. Beads which are far enough
apart from one another are combined into a single bead, from which it is then possible to calcu-
late a PSF using the Create PSF function.

Description of the algorithm


This function consists of a series of steps before and after processing. The aim is to find beads
that are far enough apart from one another. The processing steps are as follows:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 602


6 General Toolkits | 6.14 Deconvolution ZEISS

§ Select input image


§ Image smoothing
§ Segmentation
§ Alignment of the center of the found beads
§ Averaging of the beads

6.14.8 Measuring the PSF Using Subresolution Beads

Preparation
1. The surface of coverslips is hydrophobic which means, liquid droplets do not spread out
easily and beads tend to aggregate at the edges. For PSF measurements you want individu-
ally spread out beads.
2. Bath the coverslips for 10 minutes in 100% ethanol.
3. Use forceps to remove the coverslip. Shake off excess liquid and run through bunsen burner
flame.
à This makes the surface slightly hydrophilic which means, the droplets and beads spread
out easier.
à Ideally, use ZEISS coverslips with a defined thickness of 170 μm. However, coverslips and
mounting media for bead measurements must be identical to the ones used for the sam-
ple, the image of which shall be deconvolved. Beads should have a diameter below the
resolution limit of the objective, e.g. 0.175 µm. Smaller diameters are better, but smaller
beads are dimmer and can therefore be difficult to locate on the cover slip.
à Tetraspeck beads from Thermo Fisher Scientific have the advantage of covering four col-
ors which are frequently used in imaging research, but some batches can show rapid loss
of fluorescence. Single color beads are typically brighter.
4. Break up agglomerates by sonicating stock suspension in a waterbath for 20 minutes.
Stocks suspensions are way too dense, so dilute 1:100 with 70% ethanol.
5. Create further dilutions of 1:1.000 and 1:10.000 by adding 100 µl to 900µl 70% ethanol.
Mix well using a Vortex mixer.
6. Put one 5 µl drop for each dilution on a cover slip using a 20 µl Eppendorf pipette
7. Let dry. This should take less than 5 minutes. You can speed it up by putting the cover slip
on a warm surface.
8. Put 10-20 µl mounting medium on the coverslip. For aqueous mounting media seal edges
of coverslip with valap (1:1:1 mixture of vaseline, lanolin, paraffin), nailpolish or paraffin.
In the next step, you acquire an image.

Imaging
1. Locate the beads on the microscope (e.g. use a 20 x lens first, then move to 63x oil). Start
at the 1:100 spot which should have tons of beads and be easy to find.
2. When found, move to a sparser spot and try to find an area with a couple of single beads
in the FOV. This can be tricky, but usually you will be able to find good areas if you keep
looking around.
3. Acquire a Z-stack of a suitable area, observing the following rules.
à No saturation. This can be tricky with LSM’s. Use 12-bit mode at least.
à Only fill the dynamic range in the histogram to about 80%.
à Make sure to focus up and down when setting up the exposure times to measure the ex-
posure suitable for the bright bead center to avoid the risk of saturation.
4. Set up the z-stack as follows: in the Z-stack tool, click on the Optimal button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 603


6 General Toolkits | 6.14 Deconvolution ZEISS

à This sets the distance according to Nyquist. For bead measurments further reduce the
slice distance to about half of what Optimal suggests.
5. Also, define the top and bottom of the stack in such a way that the airy disc of the beads
cannot be distinguished any longer.
6. When ready, save and name the image properly.
Look at the result in OrthoView: Do you see spherical aberrations? Are the beads symmetrical?
Are there enough individual beads in the stack? Is the background low enough?

Processing in ZEN Blue


1. Use the PSF wizard (Processing/Deconvolution) to extract the PSF from the bead-z-stack.
For more information, see Creating a PSF - With Wizard and Without [} 602].
The PSF wizard guides you step by step through the necessary procedure.
The result of the wizard is a PSF file which you use in deconvolution for images acquired under
the same conditions.

6.14.9 Using Deconvolution in Direct Processing

Prerequisite ü If you are using Direct Processing on different computers, you have connected acquisition and
processing computer, see Connecting Acquisition Computer and Processing Computer
[} 222].
ü To ensure that the processing computer reads incoming files and starts the processing, you
have clicked Start Receiving in the Direct Processing tool on the Applications tab. This is
usually active by default.
ü On the Acquisition tab, Direct Processing is activated. This activates the Auto Save tool as
well.
ü Depending on your settings, you have defined the folder where the acquired images are
stored in the Direct Processing or the Auto Save tool. Use a folder to which the processing
computer has access. For information about sharing a folder, see Sharing a Folder for Direct
Processing [} 238].
ü On the Acquisition tab, you have set up your experiment for image acquisition.
ü If you want to use advanced settings created with the Apotome Plus (adjustable) function,
you have the settings available, see also Creating Deconvolution Settings [} 601].
1. On the Acquisition tab, open the Direct Processing tool.
à If no Direct Processing settings were made before for the current experiment, a particular
processing function is already preselected depending on your microscope, channel set-
tings and licenses.
2. From the Processing Function dropdown list, select Deconvolution.
3. Select a deconvolution method. We recommend Excellent, slow (Constraint Iterative). If
you want to use an advanced settings file you have created with the function Deconvolu-
tion (adjustable), activate Use Advanced Settings.
à A dropdown list is displayed under Load Setting created in the Deconvolution func-
tion.
4. In the drop-down list, select your advanced settings for Deconvolution.
Note: Currently Direct Processing supports settings configured in the Deconvolution tab
of the image processing function Deconvolution (adjustable) and some parameters of
the PSF Settings tab. Especially parameters that rely on external data (like using external
PSF) are not possible with Direct Processing.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 604


6 General Toolkits | 6.14 Deconvolution ZEISS

5. Set up the experiment. For optimal processing efficiency, select the Full Z-Stack per chan-
nel option. This way, the processing can start as soon as a channel-z-stack has been com-
pleted. Keep in mind that for Colocalization studies better results might be achieved when
the default All Channels per Slice is used, depending specific application and filter config-
uration.
6. Click Start Experiment to run the experiment. Note: You can pause the processing. If you
stop the experiment, requests that have been sent earlier by the acquisition computer are
not processed. However, already processed images will be retained.
à The images are stored in the folder you have defined in the Auto Save or Direct Pro-
cessing tool. When you abort the acquisition, the remote processing will not take place.
In case you have set up several processing functions, only the acquired image and the fi-
nal output image are stored.
à The processing computer reads incoming files and starts the processing. The path to the
selected folder, the currently processed image as well as the images to be processed are
displayed in the Direct Processing tool. The processed image is saved to the same
folder specified in the Direct Processing tool. If the image name already exists in this
folder, the new file is saved under a new name <oldName>-02.czi.
7. To cancel the processing on the processing computer, on the Applications tab, in the Di-
rect Processing tool, click Cancel Processing.
Once processing is finished, you are notified on the acquisition PC and can open and view the ac-
quired image as well as the processed image. This should be done on the processing computer, so
that you can immediately start a new experiment on the acquisition computer. However, you can
also automatically open the processed image on the acquisition PC with the respective setting in
the Direct Processing tool on the Acquisition tab.
When you open the image, in the Image View, on the Info view tab, information about the exe-
cuted deconvolution is available. When Deconvolution is done through Direct Processing, the info
about Deconvolution parameters shows the suffix online and the Convergence History graph.
Additionally, general information about Direct Processing (e.g. the duration) is also available on
the Info view tab of the processed image.

See also
2 Auto Save Tool [} 890]
2 Sharing a Folder for Direct Processing [} 238]
2 Direct Processing Tool on Acquisition Tab [} 233]
2 Connecting Acquisition Computer and Processing Computer [} 222]

6.14.10 Image Types Suitable for Deconvolution

Most types of microscope images could in principle be deconvolved. However, there are practical
limitations, for example the image file sizes might be too large or imaging conditions might be
dominated by effects other than blurring by the point spread function. If, for example, a sample
has strong light scattering properties or if light is strongly absorbed by the sample, deconvolution
becomes difficult or impossible.
Deconvolution works both in 2D as in 3D. The PSF is very small in 2D, so the improvements of de-
convolving 2D images are usually not very significant. Its full power deconvolution can show
when processing 3D image stacks which have been acquired according to the following general
rules:

§ Acquisition of images with enough pixel resolution by choosing objectives with numerical
apertures >0.5 and using camera resolutions with small enough pixel sizes as recommended
by the Nyquist criterion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 605


6 General Toolkits | 6.14 Deconvolution ZEISS

§ Acquisition of Z-stacks with distance between individual planes not larger than recommended
by the Nyquist criterion (2-fold oversampling of the theoretically resolvable information, Opti-
mal button in the Z-stack tool).
§ Acquisition of enough planes above and below the structure of interest. As a rule, acquiring
about half the axial PSF size above and below is enough to also get restoration of the struc-
tures at the top and bottom of the structure of interest.
§ Avoiding saturation of the detector.
§ Choosing imaging conditions to avoid sample bleaching.
§ Avoiding spherical aberrations by choosing objectives, which use an immersion medium with
a refractive index as close as possible to the mounting medium of the sample (for example us-
ing water immersion objectives for cell cultures in aqueous medium).
§ Choosing sample media with low background fluorescence (for example phenol red free cul-
ture media).
ZEN deconvolution is suitable for images from many different microscope types. The following list
of image types have been tested and are supported by ZEN deconvolution:

Imaging modality Suitability for Deconvolu- Comment


tion
Widefield fluorescence +++ Ideally choose objectives
with a numerical aperture >
0.5.

LSM confocal imaging de- +++ Prerequisite is to have cho-


tecting sen a dye with the correct
excitation and emission
wavelengths before acquisi-
tion.

LSM Lambda and Online Fin- ++ Exact excitation and emission


gerprinting imaging modes wavelengths are missing,
detecting fluorescence need to be added on the PSF
page before attempting de-
convolution.

2-Photon (NLO) imaging us- +++ Excitation wavelength >


ing NDD (Non-descanned de- emission wavelength.
tectors)

ApoTome fluorescence +++ Only ApoTome raw images


should be deconvolved.

Spinning disk confocal + No spinning disk specific PSF


model available, still can get
good results when process-
ing with a PSF according to
standard confocal conditions
(~1.2 airy units), or choose
measured PSF.

Lightsheet - Only single view deconvolu-


tion supported, image sizes
might be challenging, best
results for high NA objec-
tives.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 606


6 General Toolkits | 6.14 Deconvolution ZEISS

Imaging modality Suitability for Deconvolu- Comment


tion
Airyscan - Airyscan raw data deconvo-
lution is currently not sup-
ported, deconvolving already
processed images is not rec-
ommended.

Elyra - Currently not supported.

Bright field transmitted light - Not supported.


images

Axio Scan.Z1 + Can be used for fluorescence


stacks, however, frequently
file sizes are prohibitive.
Also, ideally JPEG-XR com-
pression should not be used.

Celldiscoverer 7 +++ Very well suited due to ob-


jectives specialized for life
cell imaging; recommended
use of Direct Processing
module to improve the
workflow.

6.14.11 Table of Default Parameter for Deconvolution

The following table lists the parameters which are used by default for widefield, confocal, light-
sheet and ApoTome images.

Microscope Widefield Confocal Lightsheet ApoTome


Type
General Deconvolution Parameter Defaults

Normalization Auto Auto Auto Auto


Background Off Off Off Off
Correction

Flicker Correc- Off Off Off Off


tion

Decay Correc- Off Off Off Off


tion

Hot Pixel Cor- Off Off Off Off


rection

Constrained Iterative Specific Defaults

Strength (auto- Auto Auto Manual (str 5) Auto


matic, manual;
range 0..10)

Likelihood Poisson Poisson Poisson —


Regularization Zero Order First Order Zero Order —

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 607


6 General Toolkits | 6.15 Apotome Plus ZEISS

Microscope Widefield Confocal Lightsheet ApoTome


Type
Optimization Analytical Line Search Analytical —
First Estimate Input Mean Input —
Maximum Num- 40 7 40 —
ber Of Itera-
tions

Auto Stop Per- 0.1 0.1 0.1 —


centage

Fast Iterative Specific Defaults

Method Poisson/ Poisson/ Poisson/ —


Meinel Richardson Meinel
Lucy
Regularization None None None —
Optimization None None None —
First Estimate Input Mean Input —
Maximum Num- 15 50 15 —
ber Of Itera-
tions

AutoStop Per- 0.1 0.1 0.1 —


centage

Regularized Inverse Specific Defaults

Regularization Zero Order Zero Order Zero Order First Order

6.15 Apotome Plus

Apotome Plus is a novel reconstruction algorithm for Apotome 2 and 3. Based on an iterative joint
SIM reconstruction, it increases SNR, lateral and axial resolution compared to predecessor algo-
rithms.
Apotome Plus processes 3D z-stacks and runs on ZEN 3.11 and higher. Note that a separate
workstation running ZEN desk is recommended for processing during acquisition, as the worksta-
tion requirements are significantly higher than for previous methods. Specific guidelines and rec-
ommended configurations can be found in the price list.

6.15.1 Apotome Plus (defaults)

This method allows you to select two different algorithms for Apotome Plus, without any further
settings.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 608


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
Good, Medium Uses an algorithm based on Deconvolution methods for structured il-
Speed (Joint Fast lumination microscopy, with some enhancements as described in the
Iterative) technical note. It is faster and less memory intensive, and also purely
using the image formation model.

Excellent, Slow Uses an algorithm based on the Generalized approach for accelerated
(Joint Constrained maximum likelihood based image restoration applied to three-dimen-
Iterative) sional fluorescence microscopy, but modified to allow for joint recon-
struction and with enhancements as described in the technical note. It
offers increased robustness to noise and mismatch between the theo-
retical and real PSF.

6.15.2 Apotome Plus (adjustable)

This method allows you to use and individually configure two different algorithms for Apotome
Plus. Two tabs are available for detailed configuration:

§ On the Apotome Plus tab, you can select the desired algorithm and define the precise set-
tings for it, see Apotome Plus Tab [} 609].
§ On the PSF Settings tab, you can see and change all key parameters for generating a theo-
retically calculated PSF, see PSF Settings Tab [} 613].

6.15.2.1 Apotome Plus Tab

Parameter Description
Algorithm Selects the Apotome deconvolution algorithm.

– Fast Iterative Uses an algorithm based on Deconvolution methods for structured il-
(Joint) lumination microscopy, with some enhancements as described in the
technical note. It is faster and less memory intensive, and also purely
using the image formation model.

– Constraint It- Uses an algorithm based on the Generalized approach for accelerated
erative (Joint) maximum likelihood based image restoration applied to three-dimen-
sional fluorescence microscopy, but modified to allow for joint recon-
struction and with enhancements as described in the technical note. It
offers increased robustness to noise and mismatch between the theo-
retical and real PSF.
Also, it offers more options (likelihood poisson and gaussian, and reg-
ularization), allowing choosing an algorithm optimized for specific im-
age types, e.g. sparse and dense images.

Enable Channel Se- Not possible in combination with Maximum Iterations and Quality
lection Threshold.
Activated: Applies the settings on a channel specific basis. This al-
lows you to set parameters for each channel individually. A separate,
colored tab for each of the channels is displayed.
Deactivated: Applies the same settings to all channels of a multi-
channel image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 609


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
2x Upsampling Activated: Allows you to extract additional information enabled by
the SIM principle. This modality splits one pixel into four, which allows
the algorithm to work on a finer grid and reconstruct with higher res-
olution. Note that this will largely increase the computation times and
requires a large CUDA-based GPU.

Normalization Specifies how the data of the resulting image is handled if the gray/
color levels exceed or fall short of the value range.

– Clip Clips the values that exceed or fall short of the value range. Sets neg-
ative values to 0 (black). If the values exceed the maximum possible
gray value of 65636 when the calculation is performed, they are lim-
ited to 65636 (pixel is 100% white).
Results from different input images can be quantitatively compared
with each other.

– Automatic Normalizes the output image automatically. In this case the lowest
value is 0 and the highest value is the maximum possible gray value in
the image (gray value of 65636). The maximum available gray value
range is always utilized fully in the resulting image.
Results from different input images cannot directly be compared
quantitatively with each other.

– Factor Only visible if Clip is selected.


Defines a scaling factor for normalization. A factor above 1 stretches
the histogram to show the full dynamic range of the data (showing
complete information of the given data). A factor >1 makes sense to
scale up values with a float number with decimal places. A factor be-
low 1 squeezes the histogram, data that is above the pixel maximum
would be lost.

Set Strength Man- Only available for Constrained Iterative and if for Regularization is
ually at least Zero Order selected.
Activated: Sets the desired degree of restoration with the slider. To
achieve strong restoration and best contrast, move the slider towards
Strong. To achieve lower restoration but smoother results, move the
slider towards Weak. If the setting is too strong, image noise may be
intensified and other artifacts, such as "ringing", may appear.
Deactivated: Determines the restoration strength for optimum image
quality automatically. This is recommended for widefield images and
is therefore deactivated by default.
The restoration strength is inversely proportional to the strength of
so-called regularization. This is determined automatically with the
help of Generalized Cross Validation (GCV).

Convergence His- Visible for Fast Iterative or Constrained Iterative algorithms.


tory
Displays the progress of the calculation as line graph. Several quality
parameters are measured for each iteration and once either an opti-
mum or the maximum allowed number of iterations is reached, the
processing is stopped. This display allows you to observe directly how
the iterative method affects the available data. It also shows how
many iterations have been used and how much time is being used per
iterations.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 610


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
Corrections
To display parameters for image correction, click .

– Background Activated: Analyzes the background component in the image and re-
moves it before the deconvolution calculation. This can prevent back-
ground noise being intensified during deconvolution.

– Bad Pixel Cor- Activated: Employs a fully automatic detection and removal of spuri-
rection ous or hot pixels (also known as stuck pixels) in an image stack which
might interfere with the deconvolution result.
It is based on the analysis of the gray level variance in the neighbor-
hood of each pixel in the image. It is recommended to use this param-
eter only, if stuck pixels are observed in the input image.

– Fluorescent Activated: Corrects bleaching of the sample during acquisition of the


Decay z-stack.
This function should only be activated for widefield images. Use it if
your sample undergoes strong bleaching during acquisition.

– SIM Correc- Activated: Removes stripe artefacts created by image acquisition and
tion corrects for false phases in metadata.

– Stronger Sec- Activated: Applies a stronger optical sectioning to remove out-of-fo-


tioning cus signals based on the multiplication of the optical sectioning data.

6.15.2.1.1 Advanced Settings

To display advanced settings, click .

Parameter Description
Likelihood Visible for Fast Iterative and Constrained Iterative algorithms.
Selects which likelihood calculation you want to work with.

– Poisson Only visible for the Fast Iterative algorithm.


(Richardson- Accelerated version of Richardson-Lucy, based on a Poisson likelihood
Lucy) and Biggs acceleration (https://doi.org/10.1364/AO.36.001766), al-
lowing for fast and artifact free reconstructions.

– Poisson Only visible for the Constrained Iterative algorithm.


Computation assuming a Poisson noise distribution, this is normally
the correct noise model for microscopic images.

– Gauss Only visible for the Constrained Iterative algorithm.


Computation assuming a Gaussian noise distribution. If detector
noise is dominant over sample noise, using a Gaussian noise model
can be advantageous, however, this is rarely the case with modern
microscopy systems.

Regularization Only visible for the Constrained Iterative algorithm.


Adds an additional term to the optimization which allows for
smoother optimization and is less prone to artifacts.

– None No regularization is performed.

– Zero Order Regularization based on G-difference, modeled on Tikhonov, but ac-


celerated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 611


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
– First Order Regularization based on Good's roughness. Under certain circum-
stances, more details are extracted from noisy data. It may be better
suited to the processing of confocal data sets.

– Second Order Regularization according to Tikhonov-Miller. Here higher frequencies


are penalized more than in the case of Good's roughness. Results
have a tendency to become overly smoothed.

Optimization Visible for Fast Iterative and Constrained Iterative algorithms.

– Analytical Only visible for the Constrained Iterative algorithm.


(Newton Here an attempt is made to optimize the iterations analytically. It is an
Raphson) optimization method to find the step size in each of the Constrained
Iterative iterations. This option is usually faster but may also be some-
what less precise.

– Line Search Only visible for the Constrained Iterative algorithm.


Searches rigorously and comprehensively for the minimum. It is there-
fore more robust, but the calculation takes longer. It is an optimiza-
tion method to find the step size in each of the Constrained Iterative
iterations. Line search is recommended for confocal data sets, espe-
cially if they are noisy as this can enforce convergence even for noisy
and sparsely sampled data.

– Numerical Only visible for the Fast Iterative algorithm.


Gradient If selected, an attempt is made to determine the trend of the itera-
tions in advance and extrapolate this to the entire calculation. This
can significantly speed up the calculation.

First Estimate Visible for Fast Iterative and Constrained Iterative algorithms.

– Input Image The input image is used as the first estimate of the target structure
(default).

– Last Result The result of the last calculation is used to estimate the next calcula-
Image tion. This can speed up a calculation that is repeated using slightly dif-
ferent parameters.

– Mean of Input No estimate is made, the mean gray level of the input image is being
used. This is the most rigid application of deconvolution. It should be
chosen for confocal images, where the data sampling can be quite
sparse. The computation time will increase, but missing information
can be recovered from the PSF.

– Zero Values Only visible for the Constrained Iterative algorithm.

Maximum Itera- Visible for Fast Iterative and Constrained Iterative algorithms.
tions Sets the maximum permitted number of desired iterations. In the case
of Richardson-Lucy, you should allow significantly more iterations
here.

Quality Threshold Only visible for the Fast Iterative and Constrained Iterative algo-
rithms.
Defines the quality level at which you want the calculation to be
stopped. The percentage describes the difference in enhancement be-
tween the last and next-to-last iteration compared with the greatest
difference since the start of the calculation. 1% is the default value.
Lowering this can bring about small improvements in quality.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 612


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
Since Apotome Plus only supports GPU, the following two options cannot be edited:

GPU Acceleration Only visible if a suitable (NVIDIA, CUDA based) graphics card is in-
stalled in your PC. The checkbox is then activated by default.
Activated: Uses GPU processing.
Deactivated: Uses CPU processing.

GPU Tiling Only available for very large images that exceed the available graphic
card memory.
Activated: With this function the image is split up in smaller portions
which fit into the memory of the graphic card. The function automati-
cally determines into how many tiles the image must be split to allow
maximum usage of the graphics card. The resulting tiles are automati-
cally stitched together for the final output result.
Deactivated: No tiling is performed, however, in this case only cer-
tain sub-functions of deconvolution can run on the graphics card and
the speed increase compared to CPU processing will be lower. The
image quality might be higher than with tiling because there is no
need for stitching.

6.15.2.2 PSF Settings Tab

All key parameters for generating a theoretically calculated Point Spread Function (PSF) are dis-
played on this tab.

Info
Usually, images (with file type *.czi) that have been acquired with ZEN automatically contain
all microscope parameters, meaning that you do not have to configure any settings on this
tab. Therefore, most parameters are grayed out in the display. It is possible, however, that as a
result of an incorrect microscope configuration values may not be present or may be incorrect.
You can change them here. The correction of spherical aberration can also be set here.

6.15.2.2.1 Microscope Parameters Section

The most important microscope parameters for PSF generation that are not channel-specific are
displayed in this section.

Info
If you enter incorrect values, this can lead to incorrect calculations. If the values here are obvi-
ously wrong or values are missing, check the configuration of your microscope system.

Parameter Description
NA Objective Displays the numerical aperture of the objective.

Immersion Displays the refractive index of the immersion medium. Note that this
can never be smaller than the numerical aperture of the objective.
You can make a selection from typical immersion media in the drop-
down list next to the input field.

Scale Lateral Displays the geometric scaling in the X/Y direction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 613


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
Scale Axial Displays the geometric scaling in the Z direction.

Override To change the input fields that are normally grayed out, click on the
button. The input fields and drop-down lists are now active. The text
on the button changes to Reset. To restore the original values saved
in the image, click Reset.

Master Reset Resets the metadata to the values which were originally stored in the
image at time of acquisition. It reverts any changes made by clicking
Override.

6.15.2.2.2 Advanced Section

Only visible if the Show All mode is activated.

Parameter Description
Phase Ring If you have acquired a fluorescence image using a phase contrast ob-
jective, the phase ring present in the objective is entered here. This
setting has significant effects on the theoretical Point Spread Func-
tion (PSF).

PSF Generation Selects the model for calculating the PSF.

– Scalar Theory The wave vectors of the light are interpreted as electrical field = inten-
sity and simply added. This method is fast and is sufficient in most
cases (default setting).

– Vectorial The- The wave vectors are added geometrically. However, the calculation
ory takes considerably longer.

Z-Stack This field can only be changed if it was not possible to define this pa-
rameter during acquisition, e.g. because the microscope type was un-
known. It describes the direction in which the z-stack was acquired.
Note that this setting is only relevant, if you are using the spherical
aberration correction.

– Descending The z-stack descends away from the objective.

– Ascending The z-stack ascends towards the objective.

6.15.2.2.3 Aberration Correction Section

Only visible if the Show All mode is activated.


Here you can select whether you want spherical aberration to be taken into account and cor-
rected during the calculation of the PSF. As with the other PSF parameters, most values are ex-
tracted automatically from the information about the microscope that is saved with the image
during acquisition. The input option is therefore inactive.

Parameter Description
Enable Correction Activated: Uses the correction function. All options are active and
can be edited.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 614


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
Embedding Select the used embedding medium.
Medium

Refractive Index Displays the refractive index of the selected embedding medium. En-
ter the appropriate refractive index if you are using a different embed-
ding medium.

Manufacturer Displays the manufacturer, if known.

Depth Variance When Aberration correction is activated, it is also possible to enable


the creation of depth variant PSFs. This method allows for dramatic
improvements in image restoration of thicker samples by creating axi-
ally variant theoretical PSFs as a function of the distance to the cover-
slip and the refractive index of the mounting medium.
Activated: Uses depth variant aberration correction. In the spin box
edit field you can define how many PSFs should be generated. The
more PSFs you create, the better the results, but selecting many PSFs
increases the processing time. You should choose at least 3 PSFs.
In the dropdown list you can choose between the PCA method (Pri-
mary Component Analysis, M. Arigovindan et al., 2005, IEEE Transac-
tions on Image Processing 14. nr. 4 p.450ff) which is best suited for
constrained iterative and fast iterative method and the Strata method
(Myneni and Preza, Frontiers in Optics 2009, Optical Society of Amer-
ica, paper CThC4.), which is best for regularized inverse filter and
Richardson Lucy iterative deconvolution.

Distance to Cover Displays the distance of the acquired structure from the side of the
Slip cover slip facing the embedding medium. Half the height of the z-
stack is assumed as the initial value for the distance from the cover
slip. The value can be corrected if this distance is known. If possible,
this distance should be measured.
Note: Use Ortho View and the Distance Measurement option to
define the distance of the sample to the coverslip. It is also important
to estimate the position of the glass/embedding medium interface as
precise as possible. If the z-stack extends into the coverslip, the deter-
mined range of the stack which reaches into the glass should be en-
tered as a negative value. Example: Z-stack is 26 µm thick, glass/

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 615


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
medium interface is positioned at 9 µm distance from the first plane
of the stack. Resulting value for Distance to cover slip: - 9.0 µm.

Cover Slip Type Commercially available cover slips are divided into different groups
depending on their thickness (0, 1, 1.5 and 2), which you can select
from the dropdown list. Cover slips of the 1.5 type have an average
thickness of 170 µm. In some cases, however, the actual values can
vary greatly depending on the manufacturer. For best results the use
of cover slips with a guaranteed thickness of 170 µm is recom-
mended. Values that deviate from this can be entered directly in the
input field.

Cover Slip Ref. In- Selects the material that the cover slip is made of. The corresponding
dex refractive index is displayed in the input field next to it.

Working Distance Displays the working distance of the objective (i.e. the distance be-
tween the front lens and the side of the cover slip facing the objec-
tive). The working distance of the objective is determined automati-
cally from the objective information, provided that the objective was
selected correctly in the MTB 2011 Configuration program. You can,
however, also enter the value manually.

Override Only active if Enable Correction is activated.


Overrides the value. To reset the values, click Reset.

6.15.2.2.4 Channel Specific Section

In this section you find all settings that are channel specific. This means that they can be config-
ured differently for each channel.

Parameter Description
Illumination Displays the excitation wavelength for the channel dye [in nm] by us-
ing the peak value of the emission spectrum. The color field corre-
sponds to the wavelength (as far as possible).

Detection Displays the peak value of the emission wavelength for the channel
dye. The color corresponds to the wavelength (as far as possible).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 616


6 General Toolkits | 6.15 Apotome Plus ZEISS

Parameter Description
Sampling Lateral Depends on the geometric pixel scaling in the X/Y direction and dis-
plays the extent of the oversampling according to the Nyquist crite-
rion. The value should be close to 2 or greater in order to achieve
good results during DCV. As, in the case of widefield microscopes,
this value is generally determined by the objective, the camera
adapter used and the camera itself, it can only be influenced by the
use of an Optovar. With confocal systems, the zoom can be set to
match this criterion.

Sampling Axial Depends on the geometric pixel scaling in the Z direction and displays
the extent of the oversampling according to the Nyquist criterion.
The value should be at least 2 or greater in order to achieve good re-
sults during DCV. This value is determined by the increment of the fo-
cus drive during acquisition of Z-stacks and can therefore be changed
easily.

6.15.2.2.4.1 Microscope Info Section

Displays advanced microscope information that influences the form of the PSF in a channel-de-
pendent way:

Parameter Description
Illumination Selects the illumination method with which the data set has been ac-
quired. In the event that a Conventional Microscope has been en-
tered under the microscope parameters, the following options are
available here: Epifluorescence, Multiphoton Excitation and
Transmitted Light. In the case of confocal microscopes, Epifluores-
cence is the only option.

Image Formation Displays whether the imaging was incoherent (Conventional Micro-
scope) or coherent (Laser Scanning Microscope).

Lateral Resolution Displays the lateral resolution of the calculated PSF.

Axial FWHM Displays the FWHM (Full Width Half Maximum) as a measure of the
axial resolution of the PSF.

6.15.2.2.4.2 PSF View Section

This section shows you the PSF that is calculated for a channel based on the current settings. If
you select the Auto Update checkbox, all changes made to the PSF parameters are applied im-
mediately to the PSF view. This makes it possible to check quickly whether the settings made
meet your expectations. You can extract the PSF from the image via right-click menu (PSF Snap-
shot) which opens the resulting new PSF document in the center screen area.

6.15.3 Using Apotome Plus in Direct Processing

Apotome Plus can be used in Direct Processing. For general information, see Direct Processing
[} 219].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 617


6 General Toolkits | 6.15 Apotome Plus ZEISS

Prerequisite ü If you are using Direct Processing on different computers, you have connected acquisition and
processing computer, see Connecting Acquisition Computer and Processing Computer
[} 222].
ü To ensure that the processing computer reads incoming files and starts the processing, you
have clicked Start Receiving in the Direct Processing tool on the Applications tab. This is
usually active by default.
ü On the Acquisition tab, Direct Processing is activated. This activates the Auto Save tool as
well.
ü Depending on your settings, you have defined the folder where the acquired images are
stored in the Direct Processing or the Auto Save tool. Use a folder to which the processing
computer has access. For information about sharing a folder, see Sharing a Folder for Direct
Processing [} 238].
ü On the Acquisition tab, you have set up your experiment for Apotome acquisition.
ü If you want to use advanced settings created with the Apotome Plus (adjustable) function,
you have the settings available, see also Creating Apotome Plus Settings [} 619].
1. On the Acquisition tab, open the Direct Processing tool.
à The tool parameters are displayed. In the processing pipeline, the first block is selected
automatically
2. If the function is not preselected, go to the Processing Function dropdown list and select
Apotome Plus.
à The parameters are displayed.
3. Select the algorithm you want to use. If you want to use an advanced settings file you have
created with the function Apotome Plus (adjustable), activate Use Advanced Settings.
à A dropdown list is displayed under Load Setting created in the Apotome Plus func-
tion.
4. From the dropdown list, select your advanced settings for Apotome Plus.
Note: Currently Direct Processing supports settings configured on the Apotome Plus tab
of the image processing function Apotome Plus (adjustable) and some parameters of the
PSF Settings tab. Especially parameters that rely on external data (like using external PSF)
are not possible with Direct Processing.
5. Click Start Experiment to run the experiment. Note: You can pause the processing. If you
stop the experiment, requests that have been sent earlier by the acquisition computer are
not processed. However, already processed images will be retained.
à The images are stored in the folder you have defined in the Auto Save or Direct Pro-
cessing tool. When you abort the acquisition, the remote processing will not take place.
In case you have set up several processing functions, only the acquired image and the fi-
nal output image are stored.
à The processing computer reads incoming files and starts the processing. The path to the
selected folder, the currently processed image as well as the images to be processed are
displayed in the Direct Processing tool. The processed image is saved to the same
folder specified in the Direct Processing tool. If the image name already exists in this
folder, the new file is saved under a new name <oldName>-02.czi.
6. To cancel the processing on the processing computer, on the Applications tab, in the Di-
rect Processing tool, click Cancel Processing.
Once processing is finished, you are notified on the acquisition PC and can open and view the ac-
quired image as well as the processed image. This should be done on the processing computer, so
that you can immediately start a new experiment on the acquisition computer. However, you can
also automatically open the processed image on the acquisition PC with the respective setting in
the Direct Processing tool on the Acquisition tab.
Information about Direct Processing (e.g. the duration) is available on the Info view tab of the
processed image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 618


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.15.4 Creating Apotome Plus Settings

You can create settings for Apotome Plus which can be saved, exported, and imported.

Prerequisite ü You have opened an image based on which you want to define the processing settings.
1. Open the Processing tab and select the method Apotome Plus (adjustable).
à The parameters are displayed in the Parameters window.
2. In the Input window, select the desired image for Apotome Plus.
Note: If you use the settings for Direct Processing, use a test image acquired with the iden-
tical experiment settings you will be using when running the experiment with Direct Pro-
cessing.
3. In the Parameters window, activate Show All (if it is not already activated) and click the
context menu button
à A dropdown list is displayed.
4. Select New.
à The text field gets editable.
5. Enter a name for your settings and press Enter on your keyboard, or click on the save but-
ton .
à You have defined a name for the setting.
6. Configure your settings in the Apotome Plus or PSF settings tab, see also Apotome Plus
Tab [} 609] and PSF Settings Tab [} 613]. Note that if you want to use this setting in Di-
rect Processing, some parameter settings of the PSF Settings tab are not supported/possi-
ble there, especially parameters that rely on external data (like using external PSF).
7. Click and select Save.
You have now created and saved an Apotome Plus setting. You can load this setting into the Di-
rect Processing tool to use it for a Direct Processing experiment.

See also
2 Using Apotome Plus in Direct Processing [} 617]

6.16 ZEN Connect

This module enables you to work with images from multiple sources: zoom in from the full
macroscopic view of your sample down to nanoscale details. The Correlative Workspace (CWS) is
the efficient way to analyze and correlate images from multiple sources. You can manage, cor-
rect, and align these images in 2D as well as in 3D. It works with images from SEM, FIB-SEM, X-
ray, light microscopes and any optical images, e.g., from your digital camera. Its sample-centric
workspace lets you build a seamless multimodal, multiscale picture of your sample. Use it to guide
further investigations and target additional acquisitions.
The module employs a novel graphical user interface concept that makes it easy to investigate all
your samples. Design a workflow tailored precisely to the complexity of your experiment, no mat-
ter whether it’s a simple task or a compound experiment. A sophisticated workflow environment
guides you all the way from the setup for automated acquisition to post processing and custom-
ized exports, and right on through to analysis.

6.16.1 Licensing and Functionalities of ZEN Connect

For working with ZEN Connect projects or images, you might need a separate license. The basic
ZEN Connect functionality is available for all versions. This functionality includes:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 619


6 General Toolkits | 6.16 ZEN Connect ZEISS

§ ZEN Connect correlative workspace, including the display of images with their relations.
§ Manual alignment of captured images.
§ Auto-registration of images using stage coordinates.
§ Image acquisition into the project.
§ Import of images into the correlative workspace.
§ Interactive control of stage movement from the correlative workspace.

Licensed Functionality
If you have the necessary license, additional functionality for 2D and 3D work is available.
Additional 2D functionality:

§ Export of merged project view as image.


§ Movie export as fly-through videos.
§ Import of third-party microscopy images powered by Bio-Formats.
§ SerialEM export.
§ Adding of measurements to the ZEN Connect project.
§ Two dedicated wizards to support manual alignment and 2D point alignment.
§ S&F calibration, see also Shuttle & Find [} 671].
§ Definition of regions of interest in the correlative workspace.
§ Retrieval of defined regions of interest.
Additional 3D functionality:

§ Control of the displayed z-position in ZEN Connect.


§ Alignment of images in z-dimension.
§ Viewing of two 3D stacks (provided you have the necessary licenses).
§ Alignment of two 3D stacks in x, y and z (provided you have the necessary licenses).
§ Import FIB stacks.
§ Alignment wizard for 3D Point alignment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 620


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.2 User Interface

1 Image View
Area where you interact with images. Here, for example, you can select images and align
them.
ZEN Connect provides its own 3D viewer. For more information on the user interface of
this 3D viewer, see ZEN Connect 3D View [} 621]. You can use the view tabs on the left
side of the Image View to switch between the two viewers.

2 ZEN Connect Tool


Area where you manage your projects and contained images. For more information, see
ZEN Connect Tool [} 650].

3 Button bar below Image View


Functionalities to pan, zoom, select a region, toggle region captions or view modes, and
select a carrier/holder. For more information, see Button Bar below Image View [} 659].

4 Regions Tool
Displays a list of Regions of Interest which are drawn into a ZEN Connect project. For
more information, see Regions Tool [} 663].

5 View Options
Area for general view options of the Dimensions Tab [} 1029] and specific view options
on the Measurement Tab [} 658] and Alignment Tab [} 656]. The Alignment tab is only
visible when you have entered the mode to align images (see also Activating the Align-
ment Process [} 635]).

6.16.3 ZEN Connect 3D View

The 3D view for ZEN Connect allows you to see and align two 3D volumes from your project. The
viewer and functionality is based on the Tomo3D view, see Tomo3D View [} 545]. For this func-
tionality, you also need the license for the 3D Toolkit.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 621


6 General Toolkits | 6.16 ZEN Connect ZEISS

1 Image Views
Area where you interact with the image views, set the cut lines with the mouse and align
the adjustable image in the 2D views. You can display up to four different views, includ-
ing a 3D and different 2D views. The number of image views can be set in the Ortho
Display tab, the type can be set by the dropdown in the top left corner of each view. For
further information on the functionality, see Tomo3D View [} 545].

2 ZEN Connect Tool


The standard ZEN Connect tool where you manage your projects and contained images,
see ZEN Connect Tool [} 650].

3 View Options
Area for general and the Tomo3D specific view options as well as the dedicated Align-
ment and Connect 3D tabs, see Alignment Tab ZEN Connect 3D [} 622] and Connect
3D Tab [} 623].

See also
2 Opening Images in the ZEN Connect 3D View [} 623]
2 Aligning Images in the ZEN Connect 3D View [} 643]

6.16.3.1 Alignment Tab ZEN Connect 3D

Parameter Description
Mirror

- Mirrors the image horizontally.


Flip Horizon-
tally

- Mirrors the image vertically.


Flip Vertically

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 622


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
Pre-Align In case the two volumes are some distance apart, Pre-Align helps to
bring the volumes in close proximity to each other by centering the
adjustable volume on the fixed reference volume.

Recalculate Recalculates the bounding box around the two volumes. A bounding
box is displayed surrounding both images. After an alignment of the
images, the bounding box can be too large (enclosing empty space)
or too small (not surrounding both images anymore) and can be recal-
culated.

Reset Resets the alignment as it was when you started this alignment opera-
tion.

Apply Applies the alignment to the ZEN Connect project.

6.16.3.2 Connect 3D Tab

Parameter Description
Image Table Displays information for the volumes currently opened in the 3D view.

– # Displays the number of the volume.

– Displays and toggles the visibility of the respective volume.


Visibility

– Name Displays the name of the volume. A checkmark in front of the Name
column indicates that this volume is currently selected for alignment.

Align Volume 1 Starts the alignment mode to align the volume 1.

Align Volume 2 Starts the alignment mode to align the volume 2.

6.16.4 Opening the Correlative Workspace

1. Start the software. For more information, see Starting Software [} 22].
The software opens and ZEN Connect is available.
Note that before working with ZEN Connect, you need to create a ZEN Connect project. For
more information, see Creating a ZEN Connect Project [} 625].

6.16.5 Opening Images in the ZEN Connect 3D View

In the ZEN Connect 3D view you can display two z-stacks as 3D volumes and interact with them.
Note that more than two volumes cannot be displayed in this 3D view.

Prerequisite ü You have opened a ZEN Connect project with at least two z-stacks.
1. In the ZEN Connect tool or the Image View, select one or a maximum of two z-stacks
while pressing Ctrl.
2. Right click one of the selected images in the ZEN Connect tool and select Show in 3D. Al-
ternatively, click and select Show in 3D.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 623


6 General Toolkits | 6.16 ZEN Connect ZEISS

3. If you want to open the volumes directly in 3D alignment mode, go to the ZEN Connect
tool and select Align Two images in 3D for the Alignment button. Note: For the align-
ment mode two volumes need to be selected. The image you selected second is then auto-
matically preset for alignment.
The ZEN Connect 3D view opens and displays the selected z-stacks as 3D volumes. The images
displayed in the 3D view are marked with an icon in the tree view of the ZEN Connect tool.

See also
2 Aligning Images in the ZEN Connect 3D View [} 643]

6.16.6 Non Image Data

In Zen Connect, it is also possible to import non image data into your project, have a visual repre-
sentation (marker) of it in your image area, and align the position of the data marker with respect
to the images in the project. The data is listed under Non-Image Data in the tree of the ZEN

Connect tool and represented by the marker in the image area. Per default, the marker for
this non image data is toggled invisible. To toggle data visible and invisible, see also Moving or
Hiding Images [} 630].

See also
2 Importing Non Image Data [} 633]
2 Aligning Non Image Data [} 644]

6.16.7 Raman Images

If you have licensed ZEN Connect, the software supports the display of images with the specific
Horiba LabSpec HDF5 Raman image format. These supported images basically represent a map
(score map) of intensities of the different channels. This means the higher the concentration of a
detected material, the higher the displayed color saturation. To display the data the image codec
HDF5 is used.

Info
HDF5 is only used as a standard image codec to display this specific type of image (Horiba
LabSpec HDF5 Raman image format) and is not a HDF5 import!

Display of Raman Images


§ The image can be opened just as any other image. In the file explorer, make sure that the file
type is set either to HDF5 (*h5) or to Image files. Then the file(s) with the Horiba LabSpec
HDF5 Raman image format can be selected.
§ The files of this format can only be displayed, but changes to the image cannot be saved. To
save the file after changing parameters (e.g. the image display curve), you have to save the
image in another format like *.czi.
§ To display the image(s) the FLOAT values of the original file are converted or mapped to 16
bit format. Exception: If the values in the file contain constant, NAN or INF values, no con-
version to 16 bit is done.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 624


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.8 Project and Image Management

6.16.8.1 Creating a ZEN Connect Project

Within a ZEN Connect project, in the ZEN Connect tree view, you manage your data in a project
structure tree combined with the viewer. Before acquiring or importing any images, you need to
create the ZEN Connect project. Only within a ZEN Connect project, you can use all ZEN Con-
nect functionality.
You can open only one ZEN Connect project at a time.

Prerequisite ü You have set up the sample on the microscope.


1. In the ZEN Connect tool, click Create.
à The New Document Dialog [} 817] dialog opens.
2. In the New ZEN Connect Project Setup area, select the Project Path where you want to
store the ZEN Connect project file.
3. Select the relevant data to configure the ZEN Connect project. If you select the holder/car-
rier now, you can change it later. Note: If you change the holder/carrier after a S&F calibra-
tion, the S&F calibration needs to be redone.
4. Click on OK.
à The ZEN Connect project is created with the project file name <Projectname>.a5proj.
Note that all new images are saved in the subordinated folder <Projectname_data>.
You can always check the path on the Acquisition tab in the Auto Save tool. Alterna-
tively, right- click on the project container in the Center Screen Area and select Open
Containing Folder.
à In the Image View, the sample holder is displayed.

à In the ZEN Connect tool, the empty ZEN Connect project is displayed. Here, the struc-
ture of the ZEN Connect project will be displayed as soon as you acquire or import im-
ages. In the folder on your computer, the ZEN Connect project file <CWS project
name>.a5proj is generated. A <ZEN Connect project name>.a5lock is gen-
erated to prevent more than one user to work on the project at the same time. It is gen-
erated any time you load a ZEN Connect project.
à At the bottom of the Image View, a scale bar with size, the width of the field of view
(FOV), and scaling is displayed.
à You have created a ZEN Connect project.
5. Acquire an image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 625


6 General Toolkits | 6.16 ZEN Connect ZEISS

à In the Project View, a new session node is created, and each acquisition is displayed.

à In the Image View, all images are displayed. They are signed with a colored frame (blue:
normal image, red: selected image).
6. When you close the project or the software, you are prompted to save the project file.
For information on setting up holders and carriers, see Selecting and Clearing Carrier/Holder
[} 647].
For information on the ZEN Connect tool, see ZEN Connect Tool [} 650].

6.16.8.2 Loading a ZEN Connect Project

You can load any of your ZEN Connect projects to continue with your work. You can also load
existing ZEISS Atlas 5 projects.

Info
Open first the ZEN Connect project before performing a S&F calibration.

Prerequisite ü You have created a ZEN Connect project, or a ZEISS Atlas 5 project is available. ZEISS Atlas 5
projects belong to the ZEISS ATLAS 5 software. ZEN Connect supports these formats.
1. Select File > Open, navigate to the ZEN Connect project and open it.
In the ZEN Connect Project View, the current state of the Connect project is displayed. In the
Image View, the sample holders are marked, and previously acquired images are displayed. The
current stage position is marked with a cross hair. If you want to acquire additional images to the
project, align the new session with the existing data.

See also
2 Opening or Deleting a ZEN Connect Project from ZEN Data Storage [} 273]

6.16.8.3 Adding an Image to the ZEN Connect Project

You can import simple images, such as camera images or more complex images, such as a light
microscope image with overlays, into your ZEN Connect project.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 626


6 General Toolkits | 6.16 ZEN Connect ZEISS

You can use an imported image as a backdrop to navigate the region. You can correlate imported
images with sample holder marks, e.g., fiducials or other images through the alignment process.
The imported image is displayed according to its position in the Layers View along with any
other image in the project.
The metadata of .CZI-images are read natively and are also imported.

Prerequisite ü You have loaded a ZEN Connect project.


1. In the ZEN Connect tool in the on Project View , right-click a session and select Add im-
age. Alternatively, for the Import button, select Add image. If you want to add an image
from ZEN Data Storage (without downloading it), right click in the Imported Data and se-
lect Add image from storage.
à You are prompted to select the image you want to add.
2. If you want to import the image as a background image (at the lowest level of the project
structure), activate the Background Image checkbox.
3. You also have the option to copy the image in a subfolder of the file where the project data
is stored before adding it to your project. Activate Copy files.
4. Click on Open.
The image is imported to your ZEN Connect project.
In the Project View, it is displayed in the tree, subordinated to Imported Data.
If Shuttle & Find-calibration is available for the image and the image is at least in one session in
the ZEN Connect project, the image is placed in the Image View according to the Shuttle & Find
stage position. Take care that you select the correct sample holder when importing an S&F-cali-
brated image. The correct sample holder is the same sample holder that was used during acquisi-
tion.
If no Shuttle & Find data is available, the image is displayed centrally in the FOV of theImage
View.
To add an open image to a project, see Adding an Open Image to the ZEN Connect Project
[} 627], and to add a dataset, see Adding Datasets when Adding Images [} 628].
Additionally, you have the following options to import data in your ZEN Connect project:

§ Importing Data [} 631]


§ Importing Third-party Images [} 631]
§ Importing a SmartFIB Stack into ZEN Connect [} 632]
§ Saving an Image to ZEN Data Storage [} 270]
§ Importing Non Image Data [} 633]
Note: If you import an Airyscan image, ZEN Connect displays only the raw data and not the cal-
culated Airyscan. Such images should be processed before you add them to ZEN Connect. If you
want to add an unprocessed Airyscan image, a warning will appear asking if you want to con-
tinue.
Note for z-stacks: When you use the Global Z slider and are beyond the range of a certain im-
age, only a frame for this image is displayed to show where the image is positioned.

6.16.8.4 Adding an Open Image to the ZEN Connect Project

Prerequisite ü You have loaded a ZEN Connect project.


ü You have an open image (which is not part of the project).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 627


6 General Toolkits | 6.16 ZEN Connect ZEISS

1. Click on File > Add to ZEN Connect Project.


Alternatively, you can use the button in the tool bar which is available if you customize
your application by clicking on Tools > Customize Application... > File > and double
click Add to ZEN Connect Project. This button is automatically available in the tool bar
for all users of the EM Processing Toolbox module.
The image is added to your ZEN Connect project.
Additionally, you have the following options to import data in your ZEN Connect project:

§ Importing Data [} 631]


§ Importing Third-party Images [} 631]
§ Importing a SmartFIB Stack into ZEN Connect [} 632]
§ Saving an Image to ZEN Data Storage [} 270]
Note: If you import an Airyscan image, ZEN Connect displays only the raw data and not the cal-
culated Airyscan. Such images should be processed before you add them to ZEN Connect. If you
want to add an unprocessed Airyscan image, a warning will appear asking if you want to con-
tinue.
Note for z-stacks: When you use the Global Z slider and are beyond the range of a certain im-
age, only a frame for this image is displayed to show where the image is positioned.

See also
2 Adding an Image to the ZEN Connect Project [} 626]

6.16.8.5 Adding Datasets when Adding Images

Optionally, you can add datasets to organize your imported data.

Prerequisite ü A ZEN Connect project is loaded.


1. In the Project View tree, select right-click Imported Data and select Add dataset. Alter-
natively, in the ZEN Connect tool, select Add dataset for the Import button.
2. Navigate to the image you want to add. Select it, and click Open.
The image is included in your ZEN Connect project, located below New dataset.

6.16.8.6 Zooming Images

You can zoom images in and out of a field of view (FOV).

Zooming to

Prerequisite ü A ZEN Connect project is loaded.


1. In the Project tree View, right-click an image and select Zoom to. Alternatively, click on
the Context menu button and select Zoom to.
The image is centered in the view space of the Image View.

Zooming to 100%

Prerequisite ü A ZEN Connect project is loaded.


1. In the Project tree View, right-click an image and select Zoom to 100%. Alternatively,
click on the Context menu button and select Zoom to 100%.
The image is zoomed in the view space of the Image View to 100%.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 628


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.8.7 Removing Images from the ZEN Connect Project

You can remove images from your ZEN Connect project. Images you acquired and added to the
project, you can also delete permanently from the disk.

Prerequisite ü You have loaded a ZEN Connect project.


1. In the Project view or in the Layer view, select the images to remove.
2. Right-click the image, and select Remove data. Alternatively, click on the Context menu
button and select Remove data. If you want to remove an acquired image, you are asked
if you also want to delete it from the disk.
The images are removed from the ZEN Connect project. If you remove all images from the
folder, the folder is removed as well. Removing data cannot be undone.

See also
2 ZEN Connect Tool [} 650]

6.16.8.8 Renaming Images in a ZEN Connect Project

Prerequisite ü You have loaded a ZEN Connect project.


1. In the Project view or in the Layer view, select an image to rename.
2. Right-click, select Rename data and rename the image, or press the F2 key. Alternatively,
you can double click the image name to rename it, or click on the Context menu button
, and select Rename data.
You have renamed the image. It is updated either in the Layer or the Projectview respectively.
The image name is not changed on the disk.

6.16.8.9 Opening Images in ZEN

Prerequisite ü You have loaded a ZEN Connect project.


1. In the Project View or in the Layers View, select one or more images you want to open,
and right-click Open image(s) in ZEN. Alternatively, click on the Context menu button
and select Open image(s) in ZEN. Additionally, you can also simply double click on
an image in the Project View or in the Layers View.
The image is opened in ZEN and displayed on a separate tab.

Info
ZEN Data Storage
If you have opened a project from ZEN Data Storage, you can also open an individual image
this way. The image is then downloaded and each change is not updated in the viewer and
the project until you upload the image again. For information on uploading an image to the
data storage, see Saving an Image to ZEN Data Storage [} 270].

6.16.8.10 Showing an Image in the Explorer

You can locate an image on your computer.

Prerequisite ü You have loaded a ZEN Connect project.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 629


6 General Toolkits | 6.16 ZEN Connect ZEISS

1. In the Project View or in the Layers View, right-click an image and select Show in Ex-
plorer. Alternatively, click on the Context menu button and select Show in Ex-
plorer.
The explorer opens and the folder with the selected image is displayed.

6.16.8.11 Moving or Hiding Images

In the Layers View, you can move images over and under other images, or hide them com-
pletely. In the Project View, you can hide images.

Prerequisite ü You have loaded a ZEN Connect project with at least two images.
1. To change the image order, in the Layers View, move the image by dragging it up or
down.
à In the Image View, the changed order is immediately visible.
2. To hide the image from the ZEN Connect project, in the Layers View, activate or deacti-

vate the image by clicking the Eye icon on the right of the image name. Alterna-
tively, in the Project View, right-click Show/Hide or click on the Context menu button
and select Show/Hide.
The results of your changes are displayed immediately in the Image View.

See also
2 ZEN Connect Tool [} 650]

6.16.8.12 Starting a New Session

To organize your work, you can start a new session within your ZEN Connect project any time.

Prerequisite ü You have loaded a ZEN Connect project.

1. In the ZEN Connect tool, click on the Context menu button and select New ses-
sion.
Alternatively, click on the New Session button.
A new session is activated. As soon as you acquire a new image, a new session node is created,
and the new image will be subordinated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 630


6 General Toolkits | 6.16 ZEN Connect ZEISS

See also
2 ZEN Connect Tool [} 650]

6.16.8.13 Toggling View Modes

In ZEN Connect you can switch between two different view modes for your projects. The default
is the carrier/ holder view mode, where the coordinate system of the correlative workspace is
aligned with the screen and images of the current system/ session might be rotated. The second is
the stage centric view mode, where the coordinate system of the current session is aligned with
the screen and the carrier/ sample holder as well as other sessions might be rotated.

Prerequisite ü You have opened a ZEN Connect project.


1. In the button bar below the Image View of the correlative workspace, click on the button

for the carrier/ holder or the stage centric view mode.


The view is changed according to the selected view mode.

6.16.8.14 Closing a ZEN Connect Project

You have the following options to close a ZEN Connect project:

1. Click on File > Close


2. In the Image View, click on the cross next to the ZEN Connect project name.

6.16.9 Import and Export

6.16.9.1 Importing Data

You can import simple images, such as camera images or more complex images, such as a light
microscope image with overlays, to your ZEN Connect project. For more information, see
Adding an Image to the ZEN Connect Project [} 626].
Alternatively, you have the option to import BioFormats into your ZEN Connect project. For more
information, see Importing Third-party Images [} 631].
Note: If you import an Airyscan image, ZEN Connect displays only the raw data and not the cal-
culated Airyscan. Such images should be processed before you add them to ZEN Connect. If you
want to add an unprocessed Airyscan image, a warning will appear asking if you want to con-
tinue.

See also
2 ZEN Connect Tool [} 650]

6.16.9.2 Importing Third-party Images

ZEN uses BioFormats as an integrated library for reading and writing life sciences image file for-
mats. It is capable of parsing both pixels and metadata for a large number of formats. It achieves
this by converting proprietary microscopy data into an open standard called the OME data model.
With BioFormats, you can read proprietary formats and convert them into an intermediate format,
e.g., CZI or OME-TIFF. For example, it is possible to load simple images you can import simple im-
ages, such as camera images or more complex images, such as a light microscope image with
overlays, to your ZEN Connect project.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 631


6 General Toolkits | 6.16 ZEN Connect ZEISS

Prerequisite ü You have licensed the Third Party Import.


1. Select File > Export/Import > BioFormats Import.
2. Navigate to the image with the proprietary image format you want to import, select it, and
click Open.
The image is converted and added to ZEN (not to the ZEN Connect project itself).
Alternatively, you have the following options to import data in your ZEN Connect project:

§ Adding an Image to the ZEN Connect Project [} 626].


§ Importing Data [} 631]
For more information on BioFormats, see http://www.openmicroscopy.org/bio-formats/

6.16.9.3 Importing a SmartFIB Stack into ZEN Connect

With ZEN Connect you can import SmartFIB stacks of crossbeam microscopes and align them with
data from light microscopes. The orientation of these stacks slightly differs from standard z-stack
acquisition, as the acquired images are tilted by a certain angle compared to a usual z-stack. The
import calculates this tilt from the metadata of the image. If the import finds no metadata con-
cerning the tilt angle and the user does not enter a value, it uses a default of 90 degrees. Alterna-
tively, you can enter the angle of your sample during import, if you know it, and the import then
calculates the tilt angle based on this sample angle.
During import, the XY offset metadata of the individual slices is ignored by default and only the
offset of the first tiff file is considered. This default avoids the creation of a slanted z-stack in case
some slices contain incorrect metadata. Activate the checkbox consider individual slice offsets
on the import dialog to change the behavior.

Prerequisite ü You have opened/created a ZEN Connect project.


1. In the Project view, select the session where you want to import the FIB stack.
2. Right click on the session and select Import SmartFIB z-stack.
Alternatively, select Import SmartFIB z-stack for the Import button.
à A file browser opens.
3. Select the images you want to import as FIB stack.
Note: Select only images which belong to one dataset!
Note: To make sure the stack is composed/ ordered correctly, watch out how the images
are sorted in the explorer and in which order you choose them.
4. You can enter a name for the FIB stack. This step is optional.
5. If you import images without scaling information, you can manually enter them as op-
tional Z-stack XY scaling.
Note: ZEN currently cannot determine automatically if scaling information are present!
6. You can set the slice distance. This step is optional and should only be done if you have
reason to believe the information calculated with the metadata is incorrect. Leave the input
field empty and the slice distance is automatically calculated with information saved in the
metadata of the images.
Note: When you set the slice distance manually, the information in the metadata is ig-
nored.
7. If you know the angle of your sample, enter it under optional sample angle. Otherwise
the tilt for the image is calculated with the metadata or set to the default of 90 degree (if
no information is available in the metadata).
8. If you want to consider the XY offset metadata of the individual slices for the import, acti-
vate the checkbox consider individual slice offsets. Note that this can lead to a slanted
z-stack if the metadata contain incorrect offset information!

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 632


6 General Toolkits | 6.16 ZEN Connect ZEISS

9. Click on Open.
The FIB stack is now imported into the selected session.
Note: When importing larger image files it may take a while until the entire stack is visible in the
viewer. This also applies when you open a project that contains such larger stacks.
Note: To improve the alignment of the z-stack, the TrakEM2 format is supported. Before import-
ing the SmartFIB z-stack, use a specific fiji script (for information, see https://imagej.net/Regis-
ter_Virtual_Stack_Slices#API_documentation) that creates xml-files with TrakEM2 format within
the transferred input folder. Those xml-files are then considered during the import and replace the
stage-position information with the computed pixel delta x/y shifts. Only the stage-position of the
first image is used for absolute positioning, all other images of the stack are positioned according
to this first slice and the computed shifts.

6.16.9.4 Importing Non Image Data

Prerequisite ü You have opened/created a ZEN Connect project.


1. In the ZEN Connect tool, select Import non-image data for the Import button.
à A file browser opens.
2. In the file browser, select your file. If the file should be copied into the data folder of the
project, make sure the checkbox Copy Files is activated (it is activated by default). If the file
should only be linked into the project, deactivate the checkbox.
3. Click on Open.
You have successfully imported the non-image data into your ZEN Connect project. The file is
listed under Non-Image Data in the tree of the ZEN Connect tool.

See also
2 Non Image Data [} 624]

6.16.9.5 Exporting Single Image Data

You can export data of ZEN Connect projects as a single image for distribution to collaborators,
or for the use in publications. The content can be a single image, tiles, a collection of images, or a
view of the entire ZEN Connect project. You can drag or resize the region to control the area
that you want to export, or activate if image names and frames are shown on the exported image
or not. You can pan and zoom using the mouse in the Image View to get fine control of the ex-
port area.

Prerequisite ü You have loaded a ZEN Connect project.


ü In the loaded ZEN Connect project, you have activated and deactivated the respective areas
of interest.
1. In the ZEN Connect tool, open the Project View or the Layers View. Right-click an im-
age and select Single Image Export.
Alternatively, select an image and select Single Image Export for the Export button.

à A wizard opens.
2. Make your settings and click Export Data.
3. Navigate to the folder where you want to store the exported image. The default file name
is the ZEN Connect project name. Click Save.
You have exported one image in a standard image format. The exported image is based on the
export area you set up in the Image View.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 633


6 General Toolkits | 6.16 ZEN Connect ZEISS

See also
2 ZEN Connect Single Image Export Wizard [} 659]
2 ZEN Connect Tool [} 650]

6.16.9.6 Exporting a Zen Connect Project as a Video

You can export data of ZEN Connect projects as a video.

Prerequisite ü You have loaded a ZEN Connect project.


ü In the loaded ZEN Connect project, you have activated and deactivated the respective areas
of interest.
1. In the ZEN Connect tool, open the Project View or the Layers View. Right-click an im-
age and select Video Export.
Alternatively, select an image and select Video Export for the Export button.

à The wizard for video export opens.


2. Choose your key frames by positioning the export area in the Image View and add them
to the list of key frames by clicking Add current view as key frame.
3. Make your settings, and click Export Data.
4. Navigate to the folder where you want to store the exported video. The default file name is
the ZEN Connect project name. Click on Save.
You have exported a video in a standard video format.

See also
2 ZEN Connect Tool [} 650]
2 Video Export Wizard [} 661]

6.16.9.7 Exporting Data for SerialEM

ZEN offers the functionality to export image data as an MRC file which makes it compatible to the
software application SerialEM and available for TEM users. This export is available for z-stacks and
multi-channel images with all the common pixel types (8/16 Bit, 32 Bit Float, RGB 24/32/48). Tiles,
time series, multi-scene images, and images with unprocessed data or special dimensions are not
supported. For images with more dimensions, you can use the image processing function Create
Image Subset [} 108] to extract a single image or stack and then export it with this function.
The export creates a MRC file as well as a NAV file, which contains regions of interests (e.g.
points, rectangles, polygons,...). The NAV file can be loaded in the SerialEM software and it then
loads the MRC file, so that the image with the respective regions is shown.

Prerequisite ü You have opened an image in ZEN.


1. Click on File > Export/Import > MRC Export.
à A file explorer opens.
2. In the file explorer, select a folder to save the file.
3. Name the file and click on Save.
You have exported the image data as an MRC (and NAV) file.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 634


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.10 Alignment

In a ZEN Connect project, you can manually align images in your workspace to correct their posi-
tion or size with respect to the samples. To do so, you activate the alignment process and start
aligning image data. Within a ZEN Connect project, you can also calibrate your system using a
sample holder with fiducial markers by moving between the markers and confirming their posi-
tions.

6.16.10.1 Activating the Alignment Process

The alignment process lets you align your current session with fiducial marks or previous images.
You can align image data manually.
You should create a new session any time the alignment of the sample in the microscope has
been disturbed.

Prerequisite ü A ZEN Connect project is loaded.


1. In the Layer View, or in the Project View, select the image you want to align. Alterna-
tively, you can select a region to select a couple of images.
à The image is marked with a square in each frame corner.

à As long as the alignment process is not activated, this is indicated with a little lock next
to the cursor.
2. Right-click the selected image and select Align Data.
Alternatively, right-click the image(s) in the ZEN Connect tool and select Align Data. You
can also select Align for the Alignment button and click it.
You have activated the alignment process for one or more images. The Alignment Tab [} 656]
below the Image View is displayed.
You can start aligning image data. If you start an alignment on a session node, the set alignment
is used for all current and future images of the session. You can use this if you change your sam-
ple between different systems and want to align their coordinate systems to each other.

See also
2 ZEN Connect Tool [} 650]

6.16.10.2 Aligning Image Data

In the alignment process, you have various options to align image data. Note that you can change
the alignment mode during the alignment process. The alignment edits you have made are pre-
served, but you have to restart the pinning process if you have inserted any pins before changing
the mode.
Note: The alignment process can be executed multiple times. Each time you run the alignment
process, the end result of the last alignment is used as the starting point for the new alignment. If
the initial image was far out of alignment at the start, it is easiest to do the alignment process
once roughly, and then do the alignment process a second time with more precision. The second
alignment will use the first alignment as a starting point, and will allow you to establish a more
precise alignment quickly.

Prerequisite ü You have loaded a ZEN Connect project and activated the alignment process.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 635


6 General Toolkits | 6.16 ZEN Connect ZEISS

1. In the Alignment tab, select one of the following alignment modes and the region you
want to align.

Translate Only
1. Click and drag with the mouse to translate the image you are aligning with respect to ev-
erything else.
à You can zoom in and out with the mouse wheel, or press and hold the CTRL key to pan
while you are in the process of aligning the image.

Translate and Rotate Only


1. Right-click at the location you have lined up to insert the first pin, a red and grey pin icon.
The pin locks the image to the reference at this location. Press the DEL key to remove the
last pin you inserted.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 636


6 General Toolkits | 6.16 ZEN Connect ZEISS

à After you insert the first pin, your input will rotate the item around the first pin, when
dragging it with the mouse.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 637


6 General Toolkits | 6.16 ZEN Connect ZEISS

Translate, Rotate and Scale Only


1. If one of the images is smaller than the other, you can scale it. Right-click to insert a pin,
and drag with the mouse to scale and rotate the image.

Translate, Rotate, Scale and Shear


1. Right-click to insert a second pin, and drag with the mouse to shear the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 638


6 General Toolkits | 6.16 ZEN Connect ZEISS

à After you insert the second pin, your input will also stretch and shear the item.

Image data from microscopes should not need to be stretched or sheared to perform alignment.
If you need to provide much input after inserting the second pin, this might be an indication of
other problems, such as equipment calibration issues.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 639


6 General Toolkits | 6.16 ZEN Connect ZEISS

Alignment Handles
1. If you select Alignment Handles, you can use handles to rotate, translate, and scale the
image.

Flipping the image horizontally and vertically


You can flip your image, to mirror it.

§ To flip the image horizontally, click on the Flip Horizontally button .


§ To flip the image vertically, click on the Flip Vertically button .
§ To flip the image stack in z direction, click on the Flip in Z button .

Reset alignment
1. Click on the Reset button to reset the alignment you performed.
à The alignment is reverted as it was when you started aligning. The alignment mode is still
activated.

Cancel alignment
1. Click on the Cancel button to reset the alignment you performed.
à The current alignment is cancelled and reverted to the alignment in place before you
started the alignment mode. The alignment mode is not activated any longer.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 640


6 General Toolkits | 6.16 ZEN Connect ZEISS

Finish alignment
1. Click on the Finish button to finish the alignment mode and to save the alignment informa-
tion.

Clear alignment
1. Click on the Clear button.
à The session is restored to its un-aligned state.

See also
2 Aligning Images in Z Direction [} 641]
2 Rotating a Z-Stack [} 643]
2 Alignment Tab [} 656]

6.16.10.3 Aligning Images in Z Direction

In ZEN Connect you can not only align your images/ sessions in x and y direction, but also in z.

Prerequisite ü You have opened a ZEN Connect project containing images/ z-stacks with z information.
1. Select the image or session you want to shift in z direction.
2. In the ZEN Connect tool, select Align for the Alignment button and click it. Alternatively,
right click on the image and select Align Data.
à The Alignment Tab [} 656] is displayed below the Image View.
3. For Alignment Mode select 3D Alignment in the dropdown list.
4. For Relative Z Offset set the value for your shift in z direction.
5. Click on Finish.
You have now aligned your data in z direction. For an illustration of the alignment see Example
for Z Alignment [} 642].
Note that for the z alignment the view of the aligned stack remains the same, whereas the view
of the other stacks changes.

Setting an image to the current Global Z


You can also set the center of a z-stack to the currently selected z-position of the Global-Z slider.

Prerequisite ü You have opened a ZEN Connect project containing images/ z-stacks with z information.
1. Activate the Global-Z slider and move to the z-position where you want your image to be
placed.
2. Select the image you want to shift in z direction.
3. In the ZEN Connect tool, select Align for the Alignment button and click it. Alternatively,
right click on the image and select Align Data.
à The Alignment Tab [} 656] is displayed below the Image View.
4. For Alignment Mode select 3D Alignment in the dropdown list.
5. On the Alignment tab, click on the Set to current Global-Z button.
6. Click on Finish.
You have now set the center of your z-stack to the currently selected Global-Z.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 641


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.10.3.1 Example for Z Alignment

This chapter serves as an illustration of how and what is happening for z alignment in ZEN Con-
nect. Consider the following situation:

This image illustrates two z-stacks with five planes and different z coordinates (with µm as unit).
The green line simulates the position of the Global-Z slider. Here, the Correlative Workspace
would show you plane 1 of the first stack and an empty frame where the second stack would be
because the Global-Z is beyond the range of the second stack.

Aligning Stack 2 in z direction


Now the second stack is aligned according to the workflow described in Aligning Images in Z Di-
rection [} 641] with a Relative Z Offset of 3µm. The result then is the following:

All z planes of Stack 2 are shifted by 3µm and now the z-plane 1 of Stack 1 and z-plane 3 of Stack
2 would be visible in the Correlative Workspace.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 642


6 General Toolkits | 6.16 ZEN Connect ZEISS

Aligning the whole session in z direction


Now the whole session with both images is shifted with a Relative Z Offset of 4µm.

Now the first stack is out of range of the Global-Z slider, so the Correlative Workspace would
show you plane 1 of Stack 2 and an empty frame where Stack 1 is located.

6.16.10.4 Rotating a Z-Stack

In the alignment mode you can also perform a three dimensional rotation of a z-stack.

Prerequisite ü You have opened a ZEN Connect project.


1. Select the z-stack you want to rotate.
2. In the ZEN Connect tool, click on Align. Alternatively, right-click the image and select
Align Data.
à The Alignment Tab [} 656] below the Image View is displayed.
3. For Alignment Mode, select 3D Alignment.
4. Activate the checkbox Apply 3D Rotation.
à The Manipulation Controls for rotation are activated.
5. Use the respective sliders or input fields to rotate the z-stack around the x, y, or z axis. Al-
ternatively, you can use the View Cube Control to rotate the stack interactively.
6. Click on Finish.
You have now rotated the selected z-stack around the respective axis.

6.16.10.5 Aligning Images in the ZEN Connect 3D View

With the ZEN Connect 3D view you can display and align two z-stacks as 3D volumes. This align-
ment mode allows a translation of the volumes in x, y and z.

Prerequisite ü You have opened two z-stack images in the ZEN Connect 3D view or directly in 3D alignment
mode, see Opening Images in the ZEN Connect 3D View [} 623].
1. In the Connect 3D tab, click the button for the volume you want to align, e.g. Align Vol-
ume 1. If you opened the 3D view directly in alignment mode, one volume is already se-
lected for alignment.
à You are in alignment mode and the Alignment tab is displayed.
2. To mirror the selected image, go to the Alignment tab and click to mirror the image
horizontally, or click to mirror it vertically.
3. In one of the 2D image views, shift the volume via drag and drop and align it with the sec-
ond volume as reference.
à The changes are automatically updated in all views, including the 3D view.
4. If you are satisfied with your alignment, go to the Alignment tab and click Apply.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 643


6 General Toolkits | 6.16 ZEN Connect ZEISS

à Your alignment changes are saved in the ZEN Connect project.

6.16.10.6 Aligning Non Image Data

Prerequisite ü You have opened a ZEN Connect project with non-image data.
ü Your non image data is toggled visible, see also Moving or Hiding Images [} 630].
1. In the ZEN Connect tool or in the image view, right-click the non-image data and select
Align Point Position. Alternatively, in the ZEN Connect tool, select the non-image data
and select Align for the Alignment button and click it.
à You enter the alignment mode.
2. In the image area, click at the position where you want to place the none-image data.
3. Click on Finish.
You have aligned your non image data.

See also
2 Non Image Data [} 624]

6.16.10.7 Aligning Images in the Manual Alignment Wizard

Prerequisite ü You have opened a ZEN Connect project.


1. In the correlative workspace or in the ZEN Connect tool, select the image(s) you want to
align.
2. In the ZEN Connect tool, for the Alignment button, select Manual Alignment Wizard
and click on it.
à The ZEN Connect Alignment Wizard [} 664] opens.
3. To translate the selected image(s), set the distance in x and y direction with the Translate
parameter section on the left.
à The translation is immediately displayed in the Image View.
4. To scale the image, set the scaling factor in x and y in the Scale section.
à The scaling is adjusted according to the input.
5. To rotate the image, first select the Rotation Center and then enter an Angle. The current
rotation center is represented in the image by a pin.
à The selected image(s) is/are rotated.
6. To flip/mirror the image horizontally, click on .
7. To flip/mirror the image vertically, click on .
8. If you want to shear your image, activate Enable.
à Additional shearing pins are displayed in the image. The two pins that form the "base-
line" for shearing a connected by a line.
9. Use the two pins to position the baseline and then move the pinpoint to shear the image.
10. Click on Finish to save the alignment and close the wizard.
You have aligned the selected image(s) in the ZEN Connect project.

Info
Alignment Handles
You can also use the alignment manages of the selected image(s) to translate, scale, and ro-
tate the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 644


6 General Toolkits | 6.16 ZEN Connect ZEISS

Info
View Options
You can use the available options of the Dimensions tab [} 1029] to adjust the image view
(e.g. use the Global-Z slider). The image which is adjusted by the Dimensions tab can be se-
lected in the tree view of the Select Node For Dimensions tab.

6.16.10.8 Aligning Images in the Point Alignment Wizard

Prerequisite ü You have opened a ZEN Connect project.


1. In the correlative workspace or in the ZEN Connect tool, select the image(s) you want to
align.
2. In the ZEN Connect tool, for the Alignment button, select Point Alignment Wizard and
click on it.
à The ZEN Connect Point Alignment Wizard [} 665] opens.

3. In the list on the left, use the button to add as many points as necessary for your
point alignment.
With one point only a translation operation is possible, with two translation and rotation,
and three or more points enable all transformations.
4. In the Algorithm dropdown list, select the alignment operations you want to perform.
5. Click on Draw for the first point.
à You enter the drawing mode for the first point.
6. In the Image Window on the left, click to set the point in your image(s) (Subject point).
7. In the Project Window on the right, click to set the corresponding location for this point
in the project (Reference point).
à Both color makers in the table are green and the first point for the alignment is set suc-
cessfully.
8. Repeat these three steps for every point you add/need.
9. If you want to redraw a point pair, click on Redraw and click to set the new positions in
both windows.
10. Click on Next.
à The second step of the wizard opens. It displays a preview of the final alignment result
and values for the parameter changes.
11. If you want to change the alignment, click on Back to get back to the previous step. Other-
wise, click on Finish to save the alignment and close the wizard.
You have aligned the selected image(s) in the ZEN Connect project.

6.16.10.9 Aligning Images in the 3D Point Alignment Wizard

Prerequisite ü You have opened a ZEN Connect project.


1. In the correlative workspace or in the ZEN Connect tool, select the image(s) you want to
align.
2. In the ZEN Connect tool, for the Alignment button, select Point Alignment 3D Wizard
and click on it.
à The ZEN Connect 3D Point Alignment Wizard [} 668] opens.
3. In the left image window (Tomo3D view), select the 2D image view you want to use from
the dropdown as points for alignment can only be set in the 2D views.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 645


6 General Toolkits | 6.16 ZEN Connect ZEISS

4. In the list on the left, click to add as many points as necessary for your point align-
ment.
With one point only a translation operation is possible, with two translation and rotation,
and four or more points enable all transformations.
5. In the Algorithm dropdown list, select the alignment operations you want to perform.
6. Click Draw for the first point.
à You enter the drawing mode for the first point.
7. In the Image Window on the left, click to set the point in your image(s) (Subject point).
8. In the Project Window on the right, click to set the corresponding location for this point
in the project (Reference point).
à Both color makers in the table are green and the first point for the alignment is set suc-
cessfully.
9. Repeat these steps for every point you add/need.
10. If necessary, use the controls in the Dimensions tabs, e.g. to switch to a different z-slice to
set the points on specific z-levels.
11. If necessary, change the left image view via the dropdown to add or check points in other
2D image dimensions.
à The view changes to the selected 2D image dimensions.
12. If you want to redraw a point pair, click Redraw and click to set the new positions in both
windows.
13. Click Next.
à The second step of the wizard opens. It displays a preview of the final alignment result
and values for the parameter changes.
14. If you want to change the alignment, click Back to get back to the previous step. Other-
wise, click Finish to save the alignment and close the wizard.
You have aligned the selected image(s) in the ZEN Connect project.

6.16.11 Handling of Images and Data

6.16.11.1 Zooming to Extent

Prerequisite ü You have loaded a ZEN Connect project.

1. In the button bar below the Image View, click the Zoom to Extent icon.
Alternatively, click on the Context menu button and select Zoom to extent.
In the Image View, the sample holder is centered. All images in the ZEN Connect project are
displayed.

See also
2 ZEN Connect Tool [} 650]

6.16.11.2 Panning & Zooming

1. In the button bar below the Image View, click the Pan & Zoom icon.
à With your mouse you can pan and zoom in and out in the Image View.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 646


6 General Toolkits | 6.16 ZEN Connect ZEISS

Shortcut for panning


1. Press the mouse wheel and move the image. Alternatively, press the Alt key and left click
the image.
You can use panning without having to click the Pan & Zoom icon.

See also
2 Button Bar below Image View [} 659]

6.16.11.3 Selecting Region

You select a region to later apply the Alignment Mode to the image contained in this region.

Prerequisite ü You have loaded a ZEN Connect project.


1. In the button bar below the Image View, click the Select Region icon. Alternatively, press
the CTR key, and click the desired image in the Project View.
à The image in the selected region is activated.

In the ZEN Connect tool, both in the Project view and in the Layers view, the image within the
selected region is highlighted.

6.16.11.4 Toggling the Display of Region Caption and Frame

For a better overview, you can toggle the display of the image name and of the frame of images
in the Image view of your ZEN Connect project .

Prerequisite ü You have loaded a ZEN Connect project.


1. To toggle the region caption, in the button bar below the Image View, click the A button.
The region caption of the images is displayed or hidden.

6.16.11.5 Selecting and Clearing Carrier/Holder

The sample is usually mounted on a carrier or directly on a sample holder. Select the appropriate
sample holder for your configuration when you configure your project.
We offer specific sample holders and carriers with certain markers, e.g., "L"-markers or others.
These CorrMic sample holders are necessary for a Shuttle & Find workflow. Note: If you change
the holder/carrier after a S&F calibration, the S&F calibration needs to be redone.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 647


6 General Toolkits | 6.16 ZEN Connect ZEISS

Prerequisite ü You have loaded a ZEN Connect project.


1. In the button bar below the Image View, click the Select Carrier/Holder button.
2. Select a template you want to add to your ZEN Connect project, and click OK.

à The frame of the selected template is displayed in the Image View of your ZEN Con-
nect project.
3. To deselect the carrier/holder, click the Select Carrier/Holder drop down list and select
Clear/Carrier Holder.
For information on correlative sample holders, see Correlative Sample Holders [} 695].

See also
2 Select Template Dialog [} 656]

6.16.11.6 Grabbing an Image

You can create an image from the loaded ZEN Connect project.

Prerequisite ü You have loaded a ZEN Connect project.


1. In the button bar below the Image View, select the Grab Image button.
à A new tab opens. In the Image View, the grabbed image is displayed.
2. Right-click and save the image to your computer.
You have saved the image. It is not part of your ZEN Connect project.

6.16.11.7 Using Regions of Interest in Zen Connect

ZEN Connect offers the functionality to draw and delete regions of interest (ROI) in a project. The
regions are shown in the project and listed in the Regions Tool [} 663] and they are saved and
loaded together with the project.

6.16.11.7.1 Drawing a Region of Interest in ZEN Connect

Prerequisite ü You have loaded a ZEN Connect project.

1. In the button bar below the Image View, click on the button.
2. Draw a rectangular region into your project.
The Region of Interest is displayed in your project.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 648


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.11.7.2 Deleting a Region of Interest in ZEN Connect

Prerequisite ü You have loaded a ZEN Connect project with regions of interest.

1. In the Regions tool, select your region in the list and click on the button.
Alternatively, right-click on your region of interest and select Delete.
The selected region is deleted.

6.16.11.7.3 Renaming a Region of Interest in ZEN Connect

Prerequisite ü You have loaded a ZEN Connect project with regions of interest.

1. In the Regions tool, select your region in the list and click on the button.
2. Enter a name for the selected region and press Enter.
The region is renamed according to your input.

6.16.11.7.4 Zooming to a Region of Interest in ZEN Connect

Prerequisite ü You have loaded a ZEN Connect project with regions of interest.
1. In the Image View or the list of the Regions tool, right-click on the region of interest and
select Zoom To.
The view zooms to the selected region.

6.16.11.7.5 Moving the Stage to a Region of Interest in ZEN Connect

Prerequisite ü You have loaded a ZEN Connect project with regions of interest.
1. In the Regions tool, double click on an entry of a region. Alternatively, select an entry and
click , or right click the entry and select Move to.
The stage moves to the center of the respective region.

6.16.11.8 Adding Measurements to a ZEN Connect Project

Prerequisite ü You have opened a ZEN Connect project.


1. In the Measurement Tab [} 658], click on the button for the respective measurement tool.
2. In the image view, click to set the points for the measurement. For a distance measure-
ment, set two points, for an angle three and for an area measurement create a polygon
that covers the desired area.
3. In case of area measurements, the last click has to be at the first point to "close" the poly-
gon. Alternatively, click with the right mouse button to finish the polygonal area.
à The respective measurement is displayed in the view as well as the table of the Measure-
ment tab.
You have added a measurement to your ZEN Connect project.

See also
2 Editing Measurements in a ZEN Connect Project [} 650]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 649


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.11.9 Editing Measurements in a ZEN Connect Project

Prerequisite ü You have opened a ZEN Connect project and added a measurement, see Adding Measure-
ments to a ZEN Connect Project [} 649].
1. In the button bar below the Image View, click .
à You are now in edit mode.
2. To resize measurements, click on the end points of a measurement to drag and drop them.
In case of an area measurement, you cannot rescale the contour.
à The measurement values are updated instantly.
3. To move a measurement, drag and drop the respective measurement in the Image View.
4. To change the Name of a measurement, double click on the current name.
à The name in the field is editable.
5. Enter the desired name and press Enter.
à The measurement is renamed.
6. To change the color of the measurement itself or the text showing the measured value, in
the Measurements tab, click the color field for Line or Text respectively.
à A color selection window opens.
7. Select the desired new color from the list, or click Custom to select a customized color.
à The color of the measurement or the text is updated instantly.

8. To toggle the visibility, click for the respective entry in the list.
à The measurement is toggled (in-)visible.

9. To delete a measurement, select the measurement in the list and click .


à The measurement is deleted.

See also
2 Measurement Tab [} 658]

6.16.12 ZEN Connect Tool

The ZEN Connect tool provides a layer's view and a project view of image data that you have ac-
quired for the ZEN Connect project. Every image that you have acquired for the ZEN Connect
project is listed. As you acquire or import more image data, the new image data is listed in the
views.
The ZEN Connect tool offers different options to open a ZEN Connect project or to create a
new ZEN Connect project.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 650


6 General Toolkits | 6.16 ZEN Connect ZEISS

Alternatively, you can create a new ZEN Connect project via File > New Document. For more
information, see New Document Dialog [} 817].
The ZEN Connect tool displays the following:

§ Images that have been acquired for the ZEN Connect project.
§ Images that have been imported to the ZEN Connect project.
§ Position of the image in the project or the layers.
§ Non image data added to the ZEN Connect project.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 651


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.12.1 ZEN Connect Project view

1
2
3

Fig. 31: Tree view: ZEN Connect project (Example)

1 Sample holder
Here: Custom Carrier 1

2 Imported Data
Subordinated, the data added to the ZEN Connect project is displayed. These images
are not acquired within the Connect project.

3 On top, the session node is displayed. It contains the following information. Subordi-
nated, the acquired images are listed.
Here: LM (Microscope)
Here: 20190326 (Date <yyyymmdd>)
Here: 125358 (Time <hhmmss>)
Here: New-01-02 (Image taken in this session)

4 Image Information
Displays the objective magnification with which an image was acquired (here: 40x). Ad-
ditionally, the icon is displayed for a z-stack image.

5 Z-Stacks which are opened in the ZEN Connect 3D view [} 621] are displayed with an-
other icon in the tree view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 652


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.12.2 ZEN Connect Project Layer view

Images in your ZEN Connect project are displayed in the Image View according to its position in
the Layers View. With drag & drop, you can move images over and under other images. You can
also hide them completely . For more information, see Moving or Hiding Images [} 630].
Additionally, you can see the objective magnification with which the image was acquired and if
an image is a z-stack .

6.16.12.3 Button Bar

Parameter Description
Opacity Changes the opacity of layers. The overall opacity determines to what
degree it obscures or reveals the layer beneath it. A layer with 1%
opacity appears nearly transparent, whereas one with 100% opacity
appears completely opaque.

Alignment Only available if you have selected one or more images or a session.
Starts the selected alignment operation for the currently selected im-
age(s) or session. Click on the arrow button to select an alignment.

– Align Activates the alignment process for the selected data, see Activating
the Alignment Process [} 635].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 653


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
– Align system Activates the alignment process for the current microscope session,
see Activating the Alignment Process [} 635].

– Manual Align- Opens the wizard for manual alignment, see Aligning Images in the
ment Wizard Manual Alignment Wizard [} 644].

– Point Align- Opens the wizard for point alignment, see Aligning Images in the
ment Wizard Point Alignment Wizard [} 645].

– Point Align- Opens the wizard for 3D point alignment, see Aligning Images in the
ment 3D Wiz- 3D Point Alignment Wizard [} 645].
ard

– Align Two Im- Opens the selected images directly in alignment mode in the ZEN
ages in 3D Connect 3D view, see also Aligning Images in the ZEN Connect 3D
View [} 643].

Import Starts the currently selected operation to add and/or import an image.
Click on the arrow button to select an import operation, see also Im-
porting Data [} 631].

– Add image Opens the file browser to add an image, see Adding an Image to the
ZEN Connect Project [} 626].

– Add image Opens the Stored Documents dialog to add an image from the ZEN
from storage Data Storage, see Adding an Image to the ZEN Connect Project
[} 626].

– Import non- Opens the file browser to select non-image data for an import, see
image data Importing Non Image Data [} 633].

– Import Smart- Opens the file browser to import a SmartFIB z-stack, see Importing a
FIB z-stack SmartFIB Stack into ZEN Connect [} 632].

– Add dataset Opens the file browser to add a dataset, see Adding Datasets when
Adding Images [} 628].

Export Starts the currently selected operation to export an image. Click on


the arrow button to select an export operation.

– Single Image Opens the wizard to export the selected data in one single image, see
Export Exporting Single Image Data [} 633].

– Video Export Opens the wizard to export the selected data as a video, see Export-
ing a Zen Connect Project as a Video [} 634].

– Export Project Opens a file browser to export your current ZEN Connect project, see
Exporting a ZEN Connect Project from ZEN Data Storage [} 271].

New Session Creates a new session, see Starting a New Session [} 630].

Context menu

– Zoom to Zooms one or more selected images into the center of the Image
View, see Zooming Images [} 628].

– Zoom to Zooms to the selected image in the Image View and displays it at
100% 100% scale, see Zooming Images [} 628].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 654


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
– Show/Hide Toggles the visibility of an image or a session, see Moving or Hiding
Images [} 630].

– Open image(s) Opens the selected image(s) in ZEN, see Opening Images in ZEN
in ZEN [} 629].

– Open Attach- Only available for non-image data.


ment Opens the attached file in the respective application.

– Show in Ex- Locates an image or file on your computer, see Showing an Image in
plorer the Explorer [} 629].

– Remove Data Removes the selected image from the ZEN Connect project, but does
not delete it from the computer, see Removing Images from the ZEN
Connect Project [} 629].

– Delete Only visible for non-image data.


Deletes the file from the project and from the project folder. If the file
was added as a link, only the link in the project is deleted.

– Rename Data Renames an image, see Renaming Images in a ZEN Connect Project
[} 629].

– Align Data Activates the alignment process for the selected data, see Activating
the Alignment Process [} 635].

– Single Image Opens the wizard to export the selected data in one single image, see
Export Exporting Single Image Data [} 633].

– Video Export Opens the wizard to export the selected data as a video, see Export-
ing a Zen Connect Project as a Video [} 634].

– Add image Opens the file browser to add an image, see Adding an Image to the
ZEN Connect Project [} 626].

– Add image Opens the Stored Documents dialog to add an image from ZEN
from storage Data Storage, see Adding an Image to the ZEN Connect Project
[} 626].

– Import Smart- Opens the file browser to import a SmartFIB z-stack, see Importing a
FIB z-stack SmartFIB Stack into ZEN Connect [} 632].

– Show in 3D Only available if one or two z-stack images are selected in the tree
view.
Opens the images in the ZEN Connect 3D view, see Opening Images
in the ZEN Connect 3D View [} 623].

– New Session Starts a new session. The images acquired next will be subordinated
below a new session node, see Starting a New Session [} 630].

– Clear align- Resets the alignment and places the selected image at its initial posi-
ment tion.

– Zoom to ex- Resets the view space of the Image View to be centered on the
tent holder with a field of view (FOV) that includes all visible images in the
project, see Zooming to Extent [} 646].

– Export Project Opens a file browser to export your current ZEN Connect project, see
Exporting a ZEN Connect Project from ZEN Data Storage [} 271].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 655


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
– Import non- Opens the file browser to select non-image data for an import, see
image data Importing Non Image Data [} 633].

See also
2 Aligning Image Data [} 635]

6.16.13 Select Template Dialog

In the Select Template Dialog, you select carriers and holders.

Parameter Description
Celldiscoverer Only available for celldiscoverer application.
Shows a list of celldiscoverer sample holders.

Tiles Shows a list of all generic sample holders.

Correlative Shows a list with all relevant correlative sample holders.

See also
2 Selecting and Clearing Carrier/Holder [} 647]

6.16.14 Alignment Tab

The alignment tab is visible as soon as you enter the alignment mode. For more information, see
Activating the Alignment Process [} 635].
You can perform Three-Point Alignment:

§ Line-up an imported image with reference marks, such as the precision fiducials on a CorrMic
Holder.
§ Line-up features in an imported image with LM, EM and SEM images of the same features.
§ Line-up a session of LM, EM and SEM imagery with previously acquired LM, EM and SEM im-
agery session.
With the three-point alignment process you can set the position, rotation, and scale of an image
or tile. This is used to line the image or tile up with reference marks or other images. Once an im-
age is lined up, it can be used as a reference (road map) to move the stage to control further im-
age acquisition.

Parameter Description
Alignment Mode Sets which data properties you can change during the alignment.

- Translate Only Moves the item you are aligning in x and y only without changing its
size or orientation.

- Translate and Moves the item in x and y direction and changes its orientation. It
Rotate Only does not change the scale of the item you are aligning.

- Translate, Ro- Moves, reorients, and resizes the item you are aligning. It does not
tate and Scale shear it.
Only

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 656


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
- Translate, Ro- Supports full three-point alignment.
tate, Scale
and Shear

- Alignment Displays alignment handles to rotate and resize the image.


Handles

- 3D Alignment Displays options to align an image in z direction and for three dimen-
sional rotation.

Mirrors the image horizontally.


Flip Horizontally

Mirrors the image vertically.


Flip Vertically

Mirrors the image stack in z direction around the middle z-height.


Flip in Z

Relative Z Offset Only visible if 3D Alignment is selected.


Sets the z offset for the selected image.

Step Size Only visible if 3D Alignment is selected.


Sets the step size for the Relative Z Offset input.

Set to current Only visible, if 3D Alignment is selected and only active if the
Global-Z Global-Z slider is activated on the Dimensions tab.
Sets the z value of the currently selected Global-Z as the z value for
the center of the z-stack.

Apply 3D Rotation Only visible, if 3D Alignment is selected.


Enables the controls below for the three dimensional rotation of the
z-stack.

- Rotation X- Sets the rotation along the x-axis with the slider or input field. Click
Axis on the button to reset the angle.

- Rotation Y- Sets the rotation along the y-axis with the slider or input field. Click
Axis on the button to reset the angle.

- Rotation Z- Sets the rotation along the z-axis with the slider or input field. Click
Axis on the button to reset the angle.

- Angle Step Sets the angle step size for the slider/input fields above.
Size

- View Cube With this cube control, you can rotate the stack interactively. It has a
Control visual representation of the current stack (white box) and the cutting
plane which is displayed in the 2D view above.

- Presets Sets the View Cube Control to a predefined position. You can set it
to the Default, or you can select an orientation from the dropdown
of the button to show the Default, Viewer Perspective, Left, or
Right orientation.

- Manual Con- Controls the orientation of the View Cube Control.


trol

Reset Resets the alignment as it was when you started this alignment opera-
tion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 657


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
Clear Resets the alignment to where it was when the data was first ac-
quired or imported.

Finish Exits from the alignment operation, keeping the alignment you have
established.

Cancel Returns to the alignment as it was when you started, and exits from
the alignment operation.

See also
2 Aligning Image Data [} 635]
2 Aligning Images in Z Direction [} 641]
2 Rotating a Z-Stack [} 643]

6.16.15 Measurement Tab

Parameter Description
Measurement
Tools

– Allows the user to add two points to measure a distance.


Distance

– Allows the user to add three points to measure an angle.


Angle

– Allows the user to draw a polygon contour to measure an area.


Area

– Allows the user to draw a circle to measure a diameter.


Circle

Measurement ta-
ble

– Value Displays the measured value.

– Type Displays the icon of the measurement type.

– Toggles the visibility of each measurement.


Visibility

– Name Displays the name of each measurement.

– Line Displays the color of the measurement. A click on the color field
opens a selection window to change the color.

– Text Displays the color of the measurement text. A click on the color field
opens a selection window to change the color.

– Deletes the currently selected measurement.


Delete

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 658


6 General Toolkits | 6.16 ZEN Connect ZEISS

See also
2 Adding Measurements to a ZEN Connect Project [} 649]
2 Editing Measurements in a ZEN Connect Project [} 650]

6.16.16 Button Bar below Image View

Parameter Description
Resets the view space of the Image View to be centered on the holder
with a field of view (FOV) that includes all visible images in the
Zoom To Extent project. For more information, see Zooming to Extent [} 646].

Activates the mouse for panning around and zooming in and out in
the Image View. For more information, see Panning & Zooming
Pan & Zoom [} 646].

Selects an image/ a region in the Image View. For more information,


Select Region see Selecting Region [} 647].

Activates a mode to interact with measurements added to the project.


Interact with Mea- For more information, see Editing Measurements in a ZEN Connect
surement Project [} 650].

Creates a Region of Interest in the Image View. For more information,


see Using Regions of Interest in Zen Connect [} 648].
Create Region of
Interest

A Hides or displays image names and frames of images in the Image


View. For more information, see Toggling the Display of Region
Caption and Frame [} 647].

Select Carrier/ Opens a dialog to select a carrier or sample holder that matches. For
Holder more information, see Selecting and Clearing Carrier/Holder [} 647].

Activates a stage centric view mode where the coordinate system of


the current session is aligned with the screen and the carrier/sample
Stage Centric View holder as well as other sessions might be rotated. For more informa-
Mode tion, see Toggling View Modes [} 631].

Activates the carrier/holder view mode where the coordinate system


of the correlative workspace is aligned with the screen and images of
Carrier/Holder the current session might be rotated. For more information, see Tog-
View Mode gling View Modes [} 631].

Grab Image Creates an image of the ZEN Connect project. For more information,
see Grabbing an Image [} 648].

6.16.17 ZEN Connect Single Image Export Wizard

With the ZEN Connect Single Image Export wizard, you configure the parameters of the image
you want to export.

Parameter Description
Color Style Controls the color format of the export. Select RGB (color) or Inten-
sity (black and white).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 659


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
- RGB Color Based on the RGB (Red-Green-Blue) color model. Be aware that color
files may be up to three times as large as intensity files.

- Intensity Images are saved in 8-bit format.

Export Format Selects the format for the exported file. Only the file formats that sup-
port the number of pixels you are exporting will be shown. If your ex-
port is too large, formats like BMP, JPG and TIFF are not displayed. If
you wish to export to one of these formats, you must pick a larger
pixel size, or smaller export area for your export.

- Raw Image Exports the image as a raw binary dump of the pixel values. An XML
file is also written detailing the image width and height in pixels, the
pixel size in microns, the bits per sample and samples per pixel. Raw
files are not limited in size.

- CZI Image Exports the image as a Carl Zeiss Image file. CZI files are not limited in
(Single Chan- size. The images are exported in a single channel CZI.
nel)

- CZI Image Exports the image as a Carl Zeiss Image file. CZI files are not limited in
(Multi-Chan- size. The images are exported as a multi-channel CZI.
nel)
Note that the resulting image might look different when reopened in
ZEN than it does in ZEN Connect.

- Tif Image Exports the image as a standard TIFF file. TIFF files are limited in size.

- Tif Tiles With this option, the export is in TIFF format, but broken into 2K x 2K
tiles saved as individual TIFFs. An XML file is written listing the file
names of the tiles and their positions. This export option is unlimited
in size, but designed for someone who is writing scripts to import the
data into image processing applications or similar.

- Bitmap Image Exports the image as a standard Windows Bitmap. Bitmap files are
limited in size.

- Jpg Image Exports the image as a standard JPEG file. JPEG files are limited in size.

Burn-in Data Bar Activated: Burns the currently configured data bar into the exported
image.

Show Region Cap- Controls if image names and frames are shown in the exported im-
tion age.

JpgXr Compression Activated: Uses the (lossy) JpgXr compression of the image during
Quality export and sets the quality for the compressed image with the input
field.

Rotation Rotates the view to the desired orientation. Drag the slider, or in the
text field, type in the value.

Pixel Size Sets the pixel size of the export. The smaller the pixel size, the more
disk space your export will take. The options Low, Medium and High
only have an effect, if several images are exported as a single image.

- Smallest Sets pixel size of the coarsest image, i.e. the smallest pixel size.

- Medium Calculates and sets the pixel size to the log average of finest and
coarsest image (i.e. 10^(0.5*(log(fine)+log(coarse)).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 660


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
- Largest Sets pixel size of the finest image, i.e. the largest pixel size.

- Custom Sets a custom pixel size which can be entered in the input field.

Width (px) Sets the width to directly alter the export pixel count and export area
(the pixel size is unchanged).

Height (px) Sets the height to directly alter the export pixel count and export area
(the pixel size is unchanged).

Width (µm) Displays the full width of the export area in µm.

Height (µm) Displays the full height of the export area in µm.

Approx. Data Size Displays an approximation for the data size of the exported image.
The actual file size after export may be less, depending on compres-
sion of some file formats.

Export Data Opens a file browser to export the image with your settings.

Finish Saves the changes and closes the wizard.

Cancel Closes the wizard without saving the changes.

For more information on exporting single images, see Exporting Single Image Data [} 633].

6.16.18 Field of View Width Dialog

Parameter Description
FOV Width Displays the current width of the field of view and allows you to enter
a value.

OK Sets the width to the entered value.

Cancel Closes the dialog box without setting the field of view.

6.16.19 Pixel Size Dialog

Parameter Description
Pixel Size Displays the current pixel size and allows you to enter a value.

OK Sets the pixel size to the entered value.

Cancel Closes the dialog box without setting the pixel size.

6.16.20 Video Export Wizard

Parameter Description
Burn in Data Bar Burns the currently configured data bar into the exported video.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 661


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
Show Region Cap- Controls if the image names are shown in the exported video.
tion

Show Region Out- Controls if the image frames are shown in the exported video.
line

Export Resolution Sets the resolution and format for the video export.
Resolutions available in the drop down list:
§ 320 x 240 (4:3)
§ 428 x 240 (16:9)
§ 640 x 480 (4:3) (=default value)
§ 854 x 480 (16:9)
§ 960 x 720 (4:3)
§ 1280 x 720 (16:9)
§ 1440 x 1080 (4:3)
§ 1920 x 1080 (16:9)

Zoom to Extent Places the image to the center of the preview area.

Rotation You can use the slider or the input field to rotate the view.

Start Delay Sets the delay at the start of the video. The default setting is 1,0 sec-
onds.

Key Frames Lists the key frames, including the data of the position and FOV.

Moves the selected key frame up in the list.


Move Up

Moves the selected key frame down in the list.


Move Down

Deletes the selected key frame.


Delete key
frame

Displays the selected key frame.


Go to key
frame

Reset key Sets the values of the selected key frame to the current view.
frame to current
view

Options

– Load Export Loads stored key frames.


Key Frames

– Save Export Saves the key frames in XML format.


Key Frames

Transit To Sets the transition time for zooming to a selected key frame. The de-
fault setting is 3,5 seconds.

Pause At Sets the time to stay at the selected key frame. Default setting is 0,5
seconds.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 662


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
Return to first at Returns to the first key frame at the end of the video.
end

Add current view Adds the current view as a key frame.


as key frame

Preview export Displays a real-time preview of the video.

Export Data Exports and saves the video.

Finish Saves the changes and closes the wizard.

Cancel Cancels the video export.

See also
2 Exporting a Zen Connect Project as a Video [} 634]

6.16.21 Regions Tool

This tool displays a list of regions of interest (ROI) which are drawn into a ZEN Connect project.

Parameter Description
ROI List Here you see a list of all ROI in your ZEN Connect project.
A double click on an entry moves the stage to the center of the re-
spective ROI.

Deletes the currently selected region of interest.


Delete

Allows you to rename the currently selected region of interest.


Rename

Moves the stage to the center of the currently selected region.


Move to

See also
2 Using Regions of Interest in Zen Connect [} 648]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 663


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.22 ZEN Connect Manual Alignment Wizard

1 2

1 Alignment Parameter
Control parameters to align the respective image in the project. For more information,
see Alignment Parameter Section [} 664].

2 Image View
Displays the images of the project and allows alignment of images.

3 View Options
Here you have the general options of the Dimensions tab [} 1029]. The options are al-
ways those of the image selected in the Select Node For Dimensions tab.

See also
2 Aligning Images in the Manual Alignment Wizard [} 644]

6.16.22.1 Alignment Parameter Section

Parameter Description
Translate

– Step Size Sets the step size for the translation in x and y.

– X-Direction Sets the translation in x direction. The reset button resets the
value to the default.

– Y-Direction Sets the translation in y direction. The reset button resets the
value to the default.

Scale

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 664


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
– X-Direction Sets the scaling factor in x direction. The reset button resets the
value to the default.

– Y-Direction Sets the scaling factor in y direction. The reset button resets the
value to the default.

Rotate

– Rotation Cen- Defines the rotation center around which the image is rotated. It is in-
ter dicated in the Image View with a pin.

– Angle Sets the rotation angle. The reset button resets the value to the
default.

– Custom You can set the pin in the image to your custom rotation center.

Flip/Mirror

– Mirrors the image in horizontal direction.


Horizontally

– Mirrors the image in the vertical direction.


Vertically

Shear

– Enable Activated: Activates the shearing mode and displays the three shear-
ing pins in the image.

– Reset Shear- Resets the pins to the default location.


ing Pins

Reset All Parame- Resets all alignment parameters in the wizard to the default values.
ters

Parameter Description
Finish Saves the changes and closes the wizard.

Cancel Closes the wizard without saving.

See also
2 Aligning Images in the Manual Alignment Wizard [} 644]

6.16.23 ZEN Connect Point Alignment Wizard

This wizard guides you through a three-point alignment of the image in your ZEN Connect
project.

See also
2 Aligning Images in the Point Alignment Wizard [} 645]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 665


6 General Toolkits | 6.16 ZEN Connect ZEISS

6.16.23.1 Step 1: Setup Points

1 2 3

1 Point Alignment Options


Options to configure your point alignment. For more information, see Point Alignment
Options [} 666].

2 Image Window
Displays the image(s) you are aligning. Area where you set the subject points.

3 Project Window
Displays all the images of the project except the one you are aligning. Area where you set
the reference points.

See also
2 Aligning Images in the Point Alignment Wizard [} 645]

6.16.23.1.1 Point Alignment Options

Parameter Description
Point list

– Name Displays the name of the point.

– Subject Displays the status of the subject point with a color.


§ Yellow: You are in drawing mode and have not yet set the subject
point in the Image Window.
§ Green: You have set the subject point.

– Reference Displays the status of the reference point with a color.


§ Red: You have not yet set the subject point and cannot set the ref-
erence point.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 666


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
§ Yellow: You are in drawing mode and have not yet set the refer-
ence point in the Project Window.
§ Green: You have set the reference point.

– Draw Only visible if no points have been drawn for the current point entry.
Enters the drawing mode for the respective point.

– Cancel Only visible if you are in drawing mode.


Cancels the drawing of points for the current point.

– Redraw Only visible if you have already drawn the reference and subject point
for this entry.
Reenters the drawing mode to redraw the points for this entry.

– Adds another point entry in the list.


Add

– Deletes the currently selected list entry and removes all drawn points
of the entry.
Delete

Algorithm Selects the algorithm for alignment. The algorithm is preselected


based on the number of positioned points.

– Autoselect Automatically selects the algorithm suitable for the drawn points.

– Translation Moves the item you are aligning in x and y only, without changing its
size or orientation.

– Translation Moves the item in x and y direction and changes its orientation. It
and Rotation does not change the scale of the item you are aligning.

– Translation Moves and resizes the item you are aligning.


and Scale

– Allow all Supports all possible transformations.


transforma-
tions

Parameter Description
Next Moves on to the next step of the wizard.

Finish Saves the changes and closes the wizard.

Cancel Closes the wizard without saving.

See also
2 Aligning Images in the Point Alignment Wizard [} 645]

6.16.23.2 Step 2: Preview

This step displays a preview of the finished alignment and the parameter values of each align-
ment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 667


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
Algorithm Result Displays the resulting alignment changes.

Translation Displays the resulting translation in X-Direction and Y-Direction.

Rotation Displays the resulting rotation angle around the z-axis.

Scaling Displays the resulting scaling factor for the X-Dimension and Y-Di-
mension.

Back Moves to the previous step of the wizard.

Finish Saves the changes and closes the wizard.

Cancel Closes the wizard without saving.

6.16.24 ZEN Connect 3D Point Alignment Wizard

This wizard guides you through a 3D point alignment of the image in your ZEN Connect project.

See also
2 Aligning Images in the 3D Point Alignment Wizard [} 645]

6.16.24.1 Step 1: Setup Points

1 2 3

1 Point Alignment Options


Options to configure your point alignment. For more information, see 3D Point Align-
ment Options [} 669].

2 Image Window (Tomo3D)


Displays the image(s) you are aligning with a special implementation of the Tomo3D
View [} 545]. With the dropdown in the upper left corner, you can switch to a different
2D view pane as well as display a 3D view. You set the subject points in this view. Note
that setting points is only possible in the 2D views.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 668


6 General Toolkits | 6.16 ZEN Connect ZEISS

3 Project Window
Displays all the images of the project except the one you are aligning. Area where you set
the reference points.

4 View Options
Displays some general view options of the Dimensions Tab [} 1029] for the respective
windows.

6.16.24.1.1 3D Point Alignment Options

Parameter Description
Point list

– Name Displays the name of the point.

– Subject Displays the status of the subject point with a color.


§ Yellow: You are in drawing mode and have not yet set the subject
point in the Image Window.
§ Green: You have set the subject point.

– Reference Displays the status of the reference point with a color.


§ Red: You have not yet set the subject point and cannot set the ref-
erence point.
§ Yellow: You are in drawing mode and have not yet set the refer-
ence point in the Project Window.
§ Green: You have set the reference point.

– Draw Only visible if no points have been drawn for the current point entry.
Enters the drawing mode for the respective point.

– Cancel Only visible if you are in drawing mode.


Cancels the drawing of points for the current point.

– Redraw Only visible if you have already drawn the reference and subject point
for this entry.
Reenters the drawing mode to redraw the points for this entry.

– Adds another point entry in the list.


Add

– Deletes the currently selected list entry and removes all drawn points
of the entry.
Delete

Algorithm Selects the algorithm for alignment. The algorithm is preselected


based on the number of positioned points.

– Autoselect Automatically selects the algorithm suitable for the drawn points.

– Translation Moves the item you are aligning in x and y only, without changing its
size or orientation.

– Translation Moves the item in x and y direction and changes its 2D orientation. It
and 2D Rota- does not change the scale of the item you are aligning.
tion

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 669


6 General Toolkits | 6.16 ZEN Connect ZEISS

Parameter Description
– Translation Moves and resizes the item you are aligning.
and 2D Scal-
ing

– 3D Rotation Moves and rotates the item in three dimensions. It does not change
and Transla- the scale of the item you are aligning.
tion

– Allow all Supports all possible transformations.


transforma-
tions

6.16.24.2 Step 2: Preview

This step displays a preview of the finished alignment and the parameter values of each align-
ment.

Parameter Description
Algorithm Result Displays the resulting alignment changes.

Translation Displays the resulting translation in X-Direction, Y-Direction and Z-


Direction.

Rotation Displays the resulting rotation angle around the x-, y- and z-axis.

Scaling Displays the resulting scaling factor for the X-Dimension, Y-Dimen-
sion and Z-Dimension.

Back Moves to the previous step of the wizard.

Finish Saves the changes and closes the wizard.

Cancel Closes the wizard without saving.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 670


6 General Toolkits | 6.17 Shuttle & Find ZEISS

6.17 Shuttle & Find

Fig. 32: SEM/LM system for correlative microscopy


This functionality enables you to locate sample positions in two different microscopes, e.g. a light
microscope and a scanning electron microscope (SEM). Afterwards you can correlate the two im-
ages to one merged image. This technique is called correlative microscopy or just "CorrMic". It is
used to combine the two worlds of scanning electron microscopy and light microscopy and brings
it together in one image. To use the functionality, you need a license for the Connect Toolkit.
The samples can be mounted in special designed correlative holder systems (with three correlative
calibration markers) from ZEISS. Also user-defined holder systems with three calibration markers
can be used. Biological samples are mainly deposited on cover glasses or on TEM grids. In contrast
to biological samples, the shape and size of material samples vary strongly. In respect to these re-
quirements, the correlative holders were designed accordingly.

Fig. 33: Example of a correlative ZEISS sample holder

6.17.1 Settings and Image Acquisition with the Light Microscope

Before acquiring an image with the light microscope and using it for correlative microscopy, it is
necessary to make general settings e.g. stage calibration, camera orientation, calibrating objec-
tives and setting the correct scaling. Please notice that we do not describe all these topics within
this guide as we focus on the Shuttle & Find workflow only.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 671


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Furthermore we will not describe basic functionality of the software in this guide, like program
layout or general image acquisition topics.

See also
2 Shuttle & Find Sample Positions at the Electron Microscope [} 678]

6.17.1.1 Mounting the Sample Holder to the LM

Fig. 34: Mounting of cover glasses or TEM grids


1. Place the cover glass (2) in the suitable sample holder and fix it.
In case of using the holder Life Science Cover Glass 22x22:
– Remove the clamping frame (1) using tweezers.
– Insert the cover glass (2) in the sample holder (3).
– Slide in the clamping frame into the sample holder until the clamps are clicking into place
(4).
In case of using the holder Life Science for TEM grids:
– Lift the spring of the appropriate position and turn it sidewards (5).
– Insert the TEM grid (6) into the provided holding spot of the holder and fix it with the spring
(7).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 672


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Fig. 35: Inserting a sample holder


2. Insert the sample holder (1) into the mounting frame of the microscope stage in the following
way:
– For inverted stands, see (3).
– For upright stands, see (2).

6.17.1.2 Starting the LM Software

For correlative microscopy with light microscopes ZEN software has to be installed. In addition
you need to licence the Shuttle & Find modul.

1. To start the software double click on the ZEN program icon on your desktop.
à The software starts now.
à Check that Shuttle & Find is activated under Tools > Modules Manager ....
2. In the Left Tool Area switch to the Acquisition tab and activate Shuttle & Find.
3. Open the Shuttle & Find tool.
You have successfully started the software. Now you can start working with the Shuttle & Find
module.

6.17.1.3 Selecting the Sample Holder

Prerequisite ü You have activated Shuttle & Find in the Experiment Manager.
ü You are in the Shuttle & Find tool.
1. Click on the Select… button to open the Select Template dialog and to choose the cor-
relative holder you want to use. Different types of correlative holders are available, see Ap-
pendix Correlative Sample Holders

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 673


6 General Toolkits | 6.17 Shuttle & Find ZEISS

2. In the Select Template dialog select the correlative holder you want to work with. If you
want use your own sample holders, click on the Add button below the list and fol-
low the instructions in the chapter Defining a new sample holder template [} 674].

3. Click on the Ok button to close the dialog.


You can now continue with the calibration of the sample holder, like it is shown in the chapter
Calibrating the sample holder [} 675]. The calibration of the sample holder is mandatory to ac-
quire images.

6.17.1.4 Defining a New Sample Holder Template

With this dialog you can define new correlative holders in addition to the existing holder tem-
plates. It is not mandatory to use correlative holders from ZEISS. User-defined correlative holders
with 3 fiducial markers can be used as well.

1. To open the dialog click on Add in the Select Template dialog. This dialog can be
opened via the Shuttle & Find tool.
à The New Template dialog opens.

2. Type in a name for the new holder or sample carrier. An image of the new holder can be
loaded as well.
3. Insert the distances (in millimeters) between the first and the second marker and between
the second and third marker.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 674


6 General Toolkits | 6.17 Shuttle & Find ZEISS

à The distances can be determined using the Stage Control dialog accessible via the Light
Path tool in Right Tool Area tab. We recommend doing this before starting the New
template dialog. Write down the distances to be prepared to enter them within the New
Template dialog.
à Activate the live view in the Center Screen Area by clicking on the Live button in the Lo-
cate tab.
à Navigate the stage manually to the calibration marker on the sample holder by means of
the joystick and note the x/y-coordinates of the marker.
à Repeat this procedure for all three markers and calculate the distances between marker 1
and marker 2 and between marker 2 and marker 3, respectively.

6.17.1.5 Calibrating the Sample Holder

Correlative sample holders have three fiducial markers enabling a three point calibration (signed
with the numbers 1-2-3) The calibration markers consist of one small (length 50 µm) and a large
L-shape marker (length 1 mm). The bigger marker is used for coarse orientation, whereas the
smaller marker is used for the calibration.

6.17.1.5.1 Preparing Calibration

1. Click on Live in the Acquisition tab to activate the live view in the Center Screen Area.
2. Navigate the stage manually to the first calibration marker on the sample holder (marked
with No. 1) by means of the joystick. It is enough if you move the stage to the larger L-
shaped calibration marker. The smaller marker will be detected automatically within the
Sample Holder Calibration Wizard. To locate the marker positions we recommend using
a dry objective with low magnification (5x – 20x).

3. Open the Shuttle & Find tool.


4. Click on Calibrate… to open the Sample Holder Calibration Wizard

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 675


6 General Toolkits | 6.17 Shuttle & Find ZEISS

6.17.1.5.2 Setting Calibration Options

Fig. 36: Sample Holder Calibration Wizard Options


In step 1 of the wizard, the following options should be activated to follow our recommended
workflow:

1. Check if the Automatic movement to next marker checkbox is activated.


à This will automatically move the stage to the next marker position after you have con-
firmed the position of the marker and clicked on Next.
2. Check if the Use automatic marker detection checkbox is activated.
à The software will try to find the correct positions of each marker automatically.
3. If you need to change the marker color, or check if the marker orientation is set correctly,
activate the Use settings for marker detection checkbox to access these functions.
4. Click on Next to move to the next wizard step.

6.17.1.5.3 Performing Calibration

1. Click on Set to detect the first marker position.


à An automatic stage calibration will be performed. After the stage calibration, the system
will try to detect the marker position of the small marker automatically.
à A message appears which asks if the marker was detected correctly.
2. Click on Yes to confirm the message.
3. Click on Next to move to the next step of the wizard.
à The stage will automatically move to the next (coarse) marker position. If the stage
moves into the wrong direction, you can use the invert X/invert Y buttons to correct
the movement direction.
4. Repeat the previous steps and set marker position 2 and 3 accordingly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 676


6 General Toolkits | 6.17 Shuttle & Find ZEISS

à After setting marker position 3 you will find a green check mark icon which shows that
the calibration was successful.

5. Click on Finish to save the calibration and close the wizard.


To check if the calibration was successful acquire an image and open the Tree view in the Center
Screen Area. There you should see the correlative calibration data in the list. If the Tree view is not
visible, go to Tools > Options > Documents and activate the Enable Tree View checkbox.

6.17.1.6 Acquiring the LM Image

Basically image acquisition is performed as you are used to do it within ZEN software. The file for-
mat for Shuttle & Find data is the common *.czi file format. Saved images can be loaded in ZEN
via the menu File > Open.
After image acquisition the next step in the correlative workflow is to define/draw in ROIs/POIs in
your image. Therefore you can use the Region tools on the S&F tab, see Regions, Find and Di-
mensions [} 689].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 677


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Fig. 37: LM image

6.17.2 Shuttle & Find Sample Positions at the Electron Microscope

Now you can transfer (Shuttle) the sample and the LM (Light Microscope) image file (.czi) to the
SEM (Scanning Electron Microscope). There you can easily relocate (Find) the same sample posi-
tions and acquire a corresponding image within the ZEN SEM software. Therefore exactly the
same steps have to be done as for the light microscope.

6.17.2.1 Mounting the Sample Holder to the SEM

For imaging your sample in the SEM, insert the sample holder (2) in the special SEM adapter (1)
and mount it to the SEM.

Info
The arrow of the sample holder has to face the arrow of the SEM adapter.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 678


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Fig. 38: Sample holder mounted in SEM adapter

6.17.2.2 Starting the ZEN SEM Software

For correlative microscopy with scanning electron microscopes SmartSEM and ZEN SEM have to
be installed. SmartSEM is still the control software of the scanning electron microscope. ZEN SEM
comes as an add-on for SmartSEM to perform correlative microscopy and using Shuttle & Find on
a SEM.

Prerequisite ü You have started SmartSEM.


1. Start the ZEN software by clicking on the program icon on your desktop.
à The application selection window appears.
2. Click on the SEM button to start.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 679


6 General Toolkits | 6.17 Shuttle & Find ZEISS

à You will see the program interface with a reduced user interface comparing to the soft-
ware. In the Left Tool Area, the SEM Acquisition tab and the Processing tab are avail-
able only. On the SEM Acquisition tab you will find the Shuttle & Find tool which has 3
additional buttons at the lower part of the tool.

6.17.2.3 Selecting the Sample Holder

This step is exactly the same step like for the light microscope, so please read the chapter Select-
ing the Sample Holder [} 673] if you want to know the exact steps which you have to perform.

6.17.2.4 Calibrating the Sample Holder

Like the step before this step is exactly the same like for the light microscopy, so please refer to
the chapter Calibrating the sample holder [} 675] for details.

Info
4 The calibration of the sample holder has to be done on both systems the LM and the SEM.
Otherwise the relocation of your sample positions or ROIs/POIs stored in the image won`t
be successful.
4 Note that for Shuttle & Find the beam shift must be switched off. The beam shift is deacti-
vated in SmartSEM as follows:
ð Call up the shortcut menu Center Point/Feature by right-clicking on the Stage prop-
erty page.
ð Select Center Point/Feature and select Stage only.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 680


6 General Toolkits | 6.17 Shuttle & Find ZEISS

6.17.2.5 Acquiring an EM Image

1. Load your LM image to ZEN SEM (.czi).


à The image will be displayed in the center screen area.
2. Activate the Live mode.
à You will see the Live image from the SEM. Notice that all settings for the SEM image
have to be done within the SmartSEM software.
3. Activate the S&F View in Center Screen Area.
4. Go to the S&F tab.
5. Check if the Double click in image to move stage and Show splitter view checkboxes
are activated (default setting).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 681


6 General Toolkits | 6.17 Shuttle & Find ZEISS

à In the left image container you see the live image from the SEM. The right image con-
tainer is empty.
6. Drag the loaded LM image from the Images and Documents gallery into the empty image
container.
Now you can easily relocate sample positions by double clicking within the image or on the ROI/
POI button (if ROI/POI are drawn in and selected) on S&F tab.
For image acquisition you have to use the Snap button within ZEN SEM. Notice that we will not
describe setup and image acquisition with the SEM. Please read the online help or user guide for
the SEM software.

Fig. 39: SEM and LM image

6.17.2.6 Fine Calibration of the Sample Holder

The precision of relocation can be improved by determination of an offset value. This value de-
scribes the position offset between the loaded image and the live image. The defined offset value
is only valid for the loaded image. If another image is loaded or if you close the dialogue, the off-
set value will be deleted.

Prerequisite ü An offset is visible when you try to relocate marker positions on the live image comparing to
the LM image.
1. Click on the Set Offset button.
à The stage moves to the selected marker position. Then a message appears which asks
you to move the stage to the correct position.
2. Move the stage manually to the correct position by using the joystick.
3. Confirm the message by clicking on the OK button.
Now you can repeat the relocation. The positions should be identical now.

6.17.3 Correlating Two Loaded Images

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 682


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Prerequisite ü You have acquired and loaded two images containing S&F calibration data (e.g. LM/SEM) to
be correlated. If the images are not oriented identically, you can use the Mirror Image but-
tons under Options on the S&F Correlation tab.
ü You see the two images next to each other (splitter view) in the center screen area. If not,
drag your images from the Images and Documents gallery into the center screen area.
1. Click on the Set correlation points button in the S&F Correlation tab.
à The cursor will change to a pipette symbol.
2. Click in the left image to set a correlation point. Set all 3 marker points in the left image
first, before you set the corresponding 3 markers in the right image. If a correlation point is
set, a check mark icon will appear in front of the corresponding point.
à Make sure that the positions in both images are identical. After you have set all 6 points
the cursor will be changed backwards from the pipette to the arrow.
3. Click on the Create Correlation button.
The correlated image will be generated and opened in a new image container.

Fig. 40: Correlated image

Tips & Tricks


§ It is also possible to set each correlation point individually. Therefore under Left Image/Right
Image click on the Arrow button behind a point (e.g. Point 1). Then click on the desired po-
sition within the image.
§ To improve the accuracy of the identification you can zoom into the images by using the
mouse wheel.
§ To edit/move a point, click on the point you would like to move. When the point is marked
with a dashed rectangle you are able to move the point by holding the left mouse button. Al-
ternatively, below Left Image/Right Image click on the points Arrow button you want to
move and click on a new position within the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 683


6 General Toolkits | 6.17 Shuttle & Find ZEISS

6.17.4 Correlation of Live Image and Loaded Image

Prerequisite ü You have activated the Live mode.


1. Select the S&F view in the Center Screen Area and click on the S&F Correlation tab.
à The splitter view will become visible in the Center Screen Area. In the left image con-
tainer you see the live image.
2. Drag the corresponding LM image from the Documents and Images Gallery into the
Center Screen Area.
3. Click on Set correlation points button to set the correlation points. Always start with set-
ting 3 points in the left (live) image, then continue with setting the identical points (in the
same order) in the loaded image.
4. After setting all 6 correlation points the image correlation will be performed automatically.
The correlated image will be visible in a third image container below the live image and the
loaded image.

6.17.5 Shuttle & Find with an EVO 10

To use Shuttle & Find (SW and correlative holders) with an EVO 10 make sure that the stage limits
(for x, y and z) are set as follows:

Holder Positions
The holder positions must be oriented like shown in the images

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 684


6 General Toolkits | 6.17 Shuttle & Find ZEISS

NOTICE
If you set a wrong orientation the stage cannot be moved to all correlative markers because of
the stage limits for the EVO 10.
4 The holder has to be mounted into the EVO in that the way that the correlative markers
(1) and (2) have to be near the chamber door whereas marker (3) is located furthest from
the chamber door (see Mounting A/B).
4 If necessary, the SEM image can be rotated according to the LM image using the option
Scan Rotate in SmartSEM.

Mounting A: Mounting B:

6.17.6 User Interface

Fig. 41: User Interface

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 685


6 General Toolkits | 6.17 Shuttle & Find ZEISS

1 Shuttle & Find View


Area where the images are displayed. For more information, see Shuttle & Find View
[} 687].

2 Shuttle & Find Tool


Here you choose and calibrate your sample holders. For more information, see Shuttle &
Find Tool [} 686].

3 Shuttle & Find View Options


Here the Shuttle & Find specific view options are available. For more information, see
S&F Tab [} 688] and S&F Correlation Tab [} 691].

See also
2 Sample Holder Calibration Wizard [} 692]

6.17.7 Shuttle & Find Tool

Here you choose and calibrate your sample holders. The tool is visible only if you have activated
the Shuttle & Find checkbox in the Experiment Manager.

Fig. 42: Shuttle & Find Tool

Parameter Description
Sample holder Here you see the name and preview of the selected sample
holder.

Select... Opens the Select Template dialog. There you select the pre-
ferred sample holder or define new holder templates, see Select-
ing the Sample Holder [} 673].

Calibrate... Opens the Sample Holder Calibration Wizard [} 692]. There


you can calibrate the selected sample holder.

Apply to Image Only visible if the Show All mode is activated.


Use this button only when you forgot to calibrate the
holder before you acquire the image.
Applies a calibration to an acquired image. Do not remove the
sample out of the correlative holder between image acquisition
and calibration.

Shuttle & Find tool for SEM


Only visible if you have started the ZEN SEM software.
The tool window is adapted to the requirements of the correlative workflow on a SEM. Therefore
three additional buttons are available.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 686


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Fig. 43: Shuttle & Find tool in ZEN SEM software

Parameter Function
Scale bar Adds a scale bar to the snapped (acquired) image.

Annotation bar Adds an annotation bar to the snapped (acquired) image.

Select... By clicking on this button a dialog opens to select parameters for


the annotation bar. You can select max. 9 parameters for the an-
notation bar.

6.17.8 Shuttle & Find View

Besides the Shuttle & Find tool in the Left Tool Area, the S&F (Shuttle & Find) view is visible
in the Center Screen Area of the ZEN software. If the S&F view is selected, the S&F tab and
S&F Correlation tab will appear as specific view options under the image area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 687


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Fig. 44: Shuttle & Find View

6.17.8.1 S&F Tab

Here you find helpful options and tools to draw in and relocate regions of interests (ROIs) or
points of interest (POIs) within the sample image.

6.17.8.1.1 Options

Parameter Description
Mirror Image Here you can mirror the image horizontally or vertically
by using the two buttons at the right. The alignment of the
images depends on the microscope (upright/inverted) and
orientation of the sample holder.

Keep tool Activated: Keeps the current tool active. That is helpful if
you want to draw in more than one ROI/POI.

Auto color Activated: Uses a new color for each new element which is
drawn in.

Snap to Pixel Activated: Draws in graphical elements using the pixel grid.

Use fine calibration value Activated: Uses the measured fine calibration.
The precision of relocation and therefore the quality of the
overlay image can be improved by determination of an off-
set value. This value describes the offset between the
loaded image and the live image. The defined offset value is

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 688


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Parameter Description
only valid for the loaded image which you can see in the
container. If another image is loaded or if you close the dia-
logue, the offset value will be deleted.
Determine the offset by identification of a POI (Point Of In-
terest) within the snapped image. To identify a POI use the
buttons in the Regions section. By clicking on the Set Off-
set button, the stage moves to the supposed sample posi-
tion. Compare the sample position within the live image
with the set POI and correct the stage in that way that both
shown positions are identically. Confirm the fine calibration
with the OK button. Now the fine calibration is measured
and the checkbox is activated.
More information, see Fine Calibration of the Sample
Holder [} 682].

Double click in image to Activated: Moves the stage to the position you have dou-
move stage ble clicked on.

Refocus after stage move- Activated: Adjusts the focus automatically after the stage
ment has moved.

Move stage in z-direction Activated: Moves the stage to the load position before it
before x/y movement moves to the next correlative calibration marker.

Show splitter view Activated: Activates Splitter Mode in the Center Screen
Area.

6.17.8.1.2 Regions, Find and Dimensions

Fig. 45: Regions, Find, Dimension

Regions and Find tool bar

Parameter Description
Selects the ROIs or POIs in the image area. If you are currently in an-
other mode, you can switch back to the Selection mode using this
Selection mode
button.

Draws in a rectangle (Region of Interest (ROI)) that is always parallel


to the edges of the image.
Draw rectangle

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 689


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Parameter Description
Draws in a marker point (Point of Interest (POI)).
Draw marker

Moves the stage to the center of the opened image.


Center

Moves the stage to the selected ROI/POI.


ROI/POI

Shows the current stage position as a rectangle in the image.


Show stage posi-
tion

Dimension section
Here you see coordinates and dimensions of the selected graphical element in the list. If the
Scaled checkbox is activated, the unit is µm, otherwise Pixel.

§ Parameter X: Shows the horizontal position (x coordinate) of the center of the graphical ele-
ment.
§ Parameter Y: Shows the vertical position (v coordinate) of the center of the graphical element.
§ Parameter W: Shows the width of the graphical element.
§ Parameter H: Shows the height of the graphical element.

Graphical elements list


Here you see the list of all ROI/POI which are drawn in.

Parameter Description
Eye symbol Shows or hides the ROI/POI in the image.

Lock symbol Locks a ROI/POI to prevent changes.

Type Displays the icon for the tool type (ROI/POI). To format a graphic ele-
ment, double-click on the icon. The Format Graphic Elements dia-
log opens.

ID Only visible if the Show All mode is activated.


Displays the ID for the graphic element. To do this, activate the check-
box at the corresponding list entry.

A Only visible if the Show All mode is activated.


Displays annotations for a graphic element (ROI). To do this, activate
the checkbox at the corresponding list entry. Then double click on the
checkbox. The Format Graphic Elements dialog opens. Choose an
annotation you want to have displayed within the image from the
Annotation dropdown list.

M Only visible if the Show All mode is activated.


Displays measurement data for a graphic element. To do this, activate
the checkbox at the corresponding list entry.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 690


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Parameter Description
Name Displays the name of the graphic element. To change the name, dou-
ble-click in the Name field. Then enter the text of your choice.

6.17.8.2 S&F Correlation Tab

Here you find all functions to overlay (correlate) two images.

Fig. 46: S&F Correlation tab

Parameter Description
Transform Here you select which image will be transformed. Choose via the Left
Image/Right Image buttons, which image should be transformed in
the other. During transformation, a pixel in the overlay image is calcu-
lated by using pixels of the two original images that shall be overlaid/
merged.

Interpolation Here you can select one of the following interpolation methods:

- Nearest The gray value of the resulting pixel in the overlay image is made of a
Neighbor pixel which is located next. This interpolation method is very fast.

- Linear The resulting or calculated pixel in the overlay image is assigned to a


gray value, which is the result of a linear combination of gray values
derive from pixels located nearby (in the original image).

- Cubic The calculated pixel in the overlay image is assigned to a gray value,
which is calculated by means of a polynomial function using gray val-
ues of pixels in the original images; these pixels are located nearby the
calculated pixel.

Mirror image Here you can mirror the image horizontally or vertically. Therefore
simply click on the corresponding button.
Mirroring an image is necessary, when the loaded image shows a dif-
ferent orientation than the live image.

Show Correlation Activated: Opens the correlated image in a new image document/
new container.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 691


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Parameter Description
Set correlation Enables you to set 6 points (3 points in each image) as correlation
points markers in a row, see Correlating Two Loaded Images [} 682].

Reset Deletes all correlation points in the images.

Create Correlation Active only if all correlation points are set in both images.
Creates a correlative overlay image. A third image container with the
correlated image will be opened in the Center Screen Area and the
Show Correlation checkbox will be activated automatically.

6.17.9 Sample Holder Calibration Wizard

Fig. 47: Sample Holder Calibration Wizard


With the Sample Holder Calibration Wizard you calibrate your selected correlative sample holder.
The wizard is opened via the Shuttle and Find tool. Make sure that you have activated the Shut-
tle and Find tool and selected a sample holder, see Selecting the Sample Holder [} 673].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 692


6 General Toolkits | 6.17 Shuttle & Find ZEISS

6.17.9.1 Step 1: Options

Fig. 48: Sample Holder Calibration Wizard Options

Option Description
Save marker images Activated: the marker images are saved during the calibration.
The images can be used to check the calibration afterwards. Click
on the Select Folder (...) button to select a storage folder.

Move the stage to load Activated: the stage will move to load position before moving
position before x/y to the next correlative calibration marker.
movement
In case of using an AxioObserver, the objective revolver moves to
load position.

Automatic movement Activated: By clicking on the Next button within the wizard the
to next marker stage moves automatically to the next calibration marker.

Use Autofocus at each This option is active only if the Automatic movement to next
marker position marker position checkbox is activated.
Activated: the focus is adjusted automatically after moving to
the next marker position.

Use automatic marker Activated: The software will try to detect the small calibration
detection marker automatically.

Use settings for marker This option is active only if the Use automatic marker detec-
detection tion checkbox is activated.
Activated: shows settings for marker detection (see description
below). Here you select the properties of the calibration markers.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 693


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Settings for marker detection


Only visible if the Use settings for marker detection checkbox is activated.

Option Description
Threshold marker de- A low threshold for marker detection is used when the dimen-
tection: high – low sions of the correlative L markers cannot be recognized precisely,
e.g. when the sample holder is slightly filthy.

Marker color Here you select the color of the markers displayed in the live im-
age.
White: the marker is displayed white on a dark background.
Black: the marker is displayed dark on light background.
Auto: the marker color is set automatically.

Marker orientation Here you need to set the orientation of the L-markers on your
sample holder. Click on the corresponding button to select the
orientation of the calibration marker which you can see in the
live image

If you click on the Next button you will move to the next step of the wizard.

6.17.9.2 Step 2-4: Calibration

In steps 2-4 of the wizard you will be guided through the calibration procedure.

Fig. 49: Sample Holder Calibration Wizard

Option Function
Holder position Move to Position 1 button
Moves the stage to marker position 1. This is possible only if the
first position was set before and x/y coordinates are given.
Current button
Only visible for marker position 2 and 3.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 694


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Option Function
Moves the stage to the current marker position. This is possible
only if the current position was set before and x/y coordinates
are given.

Stage movement to the Here you can change the movement of the stage in x or y direc-
next marker tion. This is necessary if during calibration the stage moves in the
wrong direction.

Marker position By clicking on the Set button, the actual marker position will be
confirmed.

6.17.10 Correlative Sample Holders

Name Image
Life Science cover glass
22 x 22

Life Science Cryo Holder

Life Science for TEM Grids

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 695


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Name Image
Cover glass with fiducials
22 x 22

MAT Flat Stubs A

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 696


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Name Image
MAT Flat Stubs

MAT Universal A

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 697


6 General Toolkits | 6.17 Shuttle & Find ZEISS

Name Image
MAT Universal B_A

MAT Universal B_B

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 698


7 Application Toolkits | 7.1 Bio Apps ZEISS

7 Application Toolkits
Toolkit Included Functionality
Bio Apps § Bio App Cell Counting [} 699]
§ Bio App Confluency [} 699]
§ Bio App Gene and Protein Expression [} 699]
§ Bio App Automated Spot Detection [} 699]

7.1 Bio Apps

This module offers the functionality to set up image analysis for very specific analysis scenarios
(e.g. to count the number of cells in an image). Each individual analysis scenario has its own appli-
cation.

7.1.1 Available Bio Apps

The following Bio Apps are currently available in ZEN:

§ Cell Counting
This Bio App provides a simple automated image analysis workflow customized for counting
of fluorescently labeled cell nuclei in biological samples and a tailored result presentation with
interactive measurement tables, heatmap and plots. This module allows automatic monitoring
of cell numbers and thus proliferation, i.e. under the influence of compound effects. The mea-
surement features include the number and the density of the cell nuclei as well as the mean
intensity and mean area of cells in a well.
§ Confluency
This Bio App provides a simple automated image analysis workflow customized for quantify-
ing the cell confluency using variance-based segmentation and a tailored result presentation
with interactive measurement tables, heatmap and plots. Applications addressed by this mod-
ule include cell confluency assays as a measure of quality control in cell-based assays and
wound healing assays to follow cell migration and cell-cell interaction. The measurement fea-
tures include the covered area and the area percentage.
§ Gene- and Protein Expression
This Bio App provides a simple automated image analysis workflow customized to quantify
gene expression and a tailored result presentation with interactive measurement tables,
heatmap and plots. Applications addressed by this module include:
– Automatic evaluation and quantification of the transfection efficiency to e.g., optimize the
transfection protocol or to pick positive clones for targeted assays
– Measurement of the expression level to quantify the abundance and distribution of labeled
molecules within a cell population
– Quantification of viral or bacterial infection
The measurement features include the total number of cells and number of positive cells, the
percentage of positive cells and the mean intensity of the transfection channel.
§ Automated Spot Detection
This Bio App provides a simple automated image analysis workflow customized to quantify
spots in the cell nuclei (e.g. for FISH, telomeres, centromeres, foci counting,...) and a tailored
result presentation with interactive measurement tables, heatmap and plots. The measure-
ment features include total number of spots, average number of spots per cell, mean intensity
of spots, mean area of nuclei, mean intensity of nuclei (nuclear stain).
§ Translocation

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 699


7 Application Toolkits | 7.1 Bio Apps ZEISS

This Bio App provides a simple automated image analysis workflow customized to automati-
cally measure the translocation ratio between the cytoplasm and the nucleus and a tailored
result presentation with interactive measurement tables, heatmap and plots. The measure-
ment features include the total number of cells, the translocation ratio, as well as the mean
intensity values of the nucleus and the ring.

7.1.2 General Workflow

The following workflow is generic for the use of a Bio App.

1. Create a new setting for the respective Bio App. For more information, see Creating a Gen-
eral Bio Apps Setting [} 700] and the respective descriptions for each individual Bio App.
This step has to be done only once per Bio App, or if you want or need another setting for
a particular Bio App.
à The created setting can be used for analysis of all suitable images.
2. Use the respective setting to run your Bio App for images you want to analyze, see Run-
ning Bio Apps [} 700] or Running Bio Apps in Batch Mode [} 707].
The images are analyzed and the results can be displayed in a specific results view.

7.1.3 Creating a General Bio Apps Setting

Before you can use a Bio App, you have to create a setting for it.

Prerequisite ü You have opened an image which is typical for the analysis scenario of the respective Bio App.
1. On the Analysis tab, in the Bio Apps tool, click on the Bio App.
à Parameters are displayed.

2. For a new setting, click and select New. Alternatively, if you have a setting you want
to use it as a template, click and select New from Template.
3. Enter a name for the new setting and click . Alternatively, enter a name and press
Enter.
à A new analysis setting file is created.
You have created a general setting which can now be opened in the Bio Apps wizard to set up
the analysis for the respective Bio App. For more information, refer to the descriptions of the indi-
vidual Bio Apps, see Available Bio Apps [} 699].

See also
2 Bio Apps Wizard [} 712]

7.1.4 Running Bio Apps

Info
Analyzing in Batch Mode
You can also setup the analysis of multiple images with Bio Apps and their settings in Batch
Mode, see Running Bio Apps in Batch Mode [} 707].

When you run a Bio App, the image analysis defined in the specific setting is applied to the image.

Prerequisite ü You have opened the image you want to analyze.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 700


7 Application Toolkits | 7.1 Bio Apps ZEISS

ü You have created a setting for the Bio App you want to use, see Creating a General Bio
Apps Setting [} 700].
1. On the Analysis tab, in the Bio Apps tool, click on the Bio App.
2. For Setting, select the setting you have created for this Bio App.
3. Click Run Analysis.
à The analysis runs with the selected Bio App and a result screen opens. On this result
screen you can see the analyzed picture, charts, and a table.
4. Click Finish to close the result screen.
You have successfully run your Bio App. The analysis results are saved in the image file and can be
displayed and exported with the Bio Apps view, see Bio Apps View [} 708].

7.1.5 Creating a Setting for Cell Counting

Info
File Types
Bio Apps can only be applied to suitable image files. If you try to use them with an unsuitable
image type, a message is displayed. The following types of images are not supported for this
Bio App:
4 Z-Stacks
4 Unprocessed Airyscan data
4 Unprocessed Apotome data
4 Multi-phase images
4 Multi-block images
4 PSF images

Prerequisite ü You have opened an image which is typical for the analysis scenario.
ü You have set up a general setting for your Bio App, see Creating a General Bio Apps Setting
[} 700].
1. On the Analysis tab, in the Bio Apps tool, click on Cell Counting.
à The parameters are displayed.
2. Select your created setting as well as your image and click Create Setting.
à The Bio Apps wizard opens.
3. Enter a Name for the objects you want to segment (e.g. Nuclei).
4. In the channel control, select the channel which contains the necessary information for the
analysis (the channel in which the cell nuclei have been stained). For multi-channel images,
which contain one of the following channels (DAPI, Hoechst, To-pro-3, HCS Nuclear Mask
Deep Red), this channel is automatically preselected.
5. Select a Color for the resulting masks.
6. Select Manual if you want to define the objects manually by clicking in the image. Other-
wise, select Automatic. In the Manual mode, you can click on the objects you want to
segment and the lower and higher threshold values will be adapted automatically. Alterna-
tively you can directly enter a Threshold (lowest and highest value) or use the Histogram
for the pixel values used by the segmentation. For color images, you can set the threshold
for each color channel.
7. If you want to use machine learning for segmentation, click Semantic or Instance for se-
mantic or instance segmentation. The prerequisite for semantic segmentation is that you
have installed the 3rd party Python Tools during the installation of ZEN. For instance seg-
mentation, you need to have the Docker Desktop software running.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 701


7 Application Toolkits | 7.1 Bio Apps ZEISS

à A dropdown to select your model is displayed. It contains your own trained and imported
networks if they have been trained on one channel. For semantic segmentation, a default
neural network for the segmentation of fluorescently labeled nuclei is provided.
8. In the AI Model dropdown, select the model you want to use for segmentation.
9. Select the Model Class that should be used for segmentation and set a Min. Confidence.
For instance segmentation you also have to select the AI Model Version.
10. If you want to perform a rolling ball background subtraction, click On.
11. Set the lowest and highest value for the Area and Circularity measurement to filter out
unwanted objects.
à A result preview is displayed by the Image View. The unwanted objects are displayed in
white.
12. If you manually want to include certain objects, for Pick to Include click + and then click
on the object in the image.
à The values employed for the filters Area and Circularity are updated accordingly to in-
clude the selected object and any other objects that fulfil the newly adapted filter criteria.
13. Click Finish.
You have created a setting for Cell Counting which can now be used to analyze images by clicking
Run Analysis, see Running Bio Apps [} 700].

7.1.6 Creating a Setting for Confluency

Info
File Types
Bio Apps can only be applied to suitable image files. If you try to use them with an unsuitable
image type, a message is displayed. The following types of images are not supported for this
Bio App:
4 Z-Stacks
4 Unprocessed Airyscan data
4 Unprocessed Apotome data
4 Multi-phase images
4 Multi-block images
4 PSF images

Prerequisite ü You have opened an image which is typical for the analysis scenario.
ü You have set up a general setting for your Bio App, see Creating a General Bio Apps Setting
[} 700].
1. On the Analysis tab, in the Bio Apps tool, click on Confluency.
à The parameters are displayed.
2. Select your created setting and click Create Setting.
à The Bio Apps wizard opens.
3. Enter a Name for the class you want to segment,
4. In the channel control, select the channel which contains the necessary information for the
analysis. For multi-channel images, which contain a channel out of the list (Bright, Oblique,
DIC and PGC), this channel is automatically preselected.
5. Select a Color for the resulting masks.
à Per default, the Segmentation Type is set to Manual to use a manual variance-based
segmentation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 702


7 Application Toolkits | 7.1 Bio Apps ZEISS

6. Select if you want to segment the Structure in your image or the Background (this inverts
the applied threshold values).
7. Define the Threshold for the variance calculated from one pixel with the neighboring pix-
els and adjust the Kernel Size for this calculation.
8. If you want to use machine learning for segmentation, click AI-based (the prerequisite is
that you have installed the 3rd party Python Tools during the installation of ZEN).
à A dropdown to select your model is displayed. It contains your own trained and imported
networks if they have been trained on one channel.
9. In the AI Model dropdown, select the model you want to use for segmentation.
10. Select the Model Class that should be used for segmentation and set a Min. Confidence.
11. Set the Min. Object Size to define the minimum area in pixel that an object must have to
be segmented.
12. Activate Fill all holes if you want to close the holes in the segmented masks. Otherwise
leave Fill all holes deactivated.
13. Set the Min. Hole Size to define minimum area in pixel of the holes in the detected ob-
jects.
14. Click Finish.
You have created a setting for Confluency which can now be used to analyze images by clicking
Run Analysis, see Running Bio Apps [} 700].

7.1.7 Creating a Setting for Gene- and Protein Expression

Info
File Types
Bio Apps can only be applied to suitable image files. If you try to use them with an unsuitable
image type, a message is displayed. The following types of images are not supported for this
Bio App:
4 Z-Stacks
4 Unprocessed Airyscan data
4 Unprocessed Apotome data
4 Multi-phase images
4 Multi-block images
4 PSF images

Prerequisite ü You have opened an image with at least two channels that is typical for the analysis scenario.
ü You have set up a general setting for your Bio App, see Creating a General Bio Apps Setting
[} 700].
1. On the Analysis tab, in the Bio Apps tool, click on Gene- and Protein Expression.
à The parameters are displayed.
2. Select your created setting as well as your image and click Create Setting.
à The Bio Apps wizard opens.
3. Enter a Name for the segmented objects (the nuclei), select the Channel in which the nu-
clei are stained as well as a Color for the resulting masks.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 703


7 Application Toolkits | 7.1 Bio Apps ZEISS

4. Select Manual if you want to define the objects manually by clicking in the image. Other-
wise, select Automatic. In the Manual mode, you can click on the objects you want to
segment and the lower and higher threshold values will be adapted automatically. Alterna-
tively you can directly enter a Threshold (lowest and highest value) or use the Histogram
for the pixel values used by the segmentation. For color images, you can set the threshold
for each color channel.
5. If you want to use machine learning for segmentation, click Semantic or Instance for se-
mantic or instance segmentation. The prerequisite for semantic segmentation is that you
have installed the 3rd party Python Tools during the installation of ZEN. For instance seg-
mentation, you need to have the Docker Desktop software running.
à A dropdown to select your model is displayed. It contains your own trained and imported
networks if they have been trained on one channel. For semantic segmentation, a default
neural network for the segmentation of fluorescently labeled nuclei is provided.
6. In the AI Model dropdown, select the model you want to use for segmentation.
7. Select the Model Class that should be used for segmentation and set a Min. Confidence.
For instance segmentation you also have to select the AI Model Version.
8. If you want to perform a rolling ball background subtraction, click On.
9. Set the lowest and highest value for the Area and Circularity measurement to filter out
unwanted objects.
à A result preview is displayed by the Image View. The unwanted objects are displayed in
white.
10. If you manually want to include certain objects, for Pick to Include click + and then click
on the object in the image.
à The values employed for the filters Area and Circularity are updated accordingly to in-
clude the selected object and any other objects that fulfil the newly adapted filter criteria.
11. Set the distance between the boundary of the masks of the segmented nuclei and the rings
where the transfection is measured. A negative value means that the ring already begins in-
side of the nucleus. A positive value creates a ring that starts in a distance from the bound-
ary of the nuclei masks.
12. Set the width of the rings displayed in the image.
13. Click Next.
à The Gene Expression step opens.
14. Enter a Name for the transfected cells, select the Channel in which you want to measure
the transfection as well as a Color for the resulting masks.
15. Set the lowest and highest value for the mean intensity of the transfection channel, for
which the cells are counted as "positive".
16. If you manually want to include certain intensities, for Pick to Include click + and then
click on the area in the image.
à The values employed for Intensity Mean are updated accordingly.
17. Click Finish.
You have created a setting for Gene Expression which can now be used to analyze images by
clicking Run Analysis, see Running Bio Apps [} 700]. As a result, this settings calculates the
transfection efficiency, which can then be displayed in Bio Apps view after the run of the analy-
sis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 704


7 Application Toolkits | 7.1 Bio Apps ZEISS

7.1.8 Creating a Setting for Automated Spot Detection

Info
File Types
Bio Apps can only be applied to suitable image files. If you try to use them with an unsuitable
image type, a message is displayed. The following types of images are not supported for this
Bio App:
4 Z-Stacks
4 Unprocessed Airyscan data
4 Unprocessed Apotome data
4 Multi-phase images
4 Multi-block images
4 PSF images

Prerequisite ü You have opened an image that is typical for the analysis scenario.
ü You have set up a general setting for your Bio App, see Creating a General Bio Apps Setting
[} 700].
1. On the Analysis tab, in the Bio Apps tool, click on Automated Spot Detection.
à The parameters are displayed.
2. Select your created setting as well as your image and click Create Setting.
à The Bio Apps wizard opens.
3. Enter a Name for the nuclei you want to segment, select the Channel which contains the
necessary information as well as a Color for the resulting masks.
4. For the segmentation of the nuclei, select Manual, if you want to define the objects manu-
ally by clicking in the image. Otherwise, select Automatic. In the Manual mode, you can
click on the objects you want to segment and the lower and higher threshold values will be
adapted automatically. Alternatively you can directly enter a Threshold (lowest and highest
value) or use the Histogram for the pixel values used by the segmentation. For color im-
ages, you can set the threshold for each color channel.
5. If you want to use machine learning for segmentation, click Semantic or Instance for se-
mantic or instance segmentation. The prerequisite for semantic segmentation is that you
have installed the 3rd party Python Tools during the installation of ZEN. For instance seg-
mentation, you need to have the Docker Desktop software running.
à A dropdown to select your model is displayed. It contains your own trained and imported
networks if they have been trained on one channel. For semantic segmentation, a default
neural network for the segmentation of fluorescently labeled nuclei is provided.
6. In the AI Model dropdown, select the model you want to use for segmentation.
7. Select the Model Class that should be used for segmentation and set a Min. Confidence.
For instance segmentation you also have to select the AI Model Version.
8. If you want to perform a rolling ball background subtraction, click On.
9. Set the lowest and highest value for the Area and Circularity measurement to filter out
unwanted objects.
à A result preview is displayed by the Image View. The unwanted objects are displayed in
white.
10. If you manually want to include certain objects, for Pick to Include click + and the click on
the object in the image.
à The values employed for the filters Area and Circularity are updated accordingly to in-
clude the selected object and any other objects that fulfil the newly adapted filter criteria.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 705


7 Application Toolkits | 7.1 Bio Apps ZEISS

11. Set the distance between the boundary of the masks of the segmented nuclei and the rings
where the spots should be detected. A negative value means that the ring already begins
inside of the nucleus. A positive value creates a ring that starts in a distance from the
boundary of the nuclei masks.
12. Set the width of the rings displayed in the image.
13. Click Next.
à The second step of the wizard opens.
14. Enter a Name for the spots, select the Channel with which the spots are stained as well as
a Color for the resulting masks.
15. For the segmentation of the nuclei, select Manual, if you want to define the objects manu-
ally by clicking in the image. Otherwise, select Automatic. In the Manual mode, you can
click on the objects you want to segment and the lower and higher threshold values will be
adapted automatically. Alternatively you can directly enter a Threshold (Low and High) or
use the Histogram for the pixel values used by the segmentation. For color images, you
can set the threshold for each color channel.
16. If you want to use machine learning for segmentation, click Semantic or Instance for se-
mantic or instance segmentation.
à A dropdown to select your model is displayed.
17. In the AI Model dropdown, select the model you want to use for segmentation.
18. Select the Model Class that should be used for segmentation and set a Min. Confidence.
For instance segmentation you also have to select the AI Model Version.
à A result preview is displayed by the Image View.
à For the Spots step, a rolling ball background subtraction is automatically enabled.
19. If you do not want to perform a rolling ball background subtraction, click Off.
20. Set the lowest and highest value for the Area and Circularity measurement to filter out
unwanted objects.
à A result preview is displayed by the Image View. The unwanted objects are displayed in
white.
21. If you manually want to include certain objects, for Pick to Include click + and then click
on the object in the image.
à The values employed for the filters Area and Circularity are updated accordingly to in-
clude the selected object and any other objects that fulfil the newly adapted filter criteria.
22. Click Finish.
You have created a setting for Spot Detection which can now be used to analyze images by click-
ing Run Analysis, see Running Bio Apps [} 700].

7.1.9 Creating a Setting for Translocation

Info
File Types
Bio Apps can only be applied to suitable image files. If you try to use them with an unsuitable
image type, a message is displayed. The following types of images are not supported for this
Bio App:
4 Z-Stacks
4 Unprocessed Airyscan data
4 Unprocessed Apotome data
4 Multi-phase images
4 Multi-block images
4 PSF images

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 706


7 Application Toolkits | 7.1 Bio Apps ZEISS

Prerequisite ü You have opened a multichannel image which is typical for the analysis scenario.
ü You have set up a general setting for your Bio App, see Creating a General Bio Apps Setting
[} 700].
1. On the Analysis tab, in the Bio Apps tool, click on Translocation.
à The parameters are displayed.
2. Select your created setting as well as your image and click Create Setting.
à The Bio Apps wizard opens.
3. Enter a Name for the segmented objects (the nuclei), select the Channel in which the nu-
clei are stained as well as a Color for the resulting masks.
4. Select Manual if you want to define the objects manually by clicking in the image. Other-
wise, select Automatic. In the Manual mode, you can click on the objects you want to
segment and the lower and higher threshold values will be adapted automatically. Alterna-
tively you can directly enter a Threshold (lowest and highest value) or use the Histogram
for the pixel values used by the segmentation. For color images, you can set the threshold
for each color channel.
5. If you want to use machine learning for segmentation, click Semantic or Instance for se-
mantic or instance segmentation. The prerequisite for semantic segmentation is that you
have installed the 3rd party Python Tools during the installation of ZEN. For instance seg-
mentation, you need to have the Docker Desktop software running.
à A dropdown to select your model is displayed. It contains your own trained and imported
networks if they have been trained on one channel. For semantic segmentation, a default
neural network for the segmentation of fluorescently labeled nuclei is provided.
6. In the AI Model dropdown, select the model you want to use for segmentation.
7. Select the Model Class that should be used for segmentation and set a Min. Confidence.
For instance segmentation you also have to select the AI Model Version.
8. If you want to perform a rolling ball background subtraction, click On.
9. Set the lowest and highest value for the Area and Circularity measurement to filter out
unwanted objects.
à A result preview is displayed by the image view. The unwanted objects are displayed in
white.
10. If you manually want to include certain objects, for Pick to Include click + and then click
on the object in the image.
à The values employed for the filters Area and Circularity are updated accordingly to in-
clude the selected object and any other objects that fulfil the newly adapted filter criteria.
11. Select the Translocation Channel.
12. Set the distance between the boundary of the masks of the segmented nuclei and the rings
where the translocation is measured. A positive value creates a ring that starts in a distance
from the boundary of the nuclei masks.
13. Set the width of the rings.
14. Click Finish.
You have created a setting for translocation which can now be used to analyze images by clicking
Run Analysis, see Running Bio Apps [} 700].

7.1.10 Running Bio Apps in Batch Mode

Prerequisite ü You are on the Processing tab.


ü You have created settings for all Bio Apps you want to use.
1. Click Batch.
à The Batch Processing view is displayed in the Center Screen Area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 707


7 Application Toolkits | 7.1 Bio Apps ZEISS

2. Click +Add.
à A file browser opens.
3. Select an image you want to analyze and click Open.
à The image is added to the list in the Batch Processing view.
4. Repeat the previous steps until all images you want to analyze are opened in the Batch
Processing view. You can also select multiple images by pressing the Ctrl button while se-
lecting.
à All images are displayed in the list.
5. In the list of the Batch Processing view, select an image.
6. In the Batch Method tool, select Bio Apps.
à Parameters are available for the image.
7. In the Parameters tool, select the Bio App and the Setting you want to use for the im-
age.
à You have set the Bio App analysis for the selected image.
8. Repeat the previous steps until you set the analysis for all opened images. If you want to
analyze multiple images with the same Bio App and setting, you can also select multiple im-
ages by pressing the Ctrl button, or all images by pressing Ctrl + A.
à You have set the Bio App analysis for all images.
9. Click Apply. Alternatively, if you want to run the analysis for only some of the images, se-
lect the images in the list and click Run Selected.
à The images are analyzed with the respective Bio Apps and settings.
à The analyzed images are saved in the defined output folder. The results can be displayed
and exported if you open the resulting images in ZEN and use the Bio Apps view, see
Exporting Results of the Bio Apps Analysis [} 708].

7.1.11 Exporting Results of the Bio Apps Analysis

Prerequisite ü You have analyzed an image with a Bio App, see Running Bio Apps [} 700] or Running Bio
Apps in Batch Mode [} 707].
ü You have opened the results of the analysis in the Bio Apps view.
1. Set the displayed information (chart, chart axis, table, etc.) in the Bio Apps view according
to your needs. The export uses the currently displayed information.
2. In the Export tab, activate the checkboxes for all the information you want to export and
select the corresponding format for each with the dropdown lists.
3. Click Export.
à A file browser opens.
4. Name the file for export, navigate to the folder where the results should be exported to
and click Save.

7.1.12 Bio Apps View

This view is only available for images which have been analyzed by a Bio App and if you have the
license for the Bio Apps toolkit. Here you can see the result of the image analysis conducted by
the Bio App and you have a table and plot section to see the result data of the analysis. The infor-
mation displayed by the plots and table is specific for each Bio App.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 708


7 Application Toolkits | 7.1 Bio Apps ZEISS

1 Image View
Displays the currently selected image of your analyzed image document as well as the
masking objects of the analysis (depending on the settings done in the Objects tab).

2 Result Chart
Displays the chart for the analysis results of the Bio App. The chart type and the Mea-
surement features displayed on the axis can be set in the Chart view options tab.

3 Result Table
Displays the table with the results of the Bio App analysis.

4 View Options
Displays general view options as well as Bio App specific options.

See also
2 Bio Apps [} 699]

7.1.12.1 Export Tab

This tab enables you to export various results of your Bio Apps analysis.

Parameter Description
Image Activated: Selects the current result image for export with the format
selected in the dropdown.

Table Activated: Selects the currently displayed table for export with the
format selected in the dropdown.

Chart Activated: Selects the currently displayed chart for export with the
format selected in the dropdown. The resolution for the exported
charts is 300 dpi.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 709


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
– Width (pixel) Sets the width for the exported chart in pixel.

– Height (pixel) Sets the height for the exported chart in pixel.

– Maintain as- Activated: A change of the width or height automatically results in a


pect ratio change of the other factor to maintain the aspect ratio of the plot
currently displayed in the Bio Apps result view.
Deactivated: The aspect ratio is not maintained. Width and height
can be set independently.

Processing Info Activated: Selects the current processing information for export with
the format selected in the dropdown.

Export Opens the file browser to export all the selected result documents.

See also
2 Bio Apps View [} 708]
2 Exporting Results of the Bio Apps Analysis [} 708]

7.1.12.2 Objects Tab

Parameter Description
Show Objects Activated: Displays the resulting mask of the analysis in the image.

Object Display Sets how the masks are displayed in the image.

– Fill Displays the masking objects as filled objects.

– Outline Displays the masking objects as an outline.

Opacity Sets the opacity of the objects in the image.

Show All Activated: Displays all region classes in the image.


Deactivated: Displays only the region class selected in the dropdown.

Region Class Drop- Selects the region class for which the chart and table is displayed.
down

See also
2 Bio Apps View [} 708]
2 Bio Apps Wizard [} 712]

7.1.12.3 Chart Tab

Parameter Description
Data Selects if the displayed results in the table and chart are for the entire
carrier, or a single scene.

– Entire Carrier Displays the results of the entire carrier.

– Single Scene Displays the results for a single scene. The chart can be toggled be-
tween histogram and xy-plot.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 710


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
Chart Type Selects which chart type is displayed.

– Histogram Only visible if Single Scene is selected.


Displays a histogram.

– XY-Plot Only visible if Single Scene is selected.


Displays an xy-plot.

– Heatmap (Sin- Only visible if Entire Carrier is selected and the image has multiple
gle Time time points.
Point) Displays a heatmap for the current time point. To go to another time
point, use the Time control on the Dimensions tab.

– Line (Total Only visible if Entire Carrier is selected and the image has multiple
Time Range) time points.
Displays a line chart with the data of the total time range.

Measurement Only visible if Entire Carrier is selected.


Selects which measurement results are displayed in the heatmap.

Measurement Only visible if Entire Carrier is selected.


Range Selects how the measurement range displayed in the chart is defined.

– Fit to Whole Fits the range to the data of the whole image.
Data Set

– Fit to Single Fits the range to the data of the current time point.
Time Point

– Define Manu- Allows you to define the range manually.


ally

X-Axis Only visible if Single Scene or Line (Total Time Range) is selected.
Selects which value is used for the x-axis of the chart.

Y-Axis Only visible if Single Scene and XY-Plot, or Line (Total Time
Range) is selected.
Selects which measurement feature is used for the y-axis of the chart.

7.1.13 Bio Apps Tool

This tool enables you to see and start the different available Bio Apps.

Parameter Description
Recent Displays recently used Bio Apps.

All Displays all available Bio Apps.

Setting Only visible if you have selected a Bio App.


Selects a settings for this particular Bio App.

Only visible if you have selected a Bio App.


Opens the options menu.
Options

– New Creates a new analysis setting. Enter a name for the setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 711


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
– Edit Opens the Bio Apps wizard to edit the setting, see Bio Apps Wizard
[} 712].

– Rename Enables you to enter a new name for the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name. Enter a name for the
setting.

– Import Imports an existing setting.

– Delete Deletes the current setting.

Input Displays the currently opened images in ZEN which serve as input for
the Bio App.

Create Setting Only visible if you have selected a Bio App and if you have created a
new setting.
Opens the wizard of the selected Bio App which allows you to modify
the parameters of the analysis setting.

Run Analysis Only available if a Bio App is selected.


Runs the respective Bio App with the selected setting.

See also
2 Bio Apps [} 699]
2 Available Bio Apps [} 699]
2 General Workflow [} 700]

7.1.14 Bio Apps Wizard

In this wizard you define the settings for your Bio Apps. In this wizard you have your image, the
settings for the Bio App, basic view options as in the 2D view and an additional Legends win-
dow. This window displays information about the individual regions in the image and can be tog-
gled on and off with the right click menu entry Regions Legend.
The options and parameters shown here in the wizard are, for the most part, Bio App specific.
The following parameters are generally available:

Parameter Description
Name Sets the name for the class/objects that is analyzed by this Bio App.

Channel Selects the image channel for the analysis.

Color Selects a color for the resulting masks. Note: Use a different color
than the channel color to be able to differentiate between mask and
measurement signal.

Finish Saves the changes and closes the wizard.

Cancel Closes the wizard without saving the changes.

See also

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 712


7 Application Toolkits | 7.1 Bio Apps ZEISS

2 Available Bio Apps [} 699]

7.1.14.1 Cell Counting Specific Settings

Parameter Description
Segm. Method Selects the method for segmentation.

– Automatic Uses threshold values that are determined automatically from the his-
togram based on the Otsu method. For all possible threshold values,
the Otsu method calculates the variance of intensities on each side of
the respective threshold. It minimizes the sum of the variances for the
background and the foreground.

– Manual Sets the threshold manually by clicking on the regions in the image
that you want to segment, or by using the Threshold control dis-
played below.

– Semantic Uses semantic segmentation based on machine learning to automati-


cally segment (fluorescently labeled) cell nuclei. This requires an instal-
lation of the 3rd party Python Tools during the installation of ZEN.

– Instance Uses an AI model for instance segmentation to automatically segment


(fluorescently labeled) cell nuclei. The AI models for instance segmen-
tation need the software Docker Desktop to run.

AI Model Only visible if Semantic or Instance is selected.


Selects the model for segmentation from a dropdown which includes
your own trained and imported networks as well as a default neural
network for the segmentation of fluorescently labeled nuclei. Note
that you can only use models trained on a single channel.

AI Model Version Only visible if Instance is selected.


Selects the model version you want to use.

Model Class Only visible if Semantic or Instance is selected.


Selects the model class used for segmentation.

Min. Confidence Only visible if Semantic or Instance is selected.


Sets the minimum confidence in % for the prediction of every object.

Threshold Only visible if Manual is selected.


Sets the threshold for the pixel intensity used by the segmentation.
For an RGB image you can set the threshold for each color channel in-
dividually.

– Low Defines the lowest pixel intensity considered for the segmentation.

– High Defines the highest pixel intensity considered for segmentation.

– Undoes the last change.

Pick to Segment Only visible if Manual is selected.

– + Enables you to expand the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

– - Enables you to reduce the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 713


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
Histogram Only visible if Manual is selected.
In the histogram you can change the lower and upper threshold value
by dragging the lower or upper adjustment handle or shift the entire
highlighted area between the lower and upper threshold value.

BG Subtraction

– On Applies a rolling ball background subtraction to the image.

– Off Applies no background subtraction to the image.

Area Sets the lowest and highest value for the area of the objects. For
more information, see the list of Measurement Features [} 440].

Circularity Sets the lowest and highest value for the roundness of the objects.
For more information, see the list of Measurement Features [} 440].

+ Enables you to expand the values employed for the region filters (area
Pick to Include and circularity) by clicking on objects in the image.

See also
2 Downloading AI Models [} 71]
2 Creating a Setting for Cell Counting [} 701]

7.1.14.2 Confluency Specific Settings

Parameter Description
Segmentation Selects the type of segmentation.
Type

– Manual Uses a manual threshold by clicking on the regions in the image that
you want to segment, or by using the Threshold control displayed
below.

– AI-based Uses machine learning to automatically segment the structures. The


use of AI-segmentation requires an installation of the 3rd party
Python Tools during the installation of ZEN.

Segm. Area Only visible if Manual is selected.


Selects which area is segmented.

– Structure Segments the structure(s) in the image.

– Background Segments only the background of the image.

Threshold Only visible if Manual is selected.


Sets the threshold for the variance calculation.
If Structure is selected, it sets the threshold for the minimum vari-
ance of the structures in your image, i.e. all areas which have a vari-
ance value higher than the specified threshold will be segmented.
If Background is selected, it sets the threshold for the maximum vari-
ance of the background, i.e. all areas which have a variance value
lower than the specified threshold will be segmented.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 714


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
Kernel Size Only visible if Manual is selected.
Sets the kernel size to calculate the variance value of one pixel with
the neighboring pixels.

AI Model Only visible if AI-based is selected.


Selects the model for segmentation from a dropdown which includes
your own trained and imported networks.

Model Class Only visible if AI-based is selected.


Selects the model class used for segmentation.

Min. Confidence Only visible if AI-based is selected.


Sets the minimum confidence in % for the prediction of every object.

Min. Object Size Sets the minimum size in pixel that an object must have to be seg-
mented.

Fill all Holes

– On Fills all holes in the segmented objects irrespective of their size.

– Off Fills holes in the segmented objects only if they are smaller than the
specified Min. Hole Area.

Min. Hole Size Sets the minimum area in pixel for the holes in the detected objects.
The input is synchronized with Min. Object Size, which cannot be
smaller than Min. Hole Size.

See also
2 Creating a Setting for Confluency [} 702]

7.1.14.3 Gene- and Protein Expression Specific Settings

For Gene- and Protein Expression you have to specify settings for the nuclei segmentation as
well as for quantification of the gene expression in the respective step.

Parameter Description
Segm. Method Only visible in the Nuclei step.
Selects the method for segmentation.

– Automatic Uses threshold values that are determined automatically from the his-
togram based on the Otsu method. For all possible threshold values,
the Otsu method calculates the variance of intensities on each side of
the respective threshold. It minimizes the sum of the variances for the
background and the foreground.

– Manual Sets the threshold manually by clicking on the regions in the image
that you want to segment, or by using the Threshold control dis-
played below.

– Semantic Uses semantic segmentation based on machine learning to automati-


cally segment (fluorescently labeled) cell nuclei. This requires an instal-
lation of the 3rd party Python Tools during the installation of ZEN.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 715


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
– Instance Uses an AI model for instance segmentation to automatically segment
(fluorescently labeled) cell nuclei. The AI models for instance segmen-
tation need the software Docker Desktop to run.

AI Model Only visible if Semantic or Instance is selected.


Selects the model for segmentation from a dropdown which includes
your own trained and imported networks as well as a default neural
network for the segmentation of (fluorescently labeled) nuclei. Note
that you can only use models trained on a single channel.

AI Model Version Only visible if Instance is selected.


Selects the model version you want to use.

Model Class Only visible if Semantic or Instance is selected.


Selects the model class used for segmentation.

Min. Confidence Only visible if Semantic or Instance is selected.


Sets the minimum confidence in % for the prediction of every object.

Threshold Only visible in the Nuclei step and if Manual is selected.


Sets the threshold for the pixel intensity used by the segmentation.
For an RGB image you can set the threshold for each color channel in-
dividually.

– Low Defines the lowest pixel intensity considered for the segmentation.

– High Defines the highest pixel intensity considered for segmentation.

– Undoes the last change.

Pick to Segment Only visible in the Nuclei step and if Manual is selected.

– + Enables you to expand the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

– - Enables you to reduce the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

Histogram Only visible in the Nuclei step and if Manual is selected.


In the histogram you can change the lower and upper threshold value
by dragging the lower or upper adjustment handle or shift the entire
highlighted area between the lower and upper threshold value.

BG Subtraction

– On Applies a rolling ball background subtraction to the image.

– Off Applies no background subtraction to the image.

Area Only available in the Nuclei step.


Sets the lowest and highest value for the area of the objects. For
more information, see the list of Measurement Features [} 440].

Circularity Only available in the Nuclei step.


Sets the lowest and highest value for the roundness of the objects.
For more information, see the list of Measurement Features [} 440].

Pick to Include Enables you to expand the values employed for the region filters (area
+ and circularity) and the mean intensity in the second step by clicking
on objects in the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 716


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
Ring Distance Only available in the Nuclei step.
Sets the distance between the inner border of the ring and the border
of the segmented nuclei.

Ring Width Only available in the Nuclei step.


Sets the width of the ring where the gene expression is measured.

Intensity Mean Only available in the Gene- and Protein Expression step.
Sets the lowest and highest value for the mean intensity measurement
of the selected channel. For more information, see the list of Mea-
surement Features [} 440]. If the mean intensity of a cell falls into
that defined range, it is considered as a positive cell.

See also
2 Downloading AI Models [} 71]
2 Creating a Setting for Gene- and Protein Expression [} 703]

7.1.14.4 Automated Spot Detection Specific Settings

For Automated Spot Detection you have to specify settings for the nuclei segmentation as well
as the spot detection itself in the respective step.

Parameter Description
Segm. Method Selects the method for segmentation.

– Automatic Uses threshold values that are determined automatically from the his-
togram based on the Otsu method. For all possible threshold values,
the Otsu method calculates the variance of intensities on each side of
the respective threshold. It minimizes the sum of the variances for the
background and the foreground.

– Manual Sets the threshold manually by clicking on the regions in the image
that you want to segment, or by using the Threshold control dis-
played below.

– Semantic Uses semantic segmentation based on machine learning to automati-


cally segment (fluorescently labeled) cell nuclei. This requires an instal-
lation of the 3rd party Python Tools during the installation of ZEN.

– Instance Uses an AI model for instance segmentation to automatically segment


(fluorescently labeled) cell nuclei. The AI models for instance segmen-
tation need the software Docker Desktop to run.

AI Model Only visible if Semantic or Instance is selected.


Selects the model for segmentation from a dropdown which includes
your own trained and imported networks as well as a default neural
network for the segmentation of fluorescently labeled nuclei. Note
that you can only use models trained on a single channel.

AI Model Version Only visible if Instance is selected.


Selects the model version you want to use.

Model Class Only visible if Semantic or Instance is selected.


Selects the model class used for segmentation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 717


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
Min. Confidence Only visible if Semantic or Instance is selected.
Sets the minimum confidence in % for the prediction of every object.

Threshold Only visible if Manual is selected.


Sets the threshold for the pixel intensity used by the segmentation.
For an RGB image you can set the threshold for each color channel in-
dividually.

– Low Defines the lowest pixel intensity considered for the segmentation.

– High Defines the highest pixel intensity considered for segmentation.

– Undoes the last change.

Pick to Segment Only visible if Manual is selected.

– + Enables you to expand the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

– - Enables you to reduce the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

Histogram Only visible if Manual is selected.


In the histogram you can change the lower and upper threshold value
by dragging the lower or upper adjustment handle or shift the entire
highlighted area between the lower and upper threshold value.

BG Subtraction

– On Applies a rolling ball background subtraction to the image.

– Off Applies no background subtraction to the image.

Area Sets the lowest and highest value for the area of the objects. For
more information, see the list of Measurement Features [} 440].

Circularity Sets the lowest and highest value for the roundness of the objects.
For more information, see the list of Measurement Features [} 440].

+ Enables you to expand the values employed for the region filters (area
Pick to Include and circularity) by clicking on objects in the image.

Ring Distance Only available in the Nuclei step.


Sets the distance between the inner border of the ring and the border
of the segmented nuclei.

Ring Width Only available in the Nuclei step.


Sets the width of the ring where the spots are detected.

See also
2 Downloading AI Models [} 71]
2 Creating a Setting for Automated Spot Detection [} 705]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 718


7 Application Toolkits | 7.1 Bio Apps ZEISS

7.1.14.5 Translocation Specific Settings

Parameter Description
Segm. Method Selects the method for segmentation.

– Automatic Uses threshold values that are determined automatically from the his-
togram based on the Otsu method. For all possible threshold values,
the Otsu method calculates the variance of intensities on each side of
the respective threshold. It minimizes the sum of the variances for the
background and the foreground.

– Manual Sets the threshold manually by clicking on the regions in the image
that you want to segment, or by using the Threshold control dis-
played below.

– Semantic Uses semantic segmentation based on machine learning to automati-


cally segment (fluorescently labeled) cell nuclei. This requires an instal-
lation of the 3rd party Python Tools during the installation of ZEN.

– Instance Uses an AI model for instance segmentation to automatically segment


(fluorescently labeled) cell nuclei. The AI models for instance segmen-
tation need the software Docker Desktop to run.

AI Model Only visible if Semantic or Instance is selected.


Selects the model for segmentation from a dropdown which includes
your own trained and imported networks as well as a default neural
network for the segmentation of (fluorescently labeled) nuclei. Note
that you can only use models trained on a single channel.

AI Model Version Only visible if Instance is selected.


Selects the model version you want to use.

Model Class Only visible if Semantic or Instance is selected.


Selects the model class used for segmentation.

Min. Confidence Only visible if Semantic or Instance is selected.


Sets the minimum confidence in % for the prediction of every object.

Threshold Only visible if Manual is selected.


Sets the threshold for the pixel intensity used by the segmentation.
For an RGB image you can set the threshold for each color channel in-
dividually.

– Low Defines the lowest pixel intensity considered for the segmentation.

– High Defines the highest pixel intensity considered for segmentation.

– Undoes the last change.

Pick to Segment Only visible if Manual is selected.

– + Enables you to expand the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

– - Enables you to reduce the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

Histogram Only visible if Manual is selected.


In the histogram you can change the lower and upper threshold value
by dragging the lower or upper adjustment handle or shift the entire
highlighted area between the lower and upper threshold value.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 719


7 Application Toolkits | 7.1 Bio Apps ZEISS

Parameter Description
BG Subtraction Only visible if Automatic or Manual is selected.

– On Applies a rolling ball background subtraction to the image.

– Off Applies no background subtraction to the image.

Area Sets the lowest and highest value for the area of the objects. For
more information, see the list of Measurement Features [} 440].

Circularity Sets the lowest and highest value for the roundness of the objects.
For more information, see the list of Measurement Features [} 440].

Pick to Include Enables you to expand the values employed for the region filters (area
+ and circularity) and the mean intensity in the second step by clicking
on objects in the image.

Translocation Selects the channel to quantify translocation.


Channel

Ring Distance Sets the distance between the inner border of the ring and the border
of the segmented nuclei.

Ring Width Sets the width of the ring where the translocation is measured.

See also
2 Creating a Setting for Translocation [} 706]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 720


8 Special/Hardware Related Modules | 8.1 Airyscan RAW Data ZEISS

8 Special/Hardware Related Modules


You can expand the software functionality with the following special modules:

§ CAT [} 722]
§ Dynamics Profiler [} 770] (Basic & Advanced)
§ EM Processing Toolbox [} 793]

8.1 Airyscan RAW Data

Airyscan RAW Data (available for LSM 900 and LSM 980) is part of the Airyscan processing
functionality and allows you to save and export the Airyscan data in a format which allows best
compatibility to third party and self programed processing tools. If you have licensed the
Airyscan processing functionality, the function to get the original 32ch raw data is also available.

8.1.1 Saving Images in 32ch Airyscan Format

Per default, Airyscan data is stored in a 4ch format, which allows faster processing. Also the Shep-
pard sum export is available in this format.
If you want to acquire and save the data in the 32ch Airyscan format, do the following:

Prerequisite ü You have licensed the Airyscan Processing module.


1. Click Tools > Options > Acquisition.
à The acquisition options are displayed.
2. Open the LSM section and activate Keep Airyscan Raw Data.
3. Click OK.
à The Options dialog closes.
Data is now acquired and saved in the 32ch Airyscan format.

8.1.2 Exporting Data in 1ch Sheppard Sum Format

Prerequisite ü You have licensed Airyscan Processing.


1. On the Processing tab, in the Methods tool under Utilities, select Airyscan Sheppard
Sum.
2. In the Input tool, select the Airyscan image that should be exported as a Sheppard sum.
3. At the top of the Processing tab, click Apply.
The image is exported as a Sheppard sum. This export does not change the Airyscan data format,
but generates an additional data file with just one summed up channel of the Airyscan. Since no
filtering or deconvolution is performed, this data format is compatible with many third party or
self programed deconvolution or machine learning super resolution methods.

See also
2 Processing Tab [} 873]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 721


8 Special/Hardware Related Modules | 8.2 Coded Microscope ZEISS

8.2 Coded Microscope

This module enables ZEN lite to receive microscope settings from coded manual instruments, dis-
play the information in ZEN lite and save it in the image files. Moreover, Coded Microscope en-
ables illumination control from ZEN lite.

8.3 Correlative Array Tomography (CAT)

This module enables you to perform automated imaging of ultra-thin serial sections (ribbons) us-
ing the light- and scanning electron microscope. After calibration of the sample carrier and detec-
tion of the sections, regions of interest can be defined manually in a single section that will be au-
tomatically propagated to all sections. The selected regions of interest can then be imaged with
different contrast methods and magnifications using the LM.
In the SEM the previously defined regions of interest will then be imaged automatically after load-
ing the image previously acquired at the LM. The corresponding 2D image sequences recorded by
the LM and SEM are aligned into a 3D Z-Stack using the integrated alignment and correlation al-
gorithms of the ZEN Correlative Array Tomography module. This process results in a correlative 3D
data set combining LM and SEM information into one image volume.
For the correlative workflow, one CAT module has to be installed on the widefield system, a sec-
ond module has to be installed on the SEM. A detailed how-to guide of the workflow can be
found in the chapter The CAT Workflow [} 722].
The software module can be used with ZEISS widefield microscopes as well as with ZEISS scan-
ning electron microscopes. In addition, to the CAT tool the module offers four wizards. Detailed
descriptions of the functions of the tools and wizards can be found in the linked chapters.

§ Correlative Array Tomography tool, see CAT Tool [} 752].


§ Calibration Wizard, see Sample Holder Calibration Wizard [} 753].
§ Acquisition Wizard, see Acquisition Wizard [} 756].
§ Z-Stack Alignment Wizard, see Z-Stack Alignment Wizard [} 763].
§ Correlation Wizard, see Correlation Wizard [} 765].

8.3.1 Basics of Array Tomography

Array Tomography is a volumetric microscopy method employed to visualize and reconstruct 3D


images of serial sections. Tissue samples or cells embedded in resin are cut into consecutive sec-
tions with an ultramicrotome and collected onto a sample carrier (e.g. cover glass). The sequence
of the sections determines the z-position and allows the reconstruction of the 3rd dimension.
Therefore the z-resolution of the resulting 3D data set is determined by the thickness of the sec-
tion.
The correlation of scanning electron microscope (SEM) data especially with an image acquired us-
ing a fluorescence light microscope (LM), enables the visualization of fluorescently labeled biologi-
cal structures in their ultrastructural context not only in 2D but now in 3D with the ZEN Correla-
tive Array Tomography module.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 722


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8.3.2 Sample Preparation

Type of Sample Carrier/Cover Glasses


We recommend cover glasses coated with Indium tin oxide and fiducials. Indium tin oxide mini-
mizes charging effects in the scanning electron microscope. Cover glasses with fiducials enables
additional preparation steps after imaging the sample with the light microscopes and before
imaging with a scanning electron microscope.

Deposition of Serial Sections on the Cover Glass


§ Sequence of serial sections
During serial sectioning, make sure that you know the sequence of the ribbons as well as the
start and the end point of the ribbons.
§ Positioning of serial sections on a cover glass
It is important to position the serial sections in the center of the cover glass. If the sections are
too close to the edge of the cover glass, it might happen that the objective touches the sam-
ple carrier during the image acquisition. This might happen particularly for immersion objec-
tives. The consequence will be that the focus map is not calculated in the correct way or im-
ages are out of focus.
§ More than one ribbon (serial section) on a cover glass
Take care that the single serial sections are not in close contact to each other, this might con-
fuse the numbering algorithm of the software and creates a wrong numbering.

8.3.3 Pre-Settings (Light Microscope)

Before you can work with the CAT module, you have to check the following settings on the light
microscope system (hardware and software settings). In general, the system is calibrated by a ser-
vice technician but we recommend checking the settings again, especially when you have
changed components, e.g. objectives or filter cubes. As these general settings are not described
here in detail, please ask your service technician, or read the ZEN Online Help.

§ Check Parcentricity and Parfocality


Note that the calibration of parcentricity and parfocality has to be done at the TFT display of
the microscope.
§ Check Camera Orientation and Stage Movement
Before checking the stage movement the correct camera orientation always has to be set first.
The camera orientation should match your view through the ocular of the microscope. If this
is not the case, you can change the camera orientation in the Camera tool.
To check the stage movement we recommend acquiring a tiles image and check if the tiles
are put together correctly. If this is not the case, you have to close ZEN software and open the
MTB 2011 software. There you must change the stage inversion in the configuration list un-
der Motorized Stage.
§ Perform Shading Correction
Before starting the CAT workflow a shading correction has to be performed in ZEN software.
Please read the corresponding chapter in the ZEN Online Help.

8.3.4 Experiment Settings

For working with the CAT module you need to set up an experiment in the ZEN software first. As
this is already described in the ZEN Online Help, we will focus here on the most important settings
which are essential for the CAT workflow:

§ In the menu Tools > Options > Acquisition > Acquisition tab the checkbox Enable Ad-
vanced Imaging Setup must be activated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 723


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

§ In the Imaging Setup tool Show All must be activated.


§ In the Imaging Setup tool Advanced Imaging Setup must be selected.
§ In the Imaging Setup tool in the light path display the following settings have to be ad-
justed:
– The Microscope Manager must be excluded from all settings. To exclude a setting, click on
the icon of the component/setting. You will see a menu where you can activate/deactivate
the checkbox Include in this Setting. If the checkbox is not activated, the component/set-
ting is excluded from the selected setting. Note that you have to select each Before/After
setting and check if the components are excluded or included and adjust it accordingly.
– The TL/RL Switch must be excluded from all settings.
– All TL/RL Shutters in the light path must be included in all settings. Note that icons of in-
cluded settings are highlighted in blue color.
– All light sources (TL/RL) within the light path must be included in all settings.
– The light intensity of the light sources for all settings must be the same (e.g. 2V).
§ In general for the Before Experiment and After Experiment settings adjust the following:
– All Shutters must be closed.
§ Example for Phase Contrast settings:
– For the Before TL Phase settings adjust the following:
- The TL Shutter must be opened.
- The RL Shutter must be closed.
– For the After TL Phase adjust the following:
- The TL Shutter must be closed.
- The RL Shutter must be closed.
§ Example for one Fluorescence Channel (here DAPI) settings:
– For the Before DAPI settings adjust the following:
- The TL Shutter must be closed.
- The RL Shutter must be opened.
– For the After DAPI adjust the following:
- The TL Shutter must be closed.
- The RL Shutter must be closed.

8.3.5 CAT Workflow

In this chapter you will find how-to guides describing the typical CAT workflow. The chapter is for
users who search for an introduction to the CAT module and workflow. Starting from general
preparations to the acquisition on the LM (light microscope), we will also explain how to acquire
images with the SEM (Scanning Electron Microscope). After the image acquisition we will focus
on the image alignment and correlation.
Please note that we will not explain how to set up an experiment in detail as this step is beyond
the scope of this guide which is focused mainly on the CAT workflow. Instead of that please read
the chapter Sample Preparation [} 723], where we describe the most important pre-requisites
for a CAT experiment. We will not take a look at the further processing of the resulting images as
well.

See also
2 Acquiring the LM image [} 729]
2 Acquiring the SEM Image [} 740]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 724


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8.3.5.1 Creating a New Sample

If you have configured your experiment in ZEN (e.g. a multi-channel experiment), the next step is
to create and select a sample. When you work with the software for the first time you, have to
create a new sample first.

Prerequisite ü You are in the Correlative Array Tomography tool.

1. Click on Select/Specify.
à The Select Sample dialog opens.

2. Click on the Add button under the List of specified samples.


à The New Sample dialog opens.
3. Enter the necessary sample information: Name, Description, Number of sample carriers,
Type of sample carrier and Section thickness.
4. Click on OK.
à The dialog closes. You will see the new sample in the List of specified samples.
5. Select the new sample from the list and click on OK.
You have created and selected a new sample.

Info
Note that specifying the correct number of sample carriers is important for the numbering of
the ribbons/sections afterwards. The sample information will be stored within the image data
and will be used for further image processing and data management.

8.3.5.2 Selecting the Sample Holder

Prerequisite ü You are in the CAT tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 725


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

1. In the Sample Holder section click on Select… to open the Select Template dialog and
to choose the correlative sample holder you want to use. Different types of correlative
holders are available, see Appendix Correlative Sample Holders [} 767].
2. In the Select Template dialog select the correlative holder you want to use. If you want to
use your own sample holders, click on the Add button below the list and follow the
instructions in the chapter Defining new sample holder templates [} 726].

3. Click on OK to close the dialog.


You can now continue with the calibration of the sample holder, as described in the chapter Cali-
brating the sample holder [} 727]. Note that the calibration of the sample holder is mandatory
to acquire images.

8.3.5.3 Defining a New Sample Holder Template

With this dialog you can define new correlative holders in addition to the existing holder tem-
plates. It is not mandatory to use correlative holders from ZEISS. User-defined correlative holders
with 3 fiducial markers can be used as well.

1. To open the dialog click on Add in the Select Template dialog. This dialog can be
opened via the Shuttle & Find tool.
à The New Template dialog opens.

2. Type in a name for the new holder or sample carrier. An image of the new holder can be
loaded as well.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 726


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

3. Insert the distances (in millimeters) between the first and the second marker and between
the second and third marker.
à The distances can be determined using the Stage Control dialog accessible via the Light
Path tool in Right Tool Area tab. We recommend doing this before starting the New
template dialog. Write down the distances to be prepared to enter them within the New
Template dialog.
à Activate the live view in the Center Screen Area by clicking on the Live button in the Lo-
cate tab.
à Navigate the stage manually to the calibration marker on the sample holder by means of
the joystick and note the x/y-coordinates of the marker.
à Repeat this procedure for all three markers and calculate the distances between marker 1
and marker 2 and between marker 2 and marker 3, respectively.

8.3.5.4 Calibrating the Sample Holder

Correlative sample holders have three fiducial markers enabling a three point calibration (signed
with the numbers 1-2-3) The calibration markers consist of one small (length 50 µm) and a large
L-shape marker (length 1 mm). The bigger marker is used for coarse orientation, whereas the
smaller marker is used for the calibration.

8.3.5.4.1 Preparing Calibration

1. Click on Live in the Acquisition tab to activate the live view in the Center Screen Area.
2. Navigate the stage manually to the first calibration marker on the sample holder (marked
with No. 1) by means of the joystick. It is enough if you move the stage to the larger L-
shaped calibration marker. The smaller marker will be detected automatically within the
Sample Holder Calibration Wizard. To locate the marker positions we recommend using
a dry objective with low magnification (5x – 20x).

3. Open the CAT tool.


4. Click on Calibrate… to open the Sample Holder Calibration Wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 727


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8.3.5.4.2 Setting Calibration Options

Fig. 50: Sample Holder Calibration Wizard Options


In step 1 of the wizard, the following options should be activated to follow our recommended
workflow:

1. Check if the Automatic movement to next marker checkbox is activated.


à This will automatically move the stage to the next marker position after you have con-
firmed the position of the marker and clicked on Next.
2. Check if the Use automatic marker detection checkbox is activated.
à The software will try to find the correct positions of each marker automatically.
3. If you need to change the marker color, or check if the marker orientation is set correctly,
activate the Use settings for marker detection checkbox to access these functions.
4. Click on Next to move to the next wizard step.

8.3.5.4.3 Performing Calibration

1. Click on Set to detect the first marker position.


à An automatic stage calibration will be performed. After the stage calibration, the system
will try to detect the marker position of the small marker automatically.
à A message appears which asks if the marker was detected correctly.
2. Click on Yes to confirm the message.
3. Click on Next to move to the next step of the wizard.
à The stage will automatically move to the next (coarse) marker position. If the stage
moves into the wrong direction, you can use the invert X/invert Y buttons to correct
the movement direction.
4. Repeat the previous steps and set marker position 2 and 3 accordingly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 728


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à After setting marker position 3 you will find a green check mark icon which shows that
the calibration was successful.

5. Click on Finish to save the calibration and close the wizard.


To check if the calibration was successful acquire an image and open the Tree view in the Center
Screen Area. There you should see the correlative calibration data in the list. If the Tree view is not
visible, go to Tools > Options > Documents and activate the Enable Tree View checkbox.

8.3.5.5 Acquiring the LM image

The image acquisition will be performed by the help of the Acquisition Wizard which is opened
if you click on Start Acquisition Wizard in the Correlative Array Tomography tool.
The wizard contains the following 7 steps:

§ Overview Imaging [} 729]


§ Ribbon Definition (optional) [} 730]
§ Ribbon Imaging (optional) [} 731]
§ Section Specification [} 733]
§ ROI Specification [} 736]
§ ROI Imaging [} 738]
§ Re-Shoot (optional) [} 739]

8.3.5.5.1 Acquiring the Overview Image

Info
Take care that the Auto checkbox on the Dimensions tab is deactivated.

Prerequisite ü You have started the Acquisition Wizard via the CAT tool.
ü You are in step 1/7 Overview Imaging.
1. Check if Image Acquisition mode is selected. This is the default setting when entering the
wizard.
2. From the Experiment dropdown list select the experiment that you have prepared in ad-
vance.
3. From the Objective list select an objective with a low magnification, e.g. 5x.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 729


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

4. Select the Channel and the Light Source you want to use for acquiring the overview im-
age. For the overview image we recommend selecting Phase contrast as channel mode.
5. Move the stage to the upper left corner of your sample.
6. Click on Set start position to define the starting position of the overview image.
7. Move the stage to the bottom right corner of your sample.
8. Click on Set end position to define the end position of the overview image.
9. Click on Acquire Overview Image.
à The overview image will be acquired. Then you should see the complete sample showing
all ribbons you want to image.

10. Click on Apply Stitching to remove the offset between the single tile images.
You have successfully acquired the overview image. You can now continue with the next step by
clicking on Next.

8.3.5.5.2 Defining the Ribbons

Info
When no detailed sample information is necessary to identify regions of interest within the
sections, you can skip this step and the following step 3 Ribbon imaging as well. You can then
go on with the wizard step 4 Section specification [} 733].

Prerequisite ü You are in step 2/7 Ribbon Definition of the Acquisition Wizard.
1. Use the tools on the Ribbon Definition tab to mark the contour lines of the ribbons which
should be imaged. The contour lines are displayed in yellow color.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 730


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à The software will automatically create as many tiles as necessary for imaging the ribbons.
The number of the tiles depend on the selected objective. The frames of the tiles will be
displayed in red color.

2. When you have marked the contours, click on Next.

8.3.5.5.3 Imaging the Ribbons

Please note that this is an optional step and must be performed only when you have defined rib-
bons as described in step 2. In summary, you have to perform the same actions mentioned in step
1 but you should use an objective with higher magnification and apply the Global focus strategy
under Focus Surface.

Prerequisite ü You are in step 3/7 Ribbon Imaging.


1. Under Objective select an objective with a higher magnification than for the overview im-
age, e.g. 10x. The objective should enable you to clearly recognize the structures of interest
on your sample.
2. Under Focus Surface select Global (all Regions/ Ribbons).
3. Click on Distribute Support Points....

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 731


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à The support points will be distributed automatically over the ribbons. They are displayed
as yellow circles with a point in the middle.

4. If required, you can add further support points by using the Add button below the
Distribute Support Points button. Simply click on the image at the position where you
would like to add another support point.
5. Click on Verify Support Points.
à Now you can check if each support point is
in focus. You will see the overview image in
the right image container and the detail im-
age in the left image container. The verifica-
tion process will start with the first support
point which was set. The current support
point is marked with a red crosshair. When
you activate Show stage position within
the image on the Ribbon Definition tab
below the Center Screen Area you will see
the current position of the stage in the im-
age as a rectangle with a blue dashed frame.
6. Hold CTRL on your keyboard and use the mouse wheel to adjust the focus for the corre-
sponding support point.
7. When the support point is in focus click on Confirm.
à The software will automatically move to the next support point.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 732


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8. Repeat the last two steps until you have corrected and verified all support points. At the
end of the process you will see the message All points have been verified.

9. Click on Create Ribbon Image.


à The ribbon image will be generated. Note that each ribbon will be displayed as one
scene.
10. Again we recommend clicking on Apply Stitching to remove the offset between the single
tile images.
You have successfully acquired the ribbon image and can now continue to the next step by click-
ing on Next.

8.3.5.5.4 Specifying the Sections

In this step all sections will be identified by using a section detection algorithm. In summary, you
have to mark the outline of at least one section on each ribbon. Then the section detection algo-
rithm will detect the sections of the ribbon automatically. If the automatic section detection does
not work properly or if not, all sections are detected, you can stamp in the missing sections. It is
also possible to edit the shape, location and orientation of the section frames afterwards.

Prerequisite ü You are in step 4/7 Section Specification.


1. On the Section Definition tab select the Polygon tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 733


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

2. Mark the outline of one section in each ribbon. The outlines of these reference contours are
displayed in orange color.

3. Click on Apply.
à The software will try to detect the remaining sections automatically. When finished the
detected sections appear in green color.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 734


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

4. If not all, sections can be detected, mark the last section which was detected and click on
the Stamp tool in the Section Definition tab.
5. Stamp in the missing sections so that each section is marked.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 735


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à Please take your time to check the numbering carefully. A correct numbering is prerequi-
site for a successful alignment of the sections, afterwards. The numbering of the ribbons
depends on how you deposited the ribbons during the cutting. To adjust the numbering
you have several options available in the context menu. To open the context menu move
the cursor over a section and right-click with the mouse.

6. If the numbering is correct, proceed to the next wizard step by clicking on Next.

8.3.5.5.5 Specifying the ROIs

Prerequisite ü You are in step 5/7 ROI Specification.


1. On the ROI Definition tab select the desired tool for marking a ROI, e.g. Rectangle or Cir-
cle.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 736


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

2. Mark the desired ROIs in one section. Marked ROIs will be displayed in purple color.

3. Click on Apply.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 737


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à The software will position the defined region of interests in each section according to
section contours. The detected ROIs then appear on each section of the ribbons.

If the ROIs are detected correctly, proceed with the next wizard step by clicking on Next.

8.3.5.5.6 Imaging the ROIs

In this step we will image the ROIs using a high magnification objective and apply a local focus
strategy. This will result in very detailed and sharp images of the ROIs which are used for the fur-
ther processing (e.g. creating Z-Stacks and image correlation with SEM images).

Prerequisite ü You are in step 6/7 ROI Imaging.


1. Under Objective select an objective with a high magnification, e.g. 63x.
2. If you are using fluorescence samples, you can now activate the corresponding fluores-
cence channel.
3. Under Focus Surface select Local (per Region or Ribbon).
4. Click on Distribute Support Points.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 738


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à According to the step 3 Ribbon Imaging the support points will be distributed automat-
ically. The support points are distributed alternately outside and inside a ROI to guaran-
tee best focusing results.

5. Click on Verify Support Points.


à The software will guide you through the process in the same way you were been guided
in step 3 Ribbon Imaging.
à If you have verified all existing support points, the message All points have been veri-
fied will appear.
6. Click on Acquire Images.
The ROIs will be imaged now. You can use the next step to check each image of the ROIs and re-
acquire (re-shoot) images from ROIs which do not fit your expectations. To proceed with the next
step click on Next.

8.3.5.5.7 Re-Shooting ROIs

This step is basically used for re-acquiring images from ROIs that are out of focus.

Prerequisite ü You are in step 7/7 Reshoot.


1. Check if the Select Tiles mode is activated. This mode should be selected by default when
entering this step.
2. You can use the arrows on each side of the image to navigate through the ROI series or the
Z-Position slider on Dimensions tab.
3. Select an image you want to re-acquire by clicking on it with the left mouse.
à The image will be displayed with a dashed green frame.
4. Continue with checking the images and selecting the images you want to re-acquire.
5. When you have selected all images to re-acquire click on Acquire.
à The software will move to the first image which you have selected.
6. Adjust the focus and click on Snap.
7. Click on Replace to replace the old image with the new one.
à The software will automatically move to the next selected image to be re-acquired.
8. Continue until you have re-acquired all selected images.
9. Click on Finish.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 739


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

You have successfully completed the Acquisition Wizard for the light microscope images of your
ribbons. Continue with the process described in the next chapter of this guide.

8.3.5.6 Preparations for the SEM Image

Prerequisite ü You have acquired the LM image according to the instructions in the chapter Acquiring the
LM image [} 729].
ü You have copied/transferred the image data of the light microscope to the SEM PC.
1. Start the Smart SEM software. Note that the SEM software is used for setting up the ac-
quisition parameters, e.g. detector settings, magnification, display settings and scan speed.
2. Start the ZEN SEM software. Please take care that before you start ZEN, SmartSEM was
started.
à You will see the SEM Acquisition tab and the Correlative Array Tomography (CAT)
tool.

3. In the CAT tool click on Select/Specify ...


4. Select the sample file which you have created during the LM acquisition. It should be lo-
cated in the LM folder which was generated automatically.
5. Select the sample holder you are using for your sample.
6. Calibrate the sample holder like described in the chapter Calibration.
You have successfully finished the general preparations. You can now continue with the acquisi-
tion of the SEM image.

8.3.5.7 Acquiring the SEM Image

Prerequisite ü You have done the general preparations, see Preparations for the SEM Image [} 740].
1. In the CAT tool click on Start Acquisition Wizard.
à You will see the first step Overview Imaging of the wizard.
2. Click on Load Image.
3. Select the image file containing the ROIs from the CAT/LM folder on your file system.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 740


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à You will see the image containing the ROIs.

4. Click on Next.
à The wizard will now jump directly to step 6/7 ROI Imaging as the software recognizes
the marked ROIs in the image file.
à Before starting to acquire the ROIs we recommend to perform the offset correction.
Therefore proceed as follows:
5. In the ROI image click on a position with a prominent structure.
à The stage will move to that position automatically. Now you may recognize a difference
between the position you have clicked on and the actual position. This is the offset we
want to correct now.
6. Activate the offset correction checkbox.

à The controls for the offset correction will appear.


7. Click on Define 4 points in image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 741


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à The 4 correction points are distributed automatically within the image. The correction
points look like the support points (red outline with a red dot in the middle).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 742


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8. Move the correction points to prominent positions on the sample containing structures
which are easy to recognize, e.g. the corner of the ribbons.

9. Click on Set correction offset. Note that for setting the offset correction you should use
the same magnification which will be used for image acquisition later.
à The stage moves to the first correction point.
à In the left image you will see the SEM image position. In the right image you will see the
correction point on the LM image. The positions do not match exactly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 743


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

10. Move the SEM stage so that its position will match the correction point in the LM image.

11. If the positions do match, confirm the message by clicking OK.


à The stage will move to the next correction point automatically.
à Repeat the last 3 steps for the remaining correction points.
à If you have finished the offset correction, you should continue with verifying the support
points again. As this is exactly the same procedure like described for the LM acquisition,
read the chapters Imaging the Ribbons [} 731] and Imaging the ROIs [} 738]. Note that
you must use the control panel for the SEM to adjust the SEM parameter.
12. After you have verified the support points click on Acquire.
The ROIs will be imaged with the SEM now. Depending on your experiment settings this can take
some time.

8.3.5.8 Aligning the Z-Stack Image

The wizard contains the following 6 steps:

§ Image Import
§ Pre-Processing
§ Image Review
§ Alignment
§ Manual Correction
§ Final Image Creation
1. In the CAT tool click on Start Z-Stack Alignment Wizard.
à You will see the first step Image Import of the wizard.
2. Click on Load Image and select the acquired Z-Stack image from the file system. In our ex-
ample we choose the LM image. The same process has to be performed for the SEM image
afterwards.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 744


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à You will see the Z-Stack image in the center screen area.

3. Click on Next.
à You will see step 2/6 Pre-Processing.
4. If your image is a tile image, click on Apply Stitching to correct the offset between the in-
dividual tiles.
5. If your image is a SEM image, click on Histogram Equalization to adjust the image dis-
play.
6. Click on Next.
à You will see step 3/6 Image Review. Note that in this step no image acquisition is possi-
ble. You can just replace an image by the next or previous image of the Z-Stack.

7. Select the image to be replaced by clicking on it with the mouse and click on Replace with
next or Replace with previous. Alternatively, you can press the N or the P key. Note that
the table of the replaced image will not be saved.
8. Click on Next.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 745


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

à You will see step 4/6 Alignment.

9. If you have acquired a multi-channel image, select the reference channel from the Channel
list.
10. Click on Start Alignment.
à The alignment of the Z-Stack image will be performed automatically. After the alignment
you will see the original Z-Stack image in the left image and in the right image you will
see the aligned Z-Stack image.
11. Click on Next.
à You will see step 5/6 Manual Correction.
à If you browse through the Z-Stack by using the Z-Position slider and you still realize a
shift between the single Z-Stack images, you can perform a manual correction of the sin-
gle Z-Stack images. Therefore continue as follows:
12. Click on Define direction.
à A red arrow will appear in the right and in the left image.
13. Place the arrow in the left image at a prominent structure in the image which is easy to rec-
ognize through the full Z-Stack.
14. Select the right image and browse through the Z-Stack by using the Z-Slider on the Dimen-
sions tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 746


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

15. When you realize a shift in an image, adjust the arrow in the right image so that it matches
with the prominent structure marked with the arrow in the left image. Note that you have
to check and adjust the arrow for each image of the Z-Stack which does not match the po-
sition.

16. Click on Apply.


à The correction will be applied. If you want to correct the Z-Stack at another position,
simply repeat the procedure with another prominent structure. Of course you can undo
and redo actions by using the Undo/Redo buttons.
17. Click on Next.
à You are in step 6/6 Create final Z-Stack.
18. If you want to create the Z-Stack image from the complete image, select Total and click on
Create final image.
19. If you want to create the Z-Stack image from the marked ROIs, select ROI. Note that you
can adjust the marked ROI in its size and position here. If you have marked more than one
ROI, you can switch between the ROIs by using the Scene slider on Dimension tab.
20. Click on Create final image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 747


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

You have successfully aligned and created the Z-Stack image. Of course you have to repeat the
process for the SEM image that was acquired.

8.3.5.9 Correlating the LM and SEM images

The wizard contains the following 4 steps:

§ Import Z-Stacks
§ Correlation
§ Manual Correction
§ Create Final Correlation Image
1. In the CAT tool click on Start Correlation Wizard.
à You will see the first step Import Z-Stacks.
2. Click on Left Container to load the aligned Z-Stack image from the SEM.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 748


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

3. Click on Right Container to load the aligned Z-Stack image from the LM.

4. Click on Next.
à You will see step 2/4 Correlation.
5. Under Transform decide whether you want to transform the Left Z-Stack into the Right
Z-Stack or vice versa.
6. Under Mode select 4 Points.
7. Click on Set Points.
8. Set the first 3 correlation points in the first Z-Stack image of the left image.
9. Set the corresponding 3 correlation points in the first Z-Stack image of the right image.
à After the third point in the right image was set, the software automatically jumps to the
last Z-Stack image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 749


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

10. Set the fourth correlation point in the left image first and then set it in the right image.

11. Click on Create correlated Z-Stack.


à The correlated Z-Stack image will be generated and displayed in a separate image con-
tainer.

12. Click on Next.


à You will see step 3/4 Manual Correction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 750


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

13. In this step you can manually correct the alignment of the images by moving and/or rotat-
ing the images according to each other. To rotate the image use the handle at the top of
the image frame. To move the image simply left click on the image and hold the mouse
button pressed while moving the image.

14. If you finished the alignment of an image click on Accept. You can browse through the
correlated Z-Stack images by using the Z-Position slider in the Dimension tab.
15. Click on Next.
à You will see step 4/4 Create Final Correlation Image.
16. Click on Create Final Z-Stack.
à The correlated Z-Stack image will be created.

17. Click on Finish to exit the wizard.


You have successfully created a correlated Z-Stack image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 751


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8.3.6 CAT Tool

Using this tool you can calibrate and manage the sample holders and start the wizards which are
used for acquiring images from serial sections, generating Z-stack images out of the single images
and correlate two Z-Stack images from the light microscope (LM) and the scanning electron mi-
croscope (SEM).

Parameter Description
Sample Name Displays the name of the sample.

Select/Specify... Opens the Select Sample Dialog [} 752].


There you can select a sample data sheet from the list or specify a
new sample with user specific information. The specified sample infor-
mation will be used for image processing (i.e. Z-Stack alignment) or
for data management.

Sample Holder Displays the name of the selected sample holder.

Select... Opens the Select Template dialog. There you select the preferred
sample holder or define new holder templates, see Selecting the sam-
ple holder.

Calibrate... Opens the Sample Holder Calibration Wizard [} 753]. There you can
calibrate the selected sample holder.

Apply to Image Only visible if the Show All mode is activated.


Use this button only when you forgot to calibrate the holder
before you acquire the image.
Applies a calibration to an acquired image. Do not remove the sample
from the correlative holder between image acquisition and calibra-
tion. Exception: correlative markers are on the sample holder.

Start Acquisition Starts the Acquisition Wizard. For more information see Acquisition
Wizard Wizard [} 756].

Start Z-Stack Starts the Z-Stack Alignment Wizard. For more information, see Z-
Alignment Wizard Stack Alignment Wizard [} 763].

Start Correlation Starts the Correlation Wizard. For more information, see Correla-
Wizard tion Wizard [} 765].

8.3.6.1 Select Sample Dialog

Here you can select or create a sample data sheet.

Parameter Description
Folder Shows the location, where the files are saved.

If you click on the button, you can change the storage location.
The default path and folder is
C:\Users\user\Pictures\CAT Samples.
Within this folder, each sample is saved in a sub-folder. Images taken
during image acquisition within the CAT Acquisition Wizard will be
saved within the sub-folder automatically.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 752


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
For a better clarity sub-folders with the name „[Date][Time]“ will be
generated when another CAT run is started within the CAT acquisition
wizard. In case the file name will exceed a certain number of charac-
ters the name will be shortened using the sign „°“.

List of specified Shows the samples which are already specified within the software.
samples
If you select a sample in the list and click OK, the sample will be used
in your experiment.

If you click on the button, the New Sample dialog opens.


There you can create a new sample definition which will be added to
the list, see Creating a New Sample [} 725].
If you click on the Options button, you will see further options for
managing samples like Show/Edit or Refresh Sample List.

Information Shows the specified sample information, e.g. name, description, num-
ber of sample carriers, sample carrier, and section thickness.

See also
2 CAT Tool [} 752]

8.3.7 Sample Holder Calibration Wizard

With the Sample Holder Calibration Wizard you calibrate the selected correlative sample holder.
Make sure that you have selected the desired sample holder, see Selecting the sample holder.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 753


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8.3.7.1 Step 1: Options

Fig. 51: Sample Holder Calibration Wizard Options

Option Description
Save marker images Activated: the marker images are saved during the calibration.
The images can be used to check the calibration afterwards. Click
on the Select Folder (...) button to select a storage folder.

Move the stage to load Activated: the stage will move to load position before moving
position before x/y to the next correlative calibration marker.
movement
In case of using an AxioObserver, the objective revolver moves to
load position.

Automatic movement Activated: By clicking on the Next button, within the wizard the
to next marker stage moves automatically to the next calibration marker.
Deactivated: You must use the joystick to navigate to the mark-
ers. This is necessary when using a correlative holder which has
no holder data deposited.

Use Autofocus at each This option is active only if the Automatic movement to next
marker position marker position checkbox is activated.
Activated: the focus is adjusted automatically after moving to
the next marker position.

Use automatic marker Activated: The software will detect the small calibration marker
detection automatically.

Use settings for marker This option is active only if the Use automatic marker detec-
detection tion checkbox is activated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 754


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Option Description
Activated: shows settings for marker detection (see description
below). Here you select the properties of the calibration markers.

Settings for marker detection


Only visible if the Use settings for marker detection checkbox is activated.

Option Description
Threshold marker de- A low threshold for marker detection is used when the dimen-
tection: high – low sions of the correlative L markers cannot be recognized precisely,
e.g. when the sample holder is slightly filthy.

Marker color Here you select the color of the markers displayed in the live im-
age.
White: the marker is displayed white on a dark background.
Black: the marker is displayed dark on light background.
Auto: the marker color is set automatically.

Marker orientation Here you need to set the orientation of the L-markers on your
sample holder. Click on the corresponding button to select the
orientation of the calibration marker which you can see in the
live image

If you click on the Next button, you will move to the next step of the wizard.

8.3.7.2 Step 2-4: Calibration

In steps 2-4 of the wizard you will be guided through the calibration procedure.

Fig. 52: Sample Holder Calibration Wizard

Option Function
Holder position Move to Position 1 button

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 755


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Option Function
Moves the stage to marker position 1. This is possible only if the
first position was set before and x/y coordinates are given.
Current button
Only visible for marker position 2 and 3.
Moves the stage to the current marker position. This is possible
only if the current position was set before and x/y coordinates
are given.

Stage movement to the Here you can change the movement of the stage in x or y direc-
next marker tion. This is necessary if during calibration the stage moves in the
wrong direction.

Marker position By clicking on the Set button, the actual marker position will be
confirmed.

Click Finish to leave the wizard.

8.3.8 Acquisition Wizard

This wizard is used to image the serial sections or user-defined region of interest within the sec-
tions.
The steps Overview Imaging, Ribbon Imaging, ROI Imaging and Re-Shoot are image acquisi-
tion steps. The step Re-Shoot gives you the opportunity to image parts of the ROI-series or tiles
of a tile image, later.
The wizard consists of 7 steps which are described in the following chapters:

§ 1/7 Overview Imaging [} 756]


§ 2/7 Ribbon Specification (optional) [} 759]
§ 3/7 Ribbon Imaging (optional) [} 759]
§ 4/7 Section Specification [} 759]
§ 5/7 ROI Definition [} 761]
§ 6/7 ROI Imaging [} 762]
§ 7/7 ReShoot (optional) [} 762]

8.3.8.1 Overview Imaging

In this step you can acquire an overview image that allows navigation on the sample. You will see
the positions of the serial sections on the sample carrier. In general, for the overview image an
objective with low magnification is used. This makes the acquisition fast due to a large field of
view and limited number of tiles.
Image acquisition with objectives with higher magnification is possible, but keep in mind that the
number of tiles will increase due a smaller field of view as well as the acquisition time.

Info
We recommend using phase contrast images for the acquisition. The used algorithm for the
automatic section specification, see step 4, is most reliable then.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 756


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
Image Acquisition/ By selecting the corresponding button, you can decide whether to ac-
Load Image quire an overview image or load an image.

Image Selection If you have selected Load Image, a saved image file from the file sys-
tem can be chosen. Therefore simply click on the button and nav-
igate to your image file.
The wizard will jump to the wizard step according to the information
saved within the loaded image.

Experiment If you have selected Image Acquisition, you have to select an experi-
ment from the Experiment list.
Note that the experiment has to be set up and saved in advance be-
fore you enter the wizard.

Objective Here you can select the objective that you want to use for the acquisi-
tion of the overview image. As mentioned before, we recommend us-
ing an objective with a low magnification (e.g. 2.5x or 5x).

Channels Here you can select the channels that you want to use for the acquisi-
tion of the overview image.
You can use more than one channel in one run, when your micro-
scope is equipped with a motorized condenser.

Selected Light Here you can select the light source that you want to use for the ac-
Source quisition of the overview image.
The light intensity can be adapted if a corresponding light source is
selected.

Camera Settings Here you can adapt the camera settings like changing the exposure
time or activating/deactivating the shading correction.
If a shading correction has been performed and activated in the se-
lected experiment, the checkbox will also be activated automatically
in the wizard.

Software Autofo- Here you can activate the Software Autofocus functionality and apply
cus it to the overview image.
If activated, you can select the positions for focusing. During focusing
no live image will be visible.
Note that sensitive fluorescence labels might be bleached during the
autofocus process.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 757


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
Overview Image Here you can define the size of the overview image by defining a start
Definition and end position.

The software will calculate the area by means of the defined start and
end position (= overview image). The number of tiles and the memory
used will be displayed below the buttons.

- Set start posi- Sets the current stage position as start position of the image area.
tion

- Set end posi- Sets the current stage position as end position of the image area.
tion

- Move to start Moves the stage automatically to the defined start position. Note that
position the start position has to be defined before.

- Move to end Moves the stage automatically to the defined end position. Note that
position the end position has to be defined before.

No. of sample car- Only active if you use more than one sample carrier for one correlative
rier Z-Stack.
Here you have to select the number of the used sample carrier. The
total number of used sample carriers was defined in the CAT tool un-
der Select/Specify sample.

Move the stage to Activated: the stage will move to load position before moving to the
load position be- next correlative calibration marker.
fore xy movement
In case of using an AxioObserver, the objective revolver moves to load
position.

Acquire Overview Starts image acquisition. The acquisition can be stopped in between.
Image Then the button will change to Restart. Before you restart the image
acquisition, you can modify the settings.
The status of the image acquisition is shown in the status bar of the
software.
After the overview image is taken, the image can be stitched. If you
click on the Apply Stitching button, stitching will be carried out.

Next Brings you to the next wizard step.

See also
2 Ribbon Definition [} 759]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 758


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

8.3.8.2 Ribbon Definition

This step is an optional step. It allows to image the ribbons with an objective with higher magnifi-
cation, if necessary. E.g. when you would like to define the regions of interest by means of the
sample structure that can only be identified using lenses with higher magnification.
Therefore you can mark the outlines of the ribbon on your sample. If you cannot see the sample
structures, due to the overview image was acquired with a too low magnification, you can image
your sample again using a higher magnification.
For marking the outlines in the image use the tools from the Ribbon Definition tab (e.g. Rectan-
gle, Circle or Polygon).

See also
2 Ribbon Imaging [} 759]

8.3.8.3 Ribbon Imaging

For this step, a split view will appear. On the left side you see the Live image. On the right side
you see the overview image with the defined ribbons.

Info
To modify either the Live image or the image with the defined ribbons click on the correspond-
ing container. The activated container will be marked with a white frame.

Again, like in step one for the overview image, you have to select the objective, channel, light
source and adapt the exposure time. Additionally, you have to generate a focus surface to ensure
that your sample will be in focus during the image acquisition.
If you click on the Create Ribbon Image button, the ribbon image will be acquired.

See also
2 Section Specification [} 759]

8.3.8.4 Section Specification

To determine the positions of regions of interest (ROIs) within the sections, you have to define the
sections. The section lines generate the reference system for the ROI positions. The sections are
marked and outlined with a frame.

Info
Note that you must mark one section on each ribbon. Meaning when your sample has three
ribbons, three sections have to be marked overall.

We recommend using phase contrast images for the section specification. The algorithm used for
the automatic section specification is most reliable when using phase contrast images. When
bright field images are used, the algorithm might be suboptimal. In that case you have the oppor-
tunity to add and to move the section contours manually.
On the Section Definition tab you will find tools and options for creating sections in the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 759


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
Reference Section

- Select Activates the selection mode (default).

- Contour By selecting this mode, you can mark a contour line of a section.

- Keep Keeps the selected tool active. You can then use the tool several times
without interruption.

- Step Back- Undo the last step


ward

- Step Forward Repeats the last step.

- Delete Deletes a selected graphical element.

Section Index Here you can determine the starting number of the ribbons. This is
important when the ribbons of a sample are deposited on more than
one sample carrier.

Selected Channel Shows the selected channel which is used for the detection.

Detection Sensitiv- Here you can adjust the detection sensitivity from Low to High by us-
ity ing the slider.
This will be done by modifying the contrast thresholds for the section
detection algorithm.
When setting a low sensitivity, sections will be recognized even if the
contrast between the section and the substrate is low; disadvantage:
sections will be recognized, even in areas where no serial sections are
deposited.
When setting a high sensitivity, the algorithm only recognizes sec-
tions, if there is a high contrast between section and substrate. If not,
all sections were recognized, you have the possibility to copy section
contours or to stamp section contours.

Section Detection

- Apply Starts the section detection on the sample. The software tries to de-
tect each section within the ribbon.

Contrast Method

- Auto Auto is used by default. The system recognizes the contrast method
of the image automatically.

- Ph. Contrast Applies the phase contrast method. Even if you are using a brightfield
image, phase contrast will be applied as contrast method.

- Brigthfield Applies the brightfield contrast method. Even if you are using a phase
contrast image, brightfield will be applied as contrast method.

Use Internal Struc- Activate this checkbox only when sample structures are clearly visible
ture within the sections.
If activated, sample structures are used for section detection, addi-
tional to contrast differences between sections and substrate.
In case that sections are not detected properly, you have the possibil-
ity either to stamp section contours or to copy section contours.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 760


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
Post Definitions

- Stamp tool By selecting this tool, you can stamp in undetected sections after the
section detection is finished.
Therefore simply select the tool and move the mouse cursor in the
area nearby the last detected section. The cursor will change to a
stamp icon and you will be able to stamp in the missing section con-
tours.

- Accept Ref. If you click on this button, reference contours will transform into sec-
Section tion contours.

When the section detection is finished, you have different options for sorting the sections accord-
ing to your needs, if necessary. Therefore right-click on the detected sections. You will see a con-
text menu with the following sorting options:

Parameter Description
Sort § Sort all sections in reverse order
Sorts all sections which have a section contour. The initial section
with number 1 becomes the last section, the last section becomes
the first section with the number 1
§ Sort selected Ribbon elements in reverse order
Sorts the selected sections on a ribbon. The initial section with
number 1 becomes the last section, the last section becomes the
first section with the number 1

Copy selected sec- Copies the selected sections.


tions from here

Copy selected Rib- Copies all section contours on the selected ribbon.
bon sections from
here

Paste Section(s) to Pastes the section contours (selection of certain section contours or all
here sections of a ribbon) to the selected position.

Exchange number- Exchanges the numbering of selected sections on different ribbons.


ing of selected
Ribbon sections

Highlight Related Highlights selected sections on a ribbon.


Ribbon Sections

Merge two Ribbon Merges sections on two different ribbons to one.


Sections

See also
2 ROI Specification [} 761]

8.3.8.5 ROI Specification

In this step you can screen your sample for interesting sample regions (ROIs) and mark this area by
a graphical element. You can define several regions of interest within in one section.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 761


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

On the ROI Definition tab you can draw either a rectangle, a circle or a freehand polygon/con-
tour. Click on the Apply button to automatically identify the region of interest in all other sec-
tions. It is also possible to Undo/Redo an action using the corresponding buttons. To remove a
graphical element select it and click on the Delete (bin icon) button.

Info
With the arrow keys on your keyboard you can jump from one ROI to the next ROI along the
series to check if the structure of interest is still within the defined region of interest.

See also
2 ROI Imaging [} 762]

8.3.8.6 ROI Imaging

With this step you can image the ROIs which are detected and marked in the previous step. The
tile images will be generated from all defined region of interests automatically.

Info
The size of the snapped tile images of a ROI series can change due to the number of tiles
which are necessary to image the defined region of interest. The number of tiles can vary due
to the bending of the ribbon.

See also
2 Re-Shoot [} 762]

8.3.8.7 Re-Shoot

This step is helpful if some tiles or regions of interest are blurry. These tiles/regions can be re-
placed by repeating the acquisition of the selected tiles or tile images. The procedure is as follows:

§ Select all blurry tiles first.


§ Adjust the focus for each tile position.
§ Take new images.

Parameter Description
Select Tiles If this mode is active, you can select the tiles which you want to re-
shoot.
Use the Z-Position slider under Dimension tab or the arrows within
the Image area to scroll through the acquired images.
If you found a tile image that you want to re-shoot, simply click on it.
Then the color of the image frame turns from red to green.
Note that all tiles or blurry regions have to be defined before the im-
age acquisition can be repeated.

Acquire If this mode is active. you can acquire the selected tiles again after the
focus was adjusted manually.
If you click on this button, the stage will move to the first tile and the
following buttons will appear:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 762


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
- Snap Acquires a new image.

- Replace Replaces the old tile by the new tile.

- Correct In case the tile is brighter or darker, here you have the possibility to
Brightness adapt the brightness of the tiles image.

Click Finish to exit the wizard.

8.3.9 Z-Stack Alignment Wizard

This wizard is used to align the single images of a Z-Stack image. The wizard consists of 6 steps
which are described in the following chapters:

§ 1/6 Image Import [} 763]


§ 2/6 Pre-Processing [} 763]
§ 3/6 Image Review [} 764]
§ 4/6 Alignment [} 764]
§ 5/6 Manual Correction (optional step) [} 764]
§ 6/6 Final Image Creation [} 765]

8.3.9.1 Image Import

In this step you can load your acquired Z-Stack images which you want to align. Therefore simply
click on the Load button and select the image file from the file system.

See also
2 Pre-Processing [} 763]

8.3.9.2 Pre-Processing

In this step you can perform pre-processing functions on the loaded image, e.g. Stitching (only for
tile images), Brightness and Contrast Correction (only for SEM images).

Parameter Description
Apply Stitching Only visible if a tile image is loaded.
button
If you click on this button, stitching is performed automatically on the
image. The stitching can be canceled (Undo) or repeated (Redo) by us-
ing the arrow buttons.

Clip Limit Reduces noise in the image. The higher the Clip Limit , the lower the
noise. The clip limit can be adjusted between 0 and 10%.

Region Size Defines the region for histogram equalization. The smaller the area,
the higher the contrast, but the noise will increase, too. The Region
Size can be adjusted from 16 to 1024 px.

Histogram Equal- If you click on this button, the SEM images are adapted to the se-
ization lected values. The Histogram Equalization can be canceled (Undo) or
repeated (Redo) by using the arrow buttons.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 763


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

See also
2 Image Review [} 764]

8.3.9.3 Image Review

This step is used for reviewing the single images of a Z-Stack. This is necessary because certain im-
ages might not be useful for 3D reconstruction due to problems during the image acquisition or
sample preparation issues (wrinkles or ruptures within the section). These regions can be replaced
either by the previous image or by the following image. To review the images, the images can be
displayed as single 2D images in the 2D view or as images series in the Gallery view.

Parameter Description
2D View If selected, you can review the single images of a Z-Stack image by us-
ing the 2D view.
You can use the Z-Position slider to navigate through the single im-
ages.
To replace an image select the image and click whether on the Re-
place with next or Replace with previous button.
If you click on the Undo button, the last action performed will be un-
done.

Gallery View If selected, you can review the single images by using the Gallery
view. The single images of a Z-Stack image are displayed as an image
gallery.
If you found an image that does not meet your expectations, simply
select the image and replace it by the next or previous image.

See also
2 Alignment [} 764]

8.3.9.4 Alignment

In this step you perform the image alignment. Therefore simply click on the Start Alignment but-
ton. To cancel the alignment click on the Stop button.

Info
Before you start the alignment, select one channel as reference channel (e.g. DAPI, because it
stains the nucleus and the nucleus is a proper structure for performing alignment).

During alignment, a splitter view is visible. In the left container you can see the original images, in
the right container you can see the aligned images.

See also
2 Manual Correction [} 764]

8.3.9.5 Manual Correction

In this step (optional) you can navigate through the aligned images and check the result of the
alignment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 764


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

In case the results are unsatisfactory, you have the possibility to correct the alignment of the im-
ages manually. Misalignment can occur when no characteristic structures are visible within the im-
ages.

See also
2 Final Image Creation [} 765]

8.3.9.6 Final Image Creation

Last but not least, in this step you create the final image.

Parameter Description
Total If selected, the complete image will be used for the image creation.

ROI If selected, only the ROI area will be used for the image creation.

Create final image Creates the final aligned Z-Stack image.


button

Click Finish to exit the wizard.

8.3.10 Correlation Wizard

This wizard is used to correlate a Z-Stack image from the Light Microscope (LM) with the Z-Stack
image from the Scanning Electron Microscope (SEM). The wizard consists of 4 steps which are de-
scribed in the following chapters:

§ 1/4 Import Z-Stacks [} 765]


§ 2/4 Correlation [} 765]
§ 3/4 Manual Correction [} 766]
§ 4/4 Create Final Correlation Image [} 767]

8.3.10.1 Import Z-Stacks

In this step you can import the aligned Z-Stack images from the LM and the SEM, e.g. the Z-Stack
image from the LM in the left container and the Z-Stack image from the SEM in the right con-
tainer.
If you click on the Left Container button, the image is opened in the left image container.
If you click on the Right Container button, the image is opened in the right image container.

See also
2 Correlation [} 765]

8.3.10.2 Correlation

In this step you correlate the images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 765


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Parameter Description
Transform Here you select which Z-Stack will be transformed. During transforma-
tion, a pixel in the overlay image of the Z-Stack is calculated by using
pixels of the two original images that shall be overlaid/merged.

Interpolation Here you can select one of the following interpolation methods:

- Nearest The gray value of the resulting pixel in the overlay image is made of a
Neighbor pixel which is located next. This interpolation method is very fast.

- Linear The resulting or calculated pixel in the overlay image is assigned to a


gray value, which is the result of a linear combination of gray values
derive from pixels located nearby (in the original image).

- Cubic The calculated pixel in the overlay image is assigned to a gray value,
which is calculated by means of a polynomial function using gray val-
ues of pixels in the original images; these pixels are located nearby the
calculated pixel.

Mode Here you can choose an algorithm mode:

- 3-Points If selected, this mode enables you to set 6 correlation points after
clicking on the Set Points button (3 points in each Z-Stack in each
container).

- 4-Points If selected, this mode enables you to set 8 correlation points after
clicking on the Set Points button (4 points in each Z-Stack), 3 points
in the first z-section, the last point in the last section.

Correlation Points If you click on the Set Points buttons, you can set the correlation
points.
The number of correlation points is according to the selected algo-
rithm. The cursor will change to a pipette symbol. Simply click in the
image to set the points. Start with setting the first three points in the
left container then set the corresponding correlation points in the
right container. If a correlation point is set, a check mark icon will ap-
pear in front of the corresponding point.
When you select the 4-Points-Algorithm, the display will move auto-
matically to the last image of the Z-Stack. Set the fourth correlation
point in both containers. Make sure that the positions in both Z-
Stacks are identical. After you have set all correlation points, the cur-
sor will be changed backwards from the pipette to the arrow.
Reset deletes all correlation points in the image.

Create correlated If you click on this button, the correlated Z-Stack will be generated
Z-Stack and opened in a new image container.

See also
2 Manual Correction [} 766]

8.3.10.3 Manual Correction

In this step you can correct the correlation manually by moving and rotating the transformed im-
age.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 766


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Therefore simply click on the Start button. Then you can interactively move the image by drag-
ging and dropping it with the mouse or rotate the image by clicking on the circle button attached
on top of the green image frame or using the Rotation slider. You can also change the image
opacity by adjusting the corresponding slider.
If you click on the Accept button the manual correction, will be adopted to the correlated image.

See also
2 Create Final Correlation Image [} 767]

8.3.10.4 Create Final Correlation Image

In this step create the final correlation image. Therefore simply click on the Create final Z-Stack
button. Click Finish to exit the wizard.

8.3.11 Correlative Sample Holders

Name Image
Life Science cover glass
22 x 22

Life Science Cryo Holder

Life Science for TEM Grids

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 767


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Name Image
Cover glass with fiducials
22 x 22

MAT Flat Stubs A

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 768


8 Special/Hardware Related Modules | 8.3 Correlative Array Tomography (CAT) ZEISS

Name Image
MAT Flat Stubs

MAT Universal A

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 769


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Name Image
MAT Universal B_A

MAT Universal B_B

8.4 Dynamics Profiler

This module allows you to use FCS (Fluorescence Correlation Spectroscopy) functionality together
with the Airyscan detector. The functionality has to be licensed. Without a license, you can only
open an existing document in one view with limited interaction.
The license Dynamics Profiler Basic expands the capability of the Airyscan detector and utilizes
the area information gathered from 32 circular arranged detection elements for fluorescence cor-
relation spectroscopy (FCS). A wizard guides you through the acquisition of your data. Based on a

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 770


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

reference image, you can evaluate up to 10 measurement spots consecutively and analyze them
with various fit models. Additionally, you can get access to the raw data of all Airyscan detection
elements for individual analysis.
The license Dynamics Profiler Advanced additionally enables you to analyze the dynamics with
pair correlation (e.g. to investigate diffusion barriers), and the active flow by providing speed in
µm/s and its direction.

8.4.1 Overview Supported Laser Lines

The Dynamics Profiler functionality works for all RGB laser lines with the following wavelengths:

Microscope Supported Laser Lines


LSM 980 445nm, 488nm, 514nm, 543nm, 561nm, 594nm, 639nm

LSM 900/800 488nm, 561nm, 639nm, 640nm

Info
405nm Laser
Note that you can also use the laser wavelength of 405nm, but only for acquiring the refer-
ence image. Performing spot measurements is not possible with 405nm. Additionally, to be
able to start the acquisition wizard, the 405nm must not be the selected main track.

8.4.2 Setting Up and Performing a Dynamics Profiler Acquisition

Info
Acquisition with data compression
If you want to acquire your data with lossless compression, go to Tools > Options > Acquisi-
tion > Data Compression and make sure that Zstd (lossless) is selected.

Prerequisite ü You have started ZEN with the necessary licenses and set up your hardware.
ü You have set up an acquisition experiment with one or two Airyscan SR tracks. The FCS func-
tionality for Airyscan is only available, if you have set up a suitable experiment with supported
objective and laser line(s), see also Overview Supported Laser Lines [} 771]. Note that if you
have added two Airyscan tracks, the one currently selected in the Imaging Setup or Chan-
nels tool is the main track for the spot measurement, the other is considered the second
track.
1. On the Acquisition tab, in the Imaging Setup tool, click Dynamics Profiler.
à The Align Airyscan Detector step of the wizard opens.
2. Click Adjustment.
à An automatic adjustment of the Airyscan detector starts and the button changes to a
Stop button.
à If the automatic adjustment fails, dedicated controls are displayed on the left to manually
configure the detector adjustment.
3. Use the controls on the left side to adjust your Airyscan detector.
à The Quality and Status of the detector is displayed and updated on the left side.
à When the detector adjustment is successfully completed, the Snap Reference Image
step opens automatically.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 771


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

4. Use the options of the step to set up the acquisition of the reference image. You can also
start a continuous acquisition by clicking Continuous and change the parameters with di-
rect visual feedback.
à If you click Continuous, a continuous acquisition starts. To continue, you have to click
Stop.
5. If you have set up your experiment with two tracks and want to acquire the reference im-
age with both, activate Second Track.
à The laser setting for the second Airyscan track is displayed if you need to adjust them,
the Gain slider is active for both tracks.
6. Click Snap Reference Image.
à Your reference image is acquired with the current settings.
7. Click Next.
à The Set Up Acquisition Spots step opens.
8. In the Spots section, click + (activated by default) and click on your spots of interest in the
reference image. Note that you can add a maximum of ten spots.
à The spots are added to the experiment and displayed in the list on the left.
9. If you want to evaluate an individual spot, select it in the list and click Evaluate Spot. You
can also move the spot during evaluation. You can also change the z-position of the spot
during evaluation. However, note that the reference image does not adjust to the new z-
position. In this case we recommend creating a new reference image by clicking Snap.
10. Set up the parameters for your time series experiment, including the measurement time.
Note that the maximum for spot measurement is 300 seconds.
11. Click Start Experiment to start the time series experiment for all spots.
à The scan experiment starts. The data is displayed in the table and charts in the Center
Screen Area.
à After the experiment is finished, the wizard closes automatically. If you have activated
Create a Reference Image after Spot Measurement, a second reference image (Post
Experiment image) is acquired after the spot experiment and before closing the wizard.
The Dynamics Profiler document is displayed in the main user interface of ZEN. You can now save
it and analyze the data with the help of the three dedicated views.
Dynamics Profiler documents are also supported by ZEN Connect, see ZEN Connect [} 619].
If you have activated Keep Positions and Keep Acquisition Settings in the last wizard step, the
spot positions and acquisition settings are taken over to the user experiment and are available for
the next acquisition with the wizard.
If you open the Dynamics Profiler document in the Info view, you can see the metadata of the
spot experiment. If you want to see the metadata for the reference image, open it as a separate
image in ZEN, see Opening the Reference Image as Separate Image [} 773].

See also
2 Adjust Airyscan Detector [} 775]
2 Snap Reference Image [} 776]
2 Set Up Acquisition Spots [} 777]

8.4.3 Exporting Data From Tables

Prerequisite ü A Dynamics Profiler document is open in the Correlation, Diffusion, or Flow view.
1. Right click in the data table.
à A context menu is displayed.
2. If you want to save the complete table content as a text file, select Write Text to File.
à A file browser opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 772


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

3. Select a folder, enter a name for the document and click Save.
à The data of the table is saved as a tab separated text file (headers in the document corre-
spond to the column names of the table) in the selected folder.

8.4.4 Exporting Data From Charts

Prerequisite ü A Dynamics Profiler document is open in the Correlation, Diffusion, or Flow view.

1. Click in the top right corner of the chart.


à A context menu is displayed.
2. If you want to save the complete chart content as a text file, select Write Text to File. If
you want to save the chart as a graphic, select Save Graphics to.
à A file browser opens.
3. Select a folder, enter a name for the document and click Save.
à The data of the chart is saved as a tab separated text file (headers in the document corre-
spond to column names/axis legends) or as a .tiff image file in the selected folder.

8.4.5 Opening the Reference Image as Separate Image

Prerequisite ü A Dynamics Profiler document is open in one of the views.


1. If you have acquired two reference images, select if you want to see the Pre-Experiment
or Post-Experiment image with the view options tab.
2. In the data table, toggle the visibility of the spots that should be present in the image.
3. Right click into reference image and select Create Image from View in the context menu.
à The reference image is opened as a new image document in ZEN with the previously se-
lected spots as well as all the metadata (visible in the Info view).

8.4.6 Cutting Out a Data Region

Prerequisite ü A Dynamics Profiler document is open in the Correlation view and the count rate chart is dis-
played.
1. In the table, select the spot entry for which you want to add a region. If you want to draw
on region for several spots, you can also select multiple spots by pressing Ctrl.
à The chart is updated according to your selection.

2. Click in the top right corner of the chart.


à A context menu is displayed.
3. Select Add Remove Region.
à The mouse curser changes to a pen.
4. Go to the count rate chart and click into the chart to define the lower threshold for your
data region.
à A line is added to the chart.
5. Go to a second measurement time position and click again.
à You have defined a region with a lower and upper threshold for your data. It can be
moved in the chart by drag and drop of the point on the horizontal line.
à The region can be deleted with the button, or resized by dragging the vertical
lines.
6. Repeat these steps for every spot where you want to draw a data region.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 773


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

The data of the region is used for the Diffusion and Flow view. The selection is saved in the
metadata of the document and is restored after it is reopened.

8.4.7 Saving Dynamics Profiler Documents as Compressed CZI

Prerequisite ü A Dynamics Profiler document is open.


1. Click File > Save As with Options.
à A file browser for saving opens.
2. Enter the File name, navigate to the folder where you want to save the document, and
open the Compression dropdown.
à The dropdown menu displays the different compression options.
3. Select Lossless Compressed (ZSTD).
4. Click Save.
à Your Dynamics Profiler document is now saved and compressed with a lossless data
compression.

8.4.8 Creating a Custom ωr Calibration

Prerequisite ü You have created a Dynamics Profiler document where you have set the Time Resolution to
ωr in the third step of the wizard.
ü This Dynamics Profiler document is open in the Correlation view.
ü The objective for your spot experiment must be the same as the objective you use for the ωr
calibration.
1. In the view options, open the ωr Calibration tab.
2. From the Dye dropdown list, select which dye you want to use for the calibration.
à The value for Diffusion Coefficient is updated automatically.
3. If you know the Diffusion Coefficient for your experiment, adapt the value in the input
field accordingly.
4. Click Calibrate.
à A file browser opens.
5. Select the folder where you want to save the calibration file and enter a file name.
6. Click Save.
à The custom ωr calibration is created and the file is saved.

See also
2 Using Custom ωr Calibration [} 774]

8.4.9 Using Custom ωr Calibration

Prerequisite ü A Dynamics Profiler document is open in the Correlation view.


ü You have a calibration file with user defined ωr calibration available, see also Creating a Cus-
tom ωr Calibration [} 774].
ü The objective for your spot experiment must be the same as the objective you have used for
the ωr calibration file.
1. In the ωr Calibration section of the Correlation Tools tab, click Custom.
à A file browser opens.
2. Navigate to the folder with your calibration file, select it and click Open.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 774


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

à The custom ωr calibration is loaded and the file name is displayed next to the button.

8.4.10 Dynamics Profiler Acquisition Wizard

This wizard guides you through an FCS experiment with Airyscan.

8.4.10.1 Adjust Airyscan Detector

With this step you can adjust your Airyscan detector. Airyscan detector adjustment ensures good
data quality for multiple cross-correlation measurements. The controls are provided in case the
automatic adjustment fails.

Parameter Description
Adjustment Starts an automatic detector adjustment. When the adjustment is run-
ning, it changes to a Stop button.

Quality and Status Displays the status of the Airyscan detector adjustment.

Detector View Displays the current intensity distribution of the emission signal over
the detector elements.

The following parameters are only available if the automatic adjustment fails:

Zoom Sets the zoom level. Clicking the 1.x button behind the input field re-
sets the zoom level to the default.

High Intensity Activated: Enables the higher laser power range between 0.2 and
Laser Range 100%. This setting is applied to all laser lines.

Laser Set the required attenuation (%) for the laser.

Master Gain Sets the master gain to control the voltage of the PMTs. Increasing
the gain of the PMT corresponds to a higher voltage of the detector.
The image gets brighter and you may be able to reduce the laser
power.
With a higher voltage, the noise level in the image increases as the
dark noise of the detector gets visible in the images, predominantly as
single bright pixels. The optimum between gain and noise depends on
your experimental requirements and on your sample.

Scan Speed Sets the scan speed with the slider or input field. The corresponding
values for Frame Time and Pixel Time are displayed above the
slider.

Fiber Position Displays controls for the manual adjustment of the fiber positions.

– X Position Changes the adjustment of the fiber in x.

– Y Position Changes the adjustment of the fiber in y.

– Store Invis Activated: Saves and stores the current values for the next align-
Correction Po- ment.
sition Auto-
matically

– Store Current Stores the current positions of x and y for further reference.
Pos.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 775


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
– Move To Moves to the currently stored position and updates the X Position
Stored Pos. and Y Position accordingly.

See also
2 Setting Up and Performing a Dynamics Profiler Acquisition [} 771]

8.4.10.2 Snap Reference Image

In this step you acquire your reference image.

Parameter Description
Continuous Starts a continuous image acquisition. When the acquisition is run-
ning, it changes to a Stop button to stop the acquisition.

Zoom Sets the zoom level. Clicking the 1.x button behind the input field re-
sets the zoom level to the default.

Scan Speed Set the scan speed with the slider or input field. The corresponding
values for Frame Time and Pixel Time are displayed above the
slider.

– Max Automatically sets the maximal possible scan speed. When you click
this button once, it changes its color to blue. This indicates that the
system always uses the highest possible scan speed as you continue
to change acquisition parameters like zoom or frame size. Click the
button again to deactivate this permanently active state.

Frame Size Adjusts the frame size (in pixel) for the image acquisition. The corre-
sponding Image Size and Pixel Size are displayed above the input
fields.

– Presets Opens a dropdown which allows you to select a frame size from a list
of default frame sizes.

Sampling

– SR Sets the sampling to 2x Nyquist for super resolution mode.

– Confocal Sets the frame size (image resolution) to an optimal value correspond-
ing to the optical magnification (objective), the zoom factor and the
wavelengths included in the experiment. This provides an image
where no spatial information is lost and no empty data is generated
as optimal sampling is achieved. The confocal value is calculated for
the given objective and magnification settings matching a 1 fold sam-
pling according to 1 time Nyquist. Rectangular image dimensions are
preserved.

Direction Selects the scan direction.

– The laser scans in one direction only, then moves back with beam
blanked and scans the next line.

– The laser also scans when moving backwards, i.e. the scan time is re-
duced by about a factor of two. Note that bi-directional scanning can
result in a pixel shift between forward and backward movement (dou-
ble image).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 776


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
High Intensity Activated: Enables the higher laser power range between 0.2 and
Laser Range 100%. This setting is applied to all laser lines.

Laser Set the required attenuation (%) for the laser.

Second Track Only visible if you have defined two Airyscan tracks.
Activated: Uses also the second Airyscan track to acquire the refer-
ence image and displays the laser setting for the second track.

Master Gain Sets the master gain to control the voltage of the PMTs. Increasing
the gain of the PMT corresponds to a higher voltage of the detector.
The image gets brighter and you may be able to reduce the laser
power.
With a higher voltage, the noise level in the image increases as the
dark noise of the detector gets visible in the images, predominantly as
single bright pixels. The optimum between gain and noise depends on
your experimental requirements and on your sample.

Snap Reference Creates the reference image with the current settings.
Image

See also
2 Setting Up and Performing a Dynamics Profiler Acquisition [} 771]

8.4.10.3 Set Up Acquisition Spots

In this step, you set up your spots, i.e. the measurement positions. In the center screen area of
this step, you have the information as in the Correlation view.

Parameter Description
Spot Measurment

– Starts the selection mode that allows you to select and move the
spots in the reference image.

– + Allows you to add new spots in the reference image. You can add a
maximum of ten spots.

– Evaluate Spot Starts a scan for the currently selected spot. When the spot scan is
running, it changes to a Stop button to stop the acquisition.

Spot Table Displays all spots and their information.

– ID Displays the ID of the spot.

– Color Displays the color of the spot.

– Name Displays the name of the spot.

– X/Y Displays the x and y coordinates of the spot.

– Quality Displays an indication about the quality at the respective spot.

– Moves the currently selected spot one position up in the list.


Move Up

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 777


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
– Moves the currently selected spot one position down in the list.
Move Down

– Deletes the currently selected spot entry.


Delete

– Delete All Deletes all spots.

High Intensity Activated: Enables the higher laser power range between 0.2% and
Laser Range 100%. This setting is applied to all laser lines. Note that selecting a
value below 0.2% is not possible in this step.

Laser Sets the required attenuation (%) for the laser.

Time Resolution Selects which time resolution is used.

– Spot Measure- Uses a pixel time of 1.2 μs and a maximum measurement time of 300
ment seconds. This option is the recommended default for spot measure-
ment.

– ωr Calibration Uses a pixel time of 0.5 µs and a maximum measurement time of 100
seconds. The recommended measurement time for ωr calibration is 60
seconds.

Measurement Sets the measurement time for the experiment.


Time

Reference Image

– Snap Acquires a new reference image.

– Create a Ref- Activated: Automatically acquires a second reference image after the
erence Image spot experiment is finished.
after Spot
Measurement

Start Experiment Starts the time series experiment for all spots.

Keep Positions Activated: Saves the spot positions defined in the wizard and takes
them over into the current experiment in ZEN.

Keep Acquisition Activated: Saves the acquisition settings defined in the wizard and
Settings takes them over into the current experiment in ZEN.

See also
2 Correlation View [} 778]
2 Setting Up and Performing a Dynamics Profiler Acquisition [} 771]

8.4.11 Correlation View

This view displays your experiment and the correlation data of the individual measurement posi-
tions. The different areas containing the image, the charts and the table can be resized by drag-
ging the individual area boundaries with the pressed left mouse button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 778


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

1 2

1 Preview Image
Here you can see the acquired preview image with the measurement positions marked in
the view.

2 Parameter Table
This table displays the data for the different measurement positions. Each position is dis-
played as a row. You can select one or multiple rows, which updates the information dis-
played in the charts. For details, see Correlation Parameter Table [} 779].

3 Charts
Here you have the result charts visualizing the measurement data for the selected spots.
You can zoom into the displayed curves with the mouse wheel or by drawing a zoom
rectangle with pressed left mouse button. A right click in the chart area resets the chart
(zoom) to the default view.

4 View Options
Here you have the area for your standard view options as well as the specific ones pro-
vided on the Correlation Tools tab, see Correlation Tools Tab [} 780].

8.4.11.1 Correlation Parameter Table

This table displays the data for the different measurement positions. Each position is displayed as
a separate row. If a value could not be calculated for a specific position, the corresponding entry
in the table is empty. A click on an entry highlights and selects the entire row. You can also select
multiple rows when pressing the Ctrl button while selecting the entries. The charts are then up-
dated accordingly. The units for individual parameters are displayed as tooltips. A right click in the
table opens a specific context menu, see Parameter Table Context Menu [} 788].

Parameter Description
Ø Activated: Uses this position for the calculation of an average for in-
dividual values. The average is displayed on the bottom of the table.

Toggles the visibility of the respective spot.


Visibility

ID Displays the ID for the individual spot.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 779


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
Color Sets the color for the respective measurement point by clicking on the
field and selecting a color form the dialog.

Name Displays and sets the name for the individual position.

Count Rate Displays the count rate in kHz.

CPM Displays the CPM in kHz. The color of the value indicates the data
quality, see Data Quality Criteria (CPM) [} 788].

Data Quality Displays an indication for the fit quality.

Number of Mole- Displays the number of molecules found at the measurement position.
cules It is calculated by 1/correlation amplitude, where the correlation
amplitude is defined as value of the correlation curve at the smallest
lag time.

Concentration Only visible after using a 3D fit model.


Displays the concentration.

Surface Concentra- Only visible after using a 2D fit model.


tion Displays the value for the surface concentration in nmol/cm2.

Triplet State Frac- Displays the triplet state fraction. One physical property of the utilized
tion fluorophore. Dependent on intensity and if applicable oxygen. A
triplet state of e.g. 16% would mean that 16% of all fluorophores are
in dark state.

Chi2 Displays the Chi2 value, see also Fit Calculation [} 789]. Chi2 is the de-
viation between the measured FCS curve and the fit curve. A value of
0 would mean a 100% accordance.

Diffusion Time Displays the diffusion time.

Diffusion Coeffi- Displays the diffusion coefficient.


cient

α Only visible if you have used an anomalous fit model.


Displays the anomalous parameter: 1 corresponds to free diffusion,
lower values indicate constrained diffusion.

Fit Model Displays which fit model was used.

Date Displays the date and time of the experiment.

See also
2 Calculation of Concentration and Diffusion Coefficient [} 788]

8.4.11.2 Correlation Tools Tab

Parameter Description
Reference Image Only visible if you have created a second reference image after the
spot experiment.
Selects which reference image is displayed int the view.

– Pre-Experi- Displays the reference image acquired before the experiment.


ment

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 780


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
– Post-Experi- Displays the reference image acquired after the experiment.
ment

Display Chart Selects which chart is displayed above the correlation chart.

– Count Rate Displays the count rate chart.

– Residuals Displays the residuals chart. Note that the residuals chart only con-
tains information after a fit was executed for the respective spot.

Filter

– Detrending Activated: Applies a detrending filter to remove the trend (e.g. due
to the photo bleaching) from the experiment data. Detrending is cal-
culated by a low-pass filter with the filter time constant provided with
the input field.

– Dust Activated: Applies a dust filter to remove high intensity peaks


(caused e.g. by aggregated objects) from the experiment data and
sets the parameter with the input field. Dust is considered, if the aver-
age intensity multiplied with the parameter value is higher than the
mean signal intensity.

Fit Model Selects the fit model for the correlation curve.

– 1 Component Selects the one component 2D model.


2D

– 2 Component Selects the two component 2D model.


2D

– 1 Component Selects the one component 3D model.


3D

– 2 Component Selects the two component 3D model.


3D

– 1 Component Selects the one component anomalous 2D model.


Anomalous 2D

– 1 Component Selects the one component anomalous 3D model.


Anomalous 3D

– Fit Applies the fit model to the currently selected position/curve.

– Fit All Applies the fit model to all positions/curves.

Amplitude Normal-
ization

– Activate Normalizes the amplitude to 1.

– Deactivate Applies no normalization.

ωr Calibration Selects which ωr should be used for the fit of the curves.

– Default Uses the default setting for the ωr calibration.

– Custom Opens a browser to select a file with a user generated ωr calibration.


This file can be created with the ωr tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 781


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

See also
2 Fit Calculation [} 789]
2 Filters [} 789]
2 Normalization of Correlation Curves [} 791]
2 Using Custom ωr Calibration [} 774]

8.4.11.3 ωr Calibration Tab

This tab enables you to create your own custom ωr calculation that you can use for fitting the cor-
relation curves.

Parameter Description
Dye Selects the dye used for the ωr calibration.

Diffusion Coeffi- Displays and sets the diffusion coefficient for the dye.
cient

Calibrate Calibrates the ωr value and opens a file browser to save it as a calibra-
tion file.

See also
2 Creating a Custom ωr Calibration [} 774]
2 Using Custom ωr Calibration [} 774]

8.4.12 Diffusion View

This view displays your experiment and the diffusion data of the individual measurement posi-
tions. For information about calculations, see Calculation of Concentration and Diffusion Coeffi-
cient [} 788]. The different areas containing the image, the charts and the table can be resized by
dragging the individual area boundaries with the pressed left mouse button.
1 2

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 782


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

1 Preview Image
Here you can see the acquired preview image with the measurement positions marked in
the view.

2 Parameter Table
This table displays the data for the different measurement positions. Each position is dis-
played as a separate row. For details, see Diffusion Parameter Table [} 784].

3 Polar Heatmap
This diagram area gives you the visual information about the diffusion in your sample
and which Airyscan fibers are used for the correlation, see Polar Heatmap [} 783]. A
right click into the area enables you to export the polar heatmap as an image.

4 Correlation Chart
Here you have the correlation chart for the currently selected spot. You can zoom into
the displayed curve with the mouse wheel or by drawing a zoom rectangle with pressed
left mouse button. A right click in the chart area resets the chart (zoom) to the default
view.

5 View Options
Here you have the area for your standard view options as well as the specific options
provided on the Diffusion Tools tab, see Diffusion Tools Tab [} 785].

8.4.12.1 Polar Heatmap

The polar heatmap illustrates directed diffusions and barriers by using color gradients referring to
the number of present molecules in specific angles. On the top you have a visual representation of
the Airyscan detector that indicates the fibers that are used for the correlations. These heatmaps
are calculated from six pair correlation curves and the pair correlation function (pCF). The pair cor-
relation function is a set of cross-correlations between the central fiber and all fibers located at a
given distance from the center. The rainbow pattern is used to map the diagram color to the cor-
responding correlation amplitude. The color mapping and legend are the same for both heatmaps
and the color palette can be selected in the Diffusion Tools tab. A right click on the heatmap
displays a menu that allows you to save it as an image on your PC. The displayed degrees can vary
based on your system configuration.

See also
2 Pair Correlation of Airyscan Fibers [} 791]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 783


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

8.4.12.2 Diffusion Parameter Table

This table displays the data for the different measurement positions. Each position is displayed as
a separate row. If a value could not be calculated for a specific position, the corresponding entry
in the table is empty. A click on an entry highlights and selects the entire row and displays the
corresponding data in the chart. The units for individual parameters are displayed as tooltips. A
right click in the table opens a context specific menu, see Parameter Table Context Menu
[} 788].

Parameter Description
Ø Activated: Calculates an average of the individual values. The aver-
age is displayed on the bottom of the table.

Toggles the visibility of the respective spot.


Visibility

ID Displays the ID for the individual spot.

Color Sets the color for the respective measurement point by clicking on the
field and selecting a color form the dialog.

Name Displays and sets the name for the individual position.

Count Rate Displays the count rate in kHz.

CPM Displays the CPM in kHz. The color of the value indicates the data
quality, see Data Quality Criteria (CPM) [} 788].

Number of Mole- Displays the number of molecules found at the measurement position.
cules It is calculated by 1/correlation amplitude, where the correlation
amplitude is defined as value of the correlation curve at the smallest
lag time.

Concentration Only visible after using a 3D fit model.


Displays the concentration.

Surface Concentra- Only visible after using a 2D fit model.


tion Displays the value for the surface concentration in nmol/cm2.

Triplet State Frac- Displays the triplet state fraction. One physical property of the utilized
tion fluorophore. Dependent on intensity and if applicable oxygen. A
triplet state of e.g. 16% would mean that 16% of all fluorophores are
in dark state.

Chi2 Displays the Chi2 value, see also Fit Calculation [} 789]. Chi2 is the de-
viation between the measured FCS curve and the fit curve. A value of
0 would mean a 100% accordance.

Diffusion Model Displays which fit model was used.

Diffusion Time Displays the diffusion time.

Diffusion Coeffi- Displays the diffusion coefficient.


cient

Date Displays the date and time of the experiment.

See also
2 Calculation of Concentration and Diffusion Coefficient [} 788]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 784


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

8.4.12.3 Diffusion Tools Tab

Parameter Description
Reference Image Only visible if you have created a second reference image after the
spot experiment.
Selects which reference image is displayed int the view.

– Pre-Experi- Displays the reference image acquired before the experiment.


ment

– Post-Experi- Displays the reference image acquired after the experiment.


ment

Correlation Chart Selects which correlation chart and which curves are displayed in the
correlation chart and allows you to set the color for the curves. You
can select to see the chart for Inner Elements or Outer Elements.

– Curve Binning Activated: Smoothes the curves by averaging for noisy data.

Amplitude Normal-
ization

– Activate Normalizes the amplitude to 1.

– Deactivate Applies no normalization.

Polar Heatmap Displays and selects the color palette used for the visualization in the
Palette polar heatmap.

See also
2 Pair Correlation of Airyscan Fibers [} 791]
2 Normalization of Correlation Curves [} 791]

8.4.13 Flow View

This view displays your experiment and the flow information. The different areas containing the
image, the charts and the table can be resized by dragging the individual area boundaries with
the pressed left mouse button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 785


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

1 2

1 Preview Image
Here you can see the acquired preview image with the measurement positions marked in
the view.

2 Parameter Table
This table displays the data for the different measurement positions. Each position is dis-
played as a row. For details, see Flow Parameter Table [} 786].

3 Flow Diagram
This diagram illustrates the flow based on the Airyscan detector. The arrow indicates the
flow direction. For information about the flow calculation and the classification for flow
speed, see Flow Calculation [} 790]. The displayed degrees can vary based on your sys-
tem configuration. A right click into the area enables you to export the flow diagram as
an image.

4 Correlation Chart
Here you have the correlation chart for the individual spots. You can zoom into the dis-
played curves with the mouse wheel or by drawing a zoom rectangle with pressed left
mouse button. A right click in the chart area resets the chart (zoom) to the default view.

5 View Options
Here you have the area for your standard view options as well as the specific options
provided on the Flow Tools tab, see Flow Tools Tab [} 787].

8.4.13.1 Flow Parameter Table

This table displays the data for the different measurement positions. Each position is displayed as
a separate row. If a value could not be calculated for a specific position, the corresponding entry
in the table is empty. A click on an entry highlights and selects the entire row and displays the
corresponding data in the chart. The units for individual parameters are displayed as tooltips. A
right click in the table opens a context specific menu, see Parameter Table Context Menu
[} 788].

Parameter Description
Ø Activated: Uses this position for the calculation of an average for in-
dividual values. The average is displayed on the bottom of the table.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 786


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
Toggles the visibility of the respective spot.
Visibility

ID Displays the ID for the individual spot.

Color Sets the color for the respective measurement point by clicking on the
field and selecting a color form the dialog.

Name Displays and sets the name for the individual position.

Count Rate Displays the count rate in kHz.

CPM Displays the CPM in kHz. The color of the value indicates the data
quality, see Data Quality Criteria (CPM) [} 788].

Data Quality Displays an indication for the fit quality.

Number of Mole- Displays the number of molecules found at the measurement position.
cules It is calculated by 1/correlation amplitude, where the correlation
amplitude is defined as value of the correlation curve at the smallest
lag time.

Flow Direction Displays the value that indicates the flow direction.

Flow Speed Displays the flow speed in µm/s.

Flow Speed Confi- Displays the confidence interval for the flow speed.
dence Interval

Fit Model Displays which fit model was used.

Date Displays the date and time of the experiment.

8.4.13.2 Flow Tools Tab

Parameter Description
Reference Image Only visible if you have created a second reference image after the
spot experiment.
Selects which reference image is displayed int the view.

– Pre-Experi- Displays the reference image acquired before the experiment.


ment

– Post-Experi- Displays the reference image acquired after the experiment.


ment

Correlation Chart Selects which curves are displayed in the correlation chart and allows
you to set the color for the curves.

Fit Model Selects the fit model for the correlation curve.

– 1 Component Selects the one component 2D model.


2D

– 1 Component Selects the one component 3D model.


3D

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 787


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
– Show Fitted Activated: Displays the fitted curves in the chart.
Curves

See also
2 Fit Calculation [} 789]

8.4.14 Parameter Table Context Menu

When you right click in the parameter table, you have the following option:

Parameter Description
Write Text to File Saves the data as a .txt file. You are prompted to enter a name and
select a folder before saving.

See also
2 Exporting Data From Tables [} 772]

8.4.15 Dynamics Profiler Calculations

8.4.15.1 Calculation of Concentration and Diffusion Coefficient

The diffusion coefficient D is calculated as indicated by the following formula:

The fluorofore concentration is given as:

§ where

is an average number of molecules and NA ​ is the Avogadro constant


§ and

where S is the structural parameter.

8.4.15.2 Data Quality Criteria (CPM)

The data quality is estimated using CPM values:

Data Quality CPM Value


Bad (red) Smaller than 1.

Not bad (yellow) Between 1 and 3.

Good (green) Higher than 3.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 788


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

8.4.15.3 Filters

Detrending Filter
The detrending filter is applied to remove the trend (e.g. due to the photo bleaching) from the ex-
periment data. The detrended signal Id(t) is calculated as follows:

where the trend, Tr(t) is the gaussian smoothed signal:

with
The FilterWindowParameter [ms] is set by the user.

Dust Filter
The dust filter allows you to remove high intensity peaks (e.g. caused by aggregated objects) from
the experiment data. Calculations are done on the 500x down sampled signal data. For compari-
son, intensity data shown in the count rate chart is down sampled with factor 2000x. The data
bin is classified as dust (filtered out) if the following criteria is fulfilled:
UserParameter * I(t) > Mean(I(t))
If both the detrending and dust filter are activated, the dust filter is applied after the detrending
filter.

8.4.15.4 Fit Calculation

The unweighted fit of the correlation curve is done using the Levenberg-Marquart algorithm. Re-
duced chi2 is calculated as follows:

where Gt is the correlation curve value, F​t the fit value, N the number of correlation/fit values and
DF the number of fit parameters.

Auto Correlation Fit Models


You can select one of the following models:

One Component 2D

One Component 3D

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 789


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Two Component 2D

Two Component 3D

One Component Anomalous 2D

One Component Anomalous 3D

Parameters
The parameters used in the calculations are the following:

Parameter Description
A The correlation amplitude.

Tt The triplet fraction.

Td1 The translational diffusion time.

S The structural parameter.

τt τt = 3µs is the fixed triplet relaxation time.

cf1 The first component fraction.

8.4.15.5 Flow Calculation

In order to determine flow speed and direction, all possible cross-correlations are calculated at a
distance of two fibers within three inner fiber rings. All correlations in the same direction are aver-
aged, resulting in six correlation curves (30°, 90°, ..., 330°; by our definition, 0° means vertical
flow direction). All six curves are fitted globally with the following model:

Parameter Description
v The flow speed (fit parameter).

ϕ The angle between the flow and the vector connecting the fibers in
this group of cross-correlations (fit parameter).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 790


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

Parameter Description
r0 The apparent distance between the fibers (calibration parameter).

Gdiff(τ) The diffusion term (2D or 3D), see Fit Calculation [} 789].

Other parameters are defined as for the fit calculations, see Fit Calculation [} 789].

8.4.15.5.1 Flow Speed Classification

The calculated flow speed values are classified depending on the diffusion time of the analyzed
fluorophore and also based on statistical quality of the flow correlation curves:

Flow Type Criterium


No Flow v <= 3*CI

Slow (v > 3*CI) & (τflow > 3*τd)

Moderate (v > 3*CI) & (τd < τflow < 3*τd)

Fast (v > 3*CI) & (τflow < τd)

where τflow = r0/v and CI is the flow speed confidence interval.

8.4.15.6 Normalization of Correlation Curves

Amplitude normalization of the correlation curves allows you to compare different correlation
curves and see the differences in diffusion times between them.
If the fit of the correlation curves is already done, activating the amplitude normalization is done
using the amplitude fit parameter. Selected correlation curves are rescaled that each selected
curve has a correlation amplitude equal to 1 (corresponding number of molecules = 1).

where A is a fitted amplitude.


In case no fit is done, correlation curves are normalized as follows:

where Amean ​ is the mean amplitude calculated over the first 10 points of the correlation curve:

8.4.15.7 Pair Correlation of Airyscan Fibers

The pair correlation function (pCF) is a set of cross-correlations between the central fiber and all
fibers located at a given distance from the center. For a better signal to noise ratio, cross-correla-
tions are calculated in both directions and then averaged. The pCFs are used and displayed in the
polar heatmaps of the Diffusion view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 791


8 Special/Hardware Related Modules | 8.4 Dynamics Profiler ZEISS

The Diffusion view can display the data of two different sets of fibers. The group called Outer El-
ements comprises fibers with a slightly bigger distance from the center (blue element) and is illus-
trated with orange in the graphic below. The second group is called Inner Elements and com-
prises fibers with a slightly smaller distance from the center. They are illustrated with the green
color in the graphic below.

Fiber Group Fibers


Outer Elements Comprises fibers 9, 11, 13, 15, 17 and 19.

Inner Elements Comprises fibers 8, 10, 12, 14, 16 and 18.

8.4.15.8 ωr Calculation

The ωr is calculated with the following formula:

During the ωr calibration, τd is calculated in the one-component 3D diffusion model

and D (diffusion coefficient) needs to be provided and added in the ωr Calibration tab. The diffu-
sion coefficients of commonly used dyes are already specified in a dropdown list. The following
requirements need to be fulfilled in order to generate a suitable calibration file:

§ Spot measurement duration of at least 60 seconds


§ Time Resolution of 0.5 µs (ωr acquisition mode)
§ The used dye concentration needs to be adjusted to match the expected FCS amplitude range
(0.05 – 2)
§ The emission wavelength of the selected dye should match the selected laser line

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 792


8 Special/Hardware Related Modules | 8.5 EM Processing Toolbox ZEISS

Four values are calculated and can be accessed by opening the calibration file with a text editor:

§ W0Ring3: Effective radius of the observation spot (detector elements 1 to 19 binned together)
§ W0Ring123: Average radius of the observation spot for a single detector element (average
value for detector elements 1 to 19)
§ R0Ring123: Effective distance between the detector elements for flow measurements
§ StructuralParameter: Ratio between the observation spot waist in the axial and lateral direc-
tion
The generated ωr calibration file can be used in the Correlation Tools tab to replace the default
ωr calibration values.

See also
2 ωr Calibration Tab [} 782]
2 Correlation Tools Tab [} 780]

8.4.15.9 Calculation of Autocorrelation Curve

The Dynamics Profiler autocorrelation curve is calculated according to the formula:

Correlation values are calculated for the lag times τ, commonly used in 16/8 multi-tau hardware
correlators. This means the lag time τ is increased linearly with the τ =PixelDwellTime for the first
16 values. Then the lag time interval for τ is doubled, and the next eight lag times are calculated.
The lag time interval is doubled after each next eight time lag values.
The very first correlation value, corresponding to the one PixelDwellTime, is skipped since it is bi-
ased due to correlation of the neighboring data points after low pass filter due to digitalization.

8.5 EM Processing Toolbox

This module offers functionality for the processing of FIB-SEM stacks. This chapter describes how
the different functions of the EM Processing Toolbox can be used to process a FIB-SEM-stack ac-
quired with SmartFIB in the ZEN software. Note that parts of this special workflow also require
functionalities of the ZEN Connect module. To make yourself familiar with this module, see also
the documentation for ZEN Connect [} 619].

See also
2 EM Processing [} 105]

8.5.1 Workflow Overview

This chapter gives an overview how you can process your FIB-SEM stacks and align them. Con-
sider the following workflow:
1. Sorting of image files:
With the function Sort SmartFIB Tiffs [} 117] you can sort your .tiff image files created by
SmartFIB according to channel name, number of pixels, image size, and spacing of the im-
ages, corresponding to slice thickness. Note that this function only works if the tiff files have
their default names (e.g. channel0_slice_0001.tiff or slice_0001.tiff)! Do not rename your files
before you use this function!

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 793


8 Special/Hardware Related Modules | 8.5 EM Processing Toolbox ZEISS

2. Image import and conversion:


With the special import functionality, you can import your FIB stack images and save them as
a czi for further processing in ZEN. You can import the stack into ZEN (see Importing Smart-
FIB Tiffs [} 797]) or into ZEN Connect (see Importing a SmartFIB Stack into ZEN Connect
[} 632]).
3. Subset image creation:
If you want to reduce the imported z-stack to a particular z-range and region before applying
further processing steps, you can create a subset image of the imported FIB stack with the im-
age processing function Create Image Subset [} 108].
4. Replacing individual slices in the z-stack:
If your stack contains image slices of bad quality which prevents further processing or seg-
mentation, you can use the function Slices Replacement [} 117] to replace those slices with
the respective predecessor or successor. For more information, see also Replacing Z-Slices in
a Z-Stack [} 796].
5. Coarse alignment of the z-stack:
To minimize shifts in x and y in the z-stack and correct a potential beam shift, you can use the
image processing function Coarse Z-Stack Alignment [} 106] to roughly align the z-stack. For
more information, see also Aligning Z-Planes Manually [} 794].
6. Image processing:
Use the image processing functions [} 105] to process your image and reduce artifacts. For
general information about image processing, see also the chapter for the Image Processing
Workflow [} 72].
7. Automatic alignment of the z-stack:
Make an automatic fine alignment of the planes in your z-stack with the processing function
Z-Stack Alignment with ROI [} 118]. For more information, see also Aligning Z-Planes Auto-
matically (Based on a ROI) [} 795].
8. Equalization:
Correct for variation of overall image intensity from image to image by equalizing the intensity
value throughout the entire z-stack with the function Z-Stack Equalization [} 120].
9. Cropping of a specific volume:
Identify a particular region of interest and cut it out of your stack with the function Cut Out
Regions [} 109]. For more information, see also Cutting Out a Volume from a Z-Stack
[} 796].
10. Adding the processed z-stack to the ZEN Connect project:
Add your processed z-stack into the correlative workspace of the ZEN Connect module. For
this you can use the Add to Correlative Workspace button in the toolbar if you have
an open project. In the correlative workspace you can then align several z-stacks and images
(e.g. an overview image). For detailed information, see also Adding an Open Image to the
ZEN Connect Project [} 627] and Aligning Image Data [} 635].
In order to import the data into a specific session in the ZEN connect project, right-click on
the respective session and select the czi file. The transformation that was applied to the ses-
sion will then also be applied to the newly imported image.

8.5.2 Aligning Z-Planes Manually

If you have an imported FIB-SEM stack which requires manual pre-alignment before using the au-
tomatic z-alignment, you can use the image processing function Coarse Z-Stack Alignment for
a manual alignment of your stack. See the following instruction.

Prerequisite ü You have opened your (imported) z-stack that needs alignment in ZEN.
1. On the Processing tab, select the image processing function Coarse Z-Stack Alignment.
2. Click on the Setup button.
à The Coarse Z-Stack Alignment Setup [} 106] opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 794


8 Special/Hardware Related Modules | 8.5 EM Processing Toolbox ZEISS

à The current z-plane (selected by the Z-Position slider in the Dimensions tab) is displayed
in cyan and the following z-plane is displayed in red.
3. If you have an image with multiple channels, select the channel which should be displayed
in the Image View with the Channels tool.
4. With the Z-Position control in the Dimensions tab, go to the z-plane where the image
needs an alignment.
5. Select the Speed with which your alignment should be performed.
6. Shift the following z-planes with the arrow buttons in the top left of the setup until the x/ y
shift in the z-stack seems to be eliminated. Alternatively, you can also use the arrow keys
on your keyboard.
7. If necessary, adjust the speed step size during the alignment.
8. Repeat the steps 4 to 6 until all shifts in the z-stack are corrected.
à Every shift is displayed in the Shift List on the left side of the setup.
9. Click on Finish to save the changes and close the setup.
à The Shift List with all the shifts is displayed in the Parameters tool.
10. On the top of the Processing tab, click on Apply.
You have now aligned the planes in your z-stack manually to correct a shift in x and/or y within
the z-stack.

See also
2 Aligning Z-Planes Automatically (Based on a ROI) [} 795]

8.5.3 Aligning Z-Planes Automatically (Based on a ROI)

With the image processing function Z-Stack Alignment with ROI [} 118] you can perform an au-
tomatic alignment of the z-planes in a stack. This alignment can be based on a particular region of
interest that you can draw into your image.

Prerequisite ü You have opened your z-stack in ZEN.


1. On the Processing tab, select the image processing function Z-Stack Alignment with
ROI.
à The method's options are displayed in the Parameters tool.
2. For Quality, select the quality for the image alignment.
3. For Registration Method, select whether the alignment to optimize the z-stack should
perform a translation, a rotation, or both.
4. For Interpolation, select the interpolation method that should be used for the alignment.
5. Under Region, select Rectangle Region in the drop-down menu.
6. In the 2D view, draw a region of interest into your image to mark the structure(s)/area of
particular interest.
7. In the Dimensions tab, use the Z-Position slider to check if the region of interest needs to
be adjusted. Note: The region of interest cannot be set for each plane individually. Make
sure that the drawn region is big enough to contain the structure(s)/area of interest in every
z-plane.
8. Adjust the region of interest if necessary. You can adjust and move it directly in the 2D view
or with the input fields in the Parameters tool.
9. If you want your output image to have the same size as your input image, activate the
checkbox Keep Size. The image will be cropped in the process, in the case that pixels are
shifted out of the area defined by the input image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 795


8 Special/Hardware Related Modules | 8.5 EM Processing Toolbox ZEISS

10. Under Channel Component, select one of the image channels whose alignment transfor-
mation matrix is then also applied to the other channel(s). If an alignment should be calcu-
lated for each channel individually, deactivate the checkbox Single Component. This step
is only applicable for images with multiple channels.
11. At the top of the Processing tab, click on Apply.
The z-planes of your image are now aligned automatically. The progress of the alignment process
is displayed in the progress bar on the bottom of the ZEN software.

8.5.4 Replacing Z-Slices in a Z-Stack

With the processing function Slices Replacement [} 117] you can replace slices of a z-stack with
the previous or next slice in the stack.

1. On the Processing tab, select the method Slices Replacement.


2. In the Dimensions tab, use the Z-Position slider or input field to select the slice you want
to replace.
3. Click on Replace with Next to replace the selected slice with the next one, or click on Re-
place with previous if you want to replace the slice with the previous one.
4. If you want to replace other slices as well, repeat the steps 2 and 3 for each slice.
à Each slice is listed in the Replacement Table on the left.
5. Click on Apply.
You have now replaced the selected slice(s) with its previous and/or next one(s).

Replacing multiple slices


If you have several slices in your z-stack which you want to replace with the following or preced-
ing slice, you can also take the following workflow:

1. On the Processing tab, select the method Slices Replacement.


2. Open the Gallery view of your z-stack.
3. In the Gallery view, press the Ctrl button and select all the slices you want to replace. As
an example, you select the slices 34, 37, and 38.
4. Click on Replace with Next to replace the selected slices with the next ones, or click on
Replace with previous if you want to replace the slices with the previous ones.
à Each slice is listed in the Replacement Table on the left. As an example, clicking Re-
place with previous would replace slice 34 with 33, and 37 and 38 with the slice 36.
5. Click on Apply.
You have now replaced the selected slices with its previous and/or next ones.

8.5.5 Cutting Out a Volume from a Z-Stack

With the processing function Cut Out Regions [} 109] you can define a region in your z-stack and
cut it out as a volume.

Prerequisite ü You have opened your z-stack in ZEN.


1. On the Processing tab, select the Method Cut Out Regions [} 109].
2. Under Parameters, click on Define Regions.
à The Define Regions Setup [} 110] opens.
3. In the Dimensions tab, use the Z-Position slider to go to the first z-slice where you want
to mark your region of interest.
4. In the Region Edit Section [} 110] on the left, click on Draw and select the type of region
you want to use (rectangular, circular, polygonal,...).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 796


8 Special/Hardware Related Modules | 8.5 EM Processing Toolbox ZEISS

5. In the image, draw your so-called support region to mark the structure of interest.
6. Repeat the previous steps for the last slice where your structure of interest appears as well
as for those slices in between where significant changes (in shape and/or position) of this
structure take place.
7. Click on Interpolate.
à Interpolated regions are created for all slices between the support regions. The interpo-
lated regions are displayed with a slightly darker color.
8. Use the Z-Position slider to move through your stack and examine whether the interpo-
lated regions satisfyingly cover the structure of interest in your stack.
9. If you find a slice where the interpolated region does not cover your structure of interest,
draw a new support region on this slice and click on Interpolate again.
10. When the entire structure is marked satisfyingly by the interpolated regions, click on Finish.
à The Define Region setup closes and your image with the newly created regions is dis-
played in the Analysis view.
11. On the Processing tab, click on Apply.
Your marked structure is now cut out of the z-stack and opened as a new image.

8.5.6 Importing SmartFIB Tiffs

In ZEN you can import SmartFIB stacks of Crossbeam microscopes. The orientation of these stacks
differs from standard z-stack acquisition, as the acquired images are tilted by a certain angle com-
pared to a z-stack acquired on a light microscope. The import function calculates this tilt from the
metadata of the image. If the import finds no metadata concerning the tilt angle and the user
does not enter a value for the sample angle, it uses a default angle of 54 degrees (default angle
between FIB and SEM column at the Crossbeam) and the image is rendered with a 90 degree tilt
when displayed in a ZEN connect project. Alternatively, you can enter the angle of your sample
during import, e.g. as set during acquisition of the stack with SmartFIB, and the import then cal-
culates the tilt angle based on this sample angle.
During import, the XY offset metadata of the individual slices is ignored by default and only the
offset of the first tiff file is considered. This default avoids the creation of a slanted z-stack, how-
ever in certain cases, such as on-grid-thinning configuration, the XY offset of the individual slices
needs to be taken into account.

1. On the Processing tab, select the image processing function Import SmartFIB TIFFs.
à The function settings are displayed in the Parameters tool.
2. Click on Select Files.
à A file browser opens.
3. Select the images you want to import as FIB stack.
Note: Select only images with consistent metadata with respect to number of pixels, image
size, and spacing of the images (i.e. use the Sort SmartFIB tiffs function before importing
the data).
Note: To make sure the stack is composed/ ordered correctly, watch out how the images
are sorted in the explorer and in which order you choose them.
4. Enter a File name for the FIB stack.
5. If you import images without scaling information, deactivate the Auto checkbox for XY-
Scaling and manually enter the information.
Note: ZEN currently cannot determine automatically if scaling information is present.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 797


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

6. You can set the slice distance manually if you deactivate the Auto checkbox for Z-Spacing.
This step is optional and should only be done if you have reason to believe the information
calculated with the metadata is incorrect. Leave the Auto checkbox activated and the slice
distance is automatically calculated with information saved in the metadata of the images.
Note: When you set the slice distance manually, the information in the metadata is ig-
nored.
7. If you know the angle of your sample, deactivate the Auto checkbox for Sample Angle
and enter it. Otherwise the tilt for the image is calculated using the metadata, or the sam-
ple angle is set to the default of 54 degrees (default angle between FIB and SEM column at
the Crossbeam) and the image is rendered with a 90 degree tilt (if no information is avail-
able in the metadata).
8. If you want to consider the xy offset metadata of the individual slices for the import, acti-
vate the checkbox Read XY Offsets. Note that this can lead to a slanted z-stack depend-
ing on the sample and the metadata, assuming tilt correction was used during acquisition
with SmartFIB (e.g. if the metadata contain incorrect offset information).
9. Click on Apply.
The FIB stack is now imported into ZEN and a czi-file is created.
Note: When importing larger image files, it may take a while until the entire stack is visible in the
viewer.

8.6 Confocal Topography

This module includes the following functionality:

Topography Acquisition
With the Topography Tool you can acquire and inspect surfaces or surface structures of differ-
ent sample types (e.g. water plates, solar cells). By the help of the Topography Measurement
Wizard you can perform a confocal image acquisition of your sample. The advanced analysis of
the topography image is performed by the help of the ConfoMap software which is included in
the software package.
In the chapter Functions & Reference you find detailed functional descriptions of the Topogra-
phy Tool [} 806] and the Topography Measurement Wizard [} 806].
In the chapter Workflow Topography Acquisition you find a detailed how-to guide for topog-
raphy acquisition, see Introduction.

Layer Thickness Measurement


With the Layer Thickness Measurement Tool you can acquire z-stacks and perform layer thick-
ness measurements of one or more transparent layers (e.g. coatings, alloys). Here as well, the
Layer Thickness Measurement Wizard will guide you through the process. The measured val-
ues can be corrected by the refractive index of the coating.
In the chapter Functions & Reference you find detailed functional descriptions of the Layer
Thickness Measurement Tool [} 808] and the Layer Thickness Measurement wizard [} 808].
In the chapter Workflow Layer Thickness Measurement you find a detailed how-to guide for
layer thickness measurement, see Introduction.

8.6.1 Acquiring Topography Images

If you want to acquire a topography image in ZEN, you need to start the topography measure-
ment wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 798


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

Prerequisite ü You are on the Applications tab.


1. In the Topography tool, click on Start.
à The wizard starts. In the left tool area you see the Step 1/2 Setup, in which you can ad-
just the acquisition parameters for the topography image. In the center screen area you
see the live image from your sample in continuous mode.
As a default the system is set up to acquire only one single z-stack. In case your region of
interest (ROI) is all within your field of view (FoV) continue with step 5 of this guide. If
your ROI is bigger than your FoV, you can setup a tiles acquisition in the Tiles tool:
2. In the Tiles tool, enter the number of desired tiles in the X and/or Y direction input fields,
e.g. 3 x 3. This will create a 3 x 3 tiles image with 9 single tiles.

3. Click on Set stage position to define the anchor point of your tile scan at the current
stage position.
4. In the Navigation (must be expanded first) section click on the arrow buttons to navigate
through the single tile images. This can help to check if the tiles cover the full ROI.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 799


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

5. In the Acquisition Mode tool, adjust the settings for Objective, Frame Size, and Bits per
Pixel according to your requirements.

6. Focus on the surface. The default pinhole setting is Max. This allows you to easily focus on
the surface just like with a widefield microscope. Of cause focusing via the eyepieces is also
possible.
7. In the Channel tool, adjust the pinhole to the required diameter. For best performance of
the system we recommend setting the pinhole size to 1 Airy Unit (1AU button). Since the
depth of field is reduced in confocal images you most probably need to slightly adjust the
focus position.

8. Adjust the intensity of the laser. To do so, focus on the brightest section of the z-stack.
Then adjust the laser either via the 405 nm slider or the Master Gain slider. Adjust the in-
tensity so that you do not see any overexposed pixels (shown in red).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 800


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

9. In the Z-Stack tool, set up the Z-Stack by adjusting the z-range (upper and lower limit of
your z-stack). We recommend using First/Last mode for that.

à Make sure the whole surface, you want to measure, is within these limits. In case of a tile
scan you can use the navigation arrows in the Tiles tool to jump to the different tiles to
check.
10. Click on Next.
à The wizard moves to Step 2/2 Z-Stack Acquisition and starts the image acquisition.
à After image acquisition the topography image (height map) will be automatically gener-
ated. You will see the image in the center screen area after the acquisition and the pro-
cessing is finished.
11. Adjust the thresholds by using the Noise Cut slider, if necessary. Note that pixels below the
lower threshold are displayed in blue color and pixels above the upper threshold in red
color.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 801


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

12. Finish your work in ZEN by choosing the following options:


- If you click on Export to ConfoMap, the topography image will be directly opened in the
ConfoMap analysis software.
- If you click on Save Topography, you can save the topography image to the file system.
- If you click on Save Z-Stack, you can save the raw data of the z-stack.
You have successfully acquired a topography image. As the image analysis is performed with Con-
foMap software read the ConfoMap documentation for further information.

8.6.2 Measuring Layer Thickness

If you want to perform layer thickness measurement in ZEN, you need to start the topography
measurement wizard.

Prerequisite ü You are on the Applications tab.


1. In the Layer Thickness Measurement tool, click on Start.
à The wizard starts. In the left tool area you see the step 1/3 Setup, in which you can ad-
just the acquisition parameters for the topography image. In the center screen area you
see the live image from your sample in continuous mode.
2. In the Acquisition Mode tool adjust the settings for Objective, Frame Size, and Bits per
Pixel according to your requirements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 802


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

3. Focus on the surface. The default pinhole setting is Max. This allows you to easily focus on
the surface just like with a widefield microscope. Of course focusing via the eyepieces is
also possible.
4. In the Channels tool, adjust the pinhole to the required diameter. For best performance of
the system we recommend to set the pinhole size to 1 Airy Unit (1AU button). Since the
depth of field is reduced in confocal images you most probably need to slightly adjust the
focus position.

5. Adjust the intensity of the laser. To do so, focus on the brightest section of the z-stack.
Then adjust the laser either via the 405 nm slider or the Master Gain slider. Adjust the in-
tensity so that you do not see any overexposed pixels (shown in red).
6. In the Z-Stack tool, define the z-stack by adjusting the z-range (upper and lower limit of
your z-stack). We recommend to use First/Last mode for that.
à Make sure that all layers, you want to measure, are within these limits. In case of a tile
scan you can use the navigation arrows in the Tiles tool to jump to the different tiles to
check.
7. Click on Next.
à The wizard moves to step 2/3 Sectioning and starts the image acquisition.
à After image acquisition and processing you will see the image in the center screen area.
8. Click on X-Z Layer or Y-Z Layer to create the corresponding cross section you want to an-
alyze in detail.

9. Click on Next.
à The wizard moves to step 3/3 Measurement.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 803


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

à The selected cross section will appear on the right sight of the screen.

10. Draw in a profile perpendicular to your surface.


à The intensity distribution of your profile will appear left to the cross section.

11. Position the calipers on the maximum intensity of the profile.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 804


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

à A table with the measurement data will appear on top of the profile.

12. Click on Add measurement to table to transfer the data to the result table on the left.
Within the table you are able to rename the layers and calculate the true layer thickness by
adding the refractive index.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 805


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

13. Finally you have three options how to save your results:
- If you click Save table, the result table is saved on the file system.
- If you click Save selected profile, the drawn in profile is exported for further investiga-
tion in third party software.
- If you click Save Z-Stack, the raw data of the z-stack is saved on the file system.
You have successfully measured the layer thickness of your sample, saved the results table, the
profiles and the raw data of the z-stack.

See also
2 Layer Thickness Measurement Wizard [} 808]

8.6.3 Topography Tool

Parameter Description
Image Acquisition If this option is selected you can acquire an image by the help of the
Topography Measurement wizard.
The wizard guides you through the image acquisition. Then you can
export the image to ConfoMap for further processing.
The wizard is started by the Start button at the bottom of the tool.

Load Z-Stack If this option is selected, you can load an existing confocal z- stack
from the file system.
Therefore simply click on the folder icon and select the z-stack image
from the file system. If you click the Start button, the Topography
wizard will directly switch to the last wizard step to apply the noise
cut and transfer the data to ConfoMap.

Automatic Noise If activated, the wizard will automatically perform the noise cut filter-
Cut ing with the preset parameters in the tool.
If not activated, the noise cut filtering is an additional step in the To-
pography Measurement wizard.

- Thresholds Here you can define thresholds for 8-bit and 16-bit images.

Start If you click on this button, the Topography Measurement Wizard


[} 806] is started.

See also
2 Layer Thickness Measurement Tool [} 808]
2 Layer Thickness Measurement Wizard [} 808]
2 Acquiring Topography Images [} 798]

8.6.4 Topography Measurement Wizard

After selecting Image Acquisition in the Topography tool, the Topography Measurement
wizard consist of two steps:

Step 1/2: Setup


This step allows you to choose an experiment or setup imaging parameters for a new image ac-
quisition, e.g. number of tiles, acquisition mode or z-stack creation, see Step 1: Setup [} 807].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 806


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

Note that when you have selected Load Z-Stack in the Topography tool and you start the wiz-
ard, this step is not available.

Step 2/2: Z-Stack Acquisition


The second step is Z-Stack Acquisition. The acquisition will be performed automatically. Addition-
ally, you can apply noise cut filtering. Pixels which are effected by the thresholds will be displayed
in red (upper threshold) or blue (lower threshold), see Step 2: Z-Stack Acquisition [} 807].

Info
The noise cut filtering will be skipped if the checkbox Automatic Noise Cut in the Topogra-
phy tool is activated. The preset parameters will be immediately applied to the image and the
wizard continues with the export to ConfoMap.

See also
2 Topography Tool [} 806]
2 Layer Thickness Measurement Wizard [} 808]
2 Acquiring Topography Images [} 798]

8.6.4.1 Step 1: Setup

After the wizard is started, you will see the live image (Continuous mode) from your sample in the
Center Screen Area. You can setup the acquisition parameters in the left area of the screen. In the
next chapters the individual steps are described.
Note that these are default ZEN blue tools customized for acquisition of topography images, see
chapter Acquisition Setup Tools.

See also
2 Tiles [} 812]
2 Channel [} 811]
2 Acquisition Mode [} 810]
2 Z-Stack [} 812]

8.6.4.2 Step 2: Z-Stack Acquisition

Parameter Description
Noise Cut Here you can adjust the noise cut parameters manually. Therefore use
the slider or enter the lower and upper values in the input fields.

Save Surface Save the image of the surface to the file system.

Export to Con- Exports the image to the ConfoMap software. The ConfoMap soft-
foMap ware will be started automatically after you have clicked the button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 807


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

8.6.5 Layer Thickness Measurement Tool

Parameter Description
Image Acquisition If this option is selected, you can acquire an image by the help of the
Layer Thickness Measurement wizard.
The wizard guides you through the image acquisition. Then you can
export the image to ConfoMap for further processing.
The wizard is started by the Start button at the bottom of the tool.

Load Z-Stack If this option is selected, you can load an existing confocal z- stack
from the file system.
Therefore simply click on the folder icon and select the z-stack image
from the file system.

Start If you click on this button, the Layer Thickness Measurement wiz-
ard (see chapter > [} 808]) is started.

See also
2 Topography Tool [} 806]
2 Topography Measurement Wizard [} 806]
2 Measuring Layer Thickness [} 802]

8.6.6 Layer Thickness Measurement Wizard

After selecting Image Acquisition in the Layer Thickness Measurement tool, the Layer
Thickness Measurement wizard consist of three steps:

Step 1/3: Setup


In this step you choose an experiment or setup the imaging parameters for a new z-stack acquisi-
tion, e.g. track setup, acquisition mode, z-stack settings, see Step 1: Setup [} 809].

Step 2/3: Sectioning


In this step (orthogonal sectioning) you define the cross section of the sample, you want to ana-
lyze. Here, in addition to the center view (X/Y axis; blue frame), you will also see the section views
of the X/Z axes (top, green frame) and Y/Z axes (right, red frame), see Step 2: Sectioning [} 809].

Step 3/3: Measurement


In this step you draw one more intensity profiles in your cross section. In these profiles you can
measure and create tables containing the measurement results. Finally you can save the profile,
the z-stack or the result table, see Step 3: Measurement [} 809].

See also
2 Layer Thickness Measurement Tool [} 808]
2 Topography Measurement Wizard [} 806]
2 Measuring Layer Thickness [} 802]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 808


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

8.6.6.1 Step 1: Setup

After the wizard was started, you see the live image (Continuous mode) from your sample in the
Center Screen Area. You can setup the acquisition parameters in the left area of the screen. In the
next chapters the individual steps are described. Note that these are default ZEN blue tools cus-
tomized for acquisition of layer thickness measurement images.

See also
2 Channel [} 811]
2 Acquisition Mode [} 810]
2 Z-Stack [} 812]

8.6.6.2 Step 2: Sectioning

Here you can adjust the sectioning parameters.

Parameter Description
X-Z Layer (green) If selected the X-Z section will be used for further investigation.

Y-Z Layer (red) If selected the Y-Z section will be used for further investigation.

Cut Lines Here you adjust the position of the desired cut line. Therefore use the
slider or directly enter the position in the input field.

Mid button If you click on this button, the corresponding cut line will be posi-
tioned in the middle (center) of the image.

Line Width Here you adjust the line width of the corresponding cut line. Default
value is 1 (in pixel).

8.6.6.3 Step 3: Measurement

Here you can adjust the measurement parameters.

Parameter Description
Profile mode Here you can select the profile mode for the measurement:

- Arrow If selected, you can draw in an arrow in the profile. This will measure
the profile along the drawn in line of the arrow.

- Rectangle If selected, you can draw in a rectangle to the profile. This will mea-
sure the profile in the whole area of the rectangle.

Add measurement If you click on this button, the measurement result will be added to
to table the measurement table at the left side. In this table you can rename
your profile and correct the result by the refractive index.

Save selected pro- If you click on this button, the selected profile will be saved as .czt
file file.

Save Z-Stack If you click on this button, the Z-Stack image will be saved as .czi file.

Save table If you click on this button, the table will be saved as .czt file.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 809


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

8.6.7 Acquisition Mode

Here you adjust scanning and acquisition parameters that you want to apply for the entire experi-
ment.

Parameter Description
Frame Size Adjust the frame size (in pixel) of the displayed image by entering
the desired value in the two input fields.
To change the frame size you must stop the live image acquisi-
tion.

- Presets button By clicking on this button you can select from a list of default
frame sizes (e.g. 128 x 128 or 512 x 512).
In case of topography and layer thickness measurements we rec-
ommend starting with 1024 x 1024.

Scan Speed Set the scan speed by adjusting the slider from 1 (slow) to 16
(very fast).
Note that the available maximum scan speed depends on the se-
lected Frame Size and zoom factor. In Airyscan MPLX mode the
speed is indicated in frames per second, an estimate of pixel time
and pixel number (without scanner return time). The actual frame
rate might be lower especially with very small frames.

- Confocal button By clicking on this button the frame size (image resolution) will
be set to an optimal value corresponding to the optical magnifi-
cation (objective) and the zoom factor.
This provides an image where no information is lost and no
empty data are generated as optimal sampling is achieved. The
optimal value is calculated for the given objective and magnifica-
tion settings matching a 2-fold oversampling according to 2 fold
Nyquist. Rectangular image dimensions are preserved.

Direction Following scanning directions can be selected:

- Unidirectional The laser scans in one direction only, then moves back to scan
the next line.

- Bi-directional The laser also scans when moving backwards, i.e. the scan time
is halved.
In case a pixel shift between forward and backward movement
(double image), resulting from bidirectional scanning, is visible,
use the Correction X/Correction Y sliders to correct it.
By clicking on the Auto button, an automatic scan correction will
be performed.

Averaging

- Number Select the number of images you want to average (1 - 16).

- Method Select the method which will be used for averaging:


§ Mean Intensity:
Uses the mean average of all images

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 810


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

Parameter Description
§ Sum Intensity:
Uses the sum of all images.

- Bits per Pixel In the drop-down list you can adjust the color bit depth to 8 Bit
or 16 Bit (i.e. 256 or 65536 gray values).
To change the bit depth you must stop the live image acquisi-
tion.

Scan Area In this section, you can adjust the position of the scan area.
The outer frame corresponds to the field of view of the micro-
scope.
The inner frame represents the scan area. All changes (Offset,
Rotation, Zoom) made in this section will be immediately applied
to the scan area.
Following functions are available:

- Offset Adjust the offset by using the Left/Right or Up/Down sliders.


You can also enter a specific value in the input field.
By clicking on the C button behind the input filed, the offset po-
sition will be reset to center position.
If you left-click on the inner frame and hold down the mouse
button, you can move the scan area freely. The positions in the
input fields will be adopted according to your adjustments.

- Rotation Adjust the rotation degree by using the Rotation slider. You can
also enter a specific value in the input field. By clicking on the O
button behind the input field, the rotation degree will be reset to
default position (zero degree).

- Zoom Adjust the zoom level (from 0.5x - 40x) by using the Zoom
slider. You can also enter a specific value in the input field.
If you click on the 1/2 button behind the input field, the zoom
level will be reset to default (0.5x).

- Reset Scan Area Resets all adjustment to the system defaults.

8.6.8 Channel

With this tool you control and adjust the laser. The following parameters are available:

Parameter Description
405 nm Here you can set the required attenuation (in %) of the laser using the
slider, the arrows, or typing in the input field.

Pinhole Adjusts the diameter of the pinhole.


The diameter is specified in micrometer. The text below translates this
diameter to Airy Units (AU) and section thickness.
For confocal topography measurements a pinhole size of 1 AU is rec-
ommended.

- 1 AU Sets the pinhole diameter to the recommended value of 1 AU (Airy


Unit).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 811


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

Parameter Description
- Max Opens the pinhole to its maximum diameter.
(Default)
This is also the default setting for the pinhole. This allows you to easily
focus on the surface just like with a widefield microscope. Of cause
focusing via the eyepieces is also possible.

Master Gain Here you can control the voltage of the PMTs. Higher voltage in-
creases the gain of the PMT. The image becomes brighter and you
may be able to reduce the laser power. At higher voltage, the noise
level in the image increases.
The optimum between gain and noise depends on your experimental
requirements and on your sample. The maximum available voltage for
multialkali PMTs is 900V.

Digital Offset Here you can perform adjustments on the background of the image.

Digital Gain Here you can digitally amplify the laser signal.

8.6.9 Tiles

Here you setup the tiles acquisition. The following parameters are available:

Parameter Description
Number of Tiles Here you can enter the desired number of tiles in X- and Y-direction.

Set stage position If you click on this button, the current stage position is defined as
starting position for the tiles acquisition.

Start position Here you can define the alignment of the tile scan in respect of the
mode defined position.

- Center If selected, the start position is the center of the tile scan.

- Upper Left If selected, the start position is the upper left corner of the tile scan.

Navigation Click on the arrow button to show the section in full.


Here you can check if each single image of your tile image is in focus
before you start the acquisition.
Navigate from on tile to another by using the arrow buttons or enter
the X/Y value, to check the set-up of your z-stack.

Start position Displays the X and Y value of the starting position for the tiles acquisi-
tion.

8.6.10 Z-Stack

Here you setup the acquisition of the Z-Stack image.

Info
Z-stack images are always acquired from bottom to top automatically, irrespective of whether
you have defined the top or bottom Z-plane of your stack as the first Z-plane. This acquisition
sequence increases the accuracy of the Z-positioning.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 812


8 Special/Hardware Related Modules | 8.6 Confocal Topography ZEISS

For manually configuring Z-Stacks you have two modes available:

Parameter Description
First/Last If activated, you are able to configure the Z-stack via setting the first
and the last positions of the Z-stack, see Configuring a Z-Stack Man-
ually (First/Last Mode) [} 396].

Center If activated, you are able to configure the Z-stack via setting the cen-
ter plane of the Z-stack, see Configuring a Z-Stack Manually (Center
Mode) [} 396].

Depending on which mode you have activated, you will see the following parameters for config-
uring the Z-stack:

Parameter Description
Set Last/Set First Only visible for First/Last mode.
By clicking on the Set Last and on the Set First button you deter-
mine the current position as last or first position of the Z-stack.

Range Displays the range of the configured Z-stack from the last to the first
section plane.

Slices Here you can enter the number of Z-slices that the Z-stack will have.

Interval Here you can enter the desired distance between the Z-slices.

Optimal The number on this button shows the distance calculated for the
channels set and the current microscope according to the Nyquist cri-
terion. If you click on the button, this value is automatically adopted
into the Interval input field.

Keep § Interval:
Keeps the set interval between the section planes constant if you
change configuration parameters in the Z-Stack tool.
§ Slice:
Keeps the set number of Z-slices constant.

Center Only visible for Center mode.


By clicking on this button, the current position is set for the central Z-
plane. You can also enter the value in the input field to the right of
the button.

Offset Here you can enter a value for an offset if desired.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 813


9 Reference | 9.1 Menus ZEISS

9 Reference
9.1 Menus

9.1.1 File Menu

Menu item Description Short


cut
New Document Opens the New Document dialog. You can create Ctrl +
new images or new tables. For more information, see Shift+N
New Document [} 817].

Open... Opens the Open Document dialog window. Here you Ctrl+O
can select the file you want to open.

Save Saves the selected file. Ctrl+S

Save As CZI Saves the selected file under a new name. In case of an Ctr-
image only .czi file format can be used. l+Shift+
S

Save As with Op- Saves the selected file under a new name. Advanced
tions... options can be selected:
File type: czi, jpeg, jpg, png, tif, tiff, bmp, gif, wmp,
wdp
Compression (only for czi and jpg/jpeg):
§ Original: The image keeps the compression of the
original image.
§ Uncompressed: The image is saved without com-
pression.
§ Compressed (JPEG XR): An uncompressed image
will be compressed with the selected quality. A com-
pressed image keeps the compression.
§ Force Compression (JPEG XR): A compressed im-
age will be decompressed and compressed with the
selected quality.

Zoom Level (only for pyramid images): Different zoom


levels can be selected, depending on the image pyra-
mid.
Set as default: Sets the selected options as default
saving options.

Rename Opens the Rename dialog window. Enter a new name


for the file. Confirm the entry with Yes.

Delete Deletes the selected file.

Export/Import § Export Ctrl+6


Opens the image processing function Image Export
[} 120] to export an image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 814


9 Reference | 9.1 Menus ZEISS

Menu item Description Short


cut
§ Movie Export
Opens the image processing function Movie Export
[} 127] to export images in the form of film se-
quences.
§ OME TIFF Export
Opens the image processing function OME TIFF Ex-
port [} 132] to export images into OME TIFF format.
§ ZVI Export
Opens the image processing function ZVI Export
[} 135] to export images into ZVI format.
§ MRC Export
Exports image data into the MRC format, which is
compatible to SerialEM. It also creates a NAV file,
which stores positions of interest. For more informa-
tion, see Exporting Data for SerialEM [} 634].
§ Import
Opens the image processing function Image Import
[} 125] to create a multidimensional image (multi-
channel, z-stack, time series, tile, position image)
from individual images.
§ BioFormats Import
Imports third-party images using BioFormats as an
integrated library for reading and writing life sci-
ences image file formats, see Importing Third-party
Images [} 631].
§ Import TXM
Opens the image processing function Import TXM
[} 127] to import a txm file to ZEN.

Send to arivis Pro This function is only available, if arivis Pro is installed
and has a valid license.
When using this command, arivis Pro opens and the
current image is imported into arivis Pro. The current
display settings in ZEN are preserved as much as possi-
ble.
Note: special CZI image types such as ApoTome raw
images, Airyscan raw images, or some other image
types are not always supported in arivis Pro. In these
cases convert them into normal processed images be-
fore sending them to arivis Pro for further analysis.

Add to ZEN Connect Adds the image to the currently opened ZEN Connect
Project project.

Send to ZEN Black The software installation includes a copy of ZEN


Black. In some cases it might be necessary to transfer
images from the software to ZEN Black to make use
of special functions found only in ZEN Black.

Close Closes the selected file. Ctrl+F4

Save All Saves all open files.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 815


9 Reference | 9.1 Menus ZEISS

Menu item Description Short


cut
Show Welcome Opens the Welcome Screen.
Screen

Open File Browser Opens the file browser in the Center Screen Area. Ctrl+F

Open Containing Opens the folder in which the selected file is located.
Folder

ZEN Data Storage Only available if you have a connection to ZEN Data
Storage and the module is activated in Tools > Op-
tions.
§ Open Image
Displays a dialog to open an image from ZEN Data
Storage.
§ Save Image
Saves the current image to the ZEN Data Storage.
§ Open ZEN Connect Project
Displays a dialog to open a Connect project from
ZEN Data Storage.
§ Save and Convert ZEN Connect Project
Saves the current Connect project to the ZEN Data
Storage.

Recent Files... Opens the Recent Files dialog window. The Recent Ctrl+R
Files dialog displays the files you have used previously,
separated according to file type.

Recently Opened Opens a list containing the file paths of recently


Files opened files.

Print Preview Opens the Print Preview [} 818] dialog for the selected Ctrl+F2
file.

Login Opens the Login dialog window.

Tiles Opens a submenu with functions associated with the


tiles tool. Here, parameters can be imported and ex-
ported.
§ Export Tiles Experiment
Opens a dialog to export the current Tiles experi-
ment either to an XML or a CSV file.
§ Import Tiles Experiment
Opens a dialog to import a Tiles experiment either
from an XML or a CSV file.
§ Import Stage Marks
Imports the existing positions from the Stage tool
as single positions in the tiles experiment.
§ Import Preview Image
Imports an existing image document as a preview
image into the Navigation/Tiles view. This function
is also available with right mouse-click in the Tiles -
Advanced Setup view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 816


9 Reference | 9.1 Menus ZEISS

Menu item Description Short


cut
§ Save Preview Images
Saves existing preview/snap images into a separate
image document.
§ Extract Sample Carrier Template
Opens a dialog to extract the current sample carrier
template from the tiles experiment as a new tem-
plate with the calibrated dimensions.

Restart Microscope Only visible for ZEN celldiscoverer.


Enables you to restart the microscope remotely, see
Restarting the Microscope Remotely [} 1166].

Exit Exits the software. Alt+F4

See also
2 Image Export [} 120]

9.1.1.1 New Document Dialog

Here you can create different types of new, empty documents (images, tables, and ZEN Connect
projects).
Select the desired document type and click on OK. The image or table will be generated and
opened in the current workspace.

Parameter Description
Images Creates a new, empty image file (*.czi).

Tables Creates a new table (*.czt).


The following elements are only visible if you have clicked on the Ta-
bles button:

- Document Here you can enter the name of the new table-document.
name

- Columns Enter the number of columns that you want the new table to have in
the input field.

- Rows Enter the number of rows that you want the new table to have in the
input field.

- Column Name Here you can enter the title of the column.

- Column type Here you can select the desired data type of a column. The following
types are available:
§ String
§ Integer
§ Real

- Default Value Here you can enter a default value that you want the column cell to
contain.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 817


9 Reference | 9.1 Menus ZEISS

Parameter Description
ZEN Connect Creates a ZEN Connect project. For more information, see Creating
Project a ZEN Connect Project [} 625].

9.1.1.2 Print Preview Dialog

Parameter Description
Printer Selects the printer you want to use.

Properties Opens a dialog containing the printer properties where you can con-
figure advanced settings. This dialog window depends on the printer.

Format Selects the page format e.g. A0 to A6, Letter or A4 Register.

Width Displays the width of the page according to the chosen format.

Height Displays the height of the page according to the chosen format.

All pages Activated: Prints all pages of the report.

Selected Pages Activated: Prints a certain number of pages of the report.


In the input field to the right, enter the pages that you want to print.
Example: The entry 1-3; 5 prints pages 1,2,3 and 5.

Pages per sheet Selects how many pages you want to print on one sheet.

Number of copies Defines the number of copies that you want to print.

Collated Only active if you have selected to print several copies.


Activated: Sorts the pages of each copy printed.

Auto fit Activated: Adjusts the size of the report or image to the size of the
page.

Scale pages Activated: Adjusts the size of the report or image to the factor set in
the input field to the right. Here you can set the desired enlargement/
reduction factor for the report or image.
A factor of 100% corresponds to the Auto fit option.

Print Prints the report using the currently set options.

Displays the next page.


Down

Displays the previous page.


Up

Auto fit Selects the zoom factor with which the page view is displayed in this
dialog.

9.1.2 Edit Menu

Menu item Description Short


cut
Undo Undoes the last action. Ctrl+Z

Redo Redoes the last action. Ctrl+Y

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 818


9 Reference | 9.1 Menus ZEISS

Menu item Description Short


cut
Cut Cuts the selected graphic element out of the image. Ctrl+X
Shift+D
el

Copy Copies a selected item to the clipboard. With an image Ctrl+C


document being active and no graphical elements se- Ctrl+Ins
lected, a copy of the image is created and put in the
clipboard to be used outside the ZEN software. If a
graphical element is selected, it will be copied.

Paste Inserts the copied graphic element into the active im- Ctrl+V
age. Shift+In
s

Delete Deletes the selected element. Del

Select All Selects all graphic elements drawn into the image. Ctrl+A

Display Here you can manage image display settings. Functions


include copy, paste, export or import of the display set-
tings.

ROI (Region of Inter- Draw a certain rectangular region that is of particular Ctrl+U
est) > Draw Region interest to you into the image. The ROI is displayed
of Interest with a red "marching ants" line. You can draw several
regions into an image.

ROI (Region of Inter- Draw a certain rectangular region that is of particular Ctr-
est) > Draw Rotat- interest to you into the image. This region can be ro- l+Shift+
able Region of Inter- tated and is displayed with a yellow "marching ants" R
est line. You can draw several regions into an image.
Note: When used on whole slide images, this function
cuts out the pixel data encompassed by the line. This
can create images with tiles of different sizes. Such im-
ages can be incompatible with certain processing func-
tions. You can instead use the Create Image Subset
processing function and activate the Keep Tiles to
keep all tiles be of the same size.

ROI (Region of Inter- Creates new image documents from the selection re- Ctr-
est) > Create Subset gions you have drawn in. All dimensions of the image l+Shift+
Images from ROI are taken into account here. This function works for C
both the non-rotatable and rotatable ROIs (the red and
the yellow regions).
Note: When used on whole slide images, this function
cuts out the pixel data encompassed by the line. This
can create images with tiles of different sizes. Such im-
ages can be incompatible with certain processing func-
tions. You can instead use the Create Image Subset
processing function and activate the Keep Tiles to
keep all tiles be of the same size.

Create Image from Creates an image from the current view and opens it
View as a new document in ZEN.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 819


9 Reference | 9.1 Menus ZEISS

9.1.3 View Menu

Menu item Description


Zoom Here you can configure various zoom settings.

Player Here you can navigate through a Z-stack or a time series im-
age.

Text View Displays the text name of a file in the Document bar.

Small Thumbnail View Displays a small preview image and the name of a file in the
Document bar.

Large Thumbnail View Displays a large preview image and the name of a file in the
Document bar.

1 Container Displays one image container in the Center Screen Area.

2 Containers Displays two image containers in the Center Screen Area.

3 Containers Displays three image containers in the Center Screen Area.

Automatic Container Lay- Uses the predefined container layout.


out

Shared View Controls General and specific view controls are shared for all contain-
ers and are active for the currently selected image container.

Separate View Controls Each container has its own separate general and specific view
controls that become active when the associated image con-
tainer is selected.

Show All (Global) Activates the Show All mode in every tool.

Show Macro Environment Activates the Macro Tool [} 979] in the Right Tool Area. If
you have licensed the Macro Environment module, the
Macro menu appears in the Menu bar. The Macro Environ-
ment is deactivated by default.

9.1.4 Acquisition Menu

Menu item Description Short cut


Locate Snap Acquires a single image with the F2
active camera.

Locate Live Shows a live image from the ac- Shift+F2


tive camera in the Center Screen
Area. On the Locate tab the
Live mode is activated.

Acquisition Snap Executes only if you have defined


at least one channel on Acquisi-
tion tab in the Channels tool.
Acquires and displays all the de-
fined channels as an overlay.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 820


9 Reference | 9.1 Menus ZEISS

Menu item Description Short cut


Acquisition Live Executes only if you have defined
a channel on Acquisition tab in
the Channels tool.
Uses the currently selected chan-
nel for a live image.

Set Exposure Executes only if you have defined


a channel on Acquisition tab in
the Channels tool.
Executes an exposure time calcu-
lation for the active camera.

Set White Balance Executes a white balance mea- Alt+W


surement.

Find Focus Executes the Software Autofocus


Running. On the Acquisition tab
the Find Focus mode is acti-
vated.

Start Experiment Only active if you have config-


ured an experiment on Acquisi-
tion tab.
Starts a defined experiment.

Stop Experiment Only active if you have started an


experiment on Acquisition tab.
Stops a running experiment.

Pause Experiment Only active if you have started an


experiment on Acquisition tab.
Pauses a running experiment.

Continue Experiment Only active if you have paused an


experiment on Acquisition tab.
Continues the paused experi-
ment.

Dual Camera Calibration Only visible if a dual camera con-


Wizard… figuration is active.
Starts Dual Camera Calibration
Wizard.

ApoTome Phase Calibra- Only visible if a ApoTome config-


tion Wizard… uration is active.
Starts ApoTome Phase Calibra-
tion Wizard.

ApoTome Focus Calibra- Only visible if a ApoTome config-


tion Wizard… uration is active.
Starts ApoTome Focus Calibra-
tion Wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 821


9 Reference | 9.1 Menus ZEISS

9.1.5 Graphics Menu

Menu item Description Short cut


Select Starts the selection mode. Alt+F1

Draw Region of Interest Allows you to draw in a region of interest (ROI). Crtl+U

Text Allows you to add a text field to the image.

Scale Bar Allows you to add a scale bar to the image.

Line Allows you to add a line to the image.

Arrow Allows you to add an arrow to the image.

Rectangle (aligned) Allows you to add an aligned rectangle to the Alt+F2


image.

Circle (Diameter) Allows you to add a circle to the image.

Ellipse Allows you to add an ellipse to the image.

Contour (Spline) Allows you to add a contour (spline) to the im-


age.

Profile Adds an intensity profile along a drawn in ar-


row region.

Rectangle Profile Adds an intensity profile within the drawn in


rectangle region.

Scaled Profile Adds an intensity profile with a scaling bar to


the image.

Grid Activated: Adds a grid to the image, see also


Displaying and Adapting a Grid in the Image
Area [} 41].

Frequent Annotations Adds frequently used annotations to the image,


e.g. Relative Time, Channel Name.

Distance Adds distance annotations to the image, e.g.


Length, Curve length.

Multiple Distances Allows you to add annotations for measuring


multiple distances to the image.

Region Allows you to add region annotations to the


image, e.g. Contour, Rectangle.

Circle Allows you to add circle annotations to the im-


age.

Angle Allows you to add angle annotations to the im-


age.

Points Allows you to add points of interest (POI) to the


image such as events or markers.

Format Allows to open the dialog for formatting


graphical elements. Also you will find options
for resetting customized graphical elements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 822


9 Reference | 9.1 Menus ZEISS

Menu item Description Short cut


Burn-in Annotations... Creates a new image with all annotations
burned-in to the image.

Show Bounding Box Shows bounding boxes around graphics/anno-


tations.

Hide Bounding Box Hides bounding boxes around graphics/annota-


tions.

Bring to Front Brings the selected graphical element(s) to the


front of the image.

Send to Back Sends the selected graphical element(s) to the


back of the image.

Bring Forward Brings the selected graphical element(s) one


layer forward.

Send Backwards Sends the selected graphical element(s) one


layer backward.

9.1.6 Macro Menu

Info
This menu is available only if you have licensed the Macro Environment module.
Activate the Macro Environment controls in the View menu by clicking on Show Macro Envi-
ronment.

Menu item Description


Record a New macro Starts recording a new macro.

Stop Recording Stops recording the macro.

Macro-Editor… Opens the Macro Editor Dialog [} 823].

9.1.6.1 Macro Editor Dialog

The macro editor represents the IDE (Integrated Developer Environment) to edit, execute, debug
and manage macros. It is started via the menu Macro > Macro Editor or from the Macro tool in
the Right Tool Area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 823


9 Reference | 9.1 Menus ZEISS

1
2
3

1 Menu bar
For a detailed description of the menus, please read Macro Editor Menus [} 824].

2 Tool bar
With the icons you can quickly access the most important functions, like saving or editing
macros.

3 Button bar
Here you find the buttons to record and control macros. For more information, see But-
ton Bar [} 826].

4 Macro list
Displays all macros and folders. The macros can be moved into a different folder via drag
and drop. Macros and folders can be edited via right-click context menu, see also Macro
List Context Menu [} 827].

5 Code Window
The central area of the Macro Editor shows the program code of the selected macro. Edit
and write your macros in here. You can either use the Record button or type in the pro-
gram code directly. Also a multi-document view is available, meaning that you can open
several code windows at once.

6 Watch/ Message Window


Here you can observe variables of the macro program code. Enter the variable directly in
the column Name. You can also mark the variable in the macro and add it using Add
Watch of the right mouse key context menu.
The Message window displays messages when using the print command in a macro.

9.1.6.1.1 Macro Editor Menus

File Menu

Menu item Description Short


cut
New Macro Opens the New Macro in the Macro programming
area.

Import Opens a file browser to select and import a macro.

Save Saves the selected macro. Ctrl+S

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 824


9 Reference | 9.1 Menus ZEISS

Menu item Description Short


cut
Save As… Saves the macro under a new name.

Rename… Opens the Rename dialog window. Enter a new name


for the macro.

Delete Deletes the selected macro.

Close Closes the selected macro.

Edit Menu

Menu item Description Short


cut
Cut Cuts the selected line out of the macro. Ctrl+X
Shift+D
el

Copy Copies the selected line in the macro. Ctrl+C


Ctrl+Ins

Paste Inserts the copied line into the macro. Ctrl+V


Shift+In
s

Find Finds the entered text. Ctrl+F

Replace Replaces the detected text with the new text.. Ctrl+H

Undo Undoes the last action. Ctrl+Z

Redo Redoes the last action. Ctrl+Y

Record Menu

Menu item Description


Record Starts recording.

Stop Recording Stops the recording of the active macro.

Debug Menu

Menu item Description Short


cut
Start Debugging Starts the debugger and executes the macro up to a F5
breakpoint or error.

Start Without Debug- Executes the macro up to a breakpoint or error without Ctrl+F5
ging debugging.

Pause Pauses debugging. Shift+F


5

*Continue (DEBUG) Continues debugging. Shift+F


5

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 825


9 Reference | 9.1 Menus ZEISS

Menu item Description Short


cut
Stop Stops the running macro at the active command. Shift+F
5

Step Into Starts the debugger stepwise, command by command, F11


without stepping into function blocks.

Step Over Starts the debugger stepwise, command by command, F10


and steps into function blocks.

Step Out Starts the debugger stepwise, command by command, Shift+F


and steps out of function blocks. 11

Toggle Breakpoint Sets/removes a breakpoint in the active line to stop/ F9


continue the macro in debug mode.

Set Line To Execute Sets the pointer in the next active command line. F8

Reset Resets all variables of the Python interpreter.

Help Menu

Menu item Description Short


cut
Contents... Opens the Online Help dialog. Ctrl+F1

Macro Object Opens the Macro Object Model Online Help dialog.
Model… This documentation includes descriptions of all objects
available for the macro editor.

Forum… Opens the OAD forum in your web browser.


Internet access required.

GitHub Opens the ZEISS GitHub page for OAD in your web
browser.
Internet access required.

9.1.6.1.2 Button Bar

On this bar you find the buttons to record and control macros.

Parameter Description
New Creates a new empty macro.

Record Starts macro recording.

Run Executes the active macro completely.

Debug Starts the debugger and executes the macro up to a breakpoint or er-
ror.

Step Over Starts the debugger stepwise, command by command, without step-
ping into function blocks.

Step Into Starts the debugger stepwise, command by command, and steps into
function blocks.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 826


9 Reference | 9.1 Menus ZEISS

Parameter Description
Step Out Starts the debugger stepwise, command by command, and steps out
of function blocks.

Pause Pauses macro recording.

Stop Stops the running macro at the active command.

Reset Resets all variables of the Python interpreter.

Breakpoint Sets/removes a breakpoint in the active line, to stop/continue the


macro in debug mode, in the active line.

Set Line Sets the pointer in the next active command line.

Run to cursor Sets the pointer to the current cursor position.

9.1.6.1.3 Macro List Context Menu

Folder menu
This context menu is only displayed if you right-click a folder in the Macro list.

Parameter Description
Add Macro Adds a new macro to the folder.

Add Folder Adds a new subfolder.

Rename Allows renaming the folder.

Delete Deletes the folder.

Replace with Con- Deletes the folder and moves all macros in the folder into the next
tent higher folder.

Expand All Only available for folder on the top level.


Expands all (sub-)folders.

Collapse All Only available for folder on the top level.


Collapses all (sub-)folders.

Macro menu
This context menu is only displayed if you right-click a macro in the Macro list.

Parameter Description
New Creates a new macro.

Save Saves the current changes.

Save as Saves the macro with a new name.

Rename Allows renaming the macro.

Delete Deletes the macro.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 827


9 Reference | 9.1 Menus ZEISS

9.1.7 Tools Menu

Menu item Description


Axio Scan Calibration… Only available for Axio Scan systems.
Opens the Axio Scan Calibration wizard. By the wizard you
can calibrate the following functions:
§ mapping of the preview camera to the scan camera,
§ parfocality of the objectives,
§ parcentricity of the objectives.
§ shading correction of the optical system (including fluores-
cence) and color calibration.

It is not necessary to execute all steps, e.g. the shading cor-


rection for fluorescence and the color calibration can be
skipped.

Diagnostics Opens the Diagnostics dialog. There you receive detailed re-
ports on your entire system state.
Ctrl+Shift+D

Kitchen Timer… Opens the Kitchen Timer dialog. There you can set a time
period after which an alert is played.

Dosimeter… Opens the Dosimeter dialog. There you can set multiple time
points at which an alert is played.

Dye Editor… Opens the Dye Editor Dialog [} 55].

Extension Manager… Opens the Extension Manager dialog.

Modules Manager… Opens the Modules Manager [} 829] dialog.

Users and Groups... Opens the Users and Group Management [} 829] dialog.

Settings Editor... Opens the Settings Editor dialog.


Select from existing hardware settings or adopt the settings
from the hardware being used into the software. You can
also transfer settings from the software to the hardware that
you are using.

System Maintenance and Opens the System Maintenance and Calibration dialog.
Calibration...
Helps to keep your system in perfect working condition.

Calibration Manager… Opens the Calibration Manager dialog.

Customize Application… Opens the Customize Application [} 829] dialog.

Scaling… Opens the Scaling [} 831] dialog.

Sample Carrier/Holder Opens the Sample Carrier Templates dialog.


Templates…

Options… Opens the Options Dialog [} 833].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 828


9 Reference | 9.1 Menus ZEISS

9.1.7.1 Modules Manager Dialog

Here you can activate or deactivate the modules for which you currently own a license. Note that
all the changes made here are implemented immediately.

Parameter Description
Available Products Here you can see the products available for your license. Click on the
relevant button to select the product.

Included Modules In this list you can activate/deactivate the modules that are included
with your product.
Activate the checkbox to activate the corresponding module.

Optional Modules In this list you can activate/deactivate the modules that you have li-
censed as an option for your product.

Optional Hardware In this list you see the hardware that you have configured.

Select All Activates all available modules.

Unselect All Deactivates all available modules.

Save Information... Saves the current selection of modules within a .txt file.

9.1.7.2 User and Group Management Dialog

Here you can create new users and groups and manage their access rights. Activate the user and
group management by activating the checkbox Enable User Management. For more details see
also User Management [} 42].

See also
2 Creating a New User [} 43]
2 Adding Users to a Group [} 45]
2 Managing Access Rights for User Groups [} 46]

9.1.7.3 Customize Application Dialog

Here you can customize the application layout, e.g. adopt the toolbar or shortcuts.
To learn more about how to customize the application, read the chapter Customizing Toolbar
[} 39].

Toolbar Tab
Here you can add menu items to the Toolbar as buttons for a quick access.

Parameter Description
Available Toolbar In this list you see all menu items that you can add to the Toolbar.
items

Adds a selected item to the tool bar. It then appears in the Selected
Toolbar Items list.
Add

Selected Toolbar In this list you see all the added menu items. Select the items here in
Items order to sort them.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 829


9 Reference | 9.1 Menus ZEISS

Parameter Description
Deletes a selected item from the Selected Toolbar Items list.
Delete

Up Moves a selected item one position up in the Selected Toolbar


Items list.

Down Moves a selected item one position down in the Selected Toolbar
Items list.

Separator Inserts a vertical separator into the Toolbar after the currently se-
lected item of the Selected Toolbar Items list.

Close Closes the Customize Application dialog and saves the adjustments.

Shortcuts Tab

Parameter Description
Available Com- In this list you see all commands from the Menubar and edited
mands Macros. Klick on the arrow on the left of the entry to show available
commands.

Shortcut for the If you have selected a command from the Available Commands list,
selected item: the related shortcut is displayed here.
If the field is empty, no shortcut yet exists for the selected command.

Remove Deletes a shortcut of the selected command.


Default shortcuts, e.g. Ctrl+S can not be removed.

Type a shortcut Here you can type in a shortcut by clicking on the desired keys of your
keyboard.
If a shortcut is already used for another command, it is displayed in
the Shortcut is used by: display field.

Add Adds a shortcut to a chosen command.

Shortcut is used If you typed in a shortcut which is already used, the related command
by: is displayed here.

All commands In this list you see all the shortcuts and their related commands.
with shortcuts:

Close Closes the Customize Application dialog and saves the adjustments.

Soft Keys Tab

Parameter Description
Available Items list In this list you see all items from the Menubar, Hardware Settings
and edited Macros. Klick on the arrow on the left of the entry to
show available items.

Soft Keys The items from the Available Items list can be assigned to the but-
tons Function0-Function9 via drag & drop.

Reset All Resets all the adjustments.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 830


9 Reference | 9.1 Menus ZEISS

Parameter Description
Close Closes the Customize Application dialog and saves the adjustments.

9.1.7.4 Calibration Manager Dialog

In this dialog several categories of calibration files and references are stored. These entries are
mainly for your information. You can update the list, delete entries, write comments and copy the
list to the clipboard. For Axioscan 7 clinical, many categories are empty since they are not rele-
vant.

9.1.7.5 Scaling Dialog

Fig. 53: Scaling Dialog


Here you can specify how your images are scaled.

Parameter Description
Active Scaling: Displays the currently set scaling.

Units Selects the desired unit for the current scaling.

Select Automati- Activated: Calculates the scaling automatically from the microscope
cally and camera configuration.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 831


9 Reference | 9.1 Menus ZEISS

Parameter Description
Scaling List Selects a scaling. The available scaling are the ones which are stored
on your system, e.g. Pixel, Theoretic. The list also includes the scal-
ings you created manually.
The scaling details are displayed in the fields below the list. If a display
field is empty, it is not used in the calculation of the scaling.

Displays options for the currently selected scaling:


Options

- Activate Scal- Activates the selected scaling. The scaling will be applied to all images
ing that are acquired from this time point onward.

- Assign Scaling Assigns the selected scaling to the current image.


to Image

- Import Opens the Import Scaling dialog window where you can select a
scaling file (.czsc) that you want to import.

- Export Opens the Export Scaling dialog window to export the selected scal-
ing. Select the folder in which you want the exported scaling file to be
saved and specify a file name (.czsc).

- Delete Deletes the selected scaling.

Interactive Calibra- Opens the Open file for interactive scaling dialog, if there is no im-
tion... age selected yet.
Starts the scaling mode and displays the Scaling Wizard [} 832] in
the Center Screen Area for the currently selected image.

9.1.7.5.1 Scaling Window

Here you can create a new scaling. To do this, draw a reference line with a predefined length into
the current image. An image of a calibration slide is best suited for this purpose.

Fig. 54: Scaling Window

Parameter Description
Tool Bar Here you can draw in two types of reference line. Therefor klick on
one of the following buttons.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 832


9 Reference | 9.1 Menus ZEISS

Parameter Description
- The cursor is in selection mode. You can move the dialog window or
select a reference line to edit it.
Select

- Draw Refer- This tool is selected by default.


ence Line
With that tool you draw a line along a distance with a known length
(e.g. using an object micrometer or calibration slide). Then you can
adjust the length and units in the input field and dropdown list.

- Draw Parallel With that tool you draw two parallel lines along a distance with a
Reference Line known length. The two parallel lines correct errors in the parallel axis
resulting from the drawing of the lines. A third, corrected line is
drawn automatically from which the scaling is determined.

Automatic Line Activated: Automatically detects individual lines of the scale bar in
Detection the image close to the interactively defined distance. Using this
method the centers of the lines are determined exactly, increasing the
precision of the scaling.

Length Input Field Defines the length of the line you have drawn in.

Unit Selection Selects the corresponding unit of your drawn in line.

Scaling Displays the calculated pixel scaling according to the drawn in line.

Name Defines the name for the scaling that will be created.

Save Scaling Saves the scaling that has been created with the specified name. The
scaling can be selected in the Scaling dialog for Available Scaling.

9.1.7.6 Options Dialog

Here you can configure the settings for general software options.

9.1.7.6.1 General Tab

Parameter Description
Select Automatically Activated: Automatically selects the user language of the oper-
ating system as the user language for the software.

Fixed Language Select the language from the dropdown list in which the soft-
ware will be run next time it is started.

9.1.7.6.2 Startup/Shutdown Tab

Parameter Description
Show Application Activated: Displays the application selection dialog when the soft-
Selection ware starts.

Smart Application Activated: Displays the smart application selection dialog when the
Selection software starts.

Reload Last Used Activated: Reloads all image documents, which were open when you
Documents last exited the system when the software starts.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 833


9 Reference | 9.1 Menus ZEISS

Parameter Description
Experiment Not relevant for Axioscan 7 clinical.
Selects the desired behavior on system start up with regard to the ex-
periment management on the Acquisition tab.

- Load Default Loads an experiment with the set default values.


Experiment

- Load Empty Loads an empty experiment.


Experiment

- Load Last Loads the last used experiment.


Used Experi-
ment

Request Stage/Fo- Activated: Shows a message which asks you to perform stage/focus
cus Calibration on calibration. This is not relevant for Axioscan 7 clinical. The stage and
Startup focus will always be calibrated automatically during start up.

Show Welcome Activated: Displays the Welcome Screen when the software starts.
Screen on Startup

9.1.7.6.3 Naming Tab

Info
Axioscan 7 clinical
This section is not relevant for Axioscan 7 clinical. Naming is controlled using the Naming tool
on the Scan tab.

Here you can specify how images are (automatically) named and indexed. Changes will be stored
after the session is ended.

Parameter Description
Name Preview Displays the preview of the naming format that will be allocated
next for the selected category.

Category Selects the category of the file you want to be named automati-
cally, e.g. an image or an experiment.

Format Specifies what information you want to include to the file name.
The info icon offers a tooltip with a list of IDs you can add.

Prefix Sets a prefix for the file name, e.g. IMG.

Suffix Sets suffix for the file name.

Digits Selects how many digits you want the counter to have.

Initial Counter Value Here you can enter the desired first value of the counter.

Save/Restore Counter Activated: Saves the counter values for the individual categories.
Value If the software is restarted, the values are restored.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 834


9 Reference | 9.1 Menus ZEISS

9.1.7.6.4 Saving Tab

For Axioscan 7, the storage path for images is controlled by the Storage Location tool on the
Scan tab.

Parameter Description
Auto Save after Snap Not relevant for Axioscan 7
Activated: Automatically saves images that are acquired on the
Locate tab using the Snap button.
Deactivated: Saves images that are acquired on the Locate tab
using the Snap button temporarily in the Auto Save Path\Temp.
The image will be marked with an asterisk and will be deleted if
it is closed without saving.

Do not Open a Docu- Not relevant for Axioscan 7


ment Window Only active if the Auto Save after Snap is activated.
Activated: Closes the automatically saved images immediately
after acquisition.

Auto Save Path Not relevant for Axioscan 7


Specifies the folder where the images are saved automatically.

Show "Discard All" If activated, the Discard All button is displayed in the Save Doc-
Button in Dialog to uments dialog.
Save Modified Docu- NOTICE! If you click on this button all un-saved images
ments will be deleted.

See also
2 Auto Save Tool [} 890]

9.1.7.6.5 Documents Tab

Default Settings for New Images section

Parameter Description
Show Rulers Activated: Displays rulers at the top and left-hand edge of the
image – the units used are according to the scaling settings.

Auto Fit Activated: Automatically adjusts the zoom factor of the image
so that the entire image is visible and the view area is filled.

Use Interpolation for Activated: Displays pixels in interpolated form.


Image Display

Set Logarithmic Scale Activated: On the Display tab the frequency distribution (y-axis)
in Histogram of the histogram is plotted using a logarithmic scale.

Show Viewport Scale- Activated: Shows a scale bar within a small window in 2D view.
bar in 2D View

Show Viewport Scale- Activated: Shows a scale bar within a small window in the Live
bar in Live Window window.

Show Navigator in 2D Activated: Shows the Navigator window in the image area.
View

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 835


9 Reference | 9.1 Menus ZEISS

Parameter Description
Use Pan Mode in 2D Activated: Pan mode will automatically activated for tiled im-
View for Tile Images ages opened in 2D view.

Baseline Shift for Activated: Adds an offset of 10.000 to the processed Airyscan
Airyscan Viewer images. This allows to display details in the processed Airyscan
image that have negative intensity values and are therefore nor-
mally cut from the histogram.

Display section

Parameter Description
Enable Tree View Additionally shows the Tree view in the Center Screen area.

Show Time series/ Activated: Time series or movie images acquired when the stage co-
movie images ordinate is adjusted are shown without the bounding X/Y area (black
without Bounding boarder).
X/Y Area

Show Rotation Shows the Rotation Slider in the Dimensions tab.


Slider in Dimen-
sions tab

Image Rendering

Parameter Description
Use Advanced Activated: Uses the advanced renderer.
Renderer

Use Advanced Usually the advanced renderer is deactivated during acquisition.


Renderer for Im- This check box activates the renderer during acquisition, which can
age Acquisition cause an appearance of display artifacts.
(Note that in a few
instances display
artifacts can occur)

Image Pyramid

Parameter Description
Generate Image Activated: Generates an offline image pyramid if there is no pyramid
Pyramid if needed available and the number of pixels is above the specified lower limit.
Deactivated: Does not generate an image pyramid. NOTICE! This
can have a negative impact on viewer performance.

Lower Limit in Pix- Sets the lower limit in pixels. The default value can depend on the
els ZEN profile. A message box is displayed if image size is bigger with a
request for pyramid calculation. Automatic calculation of image pyra-
mid is performed if the image size is bigger.

Reset to Defaults Resets the parameters to their default values.

Note: Pyramids might be generated upon opening an image which is large enough or creating a
new image with a processing function.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 836


9 Reference | 9.1 Menus ZEISS

Swapping

Parameter Description
Single File Swap- An experimental implementation of swapping. Swapping is used by
ping the application when processing extremely large files (terabyte sized),
like on Lattice Lightsheet systems. Do not activate this option other-
wise.
Activated: If the opened images are too large for the system mem-
ory, the surplus data is stored on the hard drive as one file instead of
a multitude of them. This prevents instability of the operating system.

Initial Size Only available if Single File Swapping is activated.


Defines the initial size of memory allocated on the hard drive to store
the temporary file.
The initial file size for the user PC is 512 GB, the initial file size for the
streaming PC is 1024 GB.

Directory Only available if Single File Swapping is activated.

– Default Activated: Uses the default directory. The path is displayed in the
field below.

– Custom Activated: Enables the control below to set a custom directory (by
clicking ).

3D View section

Parameter Description
Run Performance Runs a test routine which evaluates the performance of the graphic
Assessment card installed on the workstation. The result is an adjustment of the
precision and accuracy parameters to allow fluid interaction with the
rendered volume in 3D view.

Graphics Hardware Selects the performance class of your graphics hardware. A higher
Class performance class allows you to see your data in more detail but may
lead to crashes on unsuitable hardware. The following classes are
available:
§ Very Low
§ Low
§ Normal
§ High
§ Very High

Interactive Preci- Controls the interactive precision in %.


sion

Interactive Accu- Controls the interactive accuracy in %.


racy

Enable Prefetching Activated The viewer prefetches time points for time-based datasets.
for time-based
datasets

Show Logo Activated: Logo is displayed in the lower right corner of the 3D view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 837


9 Reference | 9.1 Menus ZEISS

Parameter Description
Export Logo Activated: Exports the logo in render series and snapshots.

9.1.7.6.6 Acquisition Tab

General section

Parameter Description
Automatically Add Activated: Automatically adds a scale bar to the image, if it was ac-
Scalebar Annota- quired via the Snap button.
tion at Snap

Show a Request to Activated: Shows a dialog which asks you to move manual compo-
Move Manual or nents. You have to confirm the dialog and move the component by
Coded Hardware hand.
Components

Show a Confirma- Activated: Shows a dialog which asks you to confirm to delete a
tion Dialog for channel or a track.
Channel/Track
Deletion

Lock Device Con- Activated: Prevents controls in the right tool area from be undocked
trols in Right Tool during an experiment.
Area During Run-
ning Experiments

Camera/Live section

Parameter Description
Stop Live after Activated: Automatically closes the Live mode after an acquisition
Snap via the Snap button.

Stage/Focus Con- Enables to navigate the stage and focus in Live and Continuous
trol in Live/Contin- view.
uous View
Configure the travel speed of the focus by adjusting the values in the
corresponding fields from Very Slow = 0,005 to Very Fast = 50,0.
Reset your adjustments by clicking on the Default button.

Show Camera Ex- Activated: Shows advanced (expert) camera options on Locate tab
pert Options within the Camera tool.

Use Centered Cam- Activated: Positions a camera ROI at the center of the camera chip
era ROI only regardless of its size.
Centered Camera ROI = center of camera detector

Acquisition Tab section

Parameter Description
Acquisition Tab Activated: Enables the use and set-up of experiments without any
without channel channel support in the Acquisition tab.
support

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 838


9 Reference | 9.1 Menus ZEISS

Parameter Description
Prevent Execution Activated: Prevents execution of after channel setting automatism
of After Channel while Live mode is active.
Setting while Live
Mode is Active

Automatically start Activated: Starts the Live mode when the Set Exposure button has
Live Mode when been pressed such that the live image begins immediately after the
Exposure Measure- Set Exposure measurement is complete.
ment was Started Deactivated: Takes a Snap subsequent to Set Exposure.

Switch to next En- Activated: Automatically switches to the next enabled acquisition
abled Acquisition block in the Experiment Designer during a running experiment.
Block in Experi-
ment Designer

Enable Imaging Shows the Imaging Setup tool on the Acquisition tab.
Setup

Enabled Advanced Only active, if Enable Imaging Setup is activated.


Imaging Setup Activated: Shows the Standard/Advanced option on the Acquisi-
tion tab on top of the Imaging Setup tool. As the advanced options
should be touched by experts only, this option is deactivated per de-
fault.

Z-Stack section

Parameter Description
Adjust Auto-Z- Determines the degree of match between the image focus of the first
Stack Focus Match image and that determined as the true focus (center plane of the re-
on First Slice sulting Z-stack).

Adjust Auto-Z- Determines the degree of match between the image focus of the last
Stack Focus Match image and that determined as the true focus (center plane of the re-
on Last Slice sulting Z-stack).

Delay Time After Specifies a delay time after each focus movement during Z-Stack ex-
Focus Move periments in ms.

Tiles & Positions section

Parameter Description
Automatically Activated: Automatically starts the Live mode in the Center Screen
Start Live Mode in Area if you klick in the Acquisition tab in the Tiles tool on the Ad-
the Advanced vanced Setup button.
Setup View
Uncheck this option to prevent unnecessary specimen bleaching. The
default is not activated.

Automatic Snap by Activated: Acquires an image if you click on one of the frame's blue
Clicking the Live arrow icons. The Live Navigator tool moves one frame width in the
Navigator Buttons relevant direction. You can create tile images of your sample easily in
this way.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 839


9 Reference | 9.1 Menus ZEISS

Parameter Description
Enable Stage In the Live navigator tool the current stage position including the live
Movement with image is shown as a frame outlined in blue. To move the frame, dou-
Live Navigator ble-click on the position to which you want to move it. Alternatively,
place the mouse cursor over the blue frame, press and hold the left
mouse button and drag the live navigator to the desired location.
Activated: Allows you to move the Live Navigator tool by dragging
it to a new location.

Show Stage and Activated: In the Tiles option, the setting to switch the backlash cor-
Focus Backlash rection on or off is shown. Per default it is hidden.
Correction Setting
in the Options

Delimiter for CSV Specifies the delimiter for a CSV export or import. Select Comma (de-
Export/Import fault), Semicolon or Tab.

Ask Whether Sup- When the support points and/or positions are determined by a soft-
port Points/Posi- ware autofocus run the existing points can be overwritten with the
tions Should be new Z values.
Overwritten
Activated: Shows a message box asking if the points should be over-
written if there is a autofocus Z value.

Focus Surface Out- Ignores support points that are significantly outside the interpolated
lier Determination focus surface.
You have the following setting options available:

- Maximum Inter- This value can be 0 or 1. If 1 then a linear fit is used to detect the out-
polation Degree lier support points. This is the default. If 0 a simple average value is
for Outlier De- used to detect outliers.
tection

- Threshold in This parameter defines a threshold value to determine which of the


Terms of the support points are outliers from the fitting process. This is defined by
Standard Devia- the standard deviation (sigma value) set in the spin box. Support
tion (Sigma) points not meeting this criteria are subsequently ignored when the fo-
cus surface is determined.

Delay Time After Defines a delay period which is used for all stage movements in a tiles
Stage Movements and position experiment or movements controlled in the advanced tile
setup. The delay helps prevent movement in samples where, for ex-
ample, a large volume of liquid is present in the sample holder. It can
be used with the stage speed and acceleration options to optimise ex-
periments with this type of sample.

Binning Compen- Defines the power to which the binning ratio is modified to automati-
sation of Exposure cally determine the exposure time value used for a preview scan were
Time in Preview the binning setting between the experiment and preview scan differs.
Scans The default value is 2.0 i.e. quadratic. Thus, for example the exposure
time would be reduced by a factor of four if the experiment binning is
1x1 and the preview scan binning is 2x2. The value can be varied be-
tween 1.0 and 2.0 in steps of 0.1.

Live Image in Sam-


ple Carrier Calibra-
tion Wizard (rele-
vant only for sys-
tems with camera)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 840


9 Reference | 9.1 Menus ZEISS

Parameter Description
- Use Imaging Activated: Default setting for the live image that allows navigation
Device from and focus interaction during the carrier calibration wizard.
Selected
Channel with
"Acquisition"
Settings

- Use Active This option is only relevant for systems with a wide field (camera
Camera with based) detector.
"Locate" Set- Activated: Allows you to alternatively apply locate camera settings
tings for use in the carrier calibration wizard (live image). By default the ex-
periment settings for the currently selected channel/track will be used.

Panorama section

Parameter Description
Automatically Activated: Specifies that the live mode will start running automati-
Start Live Mode in cally when you begin a panorama experiment.
the Panorama
View

Automatically Activated: Automatically moves the stage half a camera frame diago-
Move Stage/Live nally after acquisition of a snap image. Thus, the snap image can be
after an Acquisi- inspected.
tion

Enable Trans- Activated: Displays the selected tile image with a transparency effect
parency Effect on that enables you to see it in relation to the tiles underneath (lower
Selected Tile Im- layer = earlier acquisition) and those above (upper layer = more recent
age acquisition) at the same time.
You can also adjust the degree overlap of the panorama grid. The de-
fault value is 20%, changes require a re-start to become affective.
Note that this and the transparency effect parameters are only rele-
vant for manual stages.

Grid Overlap Specifies the degree of overlap for the panorama grid in %. A soft-
ware restart is required.

Show Live Activated: Note that the option should only be activated if you have
Panorama Acquisi- issues with the camera/live image during acquisition. It is only avail-
tion Options able for troubleshooting and normally not needed.
Not activated: Default. The software tries to use the determined
value for the current camera automatically. If you are unsure, if your
camera supports the functionality, we recommend leaving the default.

Focus Strategy section

Parameter Description
Show a Dialog to Activated: Reminds you to make appropriate adjustments to the fo-
Prepare the Defi- cus prior for initialization at the start of experiments using Definite Fo-
nite Focus Initial- cus.
ization

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 841


9 Reference | 9.1 Menus ZEISS

Parameter Description
Enable Definite Fo- Activated: Specifies whether the last successfully determined z posi-
cus Stabilization tion is used if the primary focus action (Definite Focus or Autofocus)
on a Suitable Fall- fails.
back Position

Show Definite Fo- Activated: An additional section is displayed in the definite focus
cus Setting "Reso- strategy. This allows selection of three definite focus modes for
lution and Speed" greater speed or accuracy of the stabilization.

Experiment Feedback section

Parameter Description
Time until a dead- Sets the time until a deadlock of the synchronized script is assumed.
lock of the syn- Here you can adjust the time until ZEN assumes that a deadlock has
chronized script is occurred after a synchronized script has been executed. If this value is
assumed exceeded the function is aborted.

Data Compression section


Note: Not all data will be compressed during acquisition. There are few exceptions due to perfor-
mance or data layout reasons. The following acquisition modes are not supported:

§ LSM time series of line and spline scans


§ Camera streaming acquisitions (when Use Camera Streaming if Possible or Use Burst
Mode if Possible are activated in the Time Series tool)

Parameter Description
Acquisition Online- Selects the compression for acquisition.
Compression

– None (uncom- Uses no compression. It is useful for low CPU load optimization (very
pressed) fast and short experiments).

– Zstd (lossless) Uses lossless zstd compression for reduced data rate and image size.

Enable Online MIP Activated: Enables the online MIP for fast data browsing after acqui-
sition.
Deactivated: Does not enable the online MIP for fastest data rate.

Mixed Mode Options section


This section is only visible for the celldiscoverer.

Parameter Description
Activate the online Specifies whether the disparity map is used to warp the LSM and
disparity warping Airyscan frames.

Path to disparity Displays the path where the disparity map is saved.
map

Interpolation Sets the interpolation mode.


Mode

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 842


9 Reference | 9.1 Menus ZEISS

Parameter Description
– Nearest The output pixel is given by the gray value of the input pixel that is
Neighbor closest to it.

– Linear The output pixel is given by the gray value resulting from the linear in-
terpolation of the input pixels closest to it.

– Cubic The output pixel is given by the gray value resulting from a cubic poly-
nomial function interpolation of the input pixels closest to it.

Disparity Map Cali- Activated: Integrates the radial distortion for the calculation of the
bration Integrates disparity map.
the Radial Distor- Note: This option should not be deactivated because it will have a
tion negative effect on the quality of the results.

LSM section
This section is only visible for an LSM.

Parameter Description
Online Scanner Activated: Enables the online scanner correction. It ensures an opti-
Correction mal image quality at scan speeds > 13.

Bidi Auto Correc- Automatically corrects line shifts for bidirectional scanning for Multi-
tion plex Imaging modes

Set lasers OFF When activated any laser which is not activated for an experiment will
when unused for automatically be set to OFF mode after 30 minutes. This does not ap-
30 minutes (re- ply to multiphoton lasers.
quires ZEN restart)

Activate extended Activates the extended zoom range.


zoom range

Keep Airyscan Raw Only visible if the Airyscan Raw Data module is licensed and acti-
Data vated in Tools > Modules Manager.
Activated: All Airyscan data is stored in the 32ch format. Processing
with the Airyscan tools in the viewer and processing tabs is un-
changed, however, with large datasets the processing might take
longer, see Airyscan RAW Data [} 721].
Deactivated: The ring preprocessing is active and Airyscan data is
stored in a 4ch format, which allows faster processing. Also the Shep-
pard sum export is available in this format.

Enable Z-Piezo Activated: Uses the Z-Piezo drive (if available) for the acquisition of Z-
Stacks. Stacks with a range that is larger than the specified working
range of the piezo drive are automatically carried out using the micro-
scopes focus drive.

Z-Piezo Range Select the range of the Z-Piezo drive. Note that the precision in the
high range is lower compared to the default range.
Note: This function is not available with LSM 980. With LSM 980 the
range of the Z Piezo is always 500 µm with high precision.

Axioscan
This section is only visible for the Axioscan (ZEN slidescan).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 843


9 Reference | 9.1 Menus ZEISS

Parameter Description
Unload Last Tray Activated: Unloads the tray after the scan is finished.
after Scan Job is
Finished

Use Separate Activated: Uses a separate folder for temporary files and displays the
Folder for Tempo- folder path. The button Change Folder opens a browser window to
rary Files set a custom path for temporary files, see Using a Separate Folder
for Temporary Files [} 1106].

Keep Separate La- Activated: Keeps the label image as a separate file after the scan is
bel Image File af- finished.
ter Finished Scan

Keep Separate Pre- Activated: Keeps the preview image as a separate file after the scan
view Image File af- is finished.
ter Finished Scan

Force Sequential Activated: Forces sequential processing for images acquired by line
Processing for Line scan.
Scan (BF)

Allow "All chan- Activated: Allows the use of the dimension order "All channels per
nels per tile" Di- tile" for xPol and pPol, even if this shortens the lifetime of the con-
mension Order for denser.
xPol and pPol De-
spite Shortened
Lifetime of Con-
denser

Delimiter for CSV Selects the delimiter for imported csv files from the dropdown. The
Import following options are available:
§ Comma
§ Semicolon
§ Tab
§ Space

Minimum Margin Sets the minimum margin for the distribution of focus points in a tile.
of Focus Point Dis-
tribution in Tile(s)

Maximal Allowed Sets the maximal value for pixel blur that is allowed in flash acquisi-
Pixel Blur in Flash tion.
Acquisition

Disable Acquisition Activated: Disables acquisition monitoring. This increases perfor-


Monitoring mance for larger scans, as no temporary files are saved.

Frame Rate Limita- Sets a frame rate limitation for the acquisition monitoring.
tion for Acquisi-
tion Monitoring

9.1.7.6.7 User Tab

Here, you can enter user and company information. These are written into the image metadata
during acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 844


9 Reference | 9.1 Menus ZEISS

Parameter Description
User Information Type in contact information of the software user here.

Company Informa- Type in contact information of the company/institute/facility here.


tion

Logo Upload a company logo to the company profile here. Therefore click
on the button.

9.1.7.6.8 Data Tables Tab

This section is not relevant for Axioscan 7 clinical.

Data Table Import Options section

Parameter Description
Import the first im- Activated: Uses the first imported row as the caption for the
ported row as column column.
caption

Import the second im- Activated: Uses the second imported row as the unit for the col-
ported row as column umn.
unit

Automatic CSV format Activated: Automatically tries to detect the format of the data
detection table when importing the table to the software.

Import datapoints from Defines the starting row of the data table into which the data
the file starting from will be imported.
datarow

Use column, decimal Activated: Uses the settings which are configured in the Win-
and list separator from dows regions settings when importing a table to the software.
windows regions set-
tings

Column Separators Only available if you have deactivated Automatic CSV format
detection and Use column, decimal and list separator from
windows regions settings.
Configures the import options according to the format of your
data table you want to import, e.g. specify the type of column or
decimal separator.

Decimal Separator Only available if you have deactivated Automatic CSV format
detection and Use column, decimal and list separator from
windows regions settings.
Selects which decimal separator should be used.

Thousands Separator Only available if you have deactivated Automatic CSV format
detection and Use column, decimal and list separator from
windows regions settings.
Selects which thousands separator should be used.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 845


9 Reference | 9.1 Menus ZEISS

Data Table section

Parameter Description
Number of Deci- Sets the maximum number of decimal places for the numbers im-
mal Places ported into the data table.

9.1.7.6.9 Macro Editor Tab

Macro Configuration section

Parameter Function
Show Inherited Activated: Shows the inherited members of the ZEN class in a pop-up
Members in Pop- window.
up

Show Line Num- Activated: Shows the line numbers.


bers

Disable Full Screen Activated: Disables the full screen mode during debugging.
Mode while De-
bugging

TCP Macro section

Parameter Description
Enable TCP Macro Activated: Enables to enter the TCP Port Number.

Allow IPv4 Nat Attention! For experts only. Do only activate this option if you know
Traversal what you are doing.

Macro Recorder

Parameter Description
Overwrite Interac- Activated: Overwrites the parameter for interactive execution of a
tive Recording function during recording with the macro recorder.
Flag

9.1.7.6.10 arivis Cloud Tab

Parameter Description
Access Token Sets/displays your private access token which is required for the use of
the arivis Cloud functionalities within ZEN, see Creating and Entering
an Access Token [} 206].

Select Execution Selects if the execution should be done locally or on a remote server.
Mode Available options:
§ Use Local Docker Desktop
§ Use Remote Docker Host

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 846


9 Reference | 9.1 Menus ZEISS

Parameter Description
Default Execution Only visible if Use Local Docker Desktop is selected.
Location Selects a default location where the arivis Cloud module is executed
and the outputs are saved.

Mount NVIDIA Activated: Uses the NVIDIA GPU of your computer when executing
GPU models requiring a GPU.
Deactivated: Disables the use of the GPU. Note that you can only ex-
ecute models using CPU. Models that require a GPU will not work if
this option is deactivated!

Remote Docker Options


Only visible if Use Remote Docker Host is selected. Enables you to configure the remote execu-
tion of arivis cloud modules, see Setting Up the Remote Module Execution [} 207].

Info
Ubuntu Distribution Required
If you want to execute your arivis cloud modules on a remote Linux machine, this remote ma-
chine needs to run an Ubuntu distribution.

Parameter Description
Remote Docker Sets the address and port of the remote Docker host.
Host API Address

Check Connection Checks if the remote Docker host can receive a request. A green
checkmarks indicates a successful connection, otherwise a red x is dis-
played.

Select Authentica- Selects the mode how you have to authenticate yourself to the re-
tion Mode mote host.

– No Authenti- The remote host needs no authentication.


cation

– Basic Authen- Displays a field to enter the Username and Password required for
tication the remote host. Also the checkbox to Use TLS (https).

– Certificate File Displays a field to browse for the Certification File and enter a Pass-
Authentica- word (optional) required for the remote host.
tion

– Windows Cer- Displays a field to browse for a Certificate from Windows Store re-
tificate Au- quired for the remote host.
thentication

Local to Remote Area to map a folder path from the local computer to the same path
File System Map- on the remote computer.
ping

– Path List Displays and maps the path of a folder on this machine to the path of
the same folder on the remote Linux machine.

– Deletes the currently selected path mapping.

– Opens the dialog to edit the currently selected path mapping.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 847


9 Reference | 9.1 Menus ZEISS

Parameter Description
– Opens the dialog to add a new path mapping.

Export Remote Opens a file browser to export the current settings as an xml file.
Settings

Import Remote Opens a file browser to select and import an xml file with settings for
Settings the remote setup.

Advanced Settings
Displays advanced settings for arivis Cloud (on-site).

Parameter Description
Client Name Sets a custom client name for this computer.

Ports that can be Defines the ports which can be used by the Docker containers.
used for the
Docker Containers

See also
2 arivis Cloud (on-site) [} 206]

9.1.7.6.10.1 Edit Mapping Dialog

Parameter Description
Local Computer
Selects the path to the folder on this local computer. Click to
Path
open a file explorer and browse to the folder.

Remote Computer Defines the path the same folder on the remote computer.
Path

Check Mapping Checks if the two paths point to the same folder and displays if the
check is successful or not.

Ok Saved this path mapping and closes the dialog.

Cancel Closes the dialog without saving.

See also
2 Creating a Path Mapping [} 208]

9.1.7.6.11 Processing Tab

On this tab you have general options for batch processing.

Parameter Description
Data Compression Selects which data compression is used for images processed in
Batch mode in ZEN.

– None Uses no compression, processed images are saved uncompressed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 848


9 Reference | 9.1 Menus ZEISS

Parameter Description
– ZSTD (lossless) Uses lossless zstd compression for reduced data rate and image size.

9.1.7.6.12 Direct Processing Tab

On this tab you have the options to set up the communication between PCs for Direct Processing,
see Connecting Acquisition Computer and Processing Computer [} 222].

Setup Acquisition PC
In this section you can set up the acquisition computer if you use a discovery proxy, see Connect-
ing Computers With Discovery Proxy [} 226].

Parameter Description
Find From Discov- Activated: Displays the control to define a Discovery Proxy from
ery Proxy which you can get a list of available PCs for processing.

IP Address (Discov- Only visible if Find From Discovery Proxy is activated.


ery Proxy) Sets the address of the Discovery Proxy from which you can get a list
of available PCs for processing.

IP Address (this Displays the IP address of your computer and allows you to select the
PC) IP address used by this computer (if more than one network connec-
tion is active).

– Select IP Ad- Activated: Enables the selection of the IP address used by this com-
dress puter (if more than one network connection is active).

Setup Processing PC
In this section you can set up the processing computer.

Parameter Description
Announcement to Activated: Announces/registers itself to a Discovery Proxy server for
Discovery Proxy the communication between the computers, see Connecting Com-
puters With Discovery Proxy [} 226].

IP Address (Discov- Only visible if Announcement to Discovery Proxy is activated.


ery Proxy) Sets the IP address for the Discovery Proxy.

IP Address (this Displays the IP address of your computer and allows you to select the
PC) IP address used by this computer (if more than one network connec-
tion is active).

PC Description Here you can add specific information about the processing computer
that will be visible on the acquisition computer.

Send Hardware In- Activated: Displays the hardware information of this computer,
formation (op- which is also visible on the acquisition computer.
tional)

Send Processing Activated: Displays Direct Processing statistics (processing speed),


Statistics (optional) which is also visible on the acquisition computer.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 849


9 Reference | 9.1 Menus ZEISS

Parameter Description
Start Receiving on Activated: The computer starts receiving processing request by de-
Startup fault.
Deactivated: The computer does not start the receiving of processing
requests automatically on startup. The receiving has to be started
manually in the Direct Processing tool on the Applications tab.

Setup Discovery Proxy Server


In this section you can set up your own computer as a Discovery Proxy, see Setting Up Your PC
as Discovery Proxy [} 228].

Parameter Description
IP Address (this Displays the IP address of your computer. Selects the IP address used
PC) by this computer for the discovery proxy server (if more than one net-
work connection is active).

Start/Stop Uses your computer as Discovery Proxy. The button changes to Stop
to stop acting as Discovery Proxy.

IP Address to Clip- Only available if the Start button has been clicked.
board Copies the IP address of your computer to the clipboard.

Advanced Settings

Parameter Description
Communication Selects the mode used for communication between the PCs.
Mode

– WCF Uses the WCF communication mode. This mode is compatible with
ZEN versions prior to ZEN 3.7.

– gRPC Uses the gRPC communication mode. This mode is incompatible with
ZEN versions using WCF communication, i.e. all prior to ZEN 3.7. Thus
communication with older versions is not possible.

Data Compression Selects the data compression.

– None Uses no compression.

– Zstd Uses lossless zstd compression for reduced data rate and image size.

See also
2 Direct Processing [} 219]

9.1.7.6.13 ZEN Connect

Parameter Description
Stage Size

– Stage Size in Positions the images initially in a better way in the correlative
mm workspace. For example, for 130x100mm stage an image at stage po-
sition 65x50mm will be placed in the center of the correlative
workspace.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 850


9 Reference | 9.1 Menus ZEISS

Parameter Description
Note that the stage size will only be taken into account for better ini-
tial positioning if you have calibrated the stage upon startup or later,
but before creating the ZEN Connect project.

Stage Move Con-


firmation

– Deactivate Activated: No confirmation dialog is shown when the stage is moved


Confirmation with double click in the Correlative Workspace.
Deactivated: A confirmation dialog is shown each time the stage is
moved with double click in the Correlative Workspace.

3D Rotation

– Show Outlines Activated: Displays a yellow outline of a rotated image in the Correl-
of Rotated ative Workspace. This outline is only visible in alignment mode, if 3D
Cube Alignment is selected and Apply 3D Rotation is activated.

2D Image Sets

– Always dis- Activated: Always displays single plane data sets in the correlative
play single workspace, even if the z-value set by the Global-Z is out of range for
plane data the 2D image(s).
sets

9.1.7.6.14 ImageJ Tab

This tab is only shown if the ImageJ extension is activated.

Parameter Description
ImageJ Folder Shows you where the software is installed.

ImageJ executable Select your preferred .exe file in the drop down list.

Shift Pixels to 16 This function only works if under Default preferred conversion (see
bit below) the option Always is selected.
Activated: Shifts the grey value of a 10-bit or 12-bit image to 16-bit.
Deactivated: No shift takes place.

Assume macro has


input

– False The software does not expect macro input.

– True The software expects macro input.

Default preferred You can specify the default for the preferred conversion.
conversion

– Automatic Uses the automatic conversion setting.

– Always Image is always converted.

– Keep Image is not converted.

Default preferred You can select the default setting for the preferred file format.
file format

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 851


9 Reference | 9.1 Menus ZEISS

Parameter Description
Available options in the drop down list:
§ Automatic
§ czi
§ Ome Tiff
§ Tiff
§ Tiff With Display Mapping

9.1.7.6.15 Storage Settings Tab

Here you can configure the settings for the ZEN Data Storage.

Parameter Description
Simple Displays the options for a general setup

– Host Name Displays and sets the host name of the server.

– Hosting Selects if you want to set up your server communication with the
Scheme http or the https protocol.

– Storage Server Displays and sets the port for the storage server.
Port

Expert Displays the setup for more experienced users.

– Storage Server Displays and sets the url for the storage server.
URL

Validate Settings Validates the settings for the ZEN Data Storage and displays the status
below, see Validating the ZEN Data Storage Settings [} 270].

Reset to Defaults Resets all settings for the ZEN Data Storage to their defaults.

Server Setup Sets up the ZEN Data Storage server.

See also
2 Setting up ZEN Data Storage Server [} 269]

9.1.7.6.16 Collections Tab

Here you can create collections for your data and specify their access.

Parameter Description
Collection Table Displays the existing collections.

– Collection Displays the name of the collection.


Name

– Collection Displays the owner of the collection.


Owner

– Access Displays the groups/users that have access to this collection.


Granted To

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 852


9 Reference | 9.1 Menus ZEISS

Parameter Description
– Opens the Add Collection dialog to add a collection.
Add

– Deletes the selected collection.


Delete

– Opens the Edit Collection dialog to edit the selected collection.


Edit

See also
2 Add/Edit Collection Dialog [} 853]
2 Creating a Collection for Data [} 274]
2 Editing or Deleting a Data Collection [} 275]

9.1.7.6.16.1 Add/Edit Collection Dialog

With this dialog you can add a collection.

Parameter Description
Collection Name Sets the name for the collection.

Table

– Name Displays the group or user with access to this collection.

– Access Level Displays and sets the access level of the user/group with the drop-
down. For a description of the available access levels, see Add Collec-
tion Access Dialog [} 853].

– Only available if you have started the application with active user
management.
Add Access
Opens the Add Collection Access dialog to add access for a user/
group.

– Only available if you have started the application with active user
management
Remove Ac-
Removes the access for the selected user/group from the collection
cess
and deletes it from the list.

OK Adds the defined collection and closes the dialog.

Cancel Closes the dialog without adding a collection.

See also
2 Creating a Collection for Data [} 274]

9.1.7.6.16.1.1 Add Collection Access Dialog

With this dialog you can select a group/user who should have access to the collection. It is only
available if you have started the application with active user management.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 853


9 Reference | 9.1 Menus ZEISS

Parameter Description
Groups Displays all currently configured groups.

Users Displays all currently configured users.

Access Level Sets the access level for the currently selected group/user with the
dropdown.

– Read Grants the group/user access to see, open or download a document.

– Write Grants the group/user access to modify a document.

– Manage Grants the group/user access to modify the access control list.

OK Adds the selected group/user with the set access level to the collec-
tion and closes the dialog.

Cancel Closes the dialog without adding any group/user to the collection.

See also
2 Creating a Collection for Data [} 274]

9.1.7.6.17 Incubation Tab

Parameter Description
Maximum Temper- Displays or sets the maximum temperature deviation.
ature Deviation

Maximum Concen- Displays or sets the maximum concentration deviation.


tration Deviation

Maximum Humid- Displays or sets the maximum humidity deviation.


ity Deviation

Metadata Logging Sets the logging cycle metadata. A bigger logging interval is useful for
Cycle very long or very fast experiments.

9.1.8 Window Menu

Menu item Description Shortcut


Full Screen Sets the Full Screen mode to maximize F11
the image view area size.

Next Window Displays the next open image in the F6


Center Screen Area (direction of
movement is to the right).

Previous Win- Displays the previous open image in the Ctrl+F6


dow Center Screen Area (direction of
movement is to the left).

Close Closes the currently selected image. Ctrl+F4

Close All Closes all the open images. Ctrl+Alt+W

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 854


9 Reference | 9.2 Main Tabs ZEISS

See also
2 Full Screen Mode [} 1050]

9.1.9 Help Menu

Menu item Description Shortcut


Contents Opens the online help. Ctrl+F1

Index Opens the online help index page. Ctrl+F2

Readme Opens the ZEISS Portal in your browser to


retrieve the Readme PDF for your software.

Create Service Opens the dialog to create the service re-


Report port, see Creating a Service Report [} 1312].

About ZEN Shows notices of the producer.

Submit Idea Opens the ZEISS Portal in the browser to


submit an idea.

Contact Sup- Opens the ZEISS Portal in the browser to


port contact support.

9.2 Main Tabs

9.2.1 Locate Tab

Depending on the system configuration and the licensed modules this tab can have a different ap-
pearance. In general you can use the locate tab for finding or "locating" interesting areas on your
sample.
For mixed systems (e.g. LSM including a microscope camera) the section System Mode is avail-
able additionally.
In the Eyepiece mode (for confocal systems) this tab contains only functions for controlling the
light path and viewing the sample via the eyepiece, see Microscope Control Tool [} 980]. In the
Camera mode this tab contains more control elements and tools, see Tools on Locate tab

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 855


9 Reference | 9.2 Main Tabs ZEISS

Fig. 55: Locate tab (Camera mode)

System Mode section


This section is only visible if a camera is installed with the system.
Here you can switch the system mode between Eyepiece and Camera mode. To switch between
the 2 modes simply click on the corresponding button. In the table below you find a description
of the two modes:

Mode Description
Eyepiece mode If you switch to Eyepiece mode the system adjusts the light path
automatically to the eyepiece. The following list shows the
changes in the ocular mode in detail:
§ All Action buttons are hidden
§ Only the Microscope Control tool is visible
§ Within the Microscope Control tool only the light path lead-
ing to the eyepiece is displayed.
§ All possible light paths to cameras are hidden.

Camera mode § All Widefield relevant components are displayed as usual.


§ The LSM Scan Head icon is not displayed in the light path.

Transmitted Light/Reflected Light section


Only visible if you have configured a motorized TL/RL shutter in MTB (MicroToolBox).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 856


9 Reference | 9.2 Main Tabs ZEISS

Parameter Description
Off Closes the shutter of the transmitted/reflected light source on a mo-
torized microscope.

On Opens the shutter of the transmitted/reflected light source on a mo-


torized microscope.

Switch To section
These buttons configure the light path either for transmitted light observation or fluorescence ob-
servation. The observation is either via Ocular or Camera which is set in the System Mode sec-
tion. The shutter for either observation path is not opened to avoid unwanted illumination of the
sample. Shutter for either mode can be operated directly on the microscope hardware or using
the controls in the Transmitted Light/Reflected Light section.

Mode Description
Transmission Click on the Transmission button to set the beam path in the micro-
scope for observation of the sample using transmission illumination.
This includes all motorized components of the microscope excluding
the shutter in front of the transmitted light source. On a fully motor-
ized microscope no further changes in HW are necessary apart from
opening the light shutter and setting the illumination strength of the
halogen lamp to achieve transmission observation of the sample.
Note: When switching to Acquisition the light shutter is closed.
When switching back to Locate the settings for Transmission obser-
vation will be restored.

Fluorescence Click on the Fluorescence button to open up the Add Dye or Con-
trast Method Dialog [} 869].
Chose the dye you want to observe in fluorescence mode, then close
the tool. The beam path is set for fluorescence observation including
all motorized components of the microscope excluding the shutter in
front of the reflected light source. On a fully motorized microscope no
further changes in HW are necessary apart from opening the light
shutter and setting the illumination strength of the reflected light
source to achieve fluorescence observation of the sample.
Note: When switching to Acquisition the light shutter is closed.
When switching back to Locate the settings for Fluorescence obser-
vation will be restored.

Favorites section

Parameter Description
Configure... Here you can configure further buttons with your favorite hardware
setting functions. Click on the button to open the Configuration dia-
log.

Action buttons section


With these buttons you control the microscope and the camera and acquire your images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 857


9 Reference | 9.2 Main Tabs ZEISS

Fig. 56: Action buttons

Parameter Function
Only visible if you have configured a motorized focus in the MTB (Mi-
croToolBox).
Find Focus
Starts an autofocus search using the current settings from the Soft-
ware Autofocus tool.

Starts an automatic exposure time measurement with the settings de-


fined in the Light Path and Camera tool or (for LSM) the settings in
Set Exposure the Imaging set up tool.

Opens Live View and shows the live image from the active camera or
the first channel of the first track when acquisition is performed with
Live LSM.

Starts a series of Snaps using the settings defined in the Light Path
and Camera tool. In contrast to a live image, the exact same camera
Continuous setting that has been set in the Camera tool is used. The result at the
end of this mode is a single, acquired image that can be saved.

Acquires a single image.

Snap button

Only active if one of the acquisition buttons has been clicked.


Stops the function of the relevant acquisition button.
Stop

Active Camera section

Parameter Description
Link Cameras Only active if you have connected two structurally identical cameras
to your system.
Activated: Acquires images using two cameras in parallel. This is of-
ten the case with 2-channel images for ratio measurements or FRET
measurements.

Active Camera Shows the active camera. If you have several cameras connected, you
can select the detector to use here.

Tools section
Depending on which modules you have purchased you see different tools available in this section,
see Tools on Locate tab.

See also
2 Configure your hardware setting favorites Dialog [} 859]
2 Microscope Control Tool [} 980]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 858


9 Reference | 9.2 Main Tabs ZEISS

9.2.1.1 Configure your hardware setting favorites Dialog

Here you configure up to 20 new buttons to get quick access to your preferred camera and hard-
ware settings.

Info
To create and edit settings you need the settings editor. Click on Tools > Settings Editor.

Parameter Description
Favorite Settings If you have not yet defined any buttons, you will see an empty list
here. To create a new button, click on the Add button . Your
Favorites are displayed as buttons on the Locate tab in the Favorites
section.
You can configure your favorite setting in the input fields:

- Name Here you can enter a name for the button.

- Hardware Set- Shows the selected hardware settings.


ting Ref.

- Camera Set- Shows the selected camera settings.


ting Ref.

- Color Here you can select a color for the related button. Click on the color
dropdown list to choose a color.

- Use Color also Activated: Uses the selected color as the button text color.
for Button
Text coloring

Available hard- Here you see a list of all hardware settings that are saved on your
ware settings on hard drive. Select the hardware setting that you want to use with the
disc configured button. To add a hardware setting, simply drag & drop
them to the desired button configuration.

Available camera Here you see a list of all camera settings that are saved on your hard
settings on disk drive. Select the camera setting that you want to use with the config-
ured button. To add a camera setting, simply drag & drop them to the
desired button configuration.

9.2.2 Acquisition Tab

Info
The content of the tab changes depending on the configuration of your imaging system and
the options that you activate or deactivate.
Settings that you configure in the top part of the tab have an effect on settings in the bottom
part of the tab. Settings that you configure in the Acquisition Parameter tool group, e.g. in
the Channels tool also apply to the acquisition of all images that you configure in the Multi-
dimensional Acquisition tool group.

Here you configure and control your acquisition experiments.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 859


9 Reference | 9.2 Main Tabs ZEISS

2
3

Fig. 57: Acquisition tab

1 Experiment Manager
The area above the blue tools where you can load and save your experiments, control ac-
quisition and decide which tools will appear in the certain tool groups.
For further information on Experiment Options, see Experiment Options [} 861].

2 Smart Setup
Opens the Smart Setup dialog, see Smart Setup [} 862].

3 Sample Navigator
The Sample Navigator wizard is a tool to find the focus plane and quickly acquire an
overview scan of your sample. You can also simplify the search for a region of interest
for the actual imaging experiment. For further information, see Using the Sample Navi-
gator with LSM 980 and LSM 900 [} 1209].

4 Action Buttons
With these buttons you control microscope and camera and acquire your images. For
further information on action buttons, see Action Buttons [} 861].

5 Acquisition Dimensions
Here you activate the desired dimensions (e.g. Z-Stack or Tiles) for your experiment. A
drop down menu appears when selecting the dimensions to determine the sequence of
acquisition. For more information, see Acquisition Sequence [} 871].
The corresponding fields to the right of each dimension show a preview of how exten-
sive the experiment will be (e.g. 9 Tiles).
Below the dimensions section you activate additional experiment features (e.g. Auto
Save) or special modules (e.g. Shuttle & Find).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 860


9 Reference | 9.2 Main Tabs ZEISS

6 Experiment Preview
Here you can see a graphical representation of the configured experiment. The Disc icon
indicates that you have enabled Auto Save function for the experiment.

9.2.2.1 Action Buttons

With these buttons you control microscope and camera and acquire your images.
The Acquisition buttons on the Acquisition tab differ from the Acquisition buttons on the Locate
tab.
The buttons on the Locate tab relate to an individual image. The buttons on the Acquisition tab
relate to a multidimensional image with at least one channel.
1 2 3 4 5 6

1 Find Focus
Only visible if you have configured a motorized focus (MicroToolBox).
Starts an autofocus search using the settings from the Focus Devices tool. The autofo-
cus search is performed for the selected reference channel in the Channels tool.

2 Set Exposure
Starts an automatic exposure time measurement with the settings defined in the Light
Path and Camera tool.

3 Live
Starts the Live Mode. In the Center Screen Area you see the live image from the cam-
era.

4 Continuous
Starts a series of Snaps using the settings defined in the Light Path and Camera tool.
In contrast to a live image, the exact same camera setting that has been set in the Cam-
era tool is used.

5 Snap
A so called "Snap" acquires a single image (snapshot).
For widefield systems an additional tiles snap option is available. You can choose be-
tween 2x2, 3x3, 4x4 and 5x5 presets.

6 Stop
Only active if one of the acquisition buttons has been clicked.
Stops the function of the relevant acquisition button.

9.2.2.2 Experiment Options

In the Options shortcut menu you can create new experiments and rename, save, import,
export or delete existing experiments.

Menu item Description


New Creates a new, empty experiment. Enter a name for the experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 861


9 Reference | 9.2 Main Tabs ZEISS

Menu item Description


New from Tem- Create a new experiment based on an existing experiment. The tem-
plate plate experiment will not be modified. You can create your own tem-
plate experiments by placing them in the folder Carl Zeiss\ZEN\Tem-
plates\Experiment Setups, which is located in the windows public
documents folder and in the documents folder for each user.

Rename Enables you to enter a new name for the experiment.

Save Saves a modified experiment under the current name. An asterisk indi-
cates the modified state.

Save As Saves the current experiment under a new name. Enter a name for
the experiment.

Reload Reloads the selected experiment.

Set As Startup De- Selecting this option will assign the currently loaded experiment as a
fault default experiment, which is loaded every time the software is started.
The startup default experiment is indicated by a special icon be-
hind the experiment name.
You can decide to start the software with a particular default experi-
ment, with the last used experiment or with an empty new experi-
ment in Tools > Options > Startup/Shutdown > Experiment.

Import Imports an existing experiment. The experiment is shown in the Ex-


periment Selection dropdown list.

Export Exports the current experiment.

Delete Deletes the current experiment.

9.2.2.3 Smart Setup Concept

Smart Setup offers you support when configuring multichannel acquisition experiments. To start
it click on the Smart Setup button on the Acquisition tab.
Select the fluorescent dyes and contrast techniques that you want to include in your experiment
from a large dye database. Smart Setup takes the configuration of your microscope hardware and
the properties of the selected dyes into account. Based on this information, it makes one or more
suggestions for acquisition. You can adopt these into your experiment as required and make fur-
ther changes to them there.

Info
If Smart Setup is unable to make a proposal, it is not possible to use the selected dyes, con-
trast techniques, or current microscope hardware to make acquisitions. Select other dyes or
another contrast technique or configure your acquisition experiment using the Acquisition
Mode tool and the Channels tool.

For working with Smart Setup please note the following:

§ Smart Setup tries to configure the motorized components of your system for the acquisition
of multichannel images.
§ Smart Setup does not change any parameters of other acquisition dimensions (e.g. Z-stack,
Time series, or Multi-position acquisitions).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 862


9 Reference | 9.2 Main Tabs ZEISS

§ For widefield tracks it does not influence any camera parameters (e.g., Exposure time or Reso-
lution).
§ For LSM tracks it adjusts parameters within the Imaging Setup, the Acquisition Mode and
the Channels tool windows.
Depending on your system you will see two buttons on top of the dialog.

Fig. 58: Smart Setup Modes


If you select the LSM button you can use Smart Setup for configuring confocal experiments, see
Smart Setup Dialog (LSM) [} 866].
If you select the WF button you can use Smart Setup for configuring widefield experiments, see
Smart Setup Dialog (WF) [} 863].

9.2.2.3.1 Smart Setup Dialog (WF)

1 Imaging Mode Selection


Selects the Imaging mode.

2 Detector Selection
Only visible if two or more cameras are configured for the system. Here you can select
the desired camera for the experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 863


9 Reference | 9.2 Main Tabs ZEISS

3 Experiment Configuration
Here you can add up to four reflected light fluorescence channels and transmitted light
contrast techniques to your experiment. The added dyes or the contrast technique are
shown in the list below.

A click on opens the Add Dye or Contrast Technique [} 869] dialog, where you
can select the desired dye or contrast technique from the Dye Database.

4 Motif Buttons
Here you can optimize image acquisition regarding particular requirements like speed or
quality. All parameters, e.g. camera resolution or dynamic range in the Acquisition
Mode or the Channels tool, are set automatically. They essentially influence the camera,
detector, and lightning settings. For more information, see Motif Buttons (WF) [} 864].

5 Graphical Display of Proposals


Here you can see the proposals made by Smart Setup displayed graphically. You can
find a detailed description of the graphical display under Graphical Display of Proposals
[} 868].
The proposals change the imaging settings in the Imaging Setup tool accordingly. The
number and type of proposals depend on the microscope hardware being used, the se-
lected dyes, and the contrast technique. For more information, see Smart Setup Propos-
als (WF) [} 865].

6 Bottom Control Bar


Here you have general settings and the controls to close the setup. For more informa-
tion, see Bottom Control Bar (WF) [} 865].

9.2.2.3.1.1 Motif Buttons (WF)

Parameter Description
Automatic § The system tries to set the optimal resolution for the camera in the
Acquisition Mode tool. The resolution is calculated from the total
magnification at the camera adapter (objective + optovar +
adapter).
§ Sets the Exposure Time:
– Transmitted light channel: 10 ms
– Reflected light channel: 10 ms
– Fluorescence channel: 150 ms
§ Sets the Auto Exposure to Off
§ Sets Intensity to the following:
– Transmitted light channel: 70%
– Reflected light channel: 70%
– Fluorescence channel: 30%

Speed § If binning is supported, one binning category is set for the camera
under the optimal resolution in the Acquisition Mode tool. The
resolution is calculated from the total magnification at the camera
adapter (objective + optovar + adapter).
§ Sets power of Colibri-LEDs 100% and power of transmitted and re-
flected light sources to 10% or 3V.
§ Sets the Exposure Time:
– Transmitted light channel: 3 ms
– Reflected light channel: 3 ms

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 864


9 Reference | 9.2 Main Tabs ZEISS

Parameter Description
– Fluorescence channel: 50 ms
§ Sets the Auto Exposure to Off
§ Sets the Intensity to the following:
– Transmitted light channel: 30%
– Reflected light channel: 30%
– Fluorescence channel: 15%

Signal § Sets the optimal resolution for the camera in the Acquisition
Mode tool. The resolution is calculated from the total magnifica-
tion at the camera adapter (objective + optovar + adapter).
§ Sets the power of Colibri-LEDs to 75% and the power of transmit-
ted and reflected light sources to 10% or 3V.
§ Sets the Exposure Time:
– Transmitted light channel: 20 ms
– Reflected light channel: 20 ms
– Fluorescence channel: 300 ms
§ Sets the Auto Exposure to Off
§ Sets the Intensity to the following:
– Transmitted light channel: 100%
– Reflected light channel: 100%
– Fluorescence channel: 60%

Default Sets the parameters for Exposure Time, Auto Exposure, Intensity
and EM Gain to the default values.

Current NOTICE! If you manually changed hardware settings in the Ac-


quisition Mode tool and do not want to lose them, make sure
you select the Current button.
No changes for Exposure Time, Auto Exposure, Intensity and EM
Gain are made. Only the necessary hardware settings for acquisition
are applied by Smart Setup.

9.2.2.3.1.2 Smart Setup Proposals (WF)

Parameter Description
Best Signal This proposal results in the best signal strength.

Fastest This proposal results in the fastest acquisition.

Best Compromise This proposal results in the best compromise between signal strength
and fastest acquisition.

9.2.2.3.1.3 Bottom Control Bar (WF)

Parameter Description
Show Excitation Activated: Shows the excitation spectrum of the selected dyes in the
graphical display.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 865


9 Reference | 9.2 Main Tabs ZEISS

Parameter Description
Show Emission Activated: Shows the emission spectrum of the selected dyes in the
graphical display.

OK Adopts the proposal displayed as the current acquisition experiment.


The suggestion overwrites existing experiments on the Acquisition
tab.

Cancel Ends Smart Setup. The suggestions are not adopted into the experi-
ment.

9.2.2.3.2 Smart Setup Dialog (LSM)

Fig. 59: Smart Setup (LSM)

1 Imaging Mode Selection


Selects the imaging mode (e. g. LSM or WF).

2 Detector Selection
Here you can select the detector. If your system is equipped with an Airyscan detector,
you can use Smart Setup to generate proposals for Airyscan instead of confocal acquisi-
tion, see also Airyscan Mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 866


9 Reference | 9.2 Main Tabs ZEISS

3 Experiment Configuration
Here you can add up to four reflected light fluorescence channels and transmitted light
contrast techniques to your experiment. The added dyes or the contrast technique are
shown in the list below.

A click on opens the Add Dye or Contrast Method Dialog [} 869], where you
can select the desired dye or contrast technique from the Dye Database.

4 Motif Buttons
Here you can optimize image acquisition regarding particular requirements like speed or
quality. All parameters, e.g. camera resolution or dynamic range in the Acquisition
Mode or the Channels tool, are set automatically.
The automatic settings influence parameters like Frame Size, Speed, Direction, Bit Depth
(in Acquisition Mode tool) and Pinhole Diameter, Gain, Laser Power (in Channels tool),
depending on the selected button.
For more information, see Motif Buttons (LSM) [} 867]. Various proposals for further ex-
periment settings are shown in the graphical display below the buttons.

5 Graphical Display of Proposals


Here you can see the proposals made by Smart Setup displayed graphically. You can
find a detailed description of the graphical display under Graphical Display of Proposals
[} 868].
The proposals change the imaging settings in the Imaging Setup tool accordingly. The
number and type of proposals depend on the microscope hardware being used, the se-
lected dyes, and the contrast technique. For more information, see Smart Setup Propos-
als (LSM) [} 868].

6 Bottom Control Bar


Here you have general settings and the controls to close the setup. For more informa-
tion, see Bottom Control Bar (LSM) [} 868].

9.2.2.3.2.1 Motif Buttons (LSM)

Parameter Description
Current No changes are made. Only the necessary hardware settings for ac-
quisition are applied by Smart Setup.
NOTICE! If you changed hardware settings in the Acquisition
Mode tool manually and do not want to lose them, make sure
you select the Current button.

Speed § Sets the frame size to 400x400 pixels


§ Sets the scanning speed to maximum value
§ Sets the scanning direction to bi-directional
§ Opens the pinhole to 2 Airy Units (AU)

Signal § Aims to provide high quality images with best signal to noise ratio
§ Sets the frame size to a minimal value that fulfills the Nyquist crite-
rion, but to a maximum of 2048x2048 pixel
§ Sets the scanning speed to 6
§ Sets the scanning direction to uni-directional
§ Sets the Bit Depth to 16 bit

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 867


9 Reference | 9.2 Main Tabs ZEISS

9.2.2.3.2.2 Smart Setup Proposals (LSM)

Parameter Description
Fastest This proposal results in the fastest acquisition.

Best Signal This proposal results in the best signal strength and minimizes the
level of cross talk.

Smartest (Line) Combines the advantages of Fastest and Best Signal. It minimizes
the number of tracks as well as cross talk.

9.2.2.3.2.3 Bottom Control Bar (LSM)

Parameter Description
Show Emission Shows the emission spectrum of the selected dyes in the graphical
display.

Show Excitation Shows the excitation spectrum of the selected dyes in the graphical
display.

Reset Clears the list of selected dyes and/or contrast methods.

Sample Navigator Opens the Sample Navigator, see Sample navigator LSM 980 and LSM
900.

OK Adopts the proposal displayed as the current acquisition experiment.


The suggestion overwrites existing experiments on the Acquisition
tab.

Cancel Ends Smart Setup. The suggestions are not adopted into the experi-
ment.

9.2.2.3.3 Graphical Display of Proposals

Info
The bars in the graphs only show relative values. The actual strength of the emission signal
and the crosstalk in the image can deviate substantially from this estimate, as Smart Setup has
no knowledge of the strength with which the sample has been dyed with the individual dye
components.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 868


9 Reference | 9.2 Main Tabs ZEISS

Fig. 60: Emission Signal, Speed, Crosstalk, and Tracks

1 Emission Signal
A filled, colored bar in the Emission Signal display field shows the relative emission sig-
nal to be expected for the corresponding channel. The channel color corresponds to the
color of the selected dye in the Configure Experiment section.

2 Speed
A gray bar in the Speed display field represents the approximate acquisition speed that
can be expected. This is the time required for the movement of microscope hardware
during multichannel acquisition. Camera exposure times or parameters for other acquisi-
tion dimensions are not taken into account here.

3 Crosstalk
A hatched bar in the Crosstalk display field shows the expected relative crosstalk origi-
nating from one or more dyes for other channels.

4 Tracks display
Only visible if the Show Excitation and/or Show Emission checkboxes are activated.
The various tracks are labeled with T1, T2 etc. The white lines show the excitation and
emission spectra of the dyes schematically. The spectra are filled in color in the places
that will be acquired by the acquisition configuration suggested by Smart Setup. Trans-
mitted light channels are displayed as a white field.

9.2.2.3.4 Add Dye or Contrast Method Dialog

Here you add dyes and contrast methods to your experiment. The dyes in the database contain
important information that is saved in the image document (e.g. spectral characteristics). This in-
formation can be used later during image processing (e.g. deconvolution).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 869


9 Reference | 9.2 Main Tabs ZEISS

Info
You can add additional dyes to the database with the Dye Editor under Tools > Dye Edi-
tor....

Parameter Description
Recently used Displays the six recently used dyes or contrast methods in a list. This
ensures that you have quick access to the dyes or contrast methods
that you use frequently.

Search Here you can enter the name or initial letters of the dye or contrasting
method that you want to search for. The search results are displayed
immediately in the Dye Database list or the Contrast Methods list.
If no search filter is active, the lists of dyes or contrast techniques are
arranged in alphabetical order. If you cannot find a certain dye, try us-
ing a related dye name or a general name.

Dye Database Selects fluorescent dyes here. A double-click (or the Add button) adds
it to the experiment. The left column shows the name of the dye. The
right column contains its color and main emission wavelength. The
Custom entry adds a channel to your experiment without any addi-
tional information. This means that the resulting image cannot be
used for certain processing operations.

Contrasting Meth- Only available for WF tracks.


ods
Here you can choose a contrasting method. A double-click (or the
Add button) adds it to the experiment.

Add Adds the selected dye to the experiment. You can add several dyes/
contrast methods in a row.

Close Closes the dialog.

9.2.2.4 Reuse

The Reuse functionality is only available if you have loaded an image in *.CZI image format. Then,
the Reuse button will then appear on the Acquisition tab. Otherwise, the Reuse button is not
active.
With this function you can apply the experiment setup of the acquired image to the current exper-
iment. This will help you to easily reproduce the acquisition conditions for the next image. The
function only works correctly if the system configuration at the time of acquisition is identical to
the system configuration at the time when you execute the function.
Removing components (e.g. filter cubes, LEDs, cameras, etc.) can result in an experiment being
created incorrectly. It is therefore essential that you check after executing the Reuse function
whether the configuration of the experiment is in line with your expectations.
Using the Reuse function for a Z-stack prompts a confirmation asking whether to place the Z-
stack at the current focus position or the original focus position of the acquired image.
Note, that the original position may be way off the current position and starting an experiment
right away can lead even lead to the destruction of your sample.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 870


9 Reference | 9.2 Main Tabs ZEISS

Info
Clicking on the Reuse button overwrites the current experiment without a prompt and marks
it as having been modified. This can be seen from the appearance of an asterisk after the file
name. If you want to keep the experiment in its previous form, you must save the modified ex-
periment with a new file name under Experiment Manager > Options > Save As.

If you acquire images and save them in *.CZI image format, the following acquisition conditions
are saved together with the image:

§ Information on the type and status of your imaging system


§ Time of acquisition
§ Parameters set in the software.

9.2.2.5 Acquisition Sequence

The available options in the dropdown list depend on the selected acquisition dimensions.

Acquisition dimensions Selection option Function


Z-Stack Full Z-Stack per Channel Acquires the complete Z-
stack for a channel and then
processes the next channel.

All Channels per Slice Acquires all channels for


each Z-plane and then lo-
cates the next plane of the Z-
stack.

Z-Stack Full Z-Stack per Channel Acquires the complete Z-


stack at a tile/position for
Tiles
each channel and then pro-
cesses the next channel.
Once all Z-stacks at a tile/po-
sition have been acquired,
the next one is located.

All Channel per Slice Acquires all channels at a


tile/position for each Z-plane
before locating the next
plane of the Z-stack. Once all
Z-planes and channels at a
tile/position have been ac-
quired, the next one is lo-
cated.

Z-Stack Full Z-Stack per Channel Acquires the complete Z-


stack for each channel for a
Time Series
time point and then pro-
cesses the Z-stack of the
next channel.

All Channels per Slice Acquires all channels for


each Z-plane for a time point
before locating the next
plane of the Z-stack.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 871


9 Reference | 9.2 Main Tabs ZEISS

Acquisition dimensions Selection option Function


Tiles All Tile Regions per Time Acquires images for all chan-
Point nels as well as images at all
Time Series
positions of the experiment
for each time point and then
waits for the next time point.

Time series per tile Acquires the complete time


series at a position with all
channels, before doing the
same at the next position.
Connected tile images are,
however, acquired in full for
each time point.

Z-Stack Time-Regions-Tiles-Chan- Acquires images for all chan-


nels-Z nels as well as images at all
Tiles
positions of the experiment
Time Series for each time point and then
waits for the next time point.
The complete Z-stack is ac-
quired at every position for
each channel and the next
channel is then processed.

Time-Regions-Tiles-Z- Acquires images for all chan-


Channels nels as well as images at all
positions of the experiment
for each time point and then
waits for the next time point.
Acquires all channels for
each Z-plane and then lo-
cates the next plane of the Z-
stack.

Regions-Time-Tiles-Chan- Acquires the complete time


nels-Z series at a position with all
channels, before doing the
same at the next position.
Acquires the complete Z-
stack for each channel and
then processes the next
channel.

Regions-Time-Tiles-Z- Acquires the complete time


Channels series at a position with all
channels, before doing the
same at the next position.
Connected tile images are,
however, acquired in full for
each time point. Acquires all
channels for each Z-plane
and then locates the next
plane of the Z-stack.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 872


9 Reference | 9.2 Main Tabs ZEISS

9.2.3 Processing Tab

Here you apply processing functions to acquired or loaded images. For general information of the
image processing, see Image Processing Workflow [} 72]. For the detailed descriptions of the
functions and the processing workflow please read more under Image Processing Functions.

Fig. 61: Processing Tab

1 Function
Using Single processing, you can apply a selected processing method, with the relevant
method and image parameters, to a single image.
Using Batch processing, you can apply a selected processing method, with the relevant
method and image parameters, to a list (batch) of images. In this mode only a limited se-
lection of processing functions is available. For more information, see Applying Batch
Processing [} 75].
With the Apply button at the top you apply the selected method to the input image.

2 Method
Here you select the image processing functions. Open the Method tool to show the list
of IP functions.

3 Method Parameters
Here you configure the parameters of the selected image processing function. Click on
the Parameters tool to show the parameters of the selected IP function.

4 Image Parameters
Here you configure the image parameters of the input and output image. Click on the In-
put tool or Output tool to open input/output image settings. For more information, see
Input Tool [} 971] and Output Tool [} 984].

9.2.4 Analysis Tab

Depending on your licenses, you find different tools available for image analysis on this tab.

See also
2 Interactive Measurement Tool [} 973]
2 Image Analysis Tool [} 940]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 873


9 Reference | 9.3 Tools ZEISS

2 Intellesis Denoising Tool [} 516]


2 Intellesis Trainable Object Classification Tool [} 524]
2 Intellesis Trainable Segmentation Tool [} 509]
2 Bio Apps Tool [} 711]

9.2.5 Applications Tab

Depending on your licenses, you have the following tools available on this tab:

§ Guided Acquisition Tool [} 324]


for creating an automated workflow to acquire images (overview), detect relevant objects (im-
age analysis) and re-image these positions with another experiment.
§ Topography Tool [} 806]
for acquiring or loading an existing confocal z- stack and exporting it to ZEISS ConfoMap for
further processing.
§ Layer Thickness Measurement Tool [} 808]
for acquiring or loading an existing confocal z- stack and perform layer thickness measure-
ments.
§ Automated Photomanipulation Tool [} 579]
for creating an automated workflow to acquire multi-position images, determine relevant
ROIs for photomanipulation (image analysis), and execute the photomanipulation experiment
at these ROIs.
§ Direct Processing Tool on Applications Tab [} 237]
for ensuring that the processing computer reads incoming files and starts the processing in
case of remote processing.
§ Pipeline Tool [} 985]
for sending an image to arivis Pro and open it with an analysis pipeline.
§ arivis Cloud [} 206]
for downloading an arivis Cloud module and using it locally in ZEN.
§ AI Model Store Tool [} 888]
for downloading AI models for instance segmentation from arivis Cloud.

9.2.6 Extensions Tab

Our extensions concept allows to extend ZEN basic functionality by implementing third party ex-
tensions, e.g. ImageJ. The extensions concept is a part of OAD (Open Application Develop-
ment) for ZEN (see also Open Application Development (OAD)).
Depending on which extension you have activated, you will see the extension's functions and
controls on the Extensions tab. Please notice that we will not describe any functions of third
party extensions here. Therefore use the third party documentation for each extension.
You can find more information on OAD and the supported extensions under www.zeiss.com/
zen-oad.
For more information on ImageJ, see ImageJ [} 282] .

9.3 Tools

9.3.1 Acquisition Mode Tool

In the Acquisition Mode tool you can set the various acquisition parameters that you want to
apply for the entire experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 874


9 Reference | 9.3 Tools ZEISS

Info
If you have created an experiment using the Experiment Designer tool, the settings in the
Acquisition Mode tool only apply to the relevant experiment block and may differ in the next
block.

In terms of content and appearance, the Acquisition mode tool is largely dependent on which
imaging mode was chosen in the Imaging Setup tool, either LSM tracks or widefield channels.
If you have configured LSM tracks, including e.g. Airyscan or Lambda Tracks, read the chapter
Parameters for LSM Imaging Modes [} 875].
If you have configured widefield channels, read the chapter Parameters for Widefield Mode
[} 880].

9.3.1.1 Parameters for LSM Imaging Modes

Adjust scanning and acquisition parameters that you want to apply for the entire experiment.
In case the experiment is run as a multiblock experiment, the settings apply to one experiment
block only.
Note that the available controls vary with the chosen track mode for LSM:

§ LSM confocal
§ Airyscan SR
§ Airyscan MPLX
§ NDD
§ LSM Lambda
§ LSM Online Fingerprinting

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 875


9 Reference | 9.3 Tools ZEISS

1
2

9
10

Fig. 62: Acquisition Mode tool

No. Parameter Description


1 Scan Mode Select the Scan Mode.

- Frame Activates the frame scan mode. If this mode is selected you will
see the representation of the scanning frame in the Scan Area
section.

- Line Activates the line scan mode. If this mode is selected you will see
the representation of the scanning line in the Scan Area section.
A line scan must be 128 pixels or more. Lower values are set

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 876


9 Reference | 9.3 Tools ZEISS

No. Parameter Description


back to 128 pixels. A line scan cannot be used to define a bleach
region within a time series.

Not available for Airyscan acquisition, as at least 32 lines are re-


quired to perform Airyscan processing.

- Spot Activates the spot scan mode. If this mode is selected (only avail-
able for LSM confocal mode) the scanner is stationary at a spot
and the signal intensity is acquired from this one position.

Note that one acquisition cycle/Snap consists of 1000 pixels each


with the defined integration time. When acquiring a time series
in spot scan mode, higher scan speeds will result in one or more
dark pixels at the beginning of each acquisition cycle. Reduce the
speed to avoid this behavior. Spot scan cannot be combined
with an acquisition region defined in the Experiment Regions
tool.

2 Crop Area Clicking the button projects a rectangular overlay into the center
of the displayed image document representing the area of 2 x
zoom. The overlay graphics can be adjusted to the sample region
to be imaged in any rectangular rotated or non-rotated from
within the boundaries of the scan field. The subsequent image
acquisition will then be confined to this area.
Note that with a tile image the function will fail if the current
stage position is not in the center position of the tile region be-
cause Crop Area is confined to the Scan Area and does not
move the stage.

- Zoom Adjust the zoom level from 0.45x (0.6 for LSM 980 on Axio Ob-
server and Axio Imager; 0.7 for LSM 980 on Axio Examiner) -
40x by using the Zoom slider.
You can also enter a specific value in the input field. If clicking on
the 1 button behind the input field the zoom level will be reset
to default (1,0x) for confocal acquisition, 1.7 for Airyscan SR
tracks on LSM 980; and 1.3x for Airyscan tracks using LSM 900.

3 Scan Area In this expandable section, you can adjust the position of the
scan area.
The outer frame corresponds to the field of view of the micro-
scope.
The inner frame represents the scan area. All changes of Offset
and Rotation made in this section will be immediately applied to
the scan area.
Following functions are available:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 877


9 Reference | 9.3 Tools ZEISS

No. Parameter Description


- Offset Adjust the offset by using the Left/Right or Up/Down sliders.
You can also enter a specific value in the input field.
If clicking on the C button behind the input filed the offset posi-
tion will be reset to center position.
If you left click on the inner frame and hold down the mouse
button you can move the scan area freely. The positions in the
input fields will be adopted according to your adjustments.

- Rotation Adjust the rotation degree by using the Rotation slider. You can
also enter a specific value in the input field. If clicking on the O
button behind the input field the rotation degree will be reset to
default position (zero degree).

- Reset Scan Resets all adjustment of Rotation, Offset and Zoom to the sys-
Area tem defaults.

4 Frame Size/ Adjust the frame size (in pixel) of the displayed image by entering
Sampling the desired value in the two input fields.

- Presets but- By clicking on this button you can select from a list of default
ton frame sizes (e.g. 128 x 128 or 512 x 512). We recommend start-
ing with 512 x 512 px.

- Confocal By clicking on this button the frame size (image resolution) will
button be set to an optimal value corresponding to the optical magnifi-
cation (objective), the zoom factor and the wavelengths included
in the experiment. This provides an image where no spatial infor-
mation is lost and no empty data is generated as optimal sam-
pling is achieved. The confocal value is calculated for the given
objective and magnification settings matching a 1 fold sampling
according to 1 time Nyquist. Rectangular image dimensions are
preserved.
When you press this button once, it will change its color to blue.
This indicates that the optimal sampling will be maintained as
you continue to change acquisition parameters like zoom, Laser
lines or add more tracks. This active state of the button will be
lost once you manually edit the frame size or click the button
again.

- SR button Clicking this button (for Airyscan SR mode only) sets the sam-
pling to 2x Nyquist for superresolution mode.

5 Scan Speed Set the scan speed by adjusting the slider from 1 (slow) to 19 (for
LSM 900 the limit is 16) (very fast). The corresponding values for
Frame Time and Pixel Time will be displayed above the slider.
Note that the available maximum scan speed depends on the se-
lected Frame Size and zoom factor. In Airyscan MPLX mode the
speed is indicated in frames per second, an estimate of pixel time
and pixel number (without scanner return time). The actual frame
rate might be lower especially with very small frames. Maximum
speed is available with a zoom factor of 13.2 (LSM 980) or 6.5x
(LSM 900).
By clicking on the Max button the maximal possible scan speed
will be set automatically.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 878


9 Reference | 9.3 Tools ZEISS

No. Parameter Description


When you click this button once, it will change its color to blue.
This indicates that the system will always use the highest possible
scan speed as you continue to change acquisition parameters like
zoom or frame size. Click the button again to deactivate this per-
manently active state.

6 Direction Following scanning directions can be selected:

- Unidirec- The laser scans in one direction only, then moves back with
tional beam blanked and scans the next line.

- Bi-direc- The laser also scans when moving backwards, i.e. the scan time
tional is reduced by about a factor of two.
Note that the pixel shift between forward and backward move-
ment (double image) resulting from bi-directional scanning must
be corrected. To do that use the Correction X/Correction Y
sliders.
By clicking on the Auto button an automatic scan correction will
be performed.
For optimal results this correction should be repeated every time
scan parameters like rotation, frame size, zoom or speed are
changed.

7 Line Step Only available if the Frame Scan Mode is selected.


Select the desired line step size (from 1-10).
According to your selection only every n-th line is scanned. The
lines in between are interpolated. This fast scan mode is called
Step Scan. This feature is not available for Airyscan acquisition.

8 Averaging

- Number Select the number of images you want to average (2x - 16x).

- Mode Select the mode for averaging :


§ Repeat per Line:
The calculation of the average is based upon individual lines,
which are acquired sequentially before moving on. By this, the
data used for the averaging is closely connected, but the ac-
quisition of the full frame takes respectively longer.
§ Repeat per Frame:
The calculation of the average is based on individual full
frames. Each frame is scanned quickly, but there is a higher
delay between the individual data sets taken for the averag-
ing.

- Method Select the method which will be used for averaging:


§ Mean Intensity:
Uses the mean average of all images
§ Sum Intensity:
Uses the sum of all images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 879


9 Reference | 9.3 Tools ZEISS

No. Parameter Description


9 Bits per Pixel Use the buttons to adjust the color bit depth to 8 Bit or 16 Bit
(i.e. 256 or 65536 gray values).

10 HDR Illumina- This parameter is only available if you have licensed the HDR
tion Confocal Basic module.
If activated, a HDR effect will be applied to the image. This effect
will boost weak structures without saturating bright areas in the
image and enable an optimal representation of the morphology
of weak and bright objects within the same image.
To achieve this, the image will be scanned three times with in-
creasing the excitation intensity. Areas in the image, which dis-
played overexposure will be excluded in the following scans in
order to avoid photobleaching. It is recommended to use 16bit
for the acquisition of HDR datasets.
Note: HDR imaging is not possible when using an Experiment Re-
gion for Acquisition (see Experiment Regions Tool); whatever is
activated first (HDR or Experiment Region for Acquisition) will
then not allow to activate the other function.
HDR was developed based on ideas and a concept of O. Ron-
neberger and R. Nitschke (Albert-Ludwigs-University Freiburg,
Department of Computer Science and Life Imaging Center at
ZBSA).

See also
2 Experiment Regions Tool [} 926]

9.3.1.2 Parameters for Widefield Mode

9.3.1.2.1 Camera Section

In this section you can adopt camera settings from the active camera to your experiment and ad-
just basic camera settings.

Parameter Description
Get Settings from
Active Camera

- Get Applies the settings from the active camera to your experiment.

- Default Resets the camera settings to factory default.

Binning Here you can set the binning.


Binning combines the information of neighboring camera pixels into a
single larger pixel. For example, if the binning is set to 2 × 2, four pix-
els are combined to one.
Increasing the binning means weaker signals can be detected for a
given exposure time.
For CCD cameras, binning increases sensitivity by improving the sig-
nal-to-noise ratio, with resolution being decreased by the same factor.
In the case of CMOS cameras, only the signal intensity is increased
and the pixel count and resolution gets reduced correspondingly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 880


9 Reference | 9.3 Tools ZEISS

Parameter Description
Binning is not available for Axiocam 705 pol.

Resolution Displays and selects the camera resolution, e.g. 1024 x 1024 px.

Optimal Binning Only available for monochrome Axiocam cameras.


Sets the optimal binning calculated from the total magnification and
numerical aperture. With the help of this function the resulting pixel
size of the camera fits best to the optical resolution of the optical sys-
tem, thereby gaining the advantages of binning (improved signal to
noise ratio and decreased file size) without compromising resolution.

Binning-Indepen- Only visible when if Show all is activated.


dent Brightness
Because Binning generally increases signal intensity, the brightness of
the image normally also increases correspondingly. By activating this
checkbox, the brightness level is automatically fixed (depending on
the camera, either through exposure time adjustment or averaging),
no matter the binning setting.

IP Quality Here you can select the color interpolation quality (IP Quality) for the
acquired image. Note that this function does not apply to Live mode.
Fast: color interpolation for optimum speed (shorter computation).
High: color interpolation for optimum quality (less artifacts). This
mode is only effective with binning factor 1.

Subsampling Here you can reduce the amount of data acquired to achieve faster
frame rates. By subsampling 2x2, the effective pixel pitch is increased
by sampling only every other pixel, thus reducing the overall data size
of your image.
The CMOS sensors in the Axiocam 705 and 712 with the exception
of Axiocam 705 pol offer a on-chip subsampling mode. This sub-
sampling mode enables a dramatic increase in frame rate especially
for time series acquisition (at short exposure times) at an full field of
view of the camera.
In addition, the amount of produced image data is decreased. As this
is done by skipping every second pixel in x and y direction, the optical
resolution is decreased accordingly. Especially in high magnification
objectives at lower NA values, the image resolution is optically limited.
So this function can be used to minimize empty image information.

9.3.1.2.2 Acquisition ROI Section

In this section you can define a Region Of Interest (ROI) on the camera sensor which will be
used for acquisition. A smaller ROI can increase the acquisition speed.
The region of interest is indicated by a blue frame in the preview window and can be moved and
resized freely. The preview window always shows the entire camera sensor area which can be ac-
quired.
The Pixel Size shown below the preview window indicates the size in µm to which a pixel corre-
sponds. This depends on the camera sensor properties and on the binning.

Parameter Description
Maximize Selects the entire available image sensor area as the region of interest.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 881


9 Reference | 9.3 Tools ZEISS

Parameter Description
Center Positions the region of interest precisely at the center of the image.

Size Sets the width and height of the region of interest in pixels.

Offset Specifies the position of the top left corner of the Acquisition ROI
(blue frame) with respect to the top left corner of the preview win-
dow.

Refresh Overview Acquires and displays an image in the preview window with the cur-
rent ROI settings. This has no effect on the image in the Center
Screen Area.

Crop Specifies a ROI (Region of Interest) in a snapped image. The


"cropped" area is used as ROI for the next image acquisition.
If no image is available in the Center Screen Area the button is de-
activated.

9.3.1.2.3 Fast Acquisition Section

In this section you can set three different modes for acquisition.

Parameter Description
Interactive Using this mode you can intervene manually at certain points during
acquisition. The acquisition is comparatively slow.

Compromise This mode is activated automatically if only individual hardware com-


ponents, but not the whole system, are compatible with the Triggered
mode for acquiring an experiment.

Triggered Fast acquisition via the hardware.

- Validate Ex- To establish whether the system is able to perform an experiment in


periment Triggered mode, click Validate Experiment. The validation result is
displayed in the info box below the button bar.

9.3.1.2.4 Post Processing Section

Here you can apply basic image processing functions while acquiring the image. This can be help-
ful if certain image processing steps are necessary for any acquired image and saves image pro-
cessing work later in a job.
Depending on the camera model, different settings are available.

Parameter Description
Black Reference Influences the live image and each image acquired. For the black ref-
erence to work, you first need to acquire a completely dark reference
image. Therefore, the light path to the camera must be blocked by
setting the eyepiece switch to 100% eyepiece and closing the re-
flected light /transmitted light shutter. Define a corresponding refer-
ence image using the Define button.
Activated: Applies the measured black reference to the image.
Deactivated: The measured black reference is not used. The refer-
ence image is retained.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 882


9 Reference | 9.3 Tools ZEISS

Parameter Description
If longer exposure times are used (from exposure times of approx.
>5s, depending on the camera), individual bright pixels may become
visible with CCD or CMOS sensors. With the help of the black refer-
ence these effects are measured and corrected in accordance with the
exposure time employed.
It is recommended that you repeat this measurement at certain inter-
vals. This correction is recommended in particular for applications that
involve long exposure times, i.e. for which very little light is used (live
cell imaging, fluorescence images).
The availability of a black reference for the selected camera can be
checked on the menu Tools > Calibration Manager.

- Define Automatically defines the black reference. The measurement lasts for
several seconds. The Black Reference checkbox is then activated au-
tomatically.

Shading Correction Shading correction is used to correct optical effects, such as minor dif-
ferences in illumination or static contaminants in the beam path, with
the help of a reference image. The reference image must be acquired
without a sample. You can select between two modes Global and
Specific from the dropdown list (see description below).
After you have selected the mode simply click on the Define button.
Activated: Applies the defined shading correction to the image. The
applied correction mode is multiplicative.
Deactivated: The measured shading correction is not used. The refer-
ence image is retained.
An empty image without structures at a medium illumination intensity
is required for the shading correction measurement. To create this im-
age, locate an empty position on the slide outside the sample and ac-
quire an image for shading correction there. There must be no visible
structures on the slide as these will be incorporated into the correc-
tion image and could then lead to a visible artifact at other positions.
It may be necessary to clean the slide and defocus the microscope
slightly. You should bear in mind that Köhler illumination needs to be
set correctly. No part of the image must be overexposed.

- Define Automatically calculates the shading correction.

- Global Performs an objective specific shading correction. This is the default


method for shading correction. The following components will be
considered:
§ Magnification: Objective and Optovar
§ Camera bit depth and RGB/BW mode
§ Camera type and port position

Fluorescent filters or other fluorescence specific components are not


considered.
In principle, shading correction is objective specific. A separate refer-
ence image has to be created for each objective. Once calibration has
been completed, the correction image associated with the objective
being used is loaded automatically if shading correction is active. If no
correction image is available for an objective, the Shading Correc-

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 883


9 Reference | 9.3 Tools ZEISS

Parameter Description
tion checkbox is automatically deactivated when the objective in
question is swung in. Objective recognition on a motorized or en-
coded microscope is required for these automatic actions.

- Specific Performs channel-specific shading correction. In this case the fluores-


cence filter block used is saved with the shading file. If the fluores-
cence channel is changed, a previously created reference image is also
loaded.
The availability of created reference images can be checked on the
menu Tools > Calibration Manager. Incorrect reference images can
also be deleted there. The following components will be considered:
§ Contrast method and condenser
§ Fluorescence reflector and beam splitter
§ Spinning disc fluorescence filter

Enable Noise Filter Activated: Filters the noise in the acquired image according to the
adjusted threshold. Affects acquired images only. The live image does
not change.
Deals with sporadic bright events in single pixels on CMOS sensors,
like blinking pixels in dark images or spurious cosmic ray events. This
feature is most useful for situations with high gain settings for acquisi-
tion of very dim signals with CMOS or EMCCD cameras. In combina-
tion with a correct black reference an absolutely flat signal back-
ground can be produced.

- Threshold The higher the value, the greater the tolerance for noise. The lower
the value, the stronger the noise reduction.
The noise filter reduces the extent to which individual pixels deviate
from the average value of their nearest neighbors. The Threshold
corresponds to a tolerance value. If the deviation of the middle pixel
value from the average value of the pixels immediately surrounding it
exceeds the tolerance value (i.e. it is interpreted as noise), it is re-
placed by the average value.
This technique reduces the noise of individual pixels that are pro-
duced, in particular with EMCCD cameras and CMOS cameras. The se-
lected technique prevents any changes being made to object edges,
as in most cases these are larger than individual pixels.
This filter is also suitable for removing individual "hot pixels" from an
image without having to acquire a reference image in advance.

Enable Unsharp Enhances contrasts at fine structures and edges. Thus, the resulting
Mask image appears clearer and enriched in detail.

- Strength Controls the amount of contrast enhancement applied to fine struc-


tures and edges. The higher the strength, the darker or lighter the re-
sulting edges, compared to the original image.

- Radius Determines the size of detail to be enhanced. A small radius enhances


smaller details. The radius also affects the appearance of enhanced
edges. A large radius leads to a visible halo along enhanced edges.
The larger the radius, the broader the halo.

- Color Mode Determines the calculation method, which affects the appearance of
the output image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 884


9 Reference | 9.3 Tools ZEISS

Parameter Description
§ RGB:
– The Unsharp Mask filter calculates the sharpness for each color
channel individually.
– The color saturation and the color of structures may be changed
and color noise may occur.
§ Luminance:
– The Unsharp Mask filter calculates the sharpness based on the
luminance signal computed from the RGB channels.
– This mode avoids possible color noise or shift in color saturation,
which could be induced by certain image textures.

- Auto Contrast Activated: Enables you to adjust the Contrast Tolerance (0-20).
Auto Contrast only works in RGB color mode.

- Contrast Tol- Increasing the contrast during unsharp masking is achieved by broad-
erance ening the distribution of intensities. This corresponds to a spread of
the image histogram.
Controls how much the intensity distribution is spread and thus how
strong the contrast is increased.
§ Contrast Tolerance = 0 : No spread of intensities, no increase of
contrast
§ Contrast Tolerance = 20: Maximum spread of intensities, maxi-
mum increase of contrast

- Clip To Valid Activated: Composes the processed image of the same colors as the
Bits original image (i.e. the value range of the output image is adjusted to
the color range of the input image).
Deactivated: Colors not present in the original image may appear in
the processed image.

See also
2 Shading Correction [} 87]

9.3.1.2.5 Mode Section

In this section you can adjust how the software retrieves the camera sensor data.

Parameter Description
Color Mode This parameter is only available for color cameras and polarization-
sensitive cameras.

– RGB Transmits the image data of a color camera unchanged. This corre-
sponds to the standard operating mode of a color camera.
For Axiocam 705 pol, captures four-channel images with one
pseudo-color image for angle and degree of polarization and bright-
ness information. For details, see Color Mode for Axiocam 705 pol
[} 908].

– B/W Treats the image data of the color channels as grayscale. The data of
related color channels are averaged. The saturation of the camera ap-
pears reduced as a result.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 885


9 Reference | 9.3 Tools ZEISS

Parameter Description
This process does not change the spectral properties of a color cam-
era. The image information of the color sensor still undergoes color
interpolation. An infrared filter also restricts the spectral sensitivity of
the color camera compared to the spectral sensitivity of a genuine
black and white camera.
For Axiocam 705 pol, captures multi-channel monochrome images
with the basic polarization directions of the sensor polarization filter
directions. For details, see Color Mode for Axiocam 705 pol [} 908].

Live Speed Here you can select the live image update speed.
For CCD based camera models = slow, medium, fast.
For CMOS based camera models = high res, fast, low light.
Enables you to focus or to find regions of interest on a sample
quickly. A high live image update speed reduces the exposure time of
the live image, even at longer exposure times used for image acquisi-
tion.
To achieve a similar impression of image brightness, however, the im-
age data supplied must be adjusted digitally, which may generate a
certain amount of noise or reduce the resolution of the live image.

– Fast Represents the image optimized and requires a shorter computation


time.

– High Represents the image without artifacts and with a higher image qual-
ity. This mode is only effective with binning factor 1.

Bit Depth Enables the reduction of the delivered camera bit depth. It is translat-
ing the 14 bit based camera data values into a smaller value of 12 bit
or 8 bit. This has a visible effect of the number range in the image his-
togram, the dynamic range and the corresponding image file size in
an uncompressed CZI image.
As default, the camera models deliver 14 bit per pixel (Axiocam
503/506/512/702) and 12 bit/pixel in case of the Axiocam 305. 14
bit and 12 bit per pixel values need to be stored in two bytes in an CZI
image file. In case of a translation to 8 bit per pixel, only one byte is
needed. Therefore it is possible to reduce the produced image file size
by a factor of two. This is especially beneficial, if large amount of im-
age data is acquired.
By reducing the native camera bit depth to smaller values, the avail-
able number range for the digital image signal is decreased. There-
fore, the available amount of resolvable intensities in one image scene
is decreased accordingly.

– LUT min/LUT LUT stands for Look Up Table. It describes the translation method for
max quickly translating digital numbers in a different range. If the full
(only available swing of the input signal is not used, the reduction of bit depth can
for 8 bit be adopted accordingly by the translation starting point "Lut min" and
mode) the translation end point "Lut max".
If the used intensity range equals just an 8 bit value range, no infor-
mation is lost and the unused bits can be excluded from being stored
by an suitably adjusted translation table.
Available range is 0 to 1. The value 0 equals 0% of the input range.
The number 1 equals 100% of the input range.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 886


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Gamma The 14 bit to 8 bit translation is linear by default, which equals a
(only available Gamma value of 1. By assigning values larger or smaller then 1, the
for 8 bit translation becomes non linear.
mode)
Values <1 selectively reduce dim signal intensities.
Values >1 selectively amplify dim signal intensities.

9.3.1.2.6 Model Specific Section

Only visible if the Show All mode is activated.

To show the section in full, click on the arrow button .


In this section you see additional, model-specific camera settings depending on which camera you
use on your system.

Reset button
Resets all entries to the original values.

See also
2 AxioCam ICc5 [} 913]
2 AxioCam MR [} 912]
2 AxioCam ERc5s [} 914]
2 AxioCam HR [} 911]
2 Axiocam 503/506/512 [} 904]
2 Axiocam 105 [} 913]
2 Axiocam 305/702/705/712 [} 906]

9.3.1.3 Parameters for Lattice Lightsheet

Parameter Description
Center Displays the options for center mode.

– Position Sets the stage position.

– Center Centers the stage at the current position. Otherwise, the stage will do
the scan around its last position.

– Auto-Center Activated: Automatically centers the system around the current posi-
tion of the stage.

First/Last Displays the options for first/last mode.

– Set First Sets the current frame as the first image of the stack.

– Set Last Sets the current frame as the last image of the stack.

Range x Defines the scan range.

Slices Defines the number of slices.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 887


9 Reference | 9.3 Tools ZEISS

Parameter Description
Interval Defines the step size. The default interval is 0.2 μm for Nyquist-sam-
pled imaging. This should only be changed to coarser values if experi-
ment/data rate/speed allows for.

– Optimal Sets the slice interval according to Nyquist.

Light Sheet Selects the size of the light sheet from a list of default light sheet sizes
(e.g. 15 x 550 with 15 µm in length and 550 nm thick).

– Dithering Activates or deactivates dithering. The color of the button indicates if


dithering is activated (blue) or deactivated.

Size Adjusts the region of interest (ROI) (in μm or px) by entering the de-
sired value in the two input fields.

– Crop Area Displays a rectangle in the image to define the cropped area.

– Optimal The light sheet size (ROI) is set to an optimal value corresponding to
the optical magnification (objective), the zoom factor and the wave-
lengths included in the experiment. This provides an image where no
spatial information is lost and no empty data is generated as optimal
sampling is achieved.

9.3.1.4 Parameters for Structured Illumination Microscopy (SIM)

Parameter Description
Number of Phases Selects the number of phase images for Lattice SIM (13 or 9) or SIM
Apotome (5 or 3).

9.3.1.5 Parameters for Single Molecule Localization Microscopy (SMLM)

Parameter Description
Live Processing Triggers on the fly SMLM Processing with default parameters.

9.3.2 AI Model Store Tool

Parameter Description
Available Models Displays a list of available models.

Displays options for the respective model.


Options

– Create Analy- Opens a file browser to create an image analysis setting from the cur-
sis Setting rently selected model.

– Delete Deletes the model.

Open AI Model Opens the model store dialog which allows you to manage all your
Store available AI models.

See also

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 888


9 Reference | 9.3 Tools ZEISS

2 Creating an Image Analysis Setting From an AI Model [} 429]

9.3.2.1 AI Model Store Dialog

With this dialog you can manage all AI models that are available to you, including downloading
new models from arivis Cloud.

Parameter Description
Available in ZEN Displays all AI models that are currently available in ZEN.

Download from Updates the model list to display all models that are available for
arivis Cloud download to you on arivis Cloud.

Model List Displays a list of available models as a table. Depending on the selec-
tion on the left, all models available locally in ZEN or all models avail-
able on arivis Cloud are displayed. The table can be sorted based on
the different information by clicking at the respective header. An ar-
row indicates whether the entries are sorted in ascending or descend-
ing order.

Opens a file browser to import a model.


Import

Deletes the currently selected model.


Delete

Properties Displays further information about the currently selected model, e.g.
the number of channels or the pixel type.

– Create Analy- Only visible if you have selected Available in ZEN.


sis Setting Opens a file browser to create an image analysis setting from the cur-
rently selected model.

– Download Only visible if you have selected Download from arivis Cloud.
Models Starts the download of the currently selected model.

See also
2 Downloading AI Models [} 71]
2 Importing AI Models [} 72]
2 Creating an Image Analysis Setting From an AI Model [} 429]

9.3.3 ApoTome Mode Tool

Parameter Description
Enable ApoTome Activated: Uses the ApoTome for acquisition and experiments.

Phase Images Select here the number of phase images per optical sectioning. 5
phase images are the default value.

Live Mode Here you set the display of the Live Mode. Default value is Grid Visi-
ble.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 889


9 Reference | 9.3 Tools ZEISS

9.3.4 Auto Save Tool

Info
The Auto Save tool is not visible, if you have activated the Panorama checkbox in the experi-
ment manager. When you execute an experiment or click Snap, the Auto Save tool is dis-
abled until the experiment is cancelled or finished. The tool also stays disabled when the ex-
periment is paused. This behavior should prevent operation errors during experiments.

Generally, all images are automatically written to the hard disk during acquisition to prevent data
loss in case of technical problems. The folder path for these files is displayed in the status bar un-
der Storage Folder. In case you want to store the files directly in a location of your choice, acti-
vate the Auto Save checkbox. In this case the files are not written to the temporary folder any-
more, but automatically saved to the path defined in this tool.

Parameter Description
Saving Location
Dropdown

– Store Locally Stores the images on you local PC in the directory you define with
Folder.

– Store in ZEN Only available if you have ZEN Data Storage set up in ZEN and defined
Data Storage a default transfer share in the server management (or during the in-
Server stallation) of the server. Both the server and ZEN need to have access
to this folder. Additionally, this option is not available if you have a
ZEN Connect project open.
Directly uploads the images to ZEN Data Storage after the acquisition
is finished and the images are closed in ZEN.

Add to Collection Only visible if you have selected Store in ZEN Data Storage Server.
Selects the collection with which the images are automatically shared
after the upload. If no collection is selected or available, the images
are uploaded to the ZEN Data Storage but not shared with a collec-
tion.

Folder Only visible if you have selected Store Locally.


Shows the directory for the images. The text box is read-only. No val-
ues can be entered or pasted by the user. This ensures that the text
box contains always a valid directory

A click on open the file browser to select a new folder for the au-
tomatically saved images.

Automatic Sub- Only available if you have selected Store Locally and no ZEN Connect
Folder project is open.
Activated: Automatically creates a top level sub folder in the given
directory. The sub folder name is based on the current date, e. g.
2014-07-04.

Name Specifies the image name. An index number is automatically ap-


pended to the image name.

Prefix Defines a prefix.

Digits Defines the number of digits.

Format Displays and defines the Format for the naming convention.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 890


9 Reference | 9.3 Tools ZEISS

Parameter Description
Initial Counter Defines the initial value for the counter.
Value

Suffix Defines the suffix.

Preview Displays a preview of the image naming based on the settings and the
Format.

Save/Restore Activated: Saves/restores the counter value.


Counter Value

Add Format IDs Displays a list of all available parameters that can be used to create a
naming convention (displayed in the Format field above). A double
click on an entry adds the parameter to the Format field.

– ID Displays the ID of the respective format parameter.

– Info Displays an information for the parameter.

Close CZI after ac- Activated: Closes the CZI image in the center screen area when the
quisition experiment is finished.

File Name Preview Shows the currently selected storage path as well as a preview of the
file name being used next.

See also
2 Uploading Images Automatically After Acquisition [} 272]
2 General Information Image Saving [} 891]

9.3.4.1 General Information Image Saving

All images in ZEN are automatically written to the hard disk during acquisition to prevent data loss
in case of technical problems. The folder path for these files is displayed in the status bar under
Storage Folder. The location can easily be opened by double-clicking on this field. The path can
be changed in the Tools > Options > Saving.
The automatically saved images are contained in the subfolder temp within the currently chosen
image storage path (default path is: C:\Users\<username>\Pictures\temp). When saving such tem-
porarily saved images via the File > Save, you are asked to specify a document name and a stor-
age location. If you close such an image document without saving, it will be permanently deleted
from the temp folder in order to prevent the accumulation of unnecessary images.
Even though these files are stored physically on the disk, they are displayed with an asterisk and
you are prompted to either rename and store them in a different place, or to delete them. They
are maintained only if the software crashes. In case you want to store the files directly in a loca-
tion of your choice, activate the Auto Save checkbox. In this case the files are not written to the
temporary folder anymore.
If the Auto Save checkbox in the Experiment Manager is activated, all images which are ac-
quired through the Acquisition tab, are automatically stored in the defined folder during acquisi-
tion.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 891


9 Reference | 9.3 Tools ZEISS

9.3.5 Automated Image Export Tool

Info
It is not possible to automatically export images created by the Snap function. If you require
to use the Auto Export feature for individual images, you must create a Time Series experiment
with a single cycle.

If the Automated Export checkbox in the Experiment Manager is activated before an experi-
ment is executed, the generated images will be stored in the defined directory with the given pa-
rameters and options, provided by the options under the checkbox. This option was developed for
automatically exporting images with a user defined format (TIFF or JPEG).

Info
When you execute an experiment, the tool is disabled until the experiment is cancelled or fin-
ished. The tool also stays disabled when the experiment is paused. This behavior should pre-
vent operation errors during experiments.

For technical reasons images acquired from the Acquisition tab are always auto-saved temporarily
as CZI files. If the application requires images to be stored in external common file formats, it is
necessary to run the export function. The Automatic Image Export facilitates this in a convenient
und automatic way giving the choice of single page TIFF or JPEG file formats. It is also possible to
automatically close and discard the auto-saved CZI file to streamline the acquisition workflow.

Parameter Description
Folder Shows the directory for the images. The text box is read-only. No
values can be entered or pasted by the user. This ensures that
the text box contains always a valid directory

To change the directory click on the button. Select a new


folder for the auto saved images in the dialog.

Automatic Sub-Folder Activated: Creates automatically a top level sub folder in the
given directory. The sub folder name is based on the actual date,
e. g. 2014-07-04.

Prefix Here you can define a prefix for the image file name and a name
for the sub folder. If the text box is empty an image gets a local-
ized default prefix (“Untitled”) and a folder gets a localized de-
fault name (“New folder”). If an image or folder with a name still
exists, the new image or folder gets the same name with an in-
creasing index in accordance to the standard Windows Explorer
behavior, e. g. New Folder (1), New Folder (2).

Format Here you select the format for the export images. Two formats
are supported:
§ TIFF: For the TIFF format (lossless, bigger file size) you can ad-
ditionally select the Compression method.
– None
– LZW
– ZIP

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 892


9 Reference | 9.3 Tools ZEISS

Parameter Description
§ JPEG: For the JPEG format (lossy, smaller file size) you can set
the Quality level by adjusting the slider between Low (lower
quality, smaller images) to High (higher quality, bigger file
size).

Original data For TIFF format only:


Activated: Generates an additional raw data TIFF image. Its bit
depth depends on the original camera image (Gray 8/16 bit or
RGB 24/48 bit)

Gray Scale Linear For JPEG format only:


Activated: Generates an additional raw data JPEG image. The
bit depth depends on the original camera image. In case of 8
bits, the JPEG image has 8 bit gray scale or 24 RGB. In case of 16
bits, the JPEG image is reduced to the “Valid Bits” of the camera.
If the camera image is a 16 bit gray scale image, the resulting
JPEG image is a 8 bit gray scale image. In case of a 48 bit RGB
image the JPEG image has 8 bit RGB.
Both additional image types are marked with an ORG suffix in
their file names.

Apply display curve Activated: Applies the display curve and channel color to the
and channel color JPEG or TIFF image

Use channel names Activated: The name of the resulting image contains the name
of the defined channel.

Add XML Metadata Activated: Saves an additional xml file with image meta data. Its
name has the following nomenclature:
Prefix_Metadata (image format).xml → Test_Metadata(tif).xml If
more than one xml file with the same name exists the file gets an
index, e.g. Test-02_Metadata(tif).xml.

Close CZI image after Activated: Closes the CZI image in the center screen area when
acquisition the experiment is finished.
NOTICE! If Auto Save is not activated, this will lead to the
loss of the original .czi file for the experiment.

Dimension/Sub-direc- If you check one of the Channels, Time Series, Z-Stack or Scenes
tory checkboxes, an additional sub-directory will be created if the cor-
responding dimension exists in the experiment block.
The sub-directory will be created in the same image dimension
order as the CZI image created, e.g. T-C-Z. The top level folder
within the “Dimension” folders is always the B (“Block”) folder
[new].
Each sub-directory gets a letter that represents its image dimen-
sion (T for time series, C for channel, etc.) and an index, if more
than one dimension of the same type exists (T=0, T=1).

9.3.6 Automation Tool

With this tool you can select OAD macros which will be executed before or/and after an experi-
ment. The default folder for macros is User/Documents/Carl Zeiss/ZEN/Documents/Macros.
Any other folder is selectable.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 893


9 Reference | 9.3 Tools ZEISS

Parameter Description
Run OAD macro If activated, the selected macro is executed before the experiment
before experiment starts.
execution
If you click on the ... button you can select a macro from the file sys-
tem.

Run OAD macro If activated, the selected macro is executed after the experiment.
after experiment
If you click on the ... button you can select a macro from the file sys-
execution
tem.

9.3.7 Camera Tool

Here you can configure all the settings for the selected camera.
Note that the functions and settings in this tool depend on which camera you are using. Not all
cameras have all the functions described in here.

9.3.7.1 Exposure Time Section

Here you control the exposure settings of your camera.


If you use automatic exposure, you can select an area on the camera sensor which is used to cal-
culate the exposure time.

Parameter Description
Time Specifies the duration of the image acquisition. Selects the unit of
time (min, ms, s, µs).

Auto Exposure Activated: The exposure time is calculated automatically every time
an image is acquired. The exposure time in the corresponding input
field fluctuates accordingly.
Deactivated: The exposure time must be set manually.

Intensity Enables you to compensate for underexposure or overexposure if you


are not content with the auto exposure result.
§ 5% - 100%: Darkens the image (compensates for overexposure)
§ 100% - 200%: Brightens the image (compensates for underexpo-
sure)

Set Exposure Starts a one-off measurement of the exposure time, which is then
used for all subsequent images. Deactivates the Auto Exposure
checkbox.
If you are not satisfied with the result, you can adjust the measured
exposure time manually.

Spot Meter/Focus Activated: The exposure time and focus measurements use the inten-
ROI sity values within a specified area instead of the entire camera sensor
area. This improves the results for the area to be acquired.
If the red Spot Meter/Focus ROI frame is not visible in the live im-
age, right-click in the live image and select Spot Meter/Focus ROI
from the context menu.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 894


9 Reference | 9.3 Tools ZEISS

Parameter Description
Binning Here you can set the binning.
Binning combines the information of neighboring camera pixels into a
single larger pixel. For example, if the binning is set to 2 × 2, four pix-
els are combined to one.
Increasing the binning means weaker signals can be detected for a
given exposure time.
For CCD cameras, binning increases sensitivity by improving the sig-
nal-to-noise ratio, with resolution being decreased by the same factor.
In the case of CMOS cameras, only the signal intensity is increased
and the pixel count and resolution gets reduced correspondingly.
Binning is not available for Axiocam 705 pol.

Resolution Displays and selects the camera resolution, e.g. 1024 x 1024 px.

Optimal Binning Only available for monochrome Axiocam cameras.


Sets the optimal binning calculated from the total magnification and
numerical aperture. With the help of this function the resulting pixel
size of the camera fits best to the optical resolution of the optical sys-
tem, thereby gaining the advantages of binning (improved signal to
noise ratio and decreased file size) without compromising resolution.

Binning-Indepen- Only visible when if Show all is activated.


dent Brightness
Because Binning generally increases signal intensity, the brightness of
the image normally also increases correspondingly. By activating this
checkbox, the brightness level is automatically fixed (depending on
the camera, either through exposure time adjustment or averaging),
no matter the binning setting.

IP Quality Here you can select the color interpolation quality (IP Quality) for the
acquired image. Note that this function does not apply to Live mode.
Fast: color interpolation for optimum speed (shorter computation).
High: color interpolation for optimum quality (less artifacts). This
mode is only effective with binning factor 1.

Subsampling Here you can reduce the amount of data acquired to achieve faster
frame rates. By subsampling 2x2, the effective pixel pitch is increased
by sampling only every other pixel, thus reducing the overall data size
of your image.
The CMOS sensors in the Axiocam 705 and 712 with the exception
of Axiocam 705 pol offer a on-chip subsampling mode. This sub-
sampling mode enables a dramatic increase in frame rate especially
for time series acquisition (at short exposure times) at an full field of
view of the camera.
In addition, the amount of produced image data is decreased. As this
is done by skipping every second pixel in x and y direction, the optical
resolution is decreased accordingly. Especially in high magnification
objectives at lower NA values, the image resolution is optically limited.
So this function can be used to minimize empty image information.

9.3.7.2 White Balance Section

This section is only visible if you are using a color camera.


Here you adjust the color balance to a neutral hue independent of the light source used.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 895


9 Reference | 9.3 Tools ZEISS

Save suitable white balance settings using the Settings section to ensure color reproducibility of
images acquired in the future.

Parameter Description
Auto Compensates for the color temperature of the light source automati-
cally to yield a neutral hue.
The entire camera sensor area is measured. If there are no pure white
areas on the sample and Auto does not yield the desired results, mea-
sure and compensate for the color temperature of the light source as
follows:
§ Transmitted light: Move the sample such that a clear and transpar-
ent region is illuminated or remove the sample from the micro-
scope. Click the Auto button to perform the auto white balance.
§ Reflected light: Use a neutral surface (e.g. a piece of white paper)
as a sample. Click the Auto button to perform the auto white bal-
ance.

You can now acquire white balanced images of your sample with the
above settings.

Pick... Enables you to select a reference pixel for white balance from the live
image.
The selected pixel should be neutral white.

3200 K Applies a predefined color balance setting to compensate for the


color temperature of a halogen light source at approximately 3200 K.

5500 K Applies a predefined color balance setting to compensate for the


color temperature of an LED light source at approximately 5500 K.

Show Channels Sets the color balance of each color channel (red/cyan, green/ma-
genta and blue/yellow) individually to make the image appear neutral.

Color Temperature Changes the overall color temperature of the image from cool (blue
cast) to warm (red cast).
The color channels (red/cyan, green/magenta and blue/yellow) are ad-
justed automatically. The Color Temperature setting can work
against the settings applied using Show Channels.
Use Color Temperature for fine tuning in combination with Pick... if
Pick... does not give perfect results.

Saturation Changes the colorfulness of the image.

Reset Resets any color changes and sets the white balance value to 6500 K.

9.3.7.3 Acquisition ROI Section

In this section you can define a Region Of Interest (ROI) on the camera sensor which will be
used for acquisition. A smaller ROI can increase the acquisition speed.
The region of interest is indicated by a blue frame in the preview window and can be moved and
resized freely. The preview window always shows the entire camera sensor area which can be ac-
quired.
The Pixel Size shown below the preview window indicates the size in µm to which a pixel corre-
sponds. This depends on the camera sensor properties and on the binning.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 896


9 Reference | 9.3 Tools ZEISS

Parameter Description
Maximize Selects the entire available image sensor area as the region of interest.

Center Positions the region of interest precisely at the center of the image.

Size Sets the width and height of the region of interest in pixels.

Offset Specifies the position of the top left corner of the Acquisition ROI
(blue frame) with respect to the top left corner of the preview win-
dow.

Refresh Overview Acquires and displays an image in the preview window with the cur-
rent ROI settings. This has no effect on the image in the Center
Screen Area.

Crop Specifies a ROI (Region of Interest) in a snapped image. The


"cropped" area is used as ROI for the next image acquisition.
If no image is available in the Center Screen Area the button is de-
activated.

9.3.7.4 Gain Section

Adjusting the gain factor amplifies the signal intensity and brightness of the camera image corre-
spondingly while at the same time reducing the available dynamic range.
For Axiocam 702, 705, and 712 models: The gain factor allows a signal amplification as speci-
fied in the camera data sheet. For these CMOS sensor based camera models, also the sensitivity of
the cameras is amplified and the cameras can detect weaker signals. Note that by amplifying a
signal, the max/min signal intensity which can be acquired will be limited. The consequence is a
reduction of the available dynamic range. Gain 4 (opt) is a best compromise between sensitivity
and available dynamic range. Gain 1x (min) is the minimum signal amplification with the highest
dynamic range. Gain 16x (max) is the highest sensitivity with the smallest dynamic range.

HDR (0.2x) Mode


The High Dynamic Range Mode of the Axiocam 702, 705, 712 cameras offers the possibility to
increase the available dynamic range by a factor of 5x. It returns noise free information in very
dim image areas and can record simultaneously very bright image areas. As the additional inten-
sity range is extended for brighter image signals, regular signals get 5 times dimmer (0.2x) com-
pared to a standard setting. This is achieved by combing two images with different adjustments:
one at a shorter exposure time and a low gain value for the bright signals and one image at
longer exposure times and higher gain for the weak signals. The used exposure times are auto-
matically derived from the current camera setting. It also works in the live image mode, but re-
duces the frame speed accordingly.
Execute a proper exposure time readjustment after activating this feature. This feature is very use-
ful if the camera should acquire reflective surfaces, i.e. in materials applications, or in polarization
microscopy of minerals.

9.3.7.5 Post Processing Section

Here you can apply basic image processing functions while acquiring the image. This can be help-
ful if certain image processing steps are necessary for any acquired image and saves image pro-
cessing work later in a job.
Depending on the camera model, different settings are available.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 897


9 Reference | 9.3 Tools ZEISS

Parameter Description
Black Reference Influences the live image and each image acquired. For the black ref-
erence to work, you first need to acquire a completely dark reference
image. Therefore, the light path to the camera must be blocked by
setting the eyepiece switch to 100% eyepiece and closing the re-
flected light /transmitted light shutter. Define a corresponding refer-
ence image using the Define button.
Activated: Applies the measured black reference to the image.
Deactivated: The measured black reference is not used. The refer-
ence image is retained.
If longer exposure times are used (from exposure times of approx.
>5s, depending on the camera), individual bright pixels may become
visible with CCD or CMOS sensors. With the help of the black refer-
ence these effects are measured and corrected in accordance with the
exposure time employed.
It is recommended that you repeat this measurement at certain inter-
vals. This correction is recommended in particular for applications that
involve long exposure times, i.e. for which very little light is used (live
cell imaging, fluorescence images).
The availability of a black reference for the selected camera can be
checked on the menu Tools > Calibration Manager.

- Define Automatically defines the black reference. The measurement lasts for
several seconds. The Black Reference checkbox is then activated au-
tomatically.

Shading Correction Shading correction is used to correct optical effects, such as minor dif-
ferences in illumination or static contaminants in the beam path, with
the help of a reference image. The reference image must be acquired
without a sample. You can select between two modes Global and
Specific from the dropdown list (see description below).
After you have selected the mode simply click on the Define button.
Activated: Applies the defined shading correction to the image. The
applied correction mode is multiplicative.
Deactivated: The measured shading correction is not used. The refer-
ence image is retained.
An empty image without structures at a medium illumination intensity
is required for the shading correction measurement. To create this im-
age, locate an empty position on the slide outside the sample and ac-
quire an image for shading correction there. There must be no visible
structures on the slide as these will be incorporated into the correc-
tion image and could then lead to a visible artifact at other positions.
It may be necessary to clean the slide and defocus the microscope
slightly. You should bear in mind that Köhler illumination needs to be
set correctly. No part of the image must be overexposed.

- Define Automatically calculates the shading correction.

- Global Performs an objective specific shading correction. This is the default


method for shading correction. The following components will be
considered:
§ Magnification: Objective and Optovar
§ Camera bit depth and RGB/BW mode
§ Camera type and port position

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 898


9 Reference | 9.3 Tools ZEISS

Parameter Description
Fluorescent filters or other fluorescence specific components are not
considered.
In principle, shading correction is objective specific. A separate refer-
ence image has to be created for each objective. Once calibration has
been completed, the correction image associated with the objective
being used is loaded automatically if shading correction is active. If no
correction image is available for an objective, the Shading Correc-
tion checkbox is automatically deactivated when the objective in
question is swung in. Objective recognition on a motorized or en-
coded microscope is required for these automatic actions.

- Specific Performs channel-specific shading correction. In this case the fluores-


cence filter block used is saved with the shading file. If the fluores-
cence channel is changed, a previously created reference image is also
loaded.
The availability of created reference images can be checked on the
menu Tools > Calibration Manager. Incorrect reference images can
also be deleted there. The following components will be considered:
§ Contrast method and condenser
§ Fluorescence reflector and beam splitter
§ Spinning disc fluorescence filter

Enable Noise Filter Activated: Filters the noise in the acquired image according to the
adjusted threshold. Affects acquired images only. The live image does
not change.
Deals with sporadic bright events in single pixels on CMOS sensors,
like blinking pixels in dark images or spurious cosmic ray events. This
feature is most useful for situations with high gain settings for acquisi-
tion of very dim signals with CMOS or EMCCD cameras. In combina-
tion with a correct black reference an absolutely flat signal back-
ground can be produced.

- Threshold The higher the value, the greater the tolerance for noise. The lower
the value, the stronger the noise reduction.
The noise filter reduces the extent to which individual pixels deviate
from the average value of their nearest neighbors. The Threshold
corresponds to a tolerance value. If the deviation of the middle pixel
value from the average value of the pixels immediately surrounding it
exceeds the tolerance value (i.e. it is interpreted as noise), it is re-
placed by the average value.
This technique reduces the noise of individual pixels that are pro-
duced, in particular with EMCCD cameras and CMOS cameras. The se-
lected technique prevents any changes being made to object edges,
as in most cases these are larger than individual pixels.
This filter is also suitable for removing individual "hot pixels" from an
image without having to acquire a reference image in advance.

Enable Unsharp Enhances contrasts at fine structures and edges. Thus, the resulting
Mask image appears clearer and enriched in detail.

- Strength Controls the amount of contrast enhancement applied to fine struc-


tures and edges. The higher the strength, the darker or lighter the re-
sulting edges, compared to the original image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 899


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Radius Determines the size of detail to be enhanced. A small radius enhances
smaller details. The radius also affects the appearance of enhanced
edges. A large radius leads to a visible halo along enhanced edges.
The larger the radius, the broader the halo.

- Color Mode Determines the calculation method, which affects the appearance of
the output image.
§ RGB:
– The Unsharp Mask filter calculates the sharpness for each color
channel individually.
– The color saturation and the color of structures may be changed
and color noise may occur.
§ Luminance:
– The Unsharp Mask filter calculates the sharpness based on the
luminance signal computed from the RGB channels.
– This mode avoids possible color noise or shift in color saturation,
which could be induced by certain image textures.

- Auto Contrast Activated: Enables you to adjust the Contrast Tolerance (0-20).
Auto Contrast only works in RGB color mode.

- Contrast Tol- Increasing the contrast during unsharp masking is achieved by broad-
erance ening the distribution of intensities. This corresponds to a spread of
the image histogram.
Controls how much the intensity distribution is spread and thus how
strong the contrast is increased.
§ Contrast Tolerance = 0 : No spread of intensities, no increase of
contrast
§ Contrast Tolerance = 20: Maximum spread of intensities, maxi-
mum increase of contrast

- Clip To Valid Activated: Composes the processed image of the same colors as the
Bits original image (i.e. the value range of the output image is adjusted to
the color range of the input image).
Deactivated: Colors not present in the original image may appear in
the processed image.

See also
2 Shading Correction [} 87]

9.3.7.6 Settings Section

In this section you can save all the settings you have made in the camera tool to a settings file
(*.czcs). This is very helpful because you can restore/load your saved settings very quickly when
starting the software again.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 900


9 Reference | 9.3 Tools ZEISS

Parameter Description
Default Resets all camera settings in the Camera tool to the factory default
settings. These settings can also be selected from the dropdown list
of available camera settings to the right of the Default button. To do
this, select the Original Settings entry.

Options Opens the Options [} 901] menu.

Reload Undoes the changes you have made to a loaded setting and restores
the original status of the loaded setting.

9.3.7.6.1 Camera Tool Options

Parameter Description
New Creates a new camera setting. Enter a name for the camera setting in
the input field. To save the camera setting, click on the Disc icon to
the right of the input field.

Rename Renames the current camera setting. Enter another name for the cam-
era setting in the input field. To save the camera setting, click on the
Disc icon to the right of the input field.

Save Saves the current camera setting.

Save As Saves the current camera setting under a new name. Enter a new
name in the input field. To save the camera setting, click on the Disc
icon to the right of the input field.

Import Imports an existing camera setting.

Export Exports the selected camera setting.

Delete Deletes the selected camera setting.

9.3.7.7 Mode Section

In this section you can adjust how the software retrieves the camera sensor data.

Parameter Description
Color Mode This parameter is only available for color cameras and polarization-
sensitive cameras.

– RGB Transmits the image data of a color camera unchanged. This corre-
sponds to the standard operating mode of a color camera.
For Axiocam 705 pol, captures four-channel images with one
pseudo-color image for angle and degree of polarization and bright-
ness information. For details, see Color Mode for Axiocam 705 pol
[} 908].

– B/W Treats the image data of the color channels as grayscale. The data of
related color channels are averaged. The saturation of the camera ap-
pears reduced as a result.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 901


9 Reference | 9.3 Tools ZEISS

Parameter Description
This process does not change the spectral properties of a color cam-
era. The image information of the color sensor still undergoes color
interpolation. An infrared filter also restricts the spectral sensitivity of
the color camera compared to the spectral sensitivity of a genuine
black and white camera.
For Axiocam 705 pol, captures multi-channel monochrome images
with the basic polarization directions of the sensor polarization filter
directions. For details, see Color Mode for Axiocam 705 pol [} 908].

Live Speed Here you can select the live image update speed.
For CCD based camera models = slow, medium, fast.
For CMOS based camera models = high res, fast, low light.
Enables you to focus or to find regions of interest on a sample
quickly. A high live image update speed reduces the exposure time of
the live image, even at longer exposure times used for image acquisi-
tion.
To achieve a similar impression of image brightness, however, the im-
age data supplied must be adjusted digitally, which may generate a
certain amount of noise or reduce the resolution of the live image.

– Fast Represents the image optimized and requires a shorter computation


time.

– High Represents the image without artifacts and with a higher image qual-
ity. This mode is only effective with binning factor 1.

Bit Depth Enables the reduction of the delivered camera bit depth. It is translat-
ing the 14 bit based camera data values into a smaller value of 12 bit
or 8 bit. This has a visible effect of the number range in the image his-
togram, the dynamic range and the corresponding image file size in
an uncompressed CZI image.
As default, the camera models deliver 14 bit per pixel (Axiocam
503/506/512/702) and 12 bit/pixel in case of the Axiocam 305. 14
bit and 12 bit per pixel values need to be stored in two bytes in an CZI
image file. In case of a translation to 8 bit per pixel, only one byte is
needed. Therefore it is possible to reduce the produced image file size
by a factor of two. This is especially beneficial, if large amount of im-
age data is acquired.
By reducing the native camera bit depth to smaller values, the avail-
able number range for the digital image signal is decreased. There-
fore, the available amount of resolvable intensities in one image scene
is decreased accordingly.

– LUT min/LUT LUT stands for Look Up Table. It describes the translation method for
max quickly translating digital numbers in a different range. If the full
(only available swing of the input signal is not used, the reduction of bit depth can
for 8 bit be adopted accordingly by the translation starting point "Lut min" and
mode) the translation end point "Lut max".
If the used intensity range equals just an 8 bit value range, no infor-
mation is lost and the unused bits can be excluded from being stored
by an suitably adjusted translation table.
Available range is 0 to 1. The value 0 equals 0% of the input range.
The number 1 equals 100% of the input range.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 902


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Gamma The 14 bit to 8 bit translation is linear by default, which equals a
(only available Gamma value of 1. By assigning values larger or smaller then 1, the
for 8 bit translation becomes non linear.
mode)
Values <1 selectively reduce dim signal intensities.
Values >1 selectively amplify dim signal intensities.

9.3.7.8 Trigger Control Section

Only visible if the selected camera has a trigger input/output.

Trigger Out section


Using the trigger output you set how the camera sends a trigger signal to an external component
(e.g. shutter).

Info
Activate both checkboxes if you want the trigger signal to be generated both during the live
image and during acquisition.

Parameter Description
Enable for Snap Activated: Generates the trigger signal during the acquisition of an
image.

Enable for Live Activated: Generates the trigger signal during the live image.

Control Signal

- Active High The Control Signal jumps from 0 Volts to 5 Volts when the camera's
exposure begins. Following exposure it returns to 0 Volts.

- Active Low The Control Signal jumps from 5 Volts to 0 Volts when the camera's
exposure begins. Following exposure it returns to 5 Volts.

Shutter Open De- Here you can enter the delay before acquisition.
lay

Trigger In section
The trigger input allows you to trigger acquisition by the camera using an external trigger signal.

Info
Due to its inertia, a mechanical shutter needs a certain amount of time to change from the
closed to the open position after the control signal has been generated. To ensure that this
transitional state is not recorded during the exposure of the sensor, the start of actual acquisi-
tion can be delayed by an adjustable period of time.

Parameter Description
Enable for Snap Activated: Only acquires the image after the trigger signal has been
received.

Control Signal

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 903


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Active High The Control Signal jumps from 0 Volts to 5 Volts when the camera's
exposure begins. Following exposure it returns to 0 Volts.

- Active Low The Control Signal jumps from 5 Volts to 0 Volts when the camera's
exposure begins. Following exposure it returns to 5 Volts.

9.3.7.9 Model Specific Section

Only visible if the Show All mode is activated.

To show the section in full, click on the arrow button .


In this section you see additional, model-specific camera settings depending on which camera you
use on your system.

Reset button
Resets all entries to the original values.

See also
2 AxioCam ICc5 [} 913]
2 AxioCam MR [} 912]
2 AxioCam ERc5s [} 914]
2 AxioCam HR [} 911]
2 Axiocam 503/506/512 [} 904]
2 Axiocam 105 [} 913]
2 Axiocam 305/702/705/712 [} 906]

9.3.7.9.1 Axiocam 503/506/512

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

– Flip Horizontally

– Flip Vertically

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 904


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Rotate 90 CW

– Rotate 90 CCW

– Rotate 180

– Mirror at +45
Diagonal

– Mirror at -45
Diagonal)

Acquire section

Parameter Description
Readout Speed Readout speed can be varied between 39 MHz and 13 MHz if the
(MHz) camera is operated via the USB3.0 bus. In case the camera is con-
nected to the slower USB2.0 bus, only the 13 MHz mode is available.
At the slower 13 MHz mode, the signal quality is slightly improved
due to a reduced noise of the signal transmission.

Cooling Status information if camera cooling is active. The Axiocam


503/506/512 can be operated without active cooling. Cooling is de-
activated if the USB2.0 connector of the camera is not connected to
the PC or to a USB compatible power supply.

Readout Port The Axiocam 503/506/512 uses a high performance CCD sensor
with four readout ports. It can be adjusted to quadport, dualport, sin-
gleport and Auto mode. Maximum speed is reached by using all four
ports and short exposure times. When exposure time gets larger than
the readout time, the benefit for using multiple ports is getting in-
significant. By switching the readout mode to single port, the most
homogenous signal quality can be reached as all data is sent through
one single processing chain. In Auto mode, the number of used read-
out ports is selected automatically depending on the exposure time.

Readout Time The valid camera readout time (in ms) is defined by the number of
used ports or by defining a sensor sub region window (ROI).

Post Processing section

Parameter Description
SW Subsampling The software subsampling feature is used to reduce the image size
which helps to reduce the amount of the image data load in case of
long time lapse or multi-dimensional images. As this is done by soft-
ware processing, the full image is acquired and prepared before it is
downsized by this function. Especially in high magnification objectives
at lower NA values, the image resolution is optically limited. Hence,
this function can be used to minimize empty image information. This
feature works with all Axiocam 3 series, 5 series, and 7 series
models.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 905


9 Reference | 9.3 Tools ZEISS

Temperature section

Parameter Description
Temperature The valid sensor temperature is shown here. It is adjusted to 18 C°. It
can not be changed. If a black reference is used it should be used at
the same sensor temperature when it was created.
If free air circulation for the camera housing is blocked, the sensor
temperature may be increased and the dark current of the sensor may
be higher than normal. If the camera is operated without cooling
(USB 2.0 port of camera not connected), the sensor temperature is in-
creased and dark current will be higher than normal. This should be
considered when using the camera with longer exposure times.

9.3.7.9.2 Axiocam 305/702/705/712

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

– Flip Horizontally

– Flip Vertically

– Rotate 90 CW

– Rotate 90 CCW

– Rotate 180

– Mirror at +45
Diagonal

– Mirror at -45
Diagonal)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 906


9 Reference | 9.3 Tools ZEISS

Acquire section

Parameter Description
Cooling Status information if camera cooling is active. While Axiocam 305 is
only temperature-stabilized, the Axiocam models of the 7 series are
temperature-stabilized and can be operated with active cooling. Cool-
ing is deactivated if the USB2.0 connector of the camera is not con-
nected to the PC or to a USB compatible power supply.

Readout Time The valid camera readout time (in ms) is defined by the number of
used ports or by defining a sensor sub region window (ROI).

Polarization section
Only available for Axiocam 705 pol.

Parameter Description
Live Polarization Only available in B/W mode.
Displays the polarization channel in the live image. The given angles
correspond to the polarization filter direction sensor.

– 0°

– 45°

– 90°

– 135°

– Raw Displays raw data without post processing.

0° Only available in B/W mode.


Selects the 0° channel which is displayed in the Dimensions tab.

45° Only available in B/W mode.


Selects the 45° channel which is displayed in the Dimensions tab.

90° Only available in B/W mode.


Selects the 90° channel which is displayed in the Dimensions tab.

135° Only available in B/W mode.


Selects the 135° channel which is displayed in the Dimensions tab.

Polarization Color Only available in RGB mode.


Mode Selects the polarization color mode.

– Standard Color Uses a computationally intensive approach to represent the polariza-


Coding tion properties according to angle of polarization and degree of polar-
ization. The maximum live image speed is slowed down because the
calculation is more complex.

– Simplified Color Ensures the fastest possible representation of the live image by choos-
Coding ing a faster calculation path for the color representation.

– Raw Data Displays raw data without post processing.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 907


9 Reference | 9.3 Tools ZEISS

Parameter Description
Display HLS im- Only available in RGB mode.
ages Switches the display of the partial images with the angle of polariza-
tion (AoP), degree of polarization (DoLP) and intensity information on
or off. If the checkbox is deactivated, only the finalized pseudo-color
image is provided.

For details, see Color Mode for Axiocam 705 pol [} 908].

Post Processing section

Parameter Description
SW Subsampling The software subsampling feature is used to reduce the image size
which helps to reduce the amount of the image data load in case of
long time lapse or multi-dimensional images. As this is done by soft-
ware processing, the full image is acquired and prepared before it is
downsized by this function. Especially in high magnification objectives
at lower NA values, the image resolution is optically limited. Hence,
this function can be used to minimize empty image information. This
feature works with all Axiocam 3 series, 5 series, and 7 series
models.

Temperature section

Parameter Description
Temperature The valid sensor temperature is shown here. It is adjusted to 18 C°. It
can not be changed. If a black reference is used it should be used at
the same sensor temperature when it was created.
If free air circulation for the camera housing is blocked, the sensor
temperature may be increased and the dark current of the sensor may
be higher than normal. If the camera is operated without cooling
(USB 2.0 port of camera not connected), the sensor temperature is in-
creased and dark current will be higher than normal. This should be
considered when using the camera with longer exposure times.

9.3.7.9.2.1 Color Mode for Axiocam 705 pol

B/W mode
In B/W mode, an image acquisition produces an image with four channels. Each channel corre-
sponds to one of the polarization directions. The channels can be viewed individually or as an
overlay image. It is possible to assign a pseudo-color to the individual polarization channels and to
view them as an overlay image. In doing so, it is helpful to adjust the characteristic curves for dis-
playing the images channel by channel.
The channels are displayed in the Dimensions tab and can be viewed individually via the Single
Channel checkbox.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 908


9 Reference | 9.3 Tools ZEISS

RGB mode
In RGB mode, the polarization information of the camera is interpreted as a color image. In addi-
tion, the underlying information is available as further channels with the angle, the degree, and
the brightness of the image. This conversion of the polarization channels into these derived pa-
rameters is based on the theory of Stokes parameters which can be used to describe polarization.
These can be derived directly from the directions of the polarization filters from the sensor.

§ I(0) = Signal intensity of the pixel with 0° pol filter transmission


§ I(45) = Signal intensity of the pixel with 45° pol filter transmission
§ I(90) = Signal intensity of the pixel with 90° pol filter transmission
§ I(135)= Signal intensity of the pixel with 135° pol filter transmission
Stokes parameters:

§ S0 = I(0) + I(90)
§ S1 = I(0) - I(90)
§ S2 = I(45) - I(135)
The following values are calculated by using the aforementioned parameters:

§ Degree of Linear Polarization (DoP)

This value is independent of intensity because it represents the degree of polarization at an


image location. At low polarization or a low percentage of non-polarized light, the value is
very small. At fully polarized light the value becomes very large. In the pseudo-color image,
the property of color saturation is assigned to this value.
§ Angle of Mean Polarization (AoP)

This value is independent of intensity because it represents the angle of polarization at an im-
age location from 0 to 180 degrees. This channel can appear noisy when the camera is at low
saturation. In the pseudo-color image, this information is assigned to the color tone (hue). If
the light intensity is low, more noise is visible in the image. The brightness only changes de-
pending on the distribution of the polarization angle of the light.
Note: Circular polarization cannot be detected with this camera.
The angle of polarization is assigned to a color value with the maximum value for AoP being
mapped to the numerical value of 16383 (214).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 909


9 Reference | 9.3 Tools ZEISS

Fig. 63: AoP Color Coding


§ Value
This value corresponds to the normal brightness information of an image. To get good AoP
and DoP signals, this channel must not be overdriven or underdriven. In the pseudo-color im-
age, this information is assigned to light intensity (value).
Via the HSV colour space, these values can be displayed in combination as a multi-channel image.

Fig. 64: HSV Color Space


Reference: HSV-Farbraum. (n.d.). In Wikipedia. Retrieved August 10, 2021, from https://
https://de.wikipedia.org/wiki/HSV-Farbraum

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 910


9 Reference | 9.3 Tools ZEISS

1 H = Color Tone (Hue) → AoP

2 S = Color Saturation (Saturation) → DoP

3 V = Light Intensity (Value) → Value

The live image is visualized via pseudo-color encoding of the polarization channels. Following en-
coding formula is used:

§ R = I(0)
– I(0) = intensity of polarization direction 0°
§ G = (I45 + I90)/2
– I(45) = intensity of polarization direction 45°
– I(90) = intensity of polarization direction 90°
§ B = I(135)
– I(135) = intensity of polarization direction 135°

The channels are displayed in the Dimensions tab.

9.3.7.9.3 AxioCam HR

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

– Flip Horizontally

– Flip Vertically

– Rotate 90 CW

– Rotate 90 CCW

– Rotate 180

– Mirror at +45
Diagonal

– Mirror at -45
Diagonal)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 911


9 Reference | 9.3 Tools ZEISS

Acquire section

Parameter Description
Readout Speed Here you can select the orientation of the camera image. This allows
(MHz) you to adjust the camera image to the properties of the different
camera ports.

– High Speed The readout speed is 24 MHz mode and the digitization accuracy is
set to 12 bits per pixel. This mode offers advantages if sufficient light
is available and situations need to be acquired quickly, for example
fast time series or tile images.

– High Accuracy The readout speed is 12 MHz and the digitization accuracy is set to 14
bits per pixel. This mode offers advantages if very little light is avail-
able and you want the camera to acquire very weak signals just above
the camera's noise level.

9.3.7.9.4 AxioCam MR

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

– Flip Horizontally

– Flip Vertically

– Rotate 90 CW

– Rotate 90 CCW

– Rotate 180

– Mirror at +45
Diagonal

– Mirror at -45
Diagonal)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 912


9 Reference | 9.3 Tools ZEISS

9.3.7.9.5 AxioCam ICc5

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

– Flip Horizontally

– Flip Vertically

– Rotate 90 CW

– Rotate 90 CCW

– Rotate 180

– Mirror at +45
Diagonal

– Mirror at -45
Diagonal)

9.3.7.9.6 Axiocam 105

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 913


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Flip Horizontally

– Flip Vertically

– Rotate 180

Acquire section

Parameter Description
Gain Boost If activated, the image signal is amplified so that the image becomes
brighter. The gain factor is 1.7x. This factor is in addition to the stan-
dard gain control.

9.3.7.9.7 AxioCam ERc5s

Camera Identifier section

Parameter Description
Camera Identifier A clear identifier for the currently active camera is displayed here. It
consists of the product name and part of the serial number. This is
helpful if you want to identify the camera in question, e.g. when
working with a dual camera system.

Sharpness section

Parameter Description
Sharpness Increases the impression of sharpness in an image.

Orientation section

Parameter Description
Orientation Here you can select the orientation of the camera image. This allows
you to adjust the camera image to the properties of the different
camera ports.

– Original

– Flip Horizontally

– Flip Vertically

– Rotate 180

9.3.8 Channels Tool

In the Channels tool you can configure channels for Widefield acquisition. The tool offers you the
option of entering the hardware settings for acquisition manually or performing the configuration
automatically. Its is not recommenced for LSM channels as you still need to open up Imaging
Setup or use Smart Setup to chose specific channels and adapt the spectral range for detection.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 914


9 Reference | 9.3 Tools ZEISS

If there is no channel available, you can add a channel to the experiment by clicking on the corre-
sponding button (e.g. Airyscan, LSM (various modes), or Widefield).

Fig. 65: Channels Tool (without channels)


If a channel is added, the tool enables you to configure settings for each channel. The following
appearance is an example with two Widefield channels:

Fig. 66: Channels tool

1 Channels list
Displays the selected channels of your experiment, see Channels List [} 916].

2 Light Source section


Displays settings for the light source or the lasers (LSM), see Light Source Section (WF)
[} 917] or Lasers Section [} 918].

3 Channel settings
Displays settings for your channels, see Channel Settings (Widefield) [} 920]/Channel
Settings (LSM) [} 922].

See also
2 Channels Tool (Axioscan Specific) [} 1151]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 915


9 Reference | 9.3 Tools ZEISS

9.3.8.1 Channels List

Note the following points for the channels list:

§ The selected channel is highlighted by a light gray bar.


§ The reference channel for the auto focus is highlighted by a blue font color and marked with
Ref..
§ The preview color (LUT) for the channel is shown on the right side of the list. To change the
preview color for the channel, click on the colored rectangle with the arrow icon and select
an alternative color from the shortcut menu. The preview color is also shown in the sections
for channel-specific hardware settings as a thin line on the left side of the list.

Info
If you select a dye or contrast technique in the Add Dye or Contrast Method dialog, a sug-
gestion for the hardware settings for the acquisition of this channel is made automatically. If
no suggestion can be made, a channel without hardware settings is added. You then see a
corresponding indication in the status area of the program interface.

List control elements

Parameter Description
Moves the selected channel one row down.
Down

Moves the selected channel one row up.


Up

If Widefield channels are added, this function opens the dialog to


add more widefield tracks, see Add Dye or Contrast Method Dialog
Add
[} 869].
If LSM or Airyscan channels are added, this function will add a new
LSM or Airyscan track.

Deletes the selected channel.

Delete

Focus Ref. Sets the selected channel as reference channel for focus actions or
stitching during acquisition.

Opens the options menu.


Options

– Add New... If Widefield channels are added, this function opens the dialog to
add more widefield tracks, see Add Dye or Contrast Method Dialog
[} 869].
If LSM or Airyscan channels are added, this function will add a new
LSM or Airyscan track.

– Duplicate Creates a new track with the same settings and dye as the currently
selected track.

– Rename Assigns a new name to the channel of the currently selected track. To
change the name of the track, you can directly click into the respec-
tive field of the channels list.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 916


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Reset Color Resets the color of the selected track(s) to default.

– Select All Selects all tracks of the list.

– Delete Deletes the selected track.

– Delete All Deletes all existing tracks.

– Set as Refer- Defines the selected channel as the reference channel for focusing ac-
ence Channel tions.
Note that, you can also set Channels of inactive Tracks as Reference
Channels. The Autofocus will in this case be performed on this chan-
nel, but the Channel or Track will not be part of the resulting image
document. Using this approach, e.g. Camera tracks may be used for
fast focusing within a Confocal experiment, while the acquisition of
Camera and Confocal into one image is not possible.
Note: Do not use a Lamdba or Online Fingerprinting track as refer-
ence track for SW Autofocus as the focus search will be extremely
slow.

– Compare... Opens the Compare channels dialog, where the active channels are
displayed horizontal so you can easily compare and adjust key param-
eters of the active tracks.

9.3.8.2 Light Source Section (WF)

Fig. 67: Light Source Section


In this section you can select the available light sources from the Selected Lightsource drop-
down list and adjust the corresponding settings. You can adjust the parameters of the light
sources without having to save these in the hardware settings. You can therefore adjust the inten-
sity of the laser lines or LEDs, for example, immediately before starting an acquisition.
If your system is equipped with a TIRF slider, the TIRF angle and type of illumination can also be
set here.
If you select the Use Setting entry, the settings for the light sources disappear. The light source
parameters from the hardware settings are used instead for the acquisition of the channel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 917


9 Reference | 9.3 Tools ZEISS

9.3.8.3 Lasers Section

Fig. 68: Lasers Section

Parameter Description
High Intensity Activated: Uses a high intensity laser range , where you can adjust
Laser Range the lasers between 0.2 and 100% of their power. This is especially rel-
evant for bleaching experiments.
The setting affects all tracks. While switching, the system is trying to
keep the intensities at a similar level. If the currently selected intensity
is outside of the overlapping range (0.2% to 3.5-5%) the closest pos-
sible value is used.
Note: This section is only available with LSM 900.
The LSM is working by default in a laser power range between 0.01%
and 3.5-5% of the available laser intensity. The available minimum
and maximum in the default range is depending on the laser.

Lasers Select the laser lines needed for sample illumination for the current
track.
Activate the required lasers by activating the corresponding checkbox.
The laser lines along with sliders will appear. Set the required attenua-
tion (%) using the sliders, the arrows, or typing a number into the in-
put field. In case the laser is not yet ready for operation (see also
Lasers Tool [} 1300]), the checkbox and text are displayed in red. For
tunable multiphoton lasers (not available for Celldiscoverer), an edit-
ing field is displayed. Write the desired wavelength into the editing
box to tune the laser to this wavelength. For multiple tracks the actual
tuning is immediately done for the first active track. For subsequent
tracks the tuning happens whenever the previous tracks are deacti-
vated or deleted or during the actual experiment. In case a tunable
and a fixed line are available, the tuning range has a gap which is de-
fined by the filter combining the tunable and fixed line to get both
beams onto the same optical path.

Relative Laser Displays the relative percentage of the laser light that is applied to the
Power (in Confocal sample, see Display of Relative Laser Power for Different Magnifi-
Mode) cations [} 919].

Pinhole Adjusts the diameter of the pinhole.


The diameter is specified in micrometer. The text below translates this
diameter to Airy Units and section thickness which is grasped by the
system for the configured detection range and excitation wavelength.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 918


9 Reference | 9.3 Tools ZEISS

Parameter Description
The Airy Unit size and, derived from this, the section thickness of the
optical slice is determined by the emission detection range. Diameter
Pinhole = 1.22 x (detection wavelength/numerical aperture). For the
calculation of the detection wavelength the center of the emission
range is taken. Laser lines set within the detection range reduce the
detection range (lower border determined by the laser line) and shift
the center point accordingly. Without any defined detection range
(i.e. no emission filter) the system takes the center of the potential de-
tection range defined by the hardware parameters of the detector.
Within one track the lowest detection range is taken for the calcula-
tion.
When increasing the pinhole diameter an information mark might ap-
pear. It signals when at the given optical parameters the resolution in
Z is no longer optimal. The tool tip showing with the information
mark informs about what is the best step size for Z stacks to not loose
resolution. For LSM confocal tracks using NLO lasers (not supported
for Celldiscoverer), the section thickness for excitation is calculated
based on a formula leaving out the settings of the pinhole, Hence no
Airy Unit value is displayed. These tracks should always be setup with
a completely open pinhole.
The control is not available for Airyscan and NDD tracks. For Airyscan
tracks the physical pinhole is automatically opened and set to the op-
timal diameter. NDD tracks do not have a pinhole.

- 1 AU Sets the pinhole diameter to a value that is corresponding to 1 Airy


unit for the configured detection wavelength, excitation wave-
length(s) and objective.
When you click this button once, it will change its color to blue. This
indicates that the system will always use a pinhole diameter corre-
sponding to 1 AU as you continue to change acquisition parameters
like excitation or emission wavelengths. Click the button again to de-
activate this permanently active state.

- Max Opens the pinhole to its maximum diameter. This can be useful to
find the focal plane and is the recommended setting when using a
multiphoton laser for excitation.

9.3.8.3.1 Display of Relative Laser Power for Different Magnifications

When using certain objective/ magnification changer combinations (e.g. the Celldiscoverer 7 con-
taining 4 objectives and 3 magnification changers), only a portion of the laser light is applied to
the sample due to the optical design of the system, see the table for applicable laser power be-
low. This information is displayed as Relative Laser Power (for LSM tracks) and Relative Laser
Power in Confocal Mode (for Airyscan MPLX tracks) in the Channels tool. The value is based on
the currently used hardware settings defined in the Right Tool Area and does not reflect the be-
fore/after settings in experiments and experiment blocks.

Relative Laser Power


To grant identical excitation in confocal and Airyscan HS mode after changing the magnification,
the laser power can be set with a slider in the Channels tool to the value used before, repre-
sented by the Relative Laser Power.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 919


9 Reference | 9.3 Tools ZEISS

Example: At 5x magnification the laser power was set to 1%. After changing to 20x/0.95 magni-
fication the laser power can be increased with the slider to set the relative laser power again to
1%.

Relative Laser Power in Confocal Mode for Airyscan MPLX


Due to parallel scanning of two lines in Airyscan MPLX mode, the laser power per pixel for all
magnifications is further decreased to 2/3 compared to confocal mode. This reduced excitation
power in MPLX mode is displayed as relative laser power in confocal mode.
For similar SNR as in confocal mode, we recommend to increase the laser power in MPLX mode
to the same value for the relative laser power in confocal mode.

Calculation
The laser power is calculated in the following way:

§ For confocal tracks: Relative laser power (%) = applicable laser power depending on objective/
magnification changer * adjusted laser power
§ For Airyscan MPLX tracks: Relative laser power in confocal mode (%) = relative laser power *
66%

Applicable Laser Power (relative)

5x/0,35 20x/0,7 20x/0,95 50x/1,2


0,5x 100% 49% 100% 92%

1x 100% 49% 64% 23%

2x 49% 12% 23% 6%

9.3.8.4 Channel Settings (Widefield)

The settings always relate to the channel you have selected in the Channels list. To show the set-
tings for all channels, click and select Select All in the Channels list.

Parameter Description
Dye Name In the input field after the selected dye you can enter an additional
name.

Camera Select the desired camera for the channel from the dropdown list.

Auto Exposure Activated: Automatically determines the camera's exposure time for
the selected channel. The value set manually is ignored.

Set Exposure Starts an exposure time measurement for the channel. After the mea-
surement the value is adopted as the exposure time setting.

Time Adjust the exposure time for the camera using the slider or spin box/
input field. Select the unit of time from the dropdown list at the right
of the spin box/input field.

Shift Only visible if the Show All mode is activated.


Here you can enter the range of the camera's dynamic range that is
utilized.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 920


9 Reference | 9.3 Tools ZEISS

Parameter Description
Shading Correction Activated: Uses the calculated shading correction for this channel. To
learn more about shading correction, see also Post Processing Sec-
tion [} 897].

- Define Automatically calculates the shading correction for the selected chan-
nel.
For ZEN Celldiscoverer, the shading reference is created and automati-
cally saved in the default collection of the shading management.

- Specific Performs channel-specific shading correction.

- Global Performs an objective specific shading correction. This is the default


method for shading correction.

EM Gain Only visible for EMCCD camera models. Sets the EM gain value.

Focus Offset Only visible if the Show All mode is activated.


Here you can enter the focus offset from the channel to the Z-position
of the reference channel or to the current position. The Lock icon
shows that this setting will be synchronized between all channels of
this track.

Pixel Shift Only visible if the Show All mode is activated.


Here you can define the pixel shift in X and Y.
The defined pixel shifts are applied to images collected with Snap,
contentious or in an experiment.

Display Setting Only visible if the Show All mode is activated.


Here you can select an existing predefined display setting to be auto-
matically applied to this channel after acquisition.
Please note, that this does not apply for Live acquisition. There always
the last used setting will be applied.

Z-Stack Mode Only visible if the Z-Stack checkbox is activated in the Experiment
Manager and the Show All mode is active.

- Full Z-Stack Acquires the Z-stack as defined in the Z-Stack tool.

- Single slice Acquires a single slice of the Z-stack only. Select the single slice in the
only input box under the list. If the Use center checkbox is activated, the
center focus plane is used for acquisition.

- Single slice, Acquires an image of a single slice of the Z-stack only. All other Z-
rest black slices of the stack are filled with black images. Select the single slice in
the input box under the list. If the Use center checkbox is activated,
the center focus plane is used for acquisition.

- Fill with single Acquires an image of a single slice of the Z-stack only and fills all
slice other Z-slices with this slice. Select the single slice in the input box un-
der the list. If the Use center checkbox is activated, the center focus
plane is used for acquisition.

Temperature Only visible for Lattice Lightsheet.


Displays the current camera temperature.

Live Denoising Only visible if you have a denoising model available in ZEN.
Activated: Uses a denoising model during a Continuous acquisition.
The model can be selected from the dropdown, see also Using De-
noising During Continuous Acquisition [} 62].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 921


9 Reference | 9.3 Tools ZEISS

9.3.8.5 Channel Settings (LSM)

The settings always relate to the channel you have selected in the Channels list. To show the set-
tings for all channels, in the Channels tool, click and select Select All.
If you are using FCS for LSM 980, see Channels Tool - Measurement Settings [} 1243] for specific
information.

Parameter Description
Master Gain Slider and editing box to control the voltage of the PMTs. Increasing
the gain of the PMT corresponds to a higher voltage of the detector.
The image becomes brighter and you may be able to reduce the laser
power. At higher voltage, the noise level in the image increases as the
dark noise of the detector becomes visible in the images predomi-
nantly as single bright pixels.
The optimum between gain and noise depends on your experimental
requirements and on your sample. The maximum available voltage de-
pends on the type of the detector and is 1200V for multialkali PMTs,
900V for GaAsP PMTs and 1000V for Airyscan. GaAsP PMTs and
Airyscan have a minimum voltage of 500V.

Digital Offset Only visible if the Show All mode is activated.


Digital Offset allows to change the background of an image. It is cali-
brated such that the minimum grey values are set to zero. In case im-
age information with zero as grey level value is not accepted increase
the offset until no zero value pixel is present in the image. You can
check this with the histogram function or the range indicator LUT.
This control element is not available for Airyscan SR tracks.

Digital Gain Only visible if the Show All mode is activated.


Digital Gain increases the amplification of the signal on the digital
level. It is set to a value of 1. This value corresponds to 3 times the
minimal possible value. This amplification provides a certain buffer for
a possible detector overload. When decreasing the Digital gain to its
minimum value of 0,3 an overload of the detector by increasing the
master gain (or laser power) is reached earlier.
Detectors will downregulate the voltage or shut down completely
when partially or completely overloaded. Increase the digital gain and
downregulate the master gain when very bright samples are imaged
to avoid detector overload.

Mode For specific GaAsP channels and one cooled Multialkaline PMT of the
LSM 980, the detectors can be run in photon counting mode. This op-
tional mode is activated by clicking the button Photon Counting.
In photon counting mode no Digital Offset and Digital Gain slider is
available. Master Gain is set to a calibrated value to have optimal set-
tings for photon counting. Offset must not be changed for this mode
either.
In photon counting mode an artificial maximum of detectable pho-
tons is set. For all GaAsP detectors and the side PMT (Ch2) this value
is defined by CRmax/digital gain (CRmax = maximal count rate) de-
fined by the software, which is 4 MHz for the BiG.2 and Ch2 and 2
MHz for Chs (32 channel GaAsP array). Higher count rates are re-
garded as saturation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 922


9 Reference | 9.3 Tools ZEISS

Parameter Description
Note that too much light on the detectors (higher count rates for
some ms) leads to detector shut down to avoid damage.
Note that images acquired in photon counting mode are displayed in
their original count rate per pixel and hence will appear fairly dark
compared to intensity mode images. Adjust the display to improve the
signal visibility.

Display Setting Only visible if the Show All mode is activated.


Here you can select an existing predefined display setting to be auto-
matically applied to this channel after acquisition.
Please note, that this does not apply for Live acquisition. There always
the last used setting will be applied.

Z-Stack Mode Only visible if the Z-Stack checkbox is activated in the Experiment
Manager and the Show All mode is active.

- Full Z-Stack Acquires the Z-stack as defined in the Z-Stack tool.

- Single slice Acquires a single slice of the Z-stack only. Select the single slice in the
only input box under the list. If the Use center checkbox is activated, the
center focus plane is used for acquisition.

- Single slice, Acquires an image of a single slice of the Z-stack only. All other Z-
rest black slices of the stack are filled with black images. Select the single slice in
the input box under the list. If the Use center checkbox is activated,
the center focus plane is used for acquisition.

- Fill with single Acquires an image of a single slice of the Z-stack only and fills all
slice other Z-slices with this slice. Select the single slice in the input box un-
der the list. If the Use center checkbox is activated, the center focus
plane is used for acquisition.

9.3.9 Cryo Temperature Tool

In this tool you can see the temperature status of the Linkam Cryo stage. When the stage is se-
lected in the MTB configuration and properly connected to the computer, the temperature is
logged beginning with the ZEN startup. This logging of data is asynchronous and runs as long as
ZEN is active.
Note that if the stage is physically disconnected from the computer, only the last received temper-
ature is logged. Only after a restart of ZEN the current temperature is again logged in a new log
file.

Parameter Description
Temperature Sta- Displays the current temperatures.
tus

– Bridge Temper- Displays the current bridge temperature.


ature

– Chamber Tem- Displays the current chamber temperature.


perature

– Dewar Temper- Displays the current dewar temperature.


ature

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 923


9 Reference | 9.3 Tools ZEISS

Parameter Description
Temperature Log-
ging

– Interval Only visible if Show All is activated.


Sets the interval for reading the temperature data between 5 to 60
seconds.

– Open record Opens the record for the logged temperatures. Current opens the
current log file in ZEN as a .czt file.
Folder opens the folder where the log file is saved on your computer
(C:\Users\user\Documents\Carl Zeiss\ZEN\Documents\TemperatureLog-
ging).

– Logging/ Start Shows that the temperature is logged. Click on Logging to stop log-
Logging ging the temperature. The button changes to Start Logging.
Click on Start Logging to continue the logging of thee temperature.

Image Tempera-
ture Data

– Export Tem- Opens the temperature data as a table in ZEN.


perature Data

9.3.10 Definite Focus Tool

Parameter Description
Status Displays the actual status of the device, e.g. Standby or Monitoring.

Find Surface Tries to find the surface of the cover glass and adjusts the focus posi-
tion accordingly.
If the signal is not strong enough, the actual focus position remains.

Store Focus Sets (and saves) the current focus position as the stabilizing position.
Note that if you change an objective, the saved position will be
deleted.

Recall Focus Restores the saved focus position.

Lock Focus If activated, Definite Focus holds the current focus distance by starting
a continuous focus stabilization. After activation, Lock Focus for Def-
inite Focus 3 will stay active during Live, Continuous, also after man-
ual refocusing, Snap (stops during acquisition and is switched on
again), 2x2/3x3 Snap, as well as experiments without focus strategy,
Z-Stack, Fast Acquisition (triggered), Mixed Mode (for Celldiscoverer
7), bleaching and channel offset. Lock Focus is switched off with
ZEN shut down, but can be switched on via the TFT display, if neces-
sary.

9.3.11 Dynamics Tool

The checkbox to activate the tool is only visible if Time Series acquisition is active and Tiles is not
activated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 924


9 Reference | 9.3 Tools ZEISS

Using the tool you can open the Mean ROI Setup where you can configure physiology functions
for a Time Series experiment. Deactivate the Dynamics checkbox to deactivate physiology func-
tions.
If you click on the Mean ROI Setup button the setup view will be visible in the Center Screen
Area. There you will see a snapshot containing all channels of the currently active image.

9.3.11.1 Mean ROI Setup

The Mean ROI Setup is in essence a modified version of the MeanROI view with several minor
additions. It allows experiment pre-settings to be made on Snap-shots of the cells/ specimen on
which the measurements will be made. These settings include:

§ image and chart layouts;


§ chart axis settings;
§ generation, placement and management of measurement and Background ROIs
§ measurement settings
A ratio preview image is also displayed that allows an assessment of the current ratio settings on
the Online Ratio tab. To update the images in the Mean ROI Setup a new Snap can be made at
any time.

See also
2 Mean ROI Tab [} 568]
2 Layout Tab [} 569]
2 Charts Tab [} 570]
2 Online Ratio Tab [} 572]
2 Mean ROI View [} 566]

9.3.12 Experiment Information Tool

Here you can find an overview of your experiment parameters, e.g. the memory requirement of
the experiment or its duration.

Parameter Description
Required Disk Space Indicates the calculated memory space that the experiment
will take up on your hard drive. All the activated blocks of
an experiment created using the Experiment Designer are
taken into account.

Duration (Theoretical) The system adds together all the exposure times arising
during acquisition in the experiment and indicates this
value. In the case of time series the intervals set are also
taken into account. The actual acquisition duration will al-
ways turn out longer, however, as switching times for com-
ponents (diaphragms, reflectors) and positioning times (Z-
plane, stage position) also come into play.

Maximum Acquisition Rate If the Time Series acquisition dimension is activated in the
Experiment Manager, you can measure the maximum
possible frame rate of the system in the Time Series tool.
In that case the frame rate is shown here. Otherwise "not

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 925


9 Reference | 9.3 Tools ZEISS

Parameter Description
available" is displayed. After any change is made to the ex-
periment the frame rate must be determined again in the
Time Series tool.

Elapsed Time (Last Experi- If you have already run the current experiment before on
ment) the system, the duration actually required for it is displayed
here. This information disappears again if you change the
experiment.

Next Time Point in Shows duration to next time point.

Tile Size Shows the X/Y dimensions of your experiment. In the case
of a single position this value is identical to the size of the
camera field.

9.3.13 Experiment Regions Tool

This tool allows to define Regions of Interest (ROIs) which are used for image acquisition, sample
manipulation (bleaching) and image analysis.
If you are using FCS for LSM 980, see the chapter Overview Acquisition Tools [} 1242] for FCS
specific options in the Experiment Regions tool.

Fig. 69: Experiment Regions Tool (Show All) - Enable Import deactivated and activated

Parameter Description
Enable Import Activate this option to show additional controls for the import of Re-
gions which were created by an Image Analysis workflow upfront.
This option is only available in Show all mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 926


9 Reference | 9.3 Tools ZEISS

Parameter Description
Import as shape: Select here, which type of Shape the imported. The shape of the cre-
Toolbar ated Experiment Region can either be a polygon, a simplified polygon
or a rectangle or ellipse with the approximate size of the bounding
box from the analysis region.
Alternatively you can define a custom rectangle or ellipse with specific
size and an offset relative to the center of the bounding box of the
analysis result.

Import regions as When you press this button, the currently selected regions from an
Image Analysis result will be imported into the list of Experiment Re-
gions. The properties, e.g. if the regions will be used for bleaching
and analysis, are defined by the neighboring checkboxes.

Color Select here the color which will be used to indicate the imported re-
gions in the image.

Toolbar Use the tools from the toolbar to draw ROIs into the image.

Edit Regions in To add a new Experiment Region to your experiment, you need to
Current Image click the Edit Regions in Current Image button first. The button will
turn to blue to indicate that Experiment Regions are displayed in the
image and can be added or manipulated. When the button is not en-
abled, all standard graphical elements are shown in the image, but
not Experiment Regions. Standard graphical elements are used for im-
age analysis and annotation, but will not have an impact on the next
image acquisition.
Experiment regions which are used e.g. for bleaching, are automati-
cally converted into standard graphical elements while the experiment
is performed.
It is not possible to edit Experiment Regions when the image is dis-
played in certain viewers. Switch back to the 2D view, in case the but-
ton is disabled.

Keep Tool Activated: Keeps the selected graphic tool for multiple actions.

Auto Color Activated: Assigns different colors for each drawn ROI.
Only available in Show all mode

ROIs List This list shows all drawn in ROIs .


Their Type (form and color), ID (number ) are listed as identifiers. For
each ROI certain properties can be chosen by activating the according
checkbox:

- Acquisition Activated: Acquires images only within the ROI(s).


Use this parameter in combination with Fit frame size to bounding
box of acquisition regions.

- Bleaching Activated: Performs a bleaching experiment will be within the se-


lected ROI(s).
The bleaching parameters are specified in the Timed Bleaching
Tool, see chapter Timed Bleaching Tool [} 989].

- Analysis Activated: Uses data for Mean of ROI analysis in the MeanROI view
from the corresponding ROI(s) .

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 927


9 Reference | 9.3 Tools ZEISS

Parameter Description
Save Saves the selected ROI(s) to the file system.

Load Loads ROI(s) from the file system.

Delete Deletes the selected ROI(s) from the ROIs list.

The following parameters are only visible in the Show All mode.

Dimensions

- X/Y Shows the X/Y position of a selected ROI.


Enter new values in the input fields.

- W/H Shows the Width (W) and Height (H) of the selected ROI.
Enter new values in the input fields.

- Angle Shows the rotation angle of the selected ROI.


Enter a new value in the input field.

- Position regions The experiment region is placed in relation to the current field of
relative to im- view. Use this option if the regions should maintain their position
age within the image in case the stage is moved.
When this option is deactivated, the regions are defined by their stage
coordinates. In this case, regions can be placed on certain structures
of your sample and the regions will stay there when the stage is
moved.
Note, that the system will not attempt to automatically move to these
positions e.g. during bleaching experiments, if they are not accessible
in the current scan area.

Fit frame size to Activated: Fits all ROIs that are marked as Acquisition ROIs in the ta-
bounding box of ble to the total frame that the scanner will cover.
acquisition regions
This can decrease imaging time, since the scanner has not to move
over the complete frame of the original image, in which the ROIs
were drawn.
While the frame size is reduced, the scan speed will maintain its value
as configured in the Acquisition Mode tool. In order to achieve maxi-
mum acquisition speed, you should use the Acquisition Mode Tool
to manually reduce the frame size and adjust the speed correspond-
ingly.

9.3.14 Focus Strategy Tool

Info
The software automatically selects the most appropriate focus strategy, e.g. Use Z Values/Fo-
cus Surface defined in Tiles Setup when you activate the tiles dimension and no focus strat-
egy has been previously selected.

Here you can select the focus strategy that you want to apply. The strategies that are available de-
pend on the dimensions selected (z-stack, time series, tiles), the hardware devices present (e.g.
Definite Focus) and software licenses. In general, focus strategies determine and/or update a Ref-
erence Z-Position, which in most cases is used directly for acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 928


9 Reference | 9.3 Tools ZEISS

Exceptions

§ When z-stacks are acquired, the center of the z-stack determines the Reference Z-Position.
§ Defined offsets for channels and z-stacks shift acquisition in relation to the Reference Z-Posi-
tion.
§ If two focusing methods are combined, the Reference Z-Position of the first method is used as
the starting point for the subsequent method.

Parameter Description
Focus Strategy
Wizard

– Optimize this Opens the Focus Strategy Wizard to optimize this focus strategy used
focus strategy for your tiles experiment.

Focus Strategy Depending on your system, experiment configuration and licensed


dropdown list modules, the following strategies are available:

– None This is the default setting for all experiments that do not include a
tiles dimension (in which case the software would automatically select
the Use Z Values/Focus Surface defined in Tiles Setup strategy).
The current z-position at the time the experiment is started is set as
the Reference z-Position and remains unchanged during the experi-
ment.
Exception:
By default, z-stacks are acquired at the fixed Reference Z-Position that
has been defined as the center in the Z-Stack tool. You can change
this setting in the Z-Stack Acquisition section of the Focus Strat-
egy tool.

– Absolute Only available if your licenses include the Tiles & Positions function-
Fixed Z Posi- ality.
tion A focus strategy that makes use of the z values defined for tiles and
positions when using a motorized stage.

– Software Aut- Only available if your licenses include the Software Autofocus func-
ofocus tionality.
Note that any focus surface/z-values defined in the tiles setup are ig-
nored if this strategy is selected.
The focus position is determined via the sharpness calculation or in-
tensity calculation of a series of images (z-stack) and set as the Refer-
ence Z-Position. The settings are configured in the Software Autofo-
cus tool.

– Definite Focus Only available if your microscope system has attached a Definite Fo-
cus device.
Note that any focus surface/z-values defined in the tiles setup are ig-
nored if this strategy is selected. Definite Focus attempts to maintain a
certain distance to the cover glass of the sample in order to compen-
sate for mechanical and thermal movements. The Definite Focus is ini-
tialized at the start of the experiment by setting the current distance
as the reference distance. You have to define this value at the start of
the experiment.
When the focus is stabilized during the experiment, the current dis-
tance is adjusted to the reference distance. This is achieved by moving
the focus drive accordingly. The new z-position resulting from this is
used as the Reference Z-Position for acquisition. The repetitions and

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 929


9 Reference | 9.3 Tools ZEISS

Parameter Description
frequency of these events is performed with predefined standard set-
tings. If you want to adjust these for a particular experiment, select
the Expert mode (only visible in Show all).
§ Definite Focus Recall: The initial z values are determined by re-
calling the previously stored focus (distance to cover glass surface).
§ Definite Focus Stabilize: Stabilizes the last valid reference z-posi-
tion (distance of the sample to the cover glass).
§ Definite Focus Find Surface: Finds the focus position on the sur-
face of the cover glass.

– Combine Soft- Only available for Tiles or Time Series experiments.


ware Autofo- This strategy allows you to combine the functions of Definite Focus
cus and Defi- and Software Autofocus. This can be done in two ways, see descrip-
nite Focus tions below.
Note that in both cases it is possible to modify the time point and fre-
quency at which these events occur. The repetitions and frequency of
these events is performed with predefined standard settings. If you
want to adjust these for a particular experiment, select the Expert
mode (only visible in Show all).

– Use Z Values/ Only available if your licenses include the Tiles & Positions function-
Focus Surface ality.
defined in This strategy is selected automatically when the Tiles dimension is ac-
Tiles Setup tivated and no previous strategy was selected. With the Tiles & Posi-
tons functionality, a focus surface can be defined in two ways: Local
(for tile regions and/or positions) or Global (based upon a carrier e.g.
petri dish, slide, plate).

– Reflex Autofo- Only available for Lattice Lightsheet.


cus Uses a focus strategy that is based on the cover glass reflection of the
light sheet.

Software Autofo- Only available if Combine Software Autofocus and Definite Focus
cus as Reference is selected.
for Definite Focus Software Autofocus moves the focus drive to the focus position that
has been calculated. Taking this as the starting point, a new reference
distance is defined for the next distance stabilization performed by
Definite Focus. This can reduce the likelihood of a stabilization failure
when the sample is long and elongated and the carrier possibly tilted.

Definite Focus as Only available if Combine Software Autofocus and Definite Focus
Start for Software is selected.
Autofocus Uses the last valid Reference Z-Position defined by Definite Focus as
the starting position for the Software Autofocus search. This allows
you to optimize the search range and step size of Software Autofo-
cus.

Definite Focus Sta- Only available if Combine Software Autofocus and Definite Focus
bilize as Start for is selected.
Software Autofo- Takes the last valid reference z-position defined by Definite Focus as
cus the starting center position for the Software Autofocus search.

Definite Focus Find Only available if Combine Software Autofocus and Definite Focus
Surface as Start is selected.
for Software Auto- Takes the calculated focus position on the surface of the cover glass
focus as the starting bottom position for the Software Autofocus search.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 930


9 Reference | 9.3 Tools ZEISS

Parameter Description
Initial Definition By default this is given by the Tile Setup (user defined values from
for Z Values/ Focus the Tiles tool) from the support points/positions/tile regions list.
Surface It is also possible to use the Software Autofocus function or the
Definite Focus. The Recall Focus function initially defines these value
prior to the start of the image acquisition. The resulting z-values can
overwrite the existing listed values in the support points/ positions list.

Z Values/Focus
Surface

– Local (per Re- For Tile Regions:


gion/Position) A local focus surface can be defined for a Tile region in two ways.
§ For large tile regions or samples in which the plane of interest ("fo-
cus") is described by a slope or parabolic you can define one or
more "support points" for each tile region. These can be arranged
in a regular or irregular manner. Each support point is assigned a
discrete z-value ("focus"). From these the software is able to inter-
polate a local focus surface with a chosen degree of complexity in
an attempt to describe the contour of the plane of interest for the
Tile region.
§ When no support points are used the z value assigned to the Tile
region defines the "focus" for all the tiles it contains. For small tile
regions on a suitable sample this might be sufficient.

For Positions:
For positions the local focus surface is defined by the discrete Z-value
assigned to it. A position cannot have support points.

– Global (Carrier A global focus surface is defined based on a selected carrier template.
based) To create a global focus surface you need to add support points by
creating or editing a carrier template from the appropriate section of
the Tiles tool. Thus, a group of support points are used to help de-
scribe the tilt or curvature of the carrier (again by a process of interpo-
lation). Tile regions or position "placed" upon this global focus surface
are mapped onto it accordingly.

Adapt Z Values/Fo- Activated: Adapts the focus surface/z-values by the following options
cus Surface (if available):

– Definite Fo- Here you select if you want to adapt the settings by using Definite Fo-
cus/Software cus or Software Autofocus (SWAF). Depending on this selection and
Autofocus the available dimensions of your experiment the following additional
functions can be selected from the second dropdown list:

– SWAF/As ad- The Reference Z-Position calculated from the Local Focus Surface is
ditional action used as the starting point for an additional software autofocus search
which updates the Reference Z-Position.
This allows you to reduce the search range and/or step size of the
Software Autofocus (faster).

– SWAF/Update This option is only available for Time Series experiments.


with single This option allows a focus surface (local or global) to be updated by
offset the activity of a software autofocus run. The focus surface is regularly
adjusted by means of a software autofocus search which is performed
exclusively at a single defined waiting position. A resulting correction
of the Reference Z-Position is adopted for all focus areas.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 931


9 Reference | 9.3 Tools ZEISS

Parameter Description
This strategy is only relevant if Tiles and Time Series experiments are
combined. Again the repetition and frequency of the software autofo-
cus stabilization can be modulated to meet the experiment needs.

– Definite Fo- The Reference Z-Position calculated from the Local Focus Surface is
cus/As addi- used as the starting point for a Definite Focus stabilization, which up-
tional action dates the Reference Z-Position (adjusts this to a single stabilization
offset, defined at the start of the experiment such that the distance
between the coverslip and objective will be the same).
This method only makes sense in the context of a very thin sample,
where the sample lies at a constant close distance to the interface.
For Definite Focus. This also reduces the likely-hood of a stabilization
failure.

– Definite Fo- This option is available for Time Series experiments only.
cus/Update This option allows a focus surface (local or global) to be updated by
with single the activity of a Definite Focus stabilization. The focus surface is regu-
offset larly adjusted by means of a definite focus stabilization, which is per-
formed exclusively at a single defined waiting position. A resulting
correction of the Reference Z-Position is adopted for all focus areas.
This strategy is only relevant if Tiles and Time Series experiments are
combined. Again the repetition and frequency of the definite focus
stabilization can be modulated to meet the experiment needs.

– Definite Fo- This option is only available for Definite Focus.2.


cus/Update This approach allows a focus surface (local or global) to be updated
with multiple by the activity of a Definite focus stabilization with multiple unique
offsets offsets. These unique stabilization offsets are determine immediately
before the start of the experiment so that the z-values of all the sup-
port points/positions/ tile regions are adapted individually respective
to their initial z-value.
This strategy can be applied to a tiles experiment with or without a
time series dimension. The repetition and frequency can only be ad-
justed for the time series loop.

– Reflex AF/As Only available for Lattice Lightsheet.


additional ac- The Reference Z-Position defined in Tiles Setup is used as the start-
tion ing point for an additional autofocus based on finding the cover glass
reflex which updates the Reference Z-Position.

– Reflex AF/Up- This option is only available for Time Series experiments for Lattice
date with sin- Lightsheet.
gle offset This option allows the Reference Z-Position defined in Tiles Setup
to be updated by the activity of an additional autofocus based on
finding the cover glass reflex. A resulting correction of the Reference
Z-Position is adopted for all focus areas.

Stabilization Event Only available for Definite Focus in combination with Tiles or Time
Repetitions and Series experiments.
Frequency

- Standard This mode uses default settings for stabilization which we recommend
to use if you are not familiar with the Definite Focus device.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 932


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Expert This mode allows advanced settings for using Definite Focus stabiliza-
tion.
Under Synchronized with Image Acquisition you can select how
Definite Focus is used:
§ Time Series: If activated, this setting repeats Definite Focus at cer-
tain predefined points within a image acquisition loop (e.g. every
second time point).
§ Tile Regions/Positions: If activated, this setting repeats Definite
Focus at certain Region/Positions (e.g. every second position).
Optionally, you can also select to run the stabilization for each tile
region at either the center (Center of Regions) or the first ac-
quired tile of the region (First Tile of Regions).
§ Tiles: If activated, this setting repeats Definite Focus at a certain
Tile (e.g. every second Tile).

Under During Time series interval you can enable Periodic Stabiliza-
tion.Periodic Stabilization is available for experiments that include
Time Series only. If it is activated, a stabilization with a defined Pe-
riod (e.g. every 10 s) is performed. This mode is useful if long intervals
are needed between image acquisition loops. This mode can be com-
bined with the stabilization events before discrete imaging loops.

Reference Channel Displays a table with the currently defined channels. The column Off-
and Offsets set sets an offset in µm. The button Set as Reference Channel sets
the currently selected channel as reference.

Autofocus Setup Only available for Lattice Lightsheet.


Allows you to define the search range of the Reflex Autofocus (with
extended range: min 10μm, max 100μm / without extended range
the sample will not be moved in z and only a single snapshot will be
used to find the cover glass reflex). Store Focus defines the focus po-
sition in z with respect to the upper cover glas surface. Recall Focus
sets the focus to the defined focus position. This is only active if Store
Focus was executed.

For more information on focus strategy, see Introduction [} 63].

9.3.14.1 Focus Strategy Wizard

This wizard guides you through the setup of a suitable focus strategy for your experiment. Cur-
rently this wizard is only available to help you optimize the focus strategy for a tiles or positions
experiment. Therefore, the license for the Tiles & Positions module is necessary for this wizard.

General Wizard Controls

Parameter Description
Next Moves on to the next step of the wizard.

Back Moves back to the previous step of the wizard.

Cancel Cancels the wizard. No changes are applied to your focus strategy
settings.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 933


9 Reference | 9.3 Tools ZEISS

Parameter Description
Finish Saves the setup and the changes based on your progress and closes
the wizard.

9.3.14.1.1 Preparation Step

This step serves as a preparation for the setup.

Parameter Description
Best Practice Displays a list of best practices to consider before continuing with the
Checklist setup.

Dimensions Displays the currently configured dimensions of your experiment. To


change the dimensions in your experiment you have to leave the wiz-
ard and change them on the Acquisition tab.

Reference Chan-
nels & Offsets

– Name Displays the name of the experiment channels.

– Offset (µm) Sets and displays the offset for each channel.
The reference channel is used by the software autofocus. If your de-
sired focus in the specimen should be offset to the result of the soft-
ware auto focus, enter the relative values (in µm) here. It can be de-
fined for each channel (fluorophore) in the image independently. Off-
sets can be used without the software autofocus to create a relative
difference in focus for any channel to the reference channel.
Offset values can be determined outside the wizard. This is a manual
process specific for your given sample and application. Values in the
Channels tool or Focus Strategy tool will appear here and can be
modified.

– Set as Refer- Sets the currently selected channel as reference channel.


ence Channel

Objective Only available if a Definite Focus is configured.


Shows the selected objective and if it is compatible with Definite Fo-
cus (if DF 2 is configured).

9.3.14.1.2 Determine Initial Focus Values Step

This step helps you to determine initial focus values for you experiment. You can use the Soft-
ware Autofocus [} 935], the Definite Focus [} 935], or you can do it manually in the Tiles tool.
When you create/ add a position or tile region, it is always assigned a z-value that corresponds to
the current focus position. You can manually adjust these values directly in the respective section
of the Tiles tool [} 359]. For more information, see also Adjusting Z-Values [} 341]. Alternatively,
you can click on the Verify button to open the Verify Tile Regions or Verify Positions Dialog
[} 371] which helps you adjust the values.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 934


9 Reference | 9.3 Tools ZEISS

9.3.14.1.2.1 Determine Initial Focus Values (Software Autofocus)

If you select to apply the Software Autofocus (SWAF), ZEN uses the SWAF to determine the z-val-
ues for positions, tile regions or their support points. Make sure that your sample is suitable for
use of the SWAF which uses the settings of the reference channel.
Every experiment in ZEN blue has SWAF settings. They can be seen and modified in the Software
Autofocus Tool [} 333]. The default settings are usually a good starting point, but should be opti-
mized according to the sample. You can find a detailed description of the parameters in the help
chapter for the tool. The adjustments will help reduce the time it takes to run the search but still
reliably determine the focus.

See also
2 Determine Initial Focus Values Step [} 934]

9.3.14.1.2.2 Determine Initial Focus Values (Definite Focus)

If you select to apply Definite Focus.2 (DF.2), ZEN uses the DF.2 device on your Axio Observer to
determine the z-values for positions, tile regions or their support points. Make sure that the se-
lected objective and your sample are suitable for use of the Definite Focus.2.
In the first step of this wizard, ZEN indicates if the selected objective can be used. You should test
your sample with DF.2 beforehand, but typically the following guidelines can be given:

§ Sample with coverslip glass or glass bottom (suitable)


§ Objective type = air/dry lens and sample fixed (suitable)
§ Objective type = oil immersion and sample fixed (not suitable)
§ Objective type = oil immersion and sample aqueous media i.e. cells in culture (suitable)
§ Objective type = water immersion and sample fixed or aqueous (suitable)
Definite Focus uses a difference of the refractive index to detect the position of the objective rela-
tive to the sample/ cover slip surface. This position can be stored and recalled quickly with high
resolution (accuracy) and reproducibility (precision). You can also define an offset to this position
by focusing into the sample as required and clicking on Store focus in the Definite Focus Tool
[} 924] (right tool area).
Definite Focus.2 can be used to setup the z-values of your positions, tile regions or their support
points. It is considerably faster than using a Software Autofocus. Keep in mind that this approach
will adjust the all z-values according to the local topology of the sample surface relative to the ob-
jective. Thus, your sample should be in focus if it follows this topology.

See also
2 Determine Initial Focus Values Step [} 934]

9.3.14.1.3 Sample Size and Distribution Step

This step determines which focus surface is needed for the experiment based on the sample size
and distribution. For general information, see Focus Surfaces in ZEN [} 936]. The first two op-
tions require a local focus surface, which can be employed with or without a sample carrier. If
your sample corresponds to the third option, a global focus surface is necessary, which can only
be used and modified with a sample carrier template.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 935


9 Reference | 9.3 Tools ZEISS

Parameter Description
Sample Carrier Selects a sample carrier and displays the name of the currently se-
lected one.

– Select Opens the Select Template Dialog [} 386] to select a sample carrier.

– Opens the sample carrier selection/editor dialog. Here you can edit
and add global support points to the selected sample carrier.
Edit Support
Points

– Deletes the selected sample carrier from the sample carrier field. The
template will still be available in the Select Template dialog.
Delete

Move Focus to Only visible if a sample carrier is selected.


Load Position Be- Activated: The focus drive moves to the load position while moving
tween Container to another container of the sample carrier (e.g. a well or a slide). This
can prevent possible damage/collisions with obstructions that occur
between different areas of the sample carriers underside.

9.3.14.1.3.1 Focus Surfaces in ZEN

Depending on the nature of your sample, its size, and its location on the sample holder, ZEN pro-
vides two options that employ a so called focus surface to help keep your sample in focus. A fo-
cus surface is basically a topographical map of a certain part of the sample. Like the contour lines
on a map, this tells the microscope for any XY coordinate on it how the objective should be set in
Z in order to make sure the image of the sample is sharp.
In principle, ZEN uses the same method regardless of the size of the sample. A focus surface can
simply be a single z-value assigned to your position or small tile region. For larger more complex
objects it is more sophisticated. For example, large tile regions created to image an entire tissue
section might have several hundred images that make it up. It is not plausible to have a single z-
value that defines the focus, neither is it efficient to define the z-value at each of these several
hundred images. In this case the focus surface is defined by a limited number of z-values at dis-
crete locations. The z-values of these “support points” are used to create a topographical map –
the focus surface - by interpolation. It covers the entire region you want to image and defines the
focus of a single image acquired on it. In this way huge areas can be imaged where every frame is
focused correctly.
ZEN defines two types of focus surface:

§ Local: Use this mode to image groups of positions, small tile regions or mixtures of both at
high and lower magnifications. It is also used to image large tiles or a number of large tiles
i.e. tissues sections or embryos. This is the standard setting for most imaging applications.
§ Global: Use this mode to image samples that are widely spread across your sample carrier.
The global focus surface is assigned to and defined on your sample carrier template. In this
manner it is typically used at lower magnifications when a very precise local z-value is not
needed to create a sharp image. In some cases this allows it to be used for more than one
sample carrier after another if they are mounted in a regular and consistent manner.

See also
2 Sample Size and Distribution Step [} 935]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 936


9 Reference | 9.3 Tools ZEISS

9.3.14.1.4 Adapting Focus Values Step

This step is only available if at least a DF.2 or SWAF is configured. You are asked if you want/need
to adapt the focus during your experiment. If you have both Definite Focus and Software Autofo-
cus configured, you are also asked if the focus is static relative to the sample carrier. Depending
on your configuration and selection, the adaptation of focus values via Definite Focus or Software
Autofocus is displayed in the next step of the wizard.

9.3.14.1.4.1 Adapting Focus Values in ZEN

Adaption of the focus values in your experiment might not always be necessary. Typically, if you
have followed the suggestions laid out at the beginning of the Focus Strategy wizard for best
practice and your experiment does not involve creating time lapse images of the specimen or long
extended periods of imaging (i.e. the sample is fixed or no longer living), you might not need to
adapt the focus at all during the imaging process. The z-values or focus surface values you define
will probably be stable enough that the images of the specimen will remain sharp.
However, in many cases, especially when living samples are involved, it is necessary to adapt your
z-values. Depending on the configuration of the system two approaches are available to adapt
your z-values:

§ Software Autofocus: This is a technique that adapts the focus based on taking a series of
images at planes above and below the current z-value. The system evaluates these images
based on contrast or intensity and then determines where the highest value lies. This plane
becomes the new z-value and in most cases it is the plane we are interested in or can be used
as reference for it. Z-stacks are centered relative to this value. This allows an adaptation of z-
values when the sample moves (e.g. growth, migration), but also if the sample and sample
carrier drift together. By its very nature this approach might need optimization to get better,
more reliable, and/ or faster results.
§ Definite Focus.2: This is a function to quickly determine the distance between your objec-
tives front lens and the sample. Using DF.2, only the drift of the sample and sample carrier to-
gether can be adapted. This can be done to restore or maintain this distance anywhere and at
any time. If necessary you can adjust this distance depending on the location in the sample
and how far into it the focus is required. Adaptation of the focus with Definite Focus.2 is very
quick and highly repeatable. As it is based on the physical principles of light refraction, it re-
quires certain characteristics of the sample and objective. ZEN informs you if the objective is
not suitable and adjusts the selection in the Focus Strategy wizard accordingly.
See also the chapter Determine Initial Focus Values (Definite Focus) [} 935] which gives
some basic guidance on the types of sample that can be used with the different objective
types.

See also
2 Adapting Focus Values Step [} 937]

9.3.14.1.5 Adapting Focus Values with Software Autofocus Step

This step guides you through the adaptation of focus values with the Software Autofocus. The op-
tions displayed here depend on whether the experiment is a time series or not, and also on the
type of sample which you have selected in the Sample Size and Distribution Step [} 935].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 937


9 Reference | 9.3 Tools ZEISS

9.3.14.1.6 Adapting Focus Values with Definite Focus Step

This step guides you through the adaptation of focus values with the Definite Focus. The options
displayed here depend on whether the experiment is a time series or not, and also on the type of
sample which you have selected in the Sample Size and Distribution Step [} 935].

9.3.14.1.7 Manually and Interactively Setting Focus Values Step

This wizard step provides you with detailed information on how to set focus values manually. The
displayed information depends on the sample characteristics you have selected in the Sample Size
and Distribution Step [} 935].

9.3.15 Focus Tool

CAUTION
Risk of Crushing Fingers
The drive of a microscope stage with a motorized vertical axis (focus drive) is strong enough to
crush fingers or objects between the stage and the microscope stand.
4 Remove your fingers or any objects from the danger area before moving the focus drive.
4 Release the joystick immediately to stop the movement.

This tool changes the vertical distance (i.e. Z direction) between stage and objective. This enables
you to focus the sample, or, for a sample with an uneven surface, to focus the area of interest.
1 2

1 Higher objective position, higher sample features in focus

2 Lower objective position, lower sample features in focus

Parameter Description
Current Displays the stage position in µm
Initially, when you use the Focus tool for the first time after switching
on the microscope, the exact position of the stage is not known.
Therefore, the position indicated by Current is initially set to zero. If
you enter a value, the stage moves by the entered amount relative to
the current position. If you want to move the focus to an absolute po-
sition, you must first click Home to move the focus to one of the end
positions. The value of Current is set to this known position. You can
then enter an absolute position.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 938


9 Reference | 9.3 Tools ZEISS

Parameter Description
Position control Enables you to set the stage position. You can either use the Naviga-
tion Bar to move the stage up or down or you can enter the target
position in the Current input field.

– Navigation Bar Enables you to move the stage freely in Z direction


To move the stage, drag the Navigation Bar button in the desired di-
rection. If released, the Navigation Bar button snaps back to the
center and the stage stops.
The Navigation Bar allows four speeds.

Normal modes:
§ Inner segments: Slow
§ Outer segments: Medium

High-speed modes:
§ Inner segments: Fast
§ Outer segments: Very Fast

To enter the high-speed mode, right-click the Navigation Bar but-


ton. The Navigation Bar turns red. To return to normal speed, right-
click the Navigation Bar again.

– Current Defines the target position of the stage in µm. The stage starts mov-
ing immediately after the coordinates have been entered and con-
firmed by pressing the Enter key or by clicking anywhere outside the
Current input field.

– Stop Stops any stage movement immediately.

Backlash Correc- Activated: Enhances the positional accuracy by performing an extra


tion movement. When activated the focusing takes slightly longer

Handwheel on § Activated: Turning the handwheel also adjusts the focus


§ Deactivated: The handwheel is deactivated: turning it does not af-
fect the focus

Step Size Defines the difference in µm by which the stage moves at each step.
Indirectly this defines the speed of the stage movement.
The Step Size also determines the accuracy of the focus position.

Home Moves the focus to one of the end positions. The value of Current is
set to this known position.
This ensures that the position shown as Current corresponds to the
actual stage position.

Work Moves the stage back to the position it was in before using the Load
button (i.e. the work position)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 939


9 Reference | 9.3 Tools ZEISS

Parameter Description
If you have moved the stage (e.g. using the Navigation Bar) after
moving it into the load position, the work position is lost and the
Work button will not work.

Load Increases the distance between objective and stage by 8,000 µm


This aids you in exchanging the sample. After exchanging the sample,
you can move the stage back into its work position by using the
Work button.
Make sure not to move the stage (e.g. using the Navigation Bar) af-
ter moving it into the load position. Otherwise, the previous position
is lost and the Work button will not work.

Measure This function allows to measure distance in Z direction.

Z-Position Specifies which position of the motorized z drive is used as the origin
(zero value)

– Set Zero Sets the current focus position as the origin (zero value)

– Calibrate Performs an automatic calibration

9.3.16 Image Analysis Tool

Note that this tool is available only when you have licensed functionality for Image Analysis or
3D Image Analysis.

Parameter Description
Setting Selects the image analysis setting.

Opens the options menu.


Options

– New Creates a new analysis setting. Enter a name for the setting.

– New from Creates a new setting based on an existing setting. The template set-
Template ting will not be modified.

– Create new Reads out czias settings from a previously analyzed image and creates
from analyzed a new setting from that.
image

– Rename Enables you to enter a new name for the setting.

– Save Saves a modified setting under the current name. An asterisk indicates
the modified state.

– Save As Saves the current setting under a new name.

– Import Opens a file browser to import an existing setting.

– Delete Deletes the current setting.

Method Displays the defined segmentation method for the currently selected
Setting.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 940


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Opens the Segmentation Method dialog.
Edit

Edit Image Analy- Opens the Image Analysis Wizard to define a new analysis program or
sis Setting to change an existing program, see Image Analysis Wizard [} 941].

Start Interactive Runs the selected analysis setting with all the interactive steps.
Analysis Note that steps which you have not marked as interactive in the Im-
age Analysis Wizard are run with the values set in the analysis set-
ting. The program does not stop to allow you to adapt them interac-
tively.

Start Analysis Runs the selected analysis setting without interruption.

See also
2 Image Analysis [} 402]
2 Creating a New Image Analysis Setting [} 403]
2 3D Image Analysis [} 525]
2 Creating a 3D Image Analysis Setting [} 525]

9.3.16.1 Segmentation Method Dialog

Parameter Description
Method Selects the method that is used for segmentation.

- Segment Region For each defined region class the specified image channel is seg-
Classes Indepen- mented using the class segmenter which can be defined in step
dently Automatic Segmentation of the image analysis wizard.

- ZOI (Zones of In- Constructs a zone of influence (ZOIs) and a ring around each pri-
fluence) mary object.

- 3D Segmentation Only available if you have licensed the 3D Image Analysis func-
tionality.
Uses a segmenter optimized for 3D analysis. For each defined re-
gion class the specified image channel is segmented using the
class segmenter which can be defined in step Automatic Seg-
mentation of the image analysis wizard.

OK Saves the segmentation method selection for the current setting


and closes the dialog.

Cancel Closes the dialog without saving.

9.3.17 Image Analysis Wizard

This wizard guides you through the setup of an image analysis. It is only available if you have li-
censed functionality for Image Analysis or 3D Image Analysis. Note that some of the parame-
ters differ depending on whether you set up a 2D or a 3D analysis.
The following basic controls enable you to move through the steps:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 941


9 Reference | 9.3 Tools ZEISS

Parameter Description
Next Moves on to the next step of the wizard.

Back Moves back to the previous step of the wizard.

Cancel Cancels the wizard. No changes are applied to your settings.

Finish Saves the setup and the changes based on your progress and closes
the wizard.

9.3.17.1 Classes

In this step you can define the classes into which the measured objects in the image are divided.

Parameter Description
Interactive Activated: The class definition can be changed interactively while the
analysis setting is run with Start Interactive Analysis.

Classes List Displays the defined classes. If you create a new analysis setting, a
predefined set of classes is created automatically. The classes list dif-
fers if you have a 3D analysis setting.
For a 2D analysis, each class consists of two entries. The first entry
concerns the entirety of all objects belonging to the class. The second
entry represents the individual objects.
For a 3D analysis, each class consists only of one entry.

Add Class Adds a new individual class to the list on the base level.

Add Subclass Adds a new subclass to the selected class.

Remove Class Deletes the selected class from the list.

Name Defines the name for the selected class in the list.
Note that you must not use the name Root for one of your classes as
this a reserved keyword.

Channel Selects the channel that is used for image segmentation of the se-
lected class in the Classes list.

Color Selects the color to mark the objects of a class.

Object Color Only visible if you have selected a class entry for individual object.

– Random The objects found by the analysis will be colorized randomly.

– Fixed Selects the fixed color to mark the objects of a class.

9.3.17.2 Frame

In this step you can define one or more measurement frames. Only the area within the measure-
ment frames gets analyzed. You can also define how the analysis treats objects that are cut by the
border of the image or the frame.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 942


9 Reference | 9.3 Tools ZEISS

Parameter Description
Interactive Activated: The measurement frame definition can be changed inter-
actively while the analysis setting is run with Start Interactive Analy-
sis.

Enables you to select already created measurement frames. To select


a measurement frame, click inside it. To select several measurement
Select Frame
frames, press the Ctrl key and click inside the desired measurement
frames. Once you have selected a measurement frame, you can
change its size.

Enables you to create a rectangle as a measurement frame in the cur-


rent image.
Draw Rectangle

Enables you to create a circle as a measurement frame in the current


image.
Draw Circle

Enables you to create a contour as a measurement frame in the cur-


rent image.
Draw Contour
(Polygon)

Removes all drawn-in measurement frames in the current image. To


delete single frames, select them and press Del.
Remove All Frames

Maximize Circle Only available for 2D settings and only active if you have defined pre-
cisely one circle.
Activated: Maximizes the drawn-in circle to the full image size. In the
case of rectangular images the circle is adjusted to the shorter side.

Center Circle Only available for 2D settings and only active if you have defined pre-
cisely one circle.
Activated: Centers the drawn-in circle to the full images size.

Mode Selects how the measurement frame should be applied. Note that this
behavior is only applied when running the analysis (interactively) and
not during the setup. The setup always uses the Cut at Frame mode.
The following modes are available:

- Inside Only Measures only those objects, that are lying completely within the
measurement frame. Objects that are touching the frame or are inter-
sected by the frame are not analyzed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 943


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Cut at Frame Measures all objects that are lying within the measurement frame.
Objects that are intersected by the measurement frame are measured
precisely up to the measurement frame.

The following fields are only active if you have selected a drawn-in graphic element:

Left Sets the starting point for the frame on the X axis in pixels.

Top Sets the starting point for the frame on the Y axis in pixels.

Width Sets the width of the frame in pixels.

Height Sets the height of the frame in pixels.

Color Selects the color of the frame.

Show Frame On Activated: Displays the frame on the image after the analysis has run.
Analyzed Image

9.3.17.3 Automatic Segmentation

In this step you can select the segmentation method that is applied and set parameters for the
segmentation of the objects that you want to measure. Note that during the setup of the analysis
(via Edit Image Analysis Setting), the segmentation is only performed on the area visible in the
viewport. If you enter the analysis wizard via Start Interactive Analysis, the image will be fully
segmented.

Parameter Description
Execute Activated: Sets the defined threshold values when the measurement
program is run.

Interactive Activated: The segmentation can be changed interactively while the


analysis setting is run with Start Interactive Analysis.

Classes Selects the class for which you want to define the segmentation.

Ring Element Class This additional parameter is only available if you have selected the
Zone of Influence (ZOI) method.

- Ring Distance Distance from surface of the primary object. Negative values mean
that the ring starts at the defined distance within the primary object.

- Ring Thick- Defines the thickness of the ring.


ness

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 944


9 Reference | 9.3 Tools ZEISS

Parameter Description
ZOI Class This additional parameter is only available if you have selected the
Zone of Influence (ZOI) method.

- ZOI Width Allows you to set the distance of border of the ZOI from the border of
the ring, or the main object, respectively.

Apply Executes the selected segmentation method after a parameter


change.
Time consuming segmentation methods like Intellesis Trainable
Class Segmenter are not run again automatically when a parameter
is changed.

Select Opens the selection of segmenters, see Segmentation Method Selec-


tion Dialog [} 953].

Info
3D Parameters
If you are setting up a 3D analysis, the available parameters are either grouped under 2D Pa-
rameters for general (2D optimized) parameters, or under 3D Parameters, if the parameters
are specifically optimized for 3D operations.

The visible parameters depend on the selected segmentation method. The following parameters
sections can be available:

§ Smoothing Section [} 945]


§ Sharpen Section [} 946]
§ Threshold & Histogram Section [} 947]
§ Variance Section [} 950]
§ Model Section [} 950]
§ Subtract BG Section [} 951]
§ Object Size & Hole Section [} 951]
§ Binary Section [} 951]
§ Separate Section [} 952]
§ Suppress Section [} 952]
§ 3D Preview Section [} 953]

9.3.17.3.1 Smoothing Section

Parameter Description
Smoothing Selects how to smooth the image before the threshold values are set.
The following methods are available:

- None The image is not smoothed.

- Lowpass Applies the Lowpass method. The lowpass filter compares the bright-
ness of each pixel to the brightness of its neighboring pixels. If a pixel
is brighter than its neighbors, the brightness of this pixel is reduced

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 945


9 Reference | 9.3 Tools ZEISS

Parameter Description
and the brightness of the neighboring pixels is increased. This sup-
presses sharp changes in brightness (i.e. contours) and leads to more
gradual changes in brightness.

- Gauss Applies the Gauss method. Each pixel is replaced by a weighted aver-
age of its neighbors. The weighting depends on the sigma value. The
Gaussian filter is particularly useful for contour enhancement, which is
very sensitive to noise. Using a Gaussian filter before finding contours
greatly improves the results.

- Median Applies the Median method. Each pixel is replaced by the median of
its neighbors. The number of neighboring pixels taken into account
depends on the size. In a set of values (in this case the pixel values
taken into account), the median is the value for which the number of
larger values is equal to the number of smaller values.

Size Only visible, if you have selected Low Pass or Median.


Sets the size of the filter matrix in the X and Y direction, i.e. the num-
ber of neighboring pixels taken into account. The size should corre-
spond to the pixel size of the contours to be reduced.

Sigma Only visible, if you have selected Gauss.


Sets the sigma value that defines how much neighboring pixels con-
tribute to the weighting. Larger values broaden the applied Gaussian
distribution and lead to reduced noise but also to an increased loss of
image information.

9.3.17.3.2 Sharpen Section

Parameter Description
Sharpen Select how to improve the sharpness by enhancing contrast at fine
structures and edges of the image before the threshold values are set.
The following methods are available:

- None No sharpening algorithm is applied.

- Delineate Applies the Delineate method. It emphasizes edges around structures


in an image, which is useful for images where the gray value range of
structures differs clearly from the gray value range of the pixels
around them.

- Unsharp Applies the Unsharp Masking method.


Masking

Threshold Only visible, if you have selected Delineate.


Sets the threshold value for edge detection. The threshold value
should correspond roughly to the gray value difference between ob-
jects and the background.

Size Only visible, if you have selected Delineate.


Sets the size of the edge detection filter, i.e. the size of image details
which are enhanced. The smaller the Size value is, the finer are the
details affected by the tool. The value should correspond to the size
of the transition area between objects and the background.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 946


9 Reference | 9.3 Tools ZEISS

Parameter Description
Strength Only visible, if you have selected Unsharp Masking.
Sets the strength of the Unsharp Masking. The higher the value se-
lected, the greater the extent to which small structures are enhanced.

9.3.17.3.3 Threshold & Histogram Section

Here you can define the threshold values for the selected class in the class list.

Parameter Description
Threshold Sets the brightness boundaries between which pixels are considered.

– Reset Clears the upper and lower thresholds. No pixels are considered.

– Undo Undoes the last change made to the threshold values.

– Redo Restores the last undone change to the threshold values.

Color Model Only visible if the image is a color image, see Color Model [} 949].

- RGB In RGB mode you can define the threshold values for the red, green
and blue color channels.

- HLS In HLS mode you can define the threshold values for hue, saturation
and lightness.

– Low Sets the lower threshold. Only pixel values above this value are con-
sidered. The range of possible values depends on the bit depth of the
image.

– High Sets the upper threshold. Only pixel values below this value are con-
sidered. The range of possible values depends on the bit depth of the
image.

– Invert Only pixels outside the threshold boundaries are considered, i.e. those
pixels below the lower threshold and above the higher threshold.

– Full Range Sets the lower threshold to 0 and the upper threshold to the highest
value (depending on bit depth). The entire range of pixel values is
considered.

Histogram In the histogram you can change the lower and upper threshold value
for the activated value. Drag the lower or upper adjustment handle or
shift the entire highlighted area between the lower and upper thresh-
old value.

Click Click in the image on the regions that you want to define as objects.
The threshold values are adapted according to the pixel intensities at
the clicked position in the image.

Automatic The threshold values are determined automatically from the his-
togram. During setup only the part of the image displayed in the
viewport is taken for the calculation of the threshold. After the auto-
matic calculation of the threshold values you can further modify the
threshold values found interactively by selecting Click for threshold
value definition.

Pick Behavior Only visible, if you have selected Click.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 947


9 Reference | 9.3 Tools ZEISS

Parameter Description
- + Enables you to expand the currently segmented regions by the gray
values/colors of the objects subsequently clicked on.

- - Enables you to reduce the currently segmented regions by the gray


values/colors of the objects subsequently clicked on.

Tolerance Only visible, if you have selected Click.


Specifies how many additional pixel values are included in the selec-
tion based on their brightness. A higher value means that more pixel
values similar to the selected one are included. A lower value means
that only the exact pixel value selected is included.

Neighborhood Only visible, if you have selected Click.


Specifies how many additional pixel values are included in the selec-
tion based on their physical proximity to the selected pixel. A higher
value means that more pixels surrounding the selected pixel are in-
cluded. The threshold boundaries are adapted so that all the pixel val-
ues of these neighboring pixels are included. A lower value means
that the boundaries are adapted based on only the pixels directly next
to the selected pixel.

Method Only visible, if you have selected Automatic.


Selects the algorithm that is used to automatically detect the thresh-
old boundaries. The most suitable algorithm depends on your precise
requirements. The value also depends on the bit depth of the image.
The following methods are available:

- Otsu The pixel values below the threshold are designated as background
and those above the threshold as foreground. It iterates through all
possible threshold values and calculates the variance of the pixel in-
tensities of the background and foreground pixels for each value. The
threshold is set at the value that minimizes both variances. This
method is particularly suited to light objects on a dark background.

- Maximum Separates background and foreground pixels at the maximum value


Peak of the histogram.

 

- Iso-Data The pixel values below the threshold are designated as background
and those above the threshold as foreground. An initial threshold
value is chosen, and the mean pixel intensity of the foreground and
background pixels is calculated. These two mean values are averaged
and the result serves as the input threshold for the next calculation.
The process is repeated until the threshold value no longer changes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 948


9 Reference | 9.3 Tools ZEISS

Parameter Description

 

- Triangle The algorithm constructs a line between the peak of the highest fre-
Threshold quency pixel intensity and the lowest pixel intensity. The distance be-
tween the line and the histogram is computed for all values along the
line. The pixel intensity where the line is longest is used as the thresh-
old. This method is particularly suited when the foreground pixels only
have a weak peak in the histogram.

 

- Three Sigma Calculates the pixel value that occurs most frequently. The standard
Threshold deviation of the values in the peak is calculated. The threshold is set
to the pixel intensity that is the sum of the average peak value and
three times the standard deviation.

9.3.17.3.3.1 Color Model

RGB
Here you can set the RGB channel threshold values.

Parameter Description
Activates the red channel in the Expander Histogram.
Red

Activates the green channel in the Expander Histogram.


Green

Activates the blue channel in the Expander Histogram.


Blue

HLS
Here you can set the hue, lightness and saturation threshold values.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 949


9 Reference | 9.3 Tools ZEISS

Parameter Description
Activates the hue in the Expander Histogram.
Hue

Activates the lightness in the Expander Histogram.


Lightness

Activates the saturation in the Expander Histogram.


Saturation

9.3.17.3.4 Variance Section

This section is only visible if Variance-Based Thresholding is selected.

Parameter Description
Kernel Size Sets the kernel size used to calculate the variance value of one pixel
with its neighboring pixels.

Variance Defines the lower and upper threshold for the variance.

9.3.17.3.5 Model Section

This section is only visible if Intellesis Trainable Class Segmenter or AI Instance Segmenta-
tion is selected.

Parameter Description
Model Name Displays the name of the currently selected model.

– Select Model Opens the dialog to select a segmentation model. Note that you can
only use models trained on a single channel.

Model Version Only visible if AI Instance Segmentation is selected.


Displays the currently selected model version.

Model Class Displays the name of the currently used model class.

– Reset Resets/Deletes the selected model.

Min. Confidence Sets the minimum value (in %) for the confidence that a certain pixel
belongs to the segmented class. The default value is 51.

9.3.17.3.5.1 Select Model Dialog

Parameter Description
Model Name Selects a model.
Only models trained on one channel images are shown here because
only those can be used to segment a specific class assigned to a spe-
cific channel.

Model Class Selects the model class.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 950


9 Reference | 9.3 Tools ZEISS

Parameter Description
Model Version Only visible for AI Instance Segmentation.
Selects the version of the model.

OK Selects the respective model.

Cancel Cancels the model selection and closes the dialog.

9.3.17.3.6 Subtract BG Section

Parameter Description
Subtract BG Only visible if Segmentation with Background Subtraction is se-
lected.
Selects which kind of background subtraction is performed.

- None No background subtraction is performed.

- Rolling ball The rolling ball background subtraction is performed.

9.3.17.3.7 Object Size & Hole Section

Parameter Description
Min. Object Size Sets the minimum size in pixels that an object must have in order to
be segmented.

Min. Hole Size Sets the minimum size in pixels that a hole must have in order to be
recognized for segmentation. This input is synchronized with the in-
put for Min. Object Size, which must not be smaller than Min. Hole
Size.

Fill all Holes Specifies how holes in detected objects are treated.
1 2

– On Fills holes in segmented objects ( 1 ).

– Off Does not fill the holes in segmented objects ( 2 ).

9.3.17.3.8 Binary Section

Parameter Description
Binary Selects which morphological operations are performed on the seg-
mented (binary) image.

- None No operation is performed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 951


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Open Performs first erosion and then dilation. The effect is smoothing and
removing of isolated pixels.

- Close Performs first dilation and then erosion. The effect is smoothing of
the objects and filling of small holes.

- Dilate Enlarges the boundaries of segmented regions. Areas grow in size and
holes within the regions become smaller.

- Erode Erodes boundaries of the segmented regions. The areas shrink in size
and holes within the areas become larger.

Count Sets how often the selected binary operation is performed with the
slider or input field.

9.3.17.3.9 Separate Section

Parameter Description
Separate Selects whether you want to process the image further after segmen-
tation. Objects that are touching one another can be separated using
different methods.

- None Objects are not separated.

- Morphology Separates objects by first reducing and then enlarging them, making
sure that once objects have been separated they do not merge to-
gether again.

- Watersheds Separates objects that are roughly the same shape. The result is two
shapes separated by a thin 1-pixel boundary. The rest of the shape
perimeter remains unchanged. This method may however result in the
splitting of elongated objects.

Count Sets the count value, which is similar to a Sigma for Gauss applied to
a binary image.

9.3.17.3.10 Suppress Section

Parameter Description
Suppress Invalid Activated: Discards invalid pixels at the border of the image.

Suppress Border Only visible if Variance-Based Thresholding is selected.


Activated: Suppresses the border pixels which might be incorrect, as
areas outside of the image are filled with zeros. The excluded area de-
pends on the used kernel size.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 952


9 Reference | 9.3 Tools ZEISS

9.3.17.3.11 3D Preview Section

Only visible if you set up a 3D analysis setting. With this section you can manipulate the preview
in 3D.

Parameter Description
Z-Position Selects the z-position around which the preview is shown.

Thickness Sets the preview thickness around the Z-Position.

9.3.17.3.12 Segmentation Method Selection Dialog

Parameter Description
Source Selects the segmentation source. Depending on the selected seg-
mentation source, the functionalities in the Image Analysis
Wizard change accordingly.

- From Image Chan- Uses the channel of the multi-channel image defined in the
nel Classes step for segmentation of the selected region class.

- Remaining to Takes the pixels within the measurement frame that are not as-
Frame signed to any other class. The resulting regions are not displayed
to improve performance, but the results are contained in the ta-
ble and chart.

- Take from Parent Takes the regions that fulfill a certain condition, defined in the
Regions Region Filter step, from the parent regions.
Note: This does not work for intensity features as region filter.
This option is used to distribute objects from one class into sev-
eral subclasses with the use of region filters. A parent class can
be segmented with any method and refined via region filters. Re-
gion filters in the subclasses define the criteria of objects to in-
clude in this subclass. Each object belongs to the first subclass of
the source where it fulfills all requirements. A subclass without
region filters takes all objects from the parent class. Objects that
are not contained in any of the subclasses are excluded from the
analysis.

Method Selects the segmentation method to be applied.

- Segment by Global A global threshold is applied to the image channel for image seg-
Thresholding mentation.

- Segmentation with A background subtraction is performed prior to a threshold-


Background Sub- based image segmentation.
traction

- Variance-Based Image segmentation via variance-based thresholding. Detects ob-


Thresholding jects where there is a strong change in pixel intensities indepen-
dent of the absolute intensity.

- Dynamic Thresh- Dynamic thresholding or adaptive thresholding calculates a local


olding threshold for small regions of the image. This is especially helpful
for inhomogeneous illumination or background structures.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 953


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Intellesis Trainable Uses machine-learning algorithms to segment the selected class
Class Segmenter by applying a trained Intellesis model or an imported neural net-
work (e.g. trained on arivis Cloud).

- AI Instance Seg- Uses an AI model for instance segmentation. You need the
mentation Docker Desktop software running on your PC and have a suitable
model available, see also Downloading AI Models [} 71].

See also
2 Automatic Segmentation [} 944]

9.3.17.4 Region Filter

Info
Settings based on image view
Note that during the setup of the analysis (via Edit Image Analysis Setting), the segmenta-
tion is only performed on the area visible in the viewport. Therefore, if you adapt the region fil-
ter by clicking on the objects displayed in the viewport, and select objects that are cut by the
current viewport, these objects will only be segmented partially. The region filter will only be
adapted based on the part of the object that is in the viewport. In case you want to select ob-
jects that exceed the viewport, we suggest to adapt the region filter values manually.
If you enter the analysis wizard via Start Interactive Analysis, the image will be fully seg-
mented during the segmentation step, and therefore it is possible to adapt the region filters by
clicking on the objects in the image.

In this step you can define the region filter conditions under which you want an object to be mea-
sured.

Parameter Description
Execute Activated: Uses the region filters when the measurement program is
run.

Interactive Activated: The region filters can be changed while the analysis set-
ting is run with Start Interactive Analysis.

Classes Selects the class for which you want to define the conditions.

Select Features Opens the editor to select region filters.

Copy to All Copies the defined region filters to all classes.

Region Filters If you have defined one or more blocks with region filters in the Re-
gion Filter Editor, you can select the block for which you want to
set the filter.
Select the relevant block and set the maximum/minimum values either
by clicking on the objects in the image you want to include in the
measurement, or by entering the maximum/minimum values sepa-
rately.

Undo Undoes the last change made to the condition.

Redo Restores the last undone change to the condition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 954


9 Reference | 9.3 Tools ZEISS

Parameter Description
Reset Resets all settings for the conditions.

See also
2 Region Filter Editor [} 955]

9.3.17.4.1 Region Filter Editor

All features in the list of selected features are calculated during image analysis. The results are dis-
played in the results table for all detected objects of the same class. The columns of the features
are sorted according to the order they appear in the Selected Features list.
The results of the settings you set here are displayed in the last step of the wizard in the table
with results on the right side.
For a detailed description of the individual features, see Measurement Features [} 440].

Parameter Description
Selected Features Displays the features that you have selected block by block. All fea-
tures in a block are And-linked, i.e. an object is only measured if the
values of each individual feature fall within the defined range.

Add Block Adds an Or block. If several Or blocks are defined, an object is mea-
sured if it meets the condition in at least one block.

Clear Block Deletes all features in an Or block.

Remove Block Deletes the selected Or block.

Remove All Deletes all Or blocks.

Available Features Displays the list with all available features. Double-click on the feature
or to add the feature to the list of selected features on the left.

Search Field Searches for features by name.

Filter Dropdown Filters the list of displayed features.

- All Lists all available features.

- Geometric Lists only the subset of geometric features.


Features

- Intensity Fea- Lists only the subset of intensity features.


tures

- Image Fea- Lists only the subset of image features.


tures

- Position Fea- Lists only the subset of position features.


tures

- Geometric Lists only the subset of unscaled geometric features.


Features Un-
scaled

Adds the selected feature to the list of selected features on the left.
Add

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 955


9 Reference | 9.3 Tools ZEISS

9.3.17.5 Interactive Segmentation

In this step you can post-process the segmented objects interactively. You can modify the results
of the automated segmentation to analyze your image data. Note that this step is not available
for 3D Image Analysis. Also note that during the setup of the analysis (via Edit Image Analysis
Setting), the segmentation is only performed on the area visible in the viewport. If you enter the
analysis wizard via Start Interactive Analysis, the image will be fully segmented.

Parameter Description
Interactive Activated: The segmented objects can be post-processed interac-
tively while the analysis setting is run with Start Interactive Analy-
sis.

Classes Selects the class whose objects you want to process.

Edit Region section


With the tools below you can modify the objects of the currently selected class.

Parameter Description
Draw Enables you to draw new objects of the selected class.

Erase Enables you to erase parts of an object. While pressing the left mouse
button, outline the parts of the object that you want to erase. Right-
click to erase these parts of the object.

Cut Enables you to separate connected objects. While pressing the left
mouse button, draw in the separation line between the objects.
Right-click to cut the objects.

Merge Enables you to connect objects. While pressing the left mouse button,
outline the parts of the object that you want to merge. Right-click to
merge the objects.

Fill Fills a hole. To fill a hole, left-click on the hole.

Remove Enables you to remove a drawn in object by clicking on it.

Deletes all drawn objects.


Remove All

Enables you to add a rectangular object or cut a rectangular region


from an object.
Rectangle

Enables you to add a circular object or cut a circular region from an


object.
Circle

Enables you to add an object or cut a region from an object.


Contour

Enables you to add an object or cut a region from an object.


Contour (Spline)

Enables you to add an object or cut a region from an object.


Active Contour

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 956


9 Reference | 9.3 Tools ZEISS

Parameter Description
Enables you to add a line-object.
Polyline Region

Enables you to add a point object.


Point

Region Growing section


Only visible for images with a size smaller than 10000 x 10000 pixel.

Parameter Description
Mode

- Click on areas in the image you want to add to the selected object
class.

- Click on areas in the image you want to remove from the selected ob-
ject class.

Intensity Sets the tolerance value for the intensity. The tolerance value specifies
how much the intensity of a pixel may deviate from the average inten-
sity of the object in order to still "grow" to become part of the object.

Color Only active if your input image is a color image.


Sets the tolerance value for the color. The tolerance value specifies
how much the color value of a pixel may deviate from the average
color value of the object in order to still "grow" to become part of the
object.

Fill Fills holes that are created during region growing.

Post Processing section


Only visible for images with a size smaller than 10000 x 10000 pixel.

Parameter Description
Region Filter Reapplies the region filter you defined in the previous step to the
post-processed image.

Parameter Description
Undo Undoes the last action.

Redo Restores the last undone action.

9.3.17.6 Features

In this step you select the measurement features.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 957


9 Reference | 9.3 Tools ZEISS

Info
Analysis Setting for Experiment Feedback
Features you have defined are available from within the Feedback Experiment. Any time you
change the image analysis settings, you need to reload the *.czias file in the feedback script
editor to activate the changes. The image analysis settings are typically saved in the Program-
Data folder on your hard drive, e.g. C:\ProgramData\Carl Zeiss\ZEN\Users\XXXX\Docu-
ments\Image Analysis Settings.

Parameter Description
Interactive Activated: The features can be changed interactively while the analy-
sis setting is run with Start Interactive Analysis.

Classes Selects the class for which you want to define measurement features.
For a 2D analysis setting, the tree view has two entries for each class
for which you can define features. The first entry ("Classes") concerns
the collection of the objects belonging to the class. The second entry
("Class") represents all individual objects belonging to the class. The
typical features of "Classes" are statistical values of the measurement
feature over all single objects of that class. For example, Mean Inten-
sity channel 1 gives you the mean intensity of all single objects. Area
gives you the sum of all areas (i.e. the total area) of the individual ob-
jects.
Fo a 3D analysis, each class has only one entry in the tree view for
which you can define features for individual regions of the class and
features for all regions of the respective class.

Features of Indi- Displays the selected features for the currently selected class and al-
vidual Regions/ lows you to select additional features. Depending on the class selec-
Features of All Re- tion, you can select and see the features for individual regions or all
gions regions.

- Select Opens the dialog for feature selection.

- Copy to All Copies the defined features to all other classes.

- Feature Displays the feature name(s) added for the currently selected class.

- Display If you activate Display in the feature selection dialog for a feature,
the result of the measurement is displayed next to the corresponding
object in the analyzed image.

Annotations Only visible for 2D analysis settings and if in the tree view a "Class"-
node (i.e. the node concerning the individual regions) is selected.
Displays the selected annotations for the currently selected class and
allows you to select features which will be shown as annotations in
the analyzed image. An example is the center of each region.

- Select Opens the dialog for feature selection.

- Copy to All Copies the annotations to all other classes.

Annotation Op- Only visible for 2D analysis settings.


tions

- Color Activated: Allows you to select the color for the region annotations.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 958


9 Reference | 9.3 Tools ZEISS

Parameter Description
Custom Feature Opens the editor to define a custom feature, see Creating Custom
Features [} 427].

Feature list Displays a list of all created custom features.

See also
2 Workflow Experiment Feedback [} 290]

9.3.17.6.1 Select Features of Individual Regions Dialog

For a description of individual measurement features, see Measurement Features [} 440].

Parameter Description
Selected Features Displays all selected features that are calculated for the object during
image analysis.

- Name Displays the name of the respective feature.

- Display Activated: The value of the feature for each object is displayed in the
analyzed image.

- Copy Only visible for Classes (collection of objects) and if more than one
class exists.
Selects where the feature is copied to. If the Copy column is empty,
the selected feature is not copied to any result table. For a description
of the possible copy operations, see Copy Operations for Features
[} 433].

- Deletes the currently selected feature from the list.


Delete

- Moves the currently selected feature one position up in the list.


Move Up

- Moves the currently selected feature one position down in the list.
Move Down

Available Features Displays the list with all available features. Double-click on the feature
to add the feature to the list of selected features on the left.

Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 959


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features are listed.
Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed are listed.
tures Unscaled

- Polygon-based All polygon-based features are listed.


Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

Adds the selected feature to the list of selected features on the left.
Add

9.3.17.6.2 Select Features of All Regions Dialog

For a description of individual measurement features, see Measurement Features [} 440].

Parameter Description
Selected Features Displays all selected features that are calculated for the object during
image analysis.

- Name Displays the name of the respective feature.

- Display Activated: The value of the feature for each object is displayed in the
analyzed image.

- Copy Only visible for Classes (collection of objects) and if more than one
class exists.
Selects where the feature is copied to. If the Copy column is empty,
the selected feature is not copied to any result table. For a description
of the possible copy operations, see Copy Operations for Features
[} 433].

- Deletes the currently selected feature from the list.


Delete

- Moves the currently selected feature one position up in the list.


Move Up

- Moves the currently selected feature one position down in the list.
Move Down

Available Features Displays the list with all available features. Double-click on the feature
to add the feature to the list of selected features on the left.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 960


9 Reference | 9.3 Tools ZEISS

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features are listed.
Features Un-
scaled

- Position Fea- All features that describe unscaled position features are listed.
tures Unscaled

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

Adds the selected feature to the list of selected features on the left.
Add

9.3.17.6.3 Annotations Dialog

Parameter Description
Selected Features Displays all selected features that are calculated for the object during
image analysis.

- Name Displays the name of the respective feature.

- Display Activated: The value of the feature for each object is displayed in the
analyzed image.

- Copy Only visible for Classes (collection of objects) and if more than one
class exists.
Selects where the feature is copied to. If the Copy column is empty,
the selected feature is not copied to any result table. For a description
of the possible copy operations, see Copy Operations for Features
[} 433].

- Deletes the currently selected feature from the list.


Delete

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 961


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Moves the currently selected feature one position up in the list.
Move Up

- Moves the currently selected feature one position down in the list.
Move Down

Available Features Displays the list with all available features. Double-click on the feature
to add the feature to the list of selected features on the left.

Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

9.3.17.6.4 Custom Feature Editor

Parameter Description
Custom Features Displays a list of the created custom features.

– Name Displays the name of the created custom feature.

– Adds a new custom feature that can be defined with the options on
the right side.
Add

– Deletes the currently selected feature.


Delete

Define Custom
Feature

– Name Defines the name of the feature.

– Unit Specifies the unit of the feature as free text input. This input is op-
tional.

Define Operands Displays and defines the operands used for the calculation of the cus-
tom feature.

– Operand Displays the name of the operand.

– Class Selects the class that is used for the definition of the operand. For a
single region class, also the classes of the children can be selected.

– Feature Displays all available predefined measurement features for the se-
lected class and selects which measurement feature should be used
for the definition of the current operand. If you activate the checkbox
behind the selection dropdown, the selected feature is also set visible
in the result table.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 962


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Expression Displays the expression of the Operand(s) defined by the Class and
Feature selection.

– Adds a new operand to the list.


Add

– Deletes the currently selected operand.


Delete

Define Custom Ex- Defines the mathematical calculation of the feature, using the Oper-
pression ands and mathematical operators, e.g. 100*(a/b+Math.Pow(c,2)).

– + Adds the mathematical operator for summation to the calculation.

– - Adds the mathematical operator for subtraction to the calculation.

– * Adds the mathematical operator for multiplication to the calculation.

– / Adds the mathematical operator for division to the calculation.

– Pow Adds the mathematical operator to calculate the power of a certain


base value. Note that this operator requires two input values (the
base and power value) separated by a comma, e.g. Math.Pow (2,3),
which corresponds to 23.

– Sqrt Adds the mathematical operator to calculate the square root of a


value.

– Abs Adds the mathematical operator to return the absolute number, i.e.
non negative values.

Verify Expression Checks the syntax of the Expression.

OK Adds the defined custom features and closes the dialog.

Cancel Closes the dialog without saving the changes.

See also
2 Creating Custom Features [} 427]
2 Examples for Custom Features [} 438]

9.3.17.7 Statistics

In this step you can define custom statistical features for your regions or objects. Note that this
step is not available for 3D Image Analysis. When an image analysis using custom statistical fea-
tures is successfully performed, the resulting values are available in the heatmap graph when the
base-node of the classes tree is selected and if well plate or sample carrier information is present.

Parameter Description
Interactive Activated: The custom feature definition can be changed interac-
tively while the analysis setting is run with Start Interactive Analy-
sis.

Classes List Selects the class for which you want to define the custom statistical
feature(s).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 963


9 Reference | 9.3 Tools ZEISS

Parameter Description
Define Custom Opens the editor to define a custom statistic feature, see Creating
Feature Custom Statistical Features [} 428].

Custom Statistic Displays the created custom statistic features.


Feature List

– Name Displays the name of the custom statistic feature.

9.3.17.7.1 Custom Statistic Feature Editor

Parameter Description
Custom Features Displays a list of the created custom statistical features.

– Name Displays the name of the created custom statistical feature.

– Adds a new custom feature that can be defined with the options on
the right side.
Add

– Deletes the currently selected feature.


Delete

Define Custom
Feature

– Name Defines the name of the feature.

– Unit Specifies the unit of the feature as free text input. This input is op-
tional.

Define Operands Displays and defines the operands used for the calculation of the cus-
tom statistical feature.

– Operand Displays the name of the operand.

– Class Selects the class that is used for the definition of the operand.

– Feature Displays all available measurement features for the selected class and
selects which measurement feature (if any) should be used for the
definition of the current operand. If you activate the checkbox behind
the selection dropdown, the selected feature is also set visible in the
result table.

– Statistical Op- Selects the statistical operation used for the current operand, e.g.
eration MEAN, MIN, MAX, SUM and COUNT.

– Expression Displays the expression of the Operand defined by Statistical Oper-


ation and the Class (and class feature) selection.

– Adds a new operand to the list.


Add

– Deletes the currently selected operand.


Delete

Define Custom Ex- Defines the mathematical calculation of the feature, using the Oper-
pression ands and mathematical operators, e.g. 100*(a/b+Math.Pow(c,2)).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 964


9 Reference | 9.3 Tools ZEISS

Parameter Description
– + Adds the mathematical operator for summation to the calculation.

– - Adds the mathematical operator for subtraction to the calculation.

– * Adds the mathematical operator for multiplication to the calculation.

– / Adds the mathematical operator for division to the calculation.

– Pow Adds the mathematical operator to calculate the power of a certain


base value. Note that this operator requires two input values (the
base and power value) separated by a comma, e.g. Math.Pow(2,3),
which corresponds to 23.

– Sqrt Adds the mathematical operator to calculate the square root of a


value.

– Abs Adds the mathematical operator to return the absolute number, i.e.
non negative values.

Verify Expression Checks the syntax of the Expression.

OK Adds the defined custom features and closes the dialog.

Cancel Closes the dialog without saving the changes.

See also
2 Creating Custom Statistical Features [} 428]
2 Examples for Custom Statistical Features [} 439]

9.3.17.8 Results Preview

In this step you see a preview of the measurement result. The results table contains only the mea-
surements performed in the current view port. These results may differ from the actual results
when the complete image analysis is performed. This increases the performance during the setup.
The results in the table depend on the settings you made in the Feature step. The table contains
all selected features for the highlighted class/classes. Click on a row of the table to highlight the
corresponding object in the image or vice versa.
The measured image is displayed in the Analysis View [} 429].

Parameter Description
Classes Here you can select the class for which you want to see the measured
features.
For a 2D analysis setting, there are two entries for each class: The
"parent" class, which shows the features for all objects together, and
the "child" class, which shows the features for each individual object.
For a 3D analysis setting, there is only one entry per class.

Highlight Box

- Color Allows you to set the color of the highlight box surrounding the se-
lected object in the image.

- Line Width Allows you to set the line width of the highlight box around the se-
lected object in the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 965


9 Reference | 9.3 Tools ZEISS

Parameter Description
Enable Chart Only visible for 2D image analysis settings.
Activated: Displays a chart with measurement results in the Analysis
View by default.
Deactivated: Displays no chart in the Analysis View by default.

Chart Type Only visible for 2D image analysis settings.


Sets the default chart type that will be displayed in the Analysis
View. With the two buttons, you can either select the Scatter Chart
or the Histogram Chart as default.

X-Axis Only visible for 2D image analysis settings.


Selects the default feature that is displayed on the x-axis of the chart
in the Analysis View.
The elements displayed in the drop down menu depend on the previ-
ously defined measurement features.

Y-Axis Only visible for 2D image analysis settings and only available for the
scatter chart.
Selects the default feature that is displayed on the y-axis of the chart
in the Analysis View.
The elements displayed in the drop down menu depend on the previ-
ously defined measurement features.

Multiple Scenes Only visible for 2D image analysis settings and only available for multi-
scene images.
Activated: Sets as the default chart a histogram/ scatter chart that
contains the data points of all scenes.

Time Series Only visible for 2D image analysis settings and only available for time
series images.
Activated: Sets as the default a chart that displays the analysis results
of the selected class in a time series chart.

Heatmap Only visible for 2D image analysis settings and only available for ex-
periments with multi well/ multi chamber plates (multiple scenes).
Activated: Sets as the default chart a heatmap of the well plate.

Back Moves back to the previous step of the wizard.

Finish Saves the created analysis setting and ends the wizard.

Cancel Cancels the analysis setting and closes the wizard.

9.3.18 Images and Documents Tool

Parameter Description
List of opened im- Here you find a list of all images and documents which are currently
ages and docu- opened in the Center Screen Area. The disk symbol with a small
ments
warning sign means that you changed and/or have not saved the
chosen image or document.

Saves the chosen file. Save as dialog will open if you have not saved
the file yet.
Save

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 966


9 Reference | 9.3 Tools ZEISS

Parameter Description
Automatically exports the active image with the default settings of
Quick Export the Image Export processing function.
Time series or z-stacks images are automatically exported with the de-
fault settings of the Movie Export processing function.

Closes the active image or document.


Close

Shows only the text of the file .


Text View

Shows a small preview image (thumbnail) of the file.


Thumbnail View

Shows a preview image of the file.


Big Preview

9.3.19 Imaging Setup Tool

Only visible, if the Enable Imaging Setup checkbox in the Tools > Options > Acquisition >
Acquisition Tab is activated.
View and adjust the hardware parameters used for confocal (LSM) or camera (WF) experiments.
All hardware parameters set to detect one or more specific signals simultaneously are defined as
one track. Specific tracks can be combined for image acquisition which is then called a multitrack
acquisition.

Info
Note that the Microscope Control tool on the Locate tab has a similar appearance and simi-
lar control elements but its function differs from the Imaging Setup tool described here.

If there is no track configured, you need to add a first track to the experiment by clicking on the
drop down button. To see a list of the availalbe acquisition modes, click on the arrow on the right
side of the button.

Fig. 70: Imaging Setup without tracks


If tracks are available each track will show as a button with the respective name (Track1, Track2,
etc.) on the top of the tool. The active track is highlighted in blue color and the type of acquisition
track is indicated below the button. Some tracks can be combined for image acquisition and run
as a multitrack acquisition. All active tracks for acquisition are either blue (current active track and
settings displayed below) or dark grey with white writing. Inactive tracks not used for acquisition
are dark grey with grey writing. Tracks which cannot be combined for image acquisition with the
current active track(s) are two-dimensional grey with grey writing. Switch between the tracks by
clicking on the corresponding track button. Use the Delete button to delete tracks and ac-
cess further options for editing via the Options button (Add, Delete, Duplicate, Rename).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 967


9 Reference | 9.3 Tools ZEISS

Fig. 71: Imaging Setup with tracks


Depending on what kind of track you have selected the Imaging Setup tool has a different ap-
pearance. For a detailed description of the specific parameters read the chapters Imaging Setup
(WF) [} 968] and/or Imaging Setup (LSM 980) [} 1221].
Tracks of different kind are not always compatible with each other. It is e.g. not possible to com-
bine camera and LSM acquisition into one single image. The Imaging Setup and Channels tool will
automatically disable incompatible tracks upon creation of new tracks. To re-enable incompatible
tracks, you need to deactivate first the active tracks. Once all incompatible tracks are disabled, the
remaining tracks can be activated again.

9.3.19.1 Imaging Setup (WF)

By selecting a WF track you can see the graphical display of the acquisition light path with various
icons. The arrangement of the icons represents the typical set-up of the microscope components
configured on your system. For a description of the most common icons, read Reflected/Transmit-
ted Light Path.
The associated hardware settings are shown above the icons and can be changed here. To
change the relevant hardware settings, left-click on the icons. In the shortcut menus you will see
numerous selection and setting options for adjusting your settings.

Info
Any change you make is automatically adopted and written to the corresponding hardware
setting of the experiment. If you want to undo these changes, do not save the experiment. In-
stead, reload the experiment in the Experiment Manager.

If you change the hardware settings in this section, please bear the following points in mind:

§ If the checkbox Include in this setting is activated the component is activated. Activated
components are included into the hardware settings of the experiment and subsequently ap-
plied in the experiment. Activated components are highlighted in blue color.
§ Components with a deactivated checkbox are not adopted into the hardware settings of the
experiment and are not subsequently applied in the experiment. These components are dis-
played with a grayed-out icon.
§ Components with a filled-in checkbox and a triangle underneath are only partially adopted
into the hardware settings of the experiment and subsequently applied in the experiment. To
show the sub-components, click on the triangle under the checkbox. To adopt the sub-com-
ponents into the hardware settings of the experiment and subsequently apply them in the ex-
periment, activate the relevant checkboxes for the sub-components.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 968


9 Reference | 9.3 Tools ZEISS

9.3.19.2 Advanced Imaging Setup

Only visible, if the Enable Advanced Imaging Setup checkbox in the Tools menu | Options |
Acquisition | Acquisition Tab | Enable Imaging Setup is activated.
There is a switch on top of the tool. By clicking on the button you can switch from the Standard
to the Advanced Imaging Setup.

Fig. 72: Advanced Imaging Setup


The Advanced Imaging Setup offers additional options for controlling an experiment. The Before/
After Experiment settings can be found right under the Standard/Advanced button.
Additionally the Experiment Settings Pool can be found at the bottom of the tool. We recom-
mend that you talk to ZEISS Service staff or Imaging Specialists before you try to change settings
here, as they should be changed only if you know what you are doing.

Before/After Experiment settings

Parameter Description
Before/After Experi- Shows the name of the hardware setting that will be applied im-
ment mediately before or after the experiment.

Options Opens the Options menu for the specific hardware setting.

Go! Applies the selected hardware settings.

Previous/Next The buttons allow you to navigate through the various hardware
settings.

Experiment Settings Pool

Parameter Description
Clear all unused hard- By clicking on the Clear button you can delete all unused hard-
ware settings from ex- ware settings from your experiment.
periment

All available hardware Here you can see all available hardware settings.
settings in experiment

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 969


9 Reference | 9.3 Tools ZEISS

9.3.19.3 Imaging Setup (Lattice Lightsheet)

For the Lattice Lightsheet, the following specific settings can be made in the Imaging Setup tool:

Parameter Description
Transmitted Light Opens the selection of transmitted light source (white or red LED).

Visible Light Opens the selection for the laser source.

SBS Opens the selection of the secondary beam splitter.

BP Opens the selection of emission filters (available for camera 1 and


camera 2).

Incubation Opens the access to incubation control.

9.3.20 Incubation Tool

Define and control parameters for temperature, atmosphere and the Y-Module. The available pa-
rameters depend on which components you have configured on your system.

Info
The symbols behind measured values indicate if the measured and the set values are
4 the same = green check mark,
4 different = red or blue triangle with exclamation point, or
4 not activated = blue circle with question mark.

Parameter Description
Temperature Here you can control up to 4 independent heating channels that are
linked to certain devices (e.g. incubator XL, heating insert P, objective
heater etc.). The devices are assigned to different channels in the Mi-
cro Tool Box (MTB).

- Heating/ Cool- Activated: Uses the channel for the experiment.


ing Under Setpoint you can set the temperature of the channel in °C.
Under Measured you see the currently measured value.

- Channel (1-4) Activated: Uses the channel for the experiment.


Under Setpoint you can set the temperature of the channel in °C.
Under Measured you see the currently measured value.

- Lid/Tray/Base Only available for Lattice Lightsheet.


Activated: Uses the channel for the experiment to heat the lid, tray
and base.
Under Setpoint you can set the temperature of the channel in °C.
Under Measured you see the currently measured value.

- Sensor Only available if the sensor is attached to the incubation controller.


Displays the current temperature inside the incubation chamber.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 970


9 Reference | 9.3 Tools ZEISS

Parameter Description
Atmosphere Here you can define the O2 and CO2 concentration, as well as the
temperature for an Air Heater module. Note that the meaning of the
symbols behind the measurement values is the same like described
above.

- O2 Activated: The O2 channel is used for the experiment.


Under Setpoint you can set the O2 concentration of the chamber in
percent (1-100%).
Under Measured you see the currently measured value.

- CO2 Activated: The CO2 channel is used for the experiment.


Under Setpoint you can set the CO2 concentration of the chamber in
percent (1-100%).
Under Measured you see the currently measured value.
§ Fan Speed:
Sets the rotation speed of the fan.

- Hum Only available for Lattice Lightsheet.


Under Setpoint you can set the humidity in %.
Under Measured you see the currently measured value.

- Air Heater Activated: The air heater will be used for the experiment.
Under Setpoint you can set the temperature of the air heater in °C.
Under Measured you see the currently measured value.
§ Fan Speed:
Sets the rotation speed of the fan.

- Pump Level Sets the pump level.


Note: If O2 Channel or CO2 Channel is activated and the Pump
Level is set to 0, a warning is displayed to remind you to set the
pump level >0 so that the gas is actually pumped to the probe.

Y-Module The Y-Module panel allows setting the temperature for two indepen-
dent modules (thermostats).

- Selected Here you can select which module you want to control (Module 1 or
Module 2).

- Circulator 1-2 Activated: The channel will be used for the experiment.
Under Setpoint you can set the temperature of the channel in °C.
Under Measured you see the currently measured value.
For each module two circulator channels can be activated.

9.3.21 Input Tool

Parameter Description
Input Image Input image with file name and path to the target folder.

Set Input Auto- Activated: The currently active image is automatically loaded as input
matically image. This can be used to load the output image of the first image
processing step as input for the next image processing step. Turn this
function off if you want to test various processing parameters and
compare the results.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 971


9 Reference | 9.3 Tools ZEISS

Parameter Description
Apply to preview, If the preview option in the Output tool is selected, activating this pa-
only rameter will cause the processing function to be applied to the pre-
view-region only and leaves the parts of the image outside the pre-
view region unchanged.

Switch to Output Activated: Automatically switches the view to the processed image.

Remain at current Activated: The currently active image document will remain active af-
view ter the image processing step.

9.3.22 Interactive Bleaching Tool

This tool allows to bleach interactively during a Continuous scan or during a Time Series experi-
ment while image acquisition is performed. The bleach region is determined by pointing the
mouse onto the position in the image.

Fig. 73: Interactive Bleaching Tool

Parameter Description
Mouse Behavior Change the display of the selected clipping plane using the dropdown
list to the right of the Activate checkbox. The following settings are
available:

- Bleach while The bleaching process is continued while the mouse button is
mouse button pressed.
pressed

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 972


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Bleach fixed The bleaching process is continued for a fixed number of times after
number of it- the mouse is pressed. The number of iterations can be entered below.
erations

- Fixed iteration Determines the number of iterations.


count

- Allow cancel If activated, the bleaching process can be stopped before the fixed
by click number iterations is accomplished. Simply click on the left mouse but-
ton again to stop the bleaching process.

Bleaching Stencils The available bleaching stencils (equivalent to ROIs for bleaching) are
list listed here.
A stencil is displayed in its graphical form, the color displays the laser
line that is assigned for bleaching to this stencil.
You can add a stencil by clicking the + Create from graphic button.
This will import an activated graphical element from the Graphics
tool tab.
A stencil can be saved, loaded or deleted.
A stencil is active, when clicked on and highlighted.
To use an activated stencil for bleaching, move the mouse cursor onto
the image and click on the left mouse button.

Laser Settings for Here you can set the laser line and laser power for the activated sten-
section cil.

9.3.23 Interactive Measurement Tool

Parameter Description
Feature Set

– Feature Set Selects and loads previously saved feature definitions/feature sets. If
Dropdown you have made changes to a feature definition, the name of the fea-
ture selection is marked with an asterisk (*). If you close the applica-
tion without saving a changed feature selection, you will be asked
whether you want to save the changes.

– Opens the options menu to create, import, export, save or delete a


feature set definition.
Options

– Define Opens the Feature Selection dialog to define the features that are
available for interactive measurements.

Feature Subset Only visible if Show All is activated.

– Feature Sub- Selects and loads previously saved definitions of subsets. If you have
set Dropdown made changes to a subset definition, the name of the feature subset
is marked with an asterisk (*). If you close the application without sav-
ing a changed feature subset, you will be asked whether you want to
save the changes.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 973


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Opens the options menu to create, import, export, save or delete a
feature subset definition.
Options

– Define Opens the Feature Subset Definition dialog to define which fea-
tures are available for the definition of the feature set.

Measurement Se- Only visible if Show All is activated.


quence

– Measurement Selects and loads previously saved measurement procedures. If you


Sequence have made changes to a measurement procedure, the name of the
Dropdown measurement procedure is marked with an asterisk (*). If you close
the application without saving a changed measurement procedure,
you will be asked whether you want to save the changes.

– Opens the options menu to create, import, export, save or delete a


measurement sequence.
Options

– Define Opens the dialog to define the sequence of measurements that you
want to execute interactively.

Run Only visible if Show All is activated.


Opens a dialog to start the selected measurement sequence.

Create Measure- Creates a measurement data table and opens it as a separate docu-
ment Table ment. This contains the measurement data from the Measure view of
the current image.

See also
2 Using Interactive Measurements [} 248]

9.3.23.1 Feature Selection Dialog

In this dialog you can specify which features are measured with the available graphical elements.

Available Elements Section


This section displays all available graphical elements ordered by type. The following types are
available for selection:

Element Type Description


Region 2D Displays graphical elements you can use to define a closed region.

Line Displays graphical elements you can use to measure a single distance.

Lines Displays graphical elements you can use to measure several distances
at once.

Angle Displays graphical elements you can use to measure an angle.

Point Displays graphical elements you can use to perform measurements at


a pixel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 974


9 Reference | 9.3 Tools ZEISS

Element Type Description


Points Displays graphical elements you can use to count various events in an
image.

Selected Features Section


This section displays the features that you selected for the currently selected graphical element.
These features are then measured when the element is drawn into the image. To add a new fea-
ture to the element, double click the feature in the list on the right, or select it and click .

Parameter Description
Name Displays the name of the feature.

Display Activated: The measured value of the feature is displayed in the


graphics plane of the image.

Deletes the selected feature.


Delete

Moves the selected feature one position higher.


Upwards

Moves the selected feature one position lower.


Downwards

Features Section
This section displays a list with all the features that are available for measuring the selected graph-
ical element. For a description of individual measurement features, see Measurement Features
[} 440].

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 975


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Geometric All features that describe unscaled geometric features.
Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed.
tures Unscaled

- Polygon-based All features polygon-based features are listed.


Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

9.3.23.2 Feature Subset Definition Dialog

In this dialog you can specify which features are available in the Feature Selection dialog by acti-
vating the checkbox in front of the features. A right click menu offers the possibility to select or
unselect all features.

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features.


Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed.
tures Unscaled

- Polygon-based All features polygon-based features are listed.


Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 976


9 Reference | 9.3 Tools ZEISS

9.3.23.3 Interactive Measurement Sequence Definition Dialog

In this dialog you can define an interactive measurement procedure. You can specify the order in
which the individual graphic elements should be drawn in and which measurement parameters
you want to have calculated for them.

Available Elements Section


This section displays all available graphical elements ordered by type. The following types are
available for selection:

Element Type Description


Region 2D Displays graphical elements you can use to define a closed region.

Line Displays graphical elements you can use to measure a single distance.

Lines Displays graphical elements you can use to measure several distances
at once.

Angle Displays graphical elements you can use to measure an angle.

Point Displays graphical elements you can use to perform measurements at


a pixel.

Points Displays graphical elements you can use to count various events in an
image.

Double click on an element to select it and add it to the Selected Elements Sequence list.

Selected Elements Sequence Section


This list displays the selected graphical elements in the order in which they will be drawn during
the measurement, from top to bottom. To display the value of the measured feature in the image,
activate the corresponding checkbox. To add a new feature to the element, double click the fea-
ture in the list on the right, or select it and click .

Parameter Description
Deletes the selected feature.
Delete

Moves the selected feature one position higher.


Upwards

Moves the selected feature one position lower.


Downwards

Features Section
This section displays a list with all the features that you can measure with the graphical element
activated in the Available Elements section. For a description of individual measurement fea-
tures, see Measurement Features [} 440].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 977


9 Reference | 9.3 Tools ZEISS

Parameter Description
Search Features Here you can enter parts of the name of the feature that you are
looking for. The features in which the entered character string occurs
are listed.
Select a type of feature according to which you want the features to
be filtered from the dropdown list.

- All All features are listed.

- Geometric All geometric features are listed.


Features

- Intensity Fea- All features that analyze intensity values are listed.
tures

- Image Fea- All features that contain meta information about the measured image
tures are listed.

- Position Fea- All features that describe the position are listed.
tures

- Geometric All features that describe unscaled geometric features.


Features Un-
scaled

- Position Fea- All features that describe unscaled positions are listed.
tures Unscaled

- Polygon-based All features polygon-based features are listed.


Features

- Statistical Fea- All features that can be used for plotting in a heatmap (i.e. that pro-
tures vide statistical values suitable for heatmap plotting) are listed.

9.3.23.4 Interactive Measurement Sequence Execution Dialog

With this dialog you can execute your previously defined sequence for interactive measurement.
You can draw the graphical elements into the image. You also have the standard controls of the
Dimensions and Display tabs to adapt the image display and change to other image dimensions
to draw the elements.
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 measure-
ments or annotations. Note that this cursor only works reliably on one channel, so for multi-chan-
nel 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.

Parameter Description
Operation

– Start Starts the drawing mode to add the sequence of graphical elements
to the image.

– Pause/Con- Pauses the drawing. This allows you to modify graphical elements
tinue that have already been drawn. The button changes to Continue for
resuming the drawing of the elements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 978


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Stop Ends the drawing mode of the measurement sequence.

Measurement Se- Displays the graphical elements of the current measurement sequence
quence in the predefined order.

Measurement Data Displays the values measured with the graphical elements. A right
Table click in the header of a column opens a context menu for the respec-
tive column.

Opens a context menu with options for the data table.


Options

– Sort Data Opens a dialog to define how to sort the data in the table.

– Filter Data Displays a field to define criteria for filtering the data in the table.

– Name Activated: Displays the column with the name of the graphical ele-
ments.

– Scene/Z-Posi- Only visible if the image contains the respective dimension(s).


tion/Time Activated: Displays the column with the image dimension (the scene,
z-position or time point).

– Feature Activated: Displays the column with the name of the measurement
feature used for the respective element.

– Value Activated: Displays the column with the measurement value.

– Unit Activated: Displays the column with the unit of the measurement.

– Add Columns Opens a dialog to add an additional column.

– Formula Col- Opens a dialog to add and define a formula column.


umn

– Delete Rows Opens a dialog to delete rows from the table.

OK Ends the execution of the interactive measurement and saves the


graphical elements drawn into the image.

Cancel Cancels the interactive measurement without saving the graphical ele-
ments.

9.3.24 Macro Tool

Parameter Description
Record Records a new macro. The Record button will change to a Stop but-
ton. Press this Stop button to stop the macro recording.

Run Executes the selected macro.

Stop Stops the running macro at the active command.

Selection Displays a list of all existing macros.

– Creates a new macro.


Add

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 979


9 Reference | 9.3 Tools ZEISS

Parameter Description
– Deletes the selected macro.
Delete

– With the options dropdown you can create, duplicate, rename, and
safe new macro files, or delete existing macros.
Options

Preview Here you see a preview to the macro program code of the selected
macro. Editing the macro here is not possible.

Properties

– Name Displays the name of the macro.

– Keywords Displays keywords for the selected macro. Keywords can also be en-
tered in this text field.

– Description Displays the description for the selected macro. A description can also
be entered in this text field.

– Toolbar Con- When you click on the button you will enter the Customize Toolbar
figuration dialog. There you can add macro buttons or functions to the toolbar
for a quick access. How you can configure the toolbar is described un-
der Customizing Toolbar [} 39].

Macro Editor… Opens the Macro Editor Dialog [} 823].

See also
2 Right Tool Area [} 28]

9.3.25 Microscope Control Tool

The configuration of your system according to your MicroToolBox (MTB) configuration setting is
shown here. A valid microscope configuration has to be created first using the MTB2011 Configu-
ration program. The light path follows the light starting with the light source to the specimen and
from there to the camera or eyepiece. It displays control elements for all motorized and manually
operated components. Here you can interactively adjust the microscope and its components.

CAUTION
Risk of Glare
There is a risk of glare when changing positions of the beam splitter wheel, excitation filter
wheel or emission filter wheel in the Microscope Control tool on Locate tab, if available. Ex-
citation light can unintentionally be directed to and emitted through the ocular if an inappro-
priate combination of positions is selected.
4 Do not look into the ocular when changing settings on the light path.
4 We recommend to use virtual reflector revolver settings instead of changing positions via
the mentioned components.

Info
If you are not using any motorized components, you will have to make the relevant adjust-
ments manually.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 980


9 Reference | 9.3 Tools ZEISS

Keep the following points in mind when working with this tool:

§ To adjust a component, left-click on the relevant icon.


§ Icons with an arrow symbol in the bottom right corner contain dialogs that allow you to con-
figure additional settings. To open the dialogs, left-click on the corresponding icon.
§ Icons with a hand symbol in the bottom left corner indicate components that have to be op-
erated manually.

Icon Parameter Description


Eyepiece Displays the total magnification of the selected beam path with
all activated intermediate magnifications above the Eyepiece
icon. To direct the light path fully to the eyepiece, simply left-
click on the icon.

Shutter Here you can set the shutter to Open or Closed. The status is
displayed in text form above the icon.
/

Reflector Here you can select one of the configured filter cubes for re-
Turret flected light techniques from the list.

Nose- Select the desired Objective from the list.


piece/Ob-
jective

Stage Here you see the options for Stage Control and Focus Control.
§ Stage >>: Opens the Stage Tool [} 985] in the Right Tool
Area.
There you can move the microscope stage virtually with the
help of a software joystick or by entering absolute coordi-
nates. You can also calibrate the stage within that tool.
§ Focus >>: Opens the Focus Tool [} 938] in the Right Tool
Area.
There you can move the focus drive virtually with the help of a
software joystick or by entering absolute coordinates. You can
also calibrate the focus drive within that tool.

Aperture Adjust the diaphragm opening (0% to 100%) using the slider or
Di- spin box/input field.
aphragm

Filter Here you can enter the first neutral density filter (e.g. 0.4%, 6%,
Wheel 100%, 100%) that you require.

Con- The condenser is only available in the Transmitted Light path.


denser
Select the contrast method from the list (e.g. brightfield, dark-
field, phase contrast ring 1, 2, 3, DIC I, II, III).

Camera/ Select whether you want to direct the light to the camera only
Eyepiece (100% Camera), to the camera and the eyepiece (30% Eye-
Switch piece/70% Camera) or to the eyepiece only (100% Eyepiece)
from the list .

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 981


9 Reference | 9.3 Tools ZEISS

Icon Parameter Description


Camera Shows the selected camera above the icon.

Micro- Opens the Microscope Manager [} 982] dialog.


scope
Manager

Reflected If your microscope has a halogen lamp for both reflected and
Light/ transmitted light illumination, here you can select whether you
Transmit- want to control the halogen lamp for reflected light illumination
ted Light or the halogen lamp for transmitted light illumination.
Switch

6x Motor- This device is part of the Motorized Dual Filter Wheel. Select the
ized desired Dichroic position from the dialog. Switching time is
Beam about 300 msec between neighboring positions.
Splitter
Wheel

6x Motor- This device is part of the Motorized Dual Filter Wheel. Select the
ized Emis- desired Emission Filter position from the dialog. Switching time is
sion Filter between 60 and 240 msec between neighboring positions (de-
Wheel pending on the speed configuration in the MTB2011 Configura-
tion program).

6x Motor- Select the desired Excitation Filter position from the dialog.
ized Exci- Switching time is between 70 and 300 msec between neighbor-
tation Fil- ing positions (depending on the speed configuration in the
ter Wheel MTB2011 Configuration program).

12x Mo- If a Motorized Dual Filter Wheel and a Motorized Emission Filter
torized Wheel is present, up to 12 virtual Reflektor positions can be con-
vReflector figured in the MTB2011 Configuration program. Select the de-
Changer sired filter combination from the list of available positions. This is
more convenient than adjusting excitation, dichroic and emission
filters individually.

9.3.25.1 Microscope Manager

Parameter Description
Contrast Manager

Mode Select the setting for the contrast mode from the Mode dropdown
list.

- Off The Contrast Manager is not used. All settings must be made manu-
ally or via a settings file.

- On Demand The function of the Contrast Manager is activated via the touch
screen on the microscope.

- Contrast Retain- If core components (e.g. condenser, reflector, shutter) for a certain
ing contrast technique are changed, dependent components are also
changed accordingly.

Method Select one of the available methods for the contrast mode here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 982


9 Reference | 9.3 Tools ZEISS

Parameter Description
Light Manager

Enabled Activated: Activates the Light Manager. Activates the Mode drop-
down list in the Light Manager.

Mode Select a setting for adjusting the brightness of the light here.

- Objective Adjusts the brightness of the light via the lamp voltage. The color
temperature changes accordingly.

- Classic Adjusts the brightness on the basis of the available filter wheels. The
color temperature is retained. Only if the brightness adjustment can-
not be achieved via the filter wheels does adjustment take place via
the lamp voltage.

Dazzle Protection Activated: Activates dazzle protection.


Dazzle protection prevents light from passing through the eyepiece
and dazzling the user, for example when reflector positions are
changed. This is mainly achieved by closing the reflected or transmit-
ted light shutter. If no shutters are installed, the lamp voltage is ad-
justed.

Parfocal Correc- Activated: Parfocal correction is activated.


tion

Parcentral Correc- Activated: Parcentral correction is activated.


tion

9.3.26 Microscope Tool

Parameter Description
Objective List Here you can easily switch between the objectives and pre-magnifica-
tion. The color bar on the objective buttons indicates the color for the
respective stage limit indicator inside the Navigation tab.
If you select autocorr objectives (motorized correction collar) you can
additionally adjust the relevant settings like Correction Mode, Bot-
tom Thickness or Imaging Depth.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 983


9 Reference | 9.3 Tools ZEISS

9.3.27 Movie Recorder Tool

NOTICE
Risk of Memory Depletion
By default, the movie recorder acquires images with the highest possible speed, which might
fill available memory and lead to a crash. To avoid this, limit the acquisition speed.
4 Go to Tools > Options > Acquisition > Camera/Live and activate Show Camera Ex-
pert Options. Then click OK.
ð The dialog closes and the setting is saved.
4 Go to the Locate tab, open the Camera tool and expand the Camera Specific section.
ð The camera specific settings, including expert settings are displayed.
4 Change the value for Frame Time which sets a waiting time between image acquisitions
within the camera.
ð You have adapted the acquisition speed.

Info
Saving the Data
If you want to save the recorded data and open it in other applications (e.g. ImageJ), it needs
to be decoded. To do this, you have to save the data via File > Save As with Options, or ex-
port the data with the dedicated image/movie export functionality in ZEN.

This tool enables you to acquire image sequences in the form of videos using the camera's fastest
burst mode. To play the acquired movie in ZEN, use the Player tab in the Center Screen Area
(only visible in Show All mode).

Parameter Description
Start Movie Starts the acquisition. The button changes into the Pause button. A
Stop button appears in the window above the button.

Pause Movie Pauses the acquisition. The button changes into the Continue button.

Continue Movie Continues acquisition if it has been paused. The button changes into
the Pause button.

Stop Stops the acquisition.

9.3.28 Output Tool

Parameter Description
Output Image Normally this windows is empty as the output image does not yet ex-
ist. If the Overwrite option is activated, you can select an already ex-
isting output image here so that the output is overwritten every time
the function is applied. This prevents multiple output images to be
created when testing out function parameters.

Custom Output Defines a custom output name.


Name

Overwrite Activated: Overwrites an existing file.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 984


9 Reference | 9.3 Tools ZEISS

Parameter Description
Create New Out- Activated: Saves the image file with a new name.
put

Save Outputs Activated: Saves the image automatically.

Naming Opens a dialog to define conventions for the image file name.

Preview Displays a preview window in your image. In this window you can see
an automatically calculated preview of what the result will look like
with the current parameter settings.

See also
2 Image Processing Workflow [} 72]

9.3.29 Pipeline Tool

This tool enables you to send an image to the arivis Pro and open it there with an analysis pipeline
selected in ZEN. The input image for the tool is always the currently opened image. A description
of each pipeline is displayed as the tooltip of the respective pipeline.

Parameter Description

Options

– Show Sample Activated: Displays sample pipelines in the directory below.


Pipelines

– Add Pipeline Opens a browser to select and add a folder with pipelines you created
Directory in arivis Pro to the list of directories below.

– Remove Pipe- Removes the selected pipeline directory in the list below.
line Directory Note: You can only remove whole directories/top level folders which
you have imported. Removing subfolders or individual pipelines from
the list is not possible!

– Update Pipe- Updates the pipeline directories.


line List

Recently used Displays a list of the most recently used pipelines.

Search Searches for a pipeline using the input field.

Cancels the current pipeline search.


Cancel Search

Open and Apply Opens arivis Pro with the current image and the selected pipeline.

9.3.30 Stage Tool

This tool enables you to navigate the sample in a microscope equipped with a motorized stage.
You can use the Navigation Circle (software joystick) to move the stage or enter the coordinates
directly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 985


9 Reference | 9.3 Tools ZEISS

CAUTION
Risk of Crushing Fingers
The drive of a microscope stage with a motorized horizontal stage axis (stage drive) is strong
enough to crush fingers or objects between the stage and nearby objects (e.g. a wall).
4 Remove your fingers or any objects from the danger area before moving the stage drive.
4 Release the joystick immediately to stop the movement.

NOTICE
Risk of Spilling the Sample
If you use the sample carrier 60mm petri dish for Celldiscoverer, you risk spilling if the stage
speed and acceleration exceed 50%. On initial selection of this sample carrier, both Speed and
Acceleration are automatically set to 50% and a warning message is displayed.
4 Do not increase stage speed and acceleration above 50% for the 60mm petri dish.

Info
You can also control the Navigation Circle and thus the motorized stage with the keyboard.
To activate keyboard control left-click anywhere inside the segmented Navigation Circle. To
change between the two speed modes, right-click the central Navigation Circle icon.
4 To move the stage at the lower speed, use the arrow keys (diagonal movements are also
possible).
4 To move the stage at the higher speed, use Shift + Arrow keys.

Parameter Description
Navigation Circle Enables you to move the stage freely in the X and Y direction and in
both diagonal directions.
To move the stage, drag the Navigation Circle icon in the desired di-
rection. If released, the icon snaps back to the Navigation Circle cen-
ter and the stage stops.
The Navigation Circle allows four speeds:
§ Normal modes:
– Inner segments: Slow
– Outer segments: Medium

§ High-speed modes:
– Inner segments: Fast
– Outer segments: Very Fast

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 986


9 Reference | 9.3 Tools ZEISS

Parameter Description

To enter the high-speed mode, right-click the Navigation Circle icon.


The Navigation Circle turns red. To return to normal speed, right-click
the Navigation Circle icon again.

Stop Stops any stage movement immediately. Use this button if you en-
tered a X-Position and/or Y-Position and wish to interrupt the stage
movement immediately (e.g. to prevent a collision).

X-Position, Y-Posi- Specifies the target coordinates for the stage movement.
tion The stage starts moving immediately after the coordinates have been
entered and confirmed; either by pressing the Return key or by click-
ing anywhere outside the current input field.

All following parameters are only visible if Show All is activated:

Speed Sets the speed for stage movement in percent (100% = maximum
possible speed).
Note that the speed setting does not change the speed graduation of
the SW joystick.

Acceleration Sets the acceleration of the stage in percent (100% = maximum accel-
eration value).

X/Y-Position

- Set Zero Sets the current position as the new zero point for the x/y coordi-
nates.

- Calibrate CAUTION! Risk of Crushing Fingers. Performs an automatic stage


calibration. For this the stage moves to the limit switches to deter-
mine the zero points in the x and y direction and then returns to its
starting position, which is now defined with its absolute coordinates.

Marks This section displays a list where you can define X and Y positions
(optional z value), so called marks. The marks can also be defined via
the Marks button on the Dimensions tab. It is also possible to im-
port an already existing list of positions (e.g. defined with the Tiles
tool).

- Name Displays and sets the name for the respective entry. To add or edit the
name, double click into the column.

- X/Y/Z (µm) Displays the x and y position of the respective stage mark. If you have
activated Z-Values, also the value for z is displayed.

- + Adds the current stage position as entry to the list.

- Moves the selected entry one position up in the list.


Move Up

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 987


9 Reference | 9.3 Tools ZEISS

Parameter Description
- Moves the selected entry one position down in the list.
Move Down

- Deletes the currently selected list entry.


Delete

- Navigates the stage to the position of the currently selected entry.


Navigate

- Opens a file browser to select and import a list of already defined


marks.
Import List

- Opens a file browser to export the current list of defined marks.


Export List

- Go Previous Navigates the stage to the position of the previous list entry.

- Go Next Navigates the stage to the position of the next list entry.

- Z-Values Activated: Displays the z values for the list entries.

- Show Marks Activated: Displays the marks in the current image.


in the Current
Image

9.3.31 Stage/Focus not Calibrated Dialog

If you see this dialog, after you have started the software and the hardware was initialized, you
should consider to calibrate the stage and focus drive immediately.
The calibration is necessary, if

§ a motorized stage and/or focus drive are used, and


§ the stage and focus drive are not calibrated.
To start the calibration procedure, simply click on the Calibrate Now button.

CAUTION
Risk of Crushing Fingers !
The drive of a microscope stage with a motorized vertical axis (focus drive) is strong enough to
crush fingers or objects between the stage and the microscope stand.
4 Before starting the calibration procedure, ensure that people stand clear of the instrument
and that the full travel range is not obstructed by any objects.

If you skip the calibration, you can calibrate the stage and focus drive afterwards within the
Stage Control and Focus Control dialogs accessible via the Lightpath tool, see Stage Control
and Focus Control. Make sure that the Show All mode is activated, to see the Calibrate button
within the dialogs.
Note that for fully automated system like Axio Scan the axes are calibrated automatically. The cali-
bration is not necessary in that case.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 988


9 Reference | 9.3 Tools ZEISS

9.3.32 Timed Bleaching Tool

This tool permits setting the bleach parameters for a bleaching experiment in combination with a
time series. Bleaching or photo manipulation is done in between acquisition.

Parameter Description
Start after # of im- Activated: Enables you to set the number of frames that are imaged
ages before the bleaching process.

Repeat after # of Activated: Enables you to set the number of images that will sepa-
images rate a repetitive bleaching procedure.

- Iterations for Defines the bleach repetitions for bleach areas.


area bleach
This defines the total amount of scans which are performed for
bleaching the selected region during each bleaching process.

- Spot Bleach This function is only available with LSM 980. When spots are defined
Duration for bleaching enter the time for each spot to be bleached in this edit-
ing field.

Stop on intensity Only visible if Show All is activated.


below Activated: Enables you to bleach the sample to an intensity value cal-
culated as % of the initial intensity within the region to bleach, during
an experiment with repetitive bleaching. The intensity value is deter-
mined with every taken image.
Note: This function can only be applied if one ROI for bleaching is de-
fined. It does not work for multiple regions.

Set Different scan Only visible if Show All is activated.


speed Activated: Enables you to set the scan speed for bleaching can differ-
ently than the imaging scan speed. A lower speed results in a longer
pixel dwell time, which increases the efficiency of bleaching.

Set different Z-Po- Only visible if Show All is activated.


sition Activated: Enables you to perform the bleaching at a different z-level
than currently set. Enter the difference in µm into the input field.

Trigger Only visible if Show All is activated.

- Trigger In The bleach event is waiting for a TriggerIN signal (TTL pulse) to be ex-
ecuted.

- Trigger Out The system outputs a trigger signal (TTL Pulse) for each bleach event.

Spot/Full area se- Only visible if Show All is activated.


quential bleach Activated: For Spot Bleach mode this is set as default. When acti-
vated all regions (and spots) are bleached sequentially performing all
bleach iterations for each region first before moving to the next re-
gion. The scan field is limited to each bleach region.

Protect detectors Only visible if Show All is activated.


during bleach Activated: PMT gain is set to 0 V during the bleaching step.
Note that, selecting this option the PMT gain will slow down the ac-
quisition. Typically, small bleach ROIs will not be causing a critically
high signal for the detectors. However, even when this option is not
activated, the detectors will either regulate down the voltage or shut
down completely in case of significant overexposure.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 989


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Excitation of
Bleach

- Use different Activated: For each previously drawn ROI a tab is present, in which
settings for laser line and laser power can be chosen.
different re-
gions

All Regions Only visible if the Use different settings for different regions is
not activated.
Activates the according checkbox for a laser line. Use the slider to ad-
just the power for bleaching/photo-manipulation. Note that for high
laser power the High Intensity Laser Range must be set in the
Imaging Setup or Channels tool (only for LSM 900).

9.4 Image Views

The software offers different image views. The general image views are visible for each image.
The specific image views are available only if the image has the appropriate characteristics (e.g.
multiple channels, Z-stack, etc.). Each image view has general and specific controls which you can
use to work with the view.

9.4.1 General Image Views

These image views are available with any image. Depending on the type of image in question, the
general control elements may have additional or more limited functions.

9.4.1.1 2D View

This is the default view to display images in the software. Here you can adjust how the image is
displayed with the general view option tabs on the bottom. Additionally, you can add graphical
elements like annotations and measurements. A right click into the image area opens a context
menu offering quick options to adjust the view, see 2D View Context Menu [} 990]. If you have
drawn graphical elements into your image, a right click on such an element opens a separate con-
text menu to modify the selected element(s), see Graphical Elements Context Menu [} 992].

See also
2 General View Options [} 1029]
2 Center Screen Area [} 26]

9.4.1.1.1 2D View Context Menu

This context menu is displayed if you right click in the image displayed in the 2D view. Note that if
you right click a graphical element or within the bounding box of a graphical element drawn into
your image, a different context menu is displayed, see Graphical Elements Context Menu
[} 992].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 990


9 Reference | 9.4 Image Views ZEISS

Menu item Description Shortcut


Full Screen Switches to full screen mode. To exit full-screen mode, press F11
F11 or ESC.

Zoom Group Here you have access to the main zoom functions, see also
Zoom Section [} 1030].

Rulers Activated: Displays rulers at the top and left edge of the im-
age.

Show Floating Activated: Displays a scale bar, which you can position Alt + S
Scale Bar freely in your image.

Draw Annota- Adds an annotation scale bar to the image and lists it in the
tion Scale Bar Graphics tab.

Navigator Activated: Displays the Navigator dialog.

Spot Measure- This function is only active in the live image or during Con-
ment/Focus tinuous mode.
ROI Displays a region in which the exposure time is measured
and the software autofocus is focused.

Graphics Activated: Displays graphical elements that have been


drawn into the image, e.g. annotations or scale bars. This
function is activated by default.

Magnetic Cur- Activated: Changes the mouse cursor. This cursor detects Alt + C
sor 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.

Graphics Op- Only available if a suitable graphical element is selected.


eration
§ None: Draws a new graphical element is into the image.
§ Add: If a newly drawn element overlaps already existing
graphical elements, the new element is added to the exist-
ing.
§ Subtract: If a newly drawn element overlaps already exist-
ing graphical elements, the overlapping part will be sub-
tracted from the existing elements.

Show Bleach Only visible for FRAP images.


ROI Displays the graphical elements that were used for bleaching
during acquisition (FRAP).

Analysis Re- Only available for images with an analysis result.


sult Activated: Displays the result of the image analysis in the
image, e.g. the segmentation masks.

Grid Activated: Adds a grid to the image, see Displaying and


Adapting a Grid in the Image Area [} 41].

Copy Display Copies the display settings of the current image.


Settings

Paste Display Inserts the copied display settings into the image.
Settings

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 991


9 Reference | 9.4 Image Views ZEISS

Menu item Description Shortcut


Paste Display Inserts the copied display settings and the channel colors into
Settings and the image.
Channel Col-
ors

Min/Max Adjusts the display characteristic curve so that the darkest


pixel is black and the brightest pixel is white in the display.
Note that this function makes an approximation to get a
quick result! For detailed information about minimum and
maximum values refer to measurements conducted in the
Histo view.

Best Fit Adjusts the display characteristic curve so that 0.1% of the
darkest pixels contained in the image are black and 0.1% of
the brightest pixels are white in the display.

ROI (Region of Enables you to draw a rectangular region of interest into the Ctrl+ U
Interest) > image. The ROI is displayed with red boundaries. You can
Draw Region draw several regions into an image.
of Interest

ROI (Region of Enables you to draw rectangular region of interest into the Ctr-
Interest) > image. This region can be rotated and is displayed with yel- l+Shift+R
Draw Rotat- low boundaries. You can draw several regions into an image.
able Region of
Interest

ROI (Region of Creates a new image document from the selected regions Ctrl+
Interest) > drawn into the image. All dimensions of the image are taken Shift + C
Create Subset into account here. This function works for both the non ro-
Images From tatable and rotatable ROIs (the red and the yellow regions).
ROI

Create Image Creates an image from the current view.


from View

Paste Inserts a graphic element into the current image from the Ctrl + V,
clipboard. Shift +
Ins

9.4.1.1.2 Graphical Elements Context Menu

This context menu is displayed if you right click on a graphical element or within the bounding
box of a graphical element in your image.

Menu item Description Shortcut


Magnetic Cur- Activated: Changes the mouse cursor. This cursor detects Alt + C
sor 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.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 992


9 Reference | 9.4 Image Views ZEISS

Menu item Description Shortcut


Analysis Re- Only available for analyzed images/images with an analysis
sult result.
Activated: Displays the result of the image analysis in the
image, e.g. the segmentation masks.

Cut Cuts the selected graphical element and copies it to the clip- Ctrl + X,
board. Shift +
Del

Copy Copies the selected graphical element(s) to the clipboard. Ctrl + C,


Ctrl + Ins

Paste Pastes the graphical element(s) from the clipboard into the Ctrl + V,
image. Shift +
Ins

Delete Deletes the selected graphical element(s). Del

Bring to Front Brings the selected graphical element(s) to the front of the
image.

Send to Back Sends the selected graphical element(s) to the back of the
image.

Bring Forward Brings the selected graphical element(s) one layer forward.

Send Back- Sends the selected graphical element(s) one layer backward.
wards

Align Only available if you have selected multiple graphical ele-


ments.
Selects the alignment of the graphical elements to each other
and applies the alignment.

Distribute Only available if you have selected at least three graphical el-
ements.
Allows you to distribute the selected graphical elements in
vertical or horizontal direction based on their centers, i.e. the
elements are realigned so that their centers all have the same
distance to each other in horizontal or vertical direction.

Group Only available if you have selected multiple graphical ele-


ments.
Groups all selected graphical elements together. Selecting
and moving one graphical elements also selects and moves
the other elements of the group.

Ungroup Only available if you have selected a group of graphical ele-


ments.
Ungroups the respective graphical elements.

Merge Only available if you have selected at least two elements that
overlap.
Merges the selected graphical elements to create one ele-
ment.

Edit Points Only available for polygonal or spline elements, e.g. Contour
or Curve.
Allows you to edit individual points of the polygonal or spline
element.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 993


9 Reference | 9.4 Image Views ZEISS

Menu item Description Shortcut


Create Subset Creates a new image document from the selected regions Ctrl+
Images from drawn into the image. All dimensions of the image are taken Shift + C
ROI into account here. This function works for both the non ro-
tatable and rotatable ROIs (the red and the yellow regions).

Format Graph- Opens the dialog for formatting the selected graphical ele-
ical Elements ment.

Choose Mea- Opens a dialog to define measurement features used (and


surement Fea- displayed) by the selected graphical element.
tures

Reset to Fac- Resets the graphical element to factory default.


tory Default

Add to Cus- Adds the selected graphical element as custom element to


tom Graphics the Custom Graphics tab.

9.4.1.2 Gallery View

In this view you see an overview of your multidimensional images. The individual images of the
images concerned are presented in a gallery. It is possible to show any combination of dimen-
sions, e.g. channels against time. When you view images for the first time in the Gallery view,
they are displayed as follows:

Image type Display


Multichannel image All the channels present in an image are shown,
including the mixed color image.

Time lapse image All the time points present in an image are
shown.

Z-stack image All Z-planes are shown.

Multichannel & time lapse image All the time points present in an image are
shown. All channels are shown as a mixed color
image.

Multichannel & Z-stack image All Z-planes are shown. All channels are shown
as a mixed color image.

Time lapse & Z-stack image All Z-planes are shown.

Time lapse, Z-stack & multichannel image All Z-planes are shown. All channels are shown
as a mixed color image.

See also
2 General View Options [} 1029]

9.4.1.2.1 Gallery Tools Tab

Here you can specify which dimension you want to be displayed on which axis of the Gallery
view. To do this, click on the corresponding dimension button. Note that the appearance of this
tab depends whether Show All is activated or deactivated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 994


9 Reference | 9.4 Image Views ZEISS

Show All deactivated


The following functions are only visible, if Show All is deactivated. Each of the buttons is only vis-
ible if the current image contains the corresponding dimension.

Parameter Description
Channels Displays the channels as individual images.

Z-Stack Displays the z-planes as individual images.

Time Series Displays the time points as individual images.

Chann.& Z (Chan- Displays the channels in relation to the z-stack images.


nels and Z-Stack)

Chann.& Time Displays the channels in relation to the time lapse images.
(Channels and Time
Series)

Z&Time (Z-Stack Displays the z-stack images in relation to the time lapse images.
and Time Series)

Show Dimension Inserts annotations into each individual image that provide informa-
Labels tion on the time point or Z-plane.

Invert X/Y axis This checkbox is only available if the Show All mode is deactivated. It
is active only if two dimensions are shown in relation to each other
(Chann.&Z, Chann.&Time, Z&Time). If activated, this function inverts
the X and Y axis of the view.

Show Graphics Shows graphics/annotations within the images (in case if graphics/an-
notations are drawn in).

Show Merged Only visible for multichannel images. Only active if the channels
present are shown. Shows the pseudo colored (mixed) images of all
channels in addition to the individual images.

Show All activated


The following functions are only visible if the Show All mode is activated:

Parameter Description
X Axis/Y Axis The first column of dropdown lists selects which dimension (depend-
ing on which dimensions are available in the active image) is shown
on the X or Y axis (X axis = horizontal direction, Y axis = vertical direc-
tion).
In the second column of dropdown lists, you can select wether you
want to display all images of each dimension or if you want to display
a certain range of images on the X or Y axis. You have the following
options:

– All Displays all images of the active image in the Gallery view.

– Subset by If selected, you can enter a step size in the Step input field. If 2 steps
Step are entered, only every second image is shown. In the Max. input
field, you can enter the desired number of images. The step size is cal-
culated automatically.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 995


9 Reference | 9.4 Image Views ZEISS

Parameter Description
– Subset by If selected, you can adjust a range of images (e.g. from image 4-10)
Range which is displayed in the view. Use the slider or the input fields to en-
ter the desired range.

Create image from Selects the type of image that you want to create.

– Gallery View Creates an image of the current Gallery view. If this option is selected,
the option Gallery Image from is available. Here you can additionally
select a dimension that is not currently displayed (e.g. Single Image
will export each single image additionally). The resulting image is al-
ways a 24 bit RGB color image. The pixel data of the original image
are changed. If the Burn in graphics checkbox is activated, all graph-
ics or annotations will be burned into the output images.

– Selection Sub- Creates an image from the images that have been selected in the cur-
set rent view. To select an image simply click on the image in the Gallery
view. Press Crtl while clicking to select more images at once. Note
that for multi-dimensional datasets (e.g. z-stack and time series), cre-
ating a new image based on selection will create a image with the en-
tire range between the individually selected images. The new dataset
will contain the smallest continuous subset of the selected input
dataset that contains all selected images. Consequently, the entire
range of images between the first and the last selected image along
each dimension (z-stack, time series) will be exported. Export of indi-
vidual scattered images, or export of different subsets at different
time or z-positions is not possible.

– Range Subset Creates an image from the defined selection range. If this entry is se-
lected, sliders for the selected dimensions appear (Start, End and In-
terval). Use the sliders to set the selection range you want.

Create Creates the image and opens it in a new image document. The result-
ing image contains all the information of the input image; the pixel
data are not changed.

9.4.1.2.2 Gallery Appearance Tab

Only visible if the Show All mode is activated.

Checkbox Function
Show Dimension Anno- Inserts annotations into each individual image that provide infor-
tations in Image mation on the z-plane.

Show Graphics Displays graphics/annotations within the images (in case graph-
ics/annotations are drawn in).

Burn-in Annotations Only available if Show Graphics is activated.


Burns the annotations into the image.

Position Only available if Show Dimension Annotations in Image is ac-


tivated.
Sets the position for dimension annotations.

Font Only available if Show Dimension Annotations in Image is ac-


tivated.
Selects the font for dimension annotations.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 996


9 Reference | 9.4 Image Views ZEISS

Checkbox Function
Layout Sets the background color of the Gallery view and the distance
between the individual images (from 1-10 pixels).

9.4.1.3 Multiwell View

This view provides an overview of all the scenes from a multiwell plate. This view is only available,
if all wells have the same number and size of scenes and regions. Empty wells are allowed.
1

1 Image Overview
Displays the images of all the scenes from a multiwell plate. A double click on one of the
images opens the respective scene in the standard 2D view. You can select multiple im-
ages by pressing Ctrl while clicking individual images, or you can press the Shift button
to select a range of images. You can open the selected images in a split view for compar-
ison (via the Multiwell Tools tab).

2 View Options
Displays the tabs for the general view options as well as view specific options on the
Multiwell Tools tab.

9.4.1.3.1 Multiwell Tools Tab

Parameter Description
Scene in Well Only visible if the document contains multiple images (scenes) per
well.
Activated: Displays only the images of the selected scene.
Deactivated: Displays all images per well side by side. The positions
do not represent the real location.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 997


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Well Selection

– Compare Only available if you have selected at least two images in the Multi-
Wells well view.
Opens the selected images in a split view that allows you to compare
them.

– Create Image Only available if you have selected at least two images in the Multi-
well view and have compared them with Compare Wells.
Creates a new image from the selected wells.

– Burn in Well Only available if Display Well Labels Inside Image is activated.
Labels Activated: Burns the well labels into the image when you use Create
Image to create a new image.

Well Labels Displays settings for labels inside the view.

– Font Opens a control to select and change the font of the text, including
the size and font type.

– Display Well Activated: Displays the well location as text directly in the image.
Labels Inside
Image

– Position Dop- Only visible if Display Well Labels Inside Image is activated.
down Sets the position of the text in the individual images.

Layout Displays settings for the layout of the individual images in the view.

– Distance X Sets the distance between the individual images in x-direction.

– Distance Y Sets the distance between the individual images in y-direction.

– Background Opens a color selection window to set the background color of the
view.

9.4.1.3.2 Context Menu Multiwell View

Parameter Description
Full Screen Switches to full screen mode. To exit full-screen mode, press F11 or
ESC.

Zoom Group Here you have access to the main zoom functions, see also Zoom
Section [} 1030].

Graphics Activated: Displays graphical elements that have been drawn into
the image, e.g. annotations or scale bars. This function is activated by
default.

Copy Display Set- Copies the display settings of the current image.
tings

Paste Display Set- Inserts the copied display settings into the image.
tings

Paste Display Set- Inserts the copied display settings and the channel colors into the im-
tings and Channel age.
Colors

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 998


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Export Display Set- Opens a file browser to export the display settings of the current im-
tings age.

Import Display Set- Opens a file browser to import display settings from a file.
tings

Import Display Set- Opens a file browser to import display settings. and channel colors
tings and Channel from a file.
Colors

Min/Max Adjusts the display characteristic curve so that the darkest pixel is
black and the brightest pixel is white in the display. Note that this
function makes an approximation to get a quick result! For detailed
information about minimum and maximum values refer to measure-
ments conducted in the Histo view.

Best Fit Adjusts the display characteristic curve so that 0.1% of the darkest
pixels contained in the image are black and 0.1% of the brightest pix-
els are white in the display.

9.4.1.4 2.5D View

In the 2.5D view intensity values in a two-dimensional image are converted into a height map.
Here the highest intensity values are represented by the greatest extension in the Z-direction.
Overall this results in a so-called 2.5D or pseudo-3D image.

Info
If you are viewing a multichannel image, you can have the intensity values of the individual
channels displayed. To do this, activate or deactivate the desired channels on the Dimensions
tab.

9.4.1.4.1 2.5D View Tool Bars

The tool bars are arranged to the left of and underneath the image area. You can use the tools to
control the display of the 2.5D volumes in the image area.

Left Tool Bar

Icon Parameter Description


Top thumb Enlarges or reduces the image area.
wheel

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 999


9 Reference | 9.4 Image Views ZEISS

Icon Parameter Description


Rotate Use this to rotate the 2.5D volume in any way you wish
within the space. This is the default mode when you switch
to 2.5 D view for the first time.

Zoom Use this to increase the zoom factor of the image area.

Bottom thumb Rotates the 2.5D volume around the horizontal (X) axis.
wheel

Bottom Tool Bar

Icon Parameter Description


Left thumb Use this to rotate the 2.5D volume around the vertical (Y)
wheel axis.

Bounding Box Use this to show or hide a bounding box around the 2.5D
volume.

Show X/Y Axis Use this to show or hide the X/Y axis.

Show Z Axis Use this to show or hide the Z axis.

- Use this to switch back to the start view. A top view of the
2.5D volume is displayed. Lateral movements and the zoom
Start View
factor are adjusted so that the 2.5D volume can be seen at
the center of the image area.

Right thumb Use this to compress the 2.5D volume on the (Z) axis per-
wheel pendicular to the screen plane.

9.4.1.4.2 2.5D Display Tab

On the 2.5D Display tab you have 4 Render mode options for displaying your 2.5D image.

Parameter Description
Render mode

- Profiles Displays the relief divided into a number of profiles with an equal dis-
tance.
Set the number of profiles using the Grid distance slider.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1000


9 Reference | 9.4 Image Views ZEISS

Parameter Description
- Grid Displays the relief overlaid with a grid. This view supports gray levels
only.
Make the grid more closely or more coarsely meshed using the Grid
distance slider.

- Filled Displays the height relief by upwardly discrete, layered pillars.

- Surface Displays the relief as a continuous, flowing landscape.


Make the surface coarser or finer using the Grid distance slider.

Invert Z axis Use this function for images that contain many large, bright regions.
Activated: Displays the lowest intensity values by means of the great-
est extension in the Z direction.

Use palette Activated: Overlays the relief with the pseudo colors that have been
set on the Dimensions tab.

Show Faces at Only available in the Surface render mode.


Side
Activated: Closes the sides of the relief.

Show plane Activated: Shows two blue, transparent planes in the 2.5D volume.
Set the position of the planes using the X/Y sliders.

Extract image To save an individual image in the current view, click on the Save As
button.

9.4.1.4.3 Series Tab

On the Series tab in the 2.5D view you can create a series of images in the 2.5D view. These se-
ries can be played back later as a video clip, for example.

Parameter Description
Render Series Here you can select the desired series mode:

- Turn Around Here you can define the start/stop angle and the rotation direction
X around the X axis.

- Turn Around Y Only visible in the 3D view.


Here you can define the start/stop angle and the rotation direction
around the Y axis.

- Turn Around Z Here you can define the start/stop angle and the rotation direction
around the Z axis.

- Start/Stop Here you can define the angle and zoom settings for the start and
end position of your series. The intermediate positions are interpo-
lated evenly.

- Position List Here you can define any number of positions. The positions can each
have completely different rotation, zoom and illumination settings.

- Over Time Only visible in the 2.5D view.


Here you can define the start time point and end time point for a se-
ries. All other settings (rotation, zoom, etc.) remain unchanged.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1001


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Stored

Opens the Options shortcut menu.


Options

Apply Creates a series image with the current settings.

Preview
To obtain a preview of the series, click on Play. To end the
preview, click on Stop.

No. of Frames Here you can enter or select the number of individual images in the
series.

9.4.1.4.4 2.5D Display Options Tab

Only visible if the Show All mode is activated.

Parameter Description
Angle X Enter the rotation angle in the X direction with a precision of 1 de-
gree using the slider or input field.

Angle Y Enter the rotation angle in the Y direction with a precision of 1 degree
using the slider or input field.

Z Scaling Enter the Z scaling using the slider or input field.

Ambient Reduces or increases the intensity of the ambient lighting in the 2.5D
view.

Reflection Reduces or increases the proportion of the ambient light reflected on


the relief.

Shine Reduces or increases the effect of the ambient light shining on the re-
lief.

Light height Reduces or increases the intensity of the lighting in the 2.5D view. A
small distance means a circular light source at the center, while a
large distance illuminates the scene evenly.

Reset lights Resets all settings to the default values.

9.4.1.5 Profile View

In the Profile view you can create intensity profiles in your image. The view is divided into 4
quadrants: Profile window (top left), Image window (top right), Profile table (bottom left),
and Interactive Measurements table (bottom right).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1002


9 Reference | 9.4 Image Views ZEISS

Info
To create an intensity profile of a certain region, select a tool on the Profile Definition tab.
Use this to draw a line across a structure of interest in the image. An intensity profile of the
drawn line is generated automatically and displayed in the Profile window. To zoom into an
aspect of the Profile window, drag out a rectangular frame using the left mouse button in the
Profile window. The selected region is displayed in enlarged form. Right-click to return to the
original view.

See also
2 General View Options [} 1029]

9.4.1.5.1 Profile Definition Tab

Tool bar
Using the tools you can add one of four different profile tools(Arrow, Polygon, Freehand, or
Rectangle) to your image. The intensity profile of each tool is shown in the Profile window.

Parameter Description
Select Changes the mouse pointer to Selection mode. You can use this to se-
lect graphic elements in the image.

Clone Use this to copy the last selected element and insert it at another po-
sition in the image.

Arrow Use this to insert an arrow into the image. The gray levels for each
pixel along the line are shown in the Profile window in the direction
of the arrow.

Polygon Use this to insert a polygonal measurement line in the original image.

Freehand Use this to insert a measurement line with a shape of your choice.

Rectangle Use this to insert a rectangular measurement region. For this tool, the
average gray values across the width of the rectangle are shown in
the Profile window and the Profile table.

Keep Tool Activated: Keeps the last selected tool active.

Auto Color Only visible if the Show All mode is activated.


Activated: Highlights each drawn-in measurement line with a ran-
dom color.

Stroke Thickness Here you can enter the line width of the measurement line. For line
widths larger than one pixel, the average gray values across the line
width are shown in the Profile window and Profile table.

Parameter Description
Show profile in Activated:Adds the profile curves to the profile tool drawn into the
graphics image.
This function is only available for the Arrow tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1003


9 Reference | 9.4 Image Views ZEISS

Profile Measurements section

Parameter Description
Normal Switches the mouse behavior for interacting with the Profile win-
dow to the standard behavior.

Measurement Use this to perform a point measurement in the Profile window. To


copy the measured value into the interactive measurement table, click
on the Add to table button.

Caliper X Use this to perform a number of measurements along a certain dis-


tance along the X axis of the profile. To adopt the value into the mea-
surement data table, click on the Add to table button.

Caliper Y Use this to perform a number of measurements along a certain dis-


tance along the Y axis of the profile. To copy the value into the inter-
active measurement table, click on the Add to table button.

Reset Table Deletes all values from the interactive measurement data table.

Add to table Adds the current measurement values of tools used in the Profile win-
dow to the interactive measurements table.

Grid Distance section

Parameter Description
Grid Distance Adjusts the value with the slider or input field. It defines how the
measurement is done:
For a grid size of 1, each pixel covered by the profile tool is measured.
For a grid size of 2, the average of 2 pixels is measured. For a grid
sized of 3, the average of 3 pixels is measured etc.. This is useful
when measuring line profiles in very large tile images e.g. from Ax-
ioscan.

9.4.1.5.2 Profile View Tab

Here you can configure the display for the Profile view.

Show section

Parameter Description
Profile Table Activated: Shows the profile table.

Int. Measurement Shows the interactive measurement table.

Values Currently without function.

Image Only visible if the Show All mode is activated.


Activated: Shows the Image window.

Channel section
Here you can activate or deactivate the profiles for each color channel for an RGB image. Gray:
shows the average intensity value for all three color channels. This function is only available for
RGB color images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1004


9 Reference | 9.4 Image Views ZEISS

X/Y Axis section


Only visible if the Show All mode is activated.
Here you can determine the limits for the X axis and Y axis.

Parameter Description
Auto Sets the limits for the axes automatically based on the available pixel
values in the image..

Norm Normalizes the profile display to the maximum values of the distribu-
tion.

Fixed Enter the min/max values for the profile display in the Min/Max input
fields manually.

Log X Scale Switches the X-axis to logarithmic value distribution.

Log Y Scale Switches the Y-axis to logarithmic value distribution.

Data Table section


Click on the Create button to create a data table of the Profile measurement table. If an interac-
tive measurement value table contains any values, it is also created as separate data table. To save
the table as comma separated values file (csv), click on the Save As button.

New Image from section


Here you can create an image document of the profile view. Select the desired image configura-
tion from the dropdown list. To save the image, click on the Save As button.

9.4.1.6 Histo View

TheHisto(Histogram) view shows you the gray value histogram of your image. In the right image
area you can see your current image and in the left image area you can see the Histogram win-
dow. At the side you will also find four data tables:

§ In the first table from the left you will find all the raw data for each channel.
§ In the second table from the left you will find all the limits for each channel of the image next
to the image name.
§ In the third table from the left you will find the statistical values for the gray value distribu-
tion, e.g. average, standard deviation, minimum and maximum value.
§ The fourth table shows the values of measurements in the histogram. The results (Integral)
show the percentaged fractions of the occurences.

See also
2 General View Options [} 1029]

9.4.1.6.1 Histo Definition Tab

Tools
With these tools you can add specific ranges to your image. The histogram window displays the
gray value histogram for each area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1005


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Changes the mouse pointer to Selection mode. You can use this to se-
lect graphic elements in the image.
Select

Clone Use this to copy the last selected element and insert it at another po-
sition in the image.

Use this to insert a rectangular measurement region.


Draw Rectangle

Use this to insert a circular measurement region.


Draw Circle

Use this to insert a measurement region with a shape of your choice.


The line is closed automatically.
Draw Spline Con-
tour

Use this to insert a polygonal measurement region in the original im-


age.
Draw Polygon

Keep Tool Activated: Keeps the last selected tool active.

Auto color Only visible if the Show All mode is activated.


Activated: Highlights each drawn-in measurement region with a ran-
dom color.

Normal Switches the Profile window back to the view display.

CaliperX Use this to perform a measurement of a region in X direction in the


histogram display. To adopt the value into the measurement data ta-
ble, click on the Add to Table button.

Add to Table Only active if a measurement (using CaliperX mode) was drawn into
the histogram.
Adds the current measurement into a measurement data table below
the original image.

Reset Table Deletes the measurement data table below the original image.

Histo Table section


The following parameters are only visible if the Show All mode is activated:

Parameter Description
Histo Table Select the type of gray value distribution from the dropdown list. The
following types are available:

- Frequency If selected, the histogram is displayed according to the relative fre-


quency of the gray values in percent.

- SumUp

- SumDown

Relative Frequency

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1006


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Bin count Enter the Bin count using the slider.

Bin size Only visible if the Show All mode is activated.


Enter the Bin size using the slider.

Logarithmic bin- Only visible if the Show All mode is activated.


ning
Activated: Switches from the linear to a logarithmic class width. The
class size is calculated automatically.

Lower Threshold Enter the lower threshold value for the gray value distribution using
the slider or spin box/input field. All regions in the image with gray
values below the lower threshold value are overlaid in blue and all
those with gray values above the upper threshold value are overlaid in
red.

Skip Black Activated: Automatically subtracts the lowest value of the gray distri-
bution. If activated, the settings for the lower threshold value are de-
activated.

Upper Threshold Enter the upper threshold value for the gray value distribution using
the slider or spin box/input field. All regions in the image with gray
values below the lower threshold value are overlaid in blue and all
those with gray values above the upper threshold value are overlaid in
red.

Skip White Activated: Automatically subtracts the highest value of the gray dis-
tribution. The settings for the upper threshold value are deactivated.

Show thresholds Only visible if the Show All mode is activated.


Activated: Shows the threshold values as colored overlays in the
original image.

9.4.1.6.2 Histo View Tab

Here you can configure the display for the Histo view.

Show section

Parameter Description
Statistic table Activated: Shows the table containing the statistical values in the im-
age area.

Int. Measurement Activated: Shows the measurement data table below the original im-
age.

Frequency Table Only visible if the Show All mode is activated.


Activated: Shows the table containing the raw data for each chan-
nel.

Image Only visible if the Show All mode is activated.


Activated: Shows the original image in the image area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1007


9 Reference | 9.4 Image Views ZEISS

Channel section
Here you can activate or deactivate the histograms for each channel.

X/Y Axis section


Only visible if the Show All mode is activated.
Here you can determine the limits for the X axis and Y axis.

Parameter Description
Auto Sets the limits for the axes automatically.

Norm Normalizes the histogram display to the maximum values of the distri-
bution.

Fixed Enter the min/max values for the histogram display in the Min/Max
input fields.

Logarithmic

Channel Transparency section

Parameter Description
Channel Trans-
parency

Data Table section


Click on the Create button to create a data table from all the measured values displayed. To save
the table, click on the Save As button.

New Image From section


Here you can create a new image document. Select the type of image from the dropdown list. To
save the image, click on the Save As button.

9.4.1.7 Measure View

In this view measured values from images are displayed in a table. The table is only visible if there
are annotations/measured values in the image. To highlight the row of the table containing the
measured values of a graphic element, click on a graphic element in the image. To highlight a
graphic element in the image, click on the measured value in the row of the table.

9.4.1.7.1 Measurement Tab

Here you can specify how to draw the graphic elements for measurements into an image and
how the measurement data are displayed. You can also add user-specific features to individual
graphic elements.

Graphic Elements Section


Only visible if the current image is a multidimensional image.
Here you can decide, whether to draw a graphic element "globally" into all channels, Z-positions,
time points, etc., or whether to draw in separate elements for the view currently displayed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1008


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Channel Activated: Activates the Single Channel mode. Only draws graphic el-
ements into the channel currently displayed.

Time Activated: Only draws graphic elements into the time point currently
displayed.

Z-Position Activated: Only draws graphic elements into the Z-position currently
displayed.

Copy in All Follow- Activated: Draws a new graphic element into the view currently dis-
ing played and into all subsequent time points or Z-positions.

New Feature section


Here you can add a defined feature to the selected graphic element.

Parameter Description
Name Here you can enter a name for the feature.

Value Here you can enter the desired value for the current graphic element.

Unit Here you can enter the desired unit for the feature.

Add Adds the feature. The measurement data table is expanded to include
this feature.

Remove Removes the selected feature.

Data Display section


Here you can specify how you want the measured values for the drawn-in graphic elements to be
displayed.

Parameter Description
Format

- Table Displays the measured values in a row of a table. As you can specify
the features individually for each graphic element, the number of col-
umns containing measured values may differ from graphic element to
graphic element (i.e. from row to row).

- List Displays each measured value in a separate row. The measurement


data table then has the following defined columns:
§ Name: Name of the graphic element (e.g. line).
§ Feature: Name of the feature (e.g. distance).
§ Value: Value of the feature.
§ Unit: Unit of the feature (e.g. µm).

Current View Only displays the measured values of the current view.

All Views Displays all measured values contained in the image.

Create Document Creates a measurement data table from the measured values dis-
played. The table is saved as a separate document.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1009


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Export Tempera- Only visible for cryo images with temperature data.
ture Data
Opens the temperature data as a table in ZEN.

9.4.1.8 Info View

The Info View allows you to display extensive information about your image. Using the
buttons in each of the sections you can show additional fields in the sections or hide fields that
are currently showing. To show or hide individual sections, click on the button to the left of
the headings for each of the sections.

Info

The Info View only shows the fields that actually contain data. Using the buttons in
each of the sections you can show additional fields. To do this, activate the corresponding
checkboxes in the context menu.

9.4.1.8.1 General Section

Parameter Description
Title Here you can enter a title for your image.

Description Here you can enter a description for your image.

Comment Here you can enter a comment.

Keywords Here you can enter keywords for your image.

Rating Here you can enter a rating for your image. To enter a rating, click on
the star icons.

9.4.1.8.2 File Information Section

Parameter Description
Name Displays the file name of the image without file extension.

File Type Displays the file type of the image.

File Path Displays the location where the image is saved in your file system.

File Size Displays the file size of the image.

Created Displays when the image was created.

Modified Displays when the image was last changed.

User Displays the name of the user. You can enter the user name in the
Tools > Options > User [} 844].

Compression Displays the compression method.


Method

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1010


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Compression Qual- Displays the compression quality.
ity

9.4.1.8.3 Image Dimensions Section

Parameter Description
Time Series Displays how many time points the image contains. The value in
brackets shows the full duration of acquisition.

Z-Stack Displays how many z-planes the image contains. The value in brackets
shows the full size of the z-stack.

Channels Displays how many channels the image contains.

Tiles Displays how many individual images (tiles) the image is composed of.

Scaling (per Pixel) Displays the scaling per pixel.


Edit button:
Opens the Edit Scaling dialog [} 1012].

Image Size (Pixels) Displays the image size in pixels. The first number indicates the hori-
zontal dimension and the second the vertical dimension.

Frame Store Reso- Displays the frame store resolution, the pixel size of a single tile for
lution SEM images.

Image Size (Scaled) Displays the scaled image size. The first number indicates the horizon-
tal dimension and the second the vertical dimension.

Bit Depth Displays the bit depth of the active image, e.g. 24 Bit. The bit depth
depends on the camera settings when acquiring the image.

Stage Position Displays the stage position. Within the image this is the center point.
In the case of tile images this is the center point of the first tile.

Scanning Mode Displays the scanning mode. This can either be the image field, an im-
age line or a pixel.

Scanner Zoom Displays the zoom factor. The value 1 corresponds to the standardized
image field of all confocal systems.

Rotation Displays the rotation of the image field around the optical axis.

Crop Offset Displays the shift of the scanned region from the center of the image.

Pixel Time Displays for how long the emission signal is collected per pixel. This is
the so-called integration time.

Line Time Displays how long the system needs to scan an image line.

Frame Time Displays how long the system needs to scan the image field displayed
in X and Y in full.

Averaging Displays the number of individual measurements per image or line.


The average of the individual measurements produces the pixel inten-
sity values for the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1011


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Image Center Posi- Displays the stage position of the most central pixel in the image for
tion an x/y stage.

ROI Center Offset Indicates the offset of the scan field relative to the maximum scan
field.

9.4.1.8.3.1 Edit Scaling Dialog

The Edit Scaling dialog is divided up into table form. The columns contain the Scaling Factor
and Scaling Unit and the rows the dimensions.

Parameter Description
Scale Factor Sets the desired scaling factor in the input fields.

Scale Unit column Selects the desired scaling unit from the dropdown list. The met-
ric units Meter, Centimeter, Millimeter, Micrometer,
Nanometer and Picometers are available as options, as well as
the imperial units Inch and Mil.

Row X Shows the scaling in the horizontal direction.

Row Y Shows the scaling in the vertical direction.

Row Z Shows the scaling in the 3rd dimension. This is usually the focus
direction.

Info
Row Z for the third dimension is only displayed if the image has a third dimension.

9.4.1.8.4 Acquisition Information Section

Parameter Description
Acquisition Start Displays the date and time when the acquisition of the image
took place.

Microscope Displays which microscope was used to acquire the image.

Objective Displays which objective was used to acquire the image.

Optovar Displays which Optovar was used to acquire the image.

Zoom

Total Magnification (Eye-


piece)

Filters

Beam Splitter Displays which beam splitter was used to acquire the channel.

Lasers

Calibration Marker Posi-


tions

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1012


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Aperture size

Magnification

Accelerating Voltage

Working Distance

Scan Speed

Probe Current

Specimen Current

Brightness

Contrast

Noise reduction

Tracks

Reflector Displays which reflector cube was used to acquire the image.

Beam Splitter

Filter Ex. Wavelength

Filter Em. Wavelength

Contrast Method Displays the contrast technique. In transmitted light this is the
condenser setting, while in reflected light it corresponds to the
selected reflector cube.

Ligth Source

Ligth Source Intensity Displays the lamp intensity with which the image was acquired.

Illumination Wavelength

Pinhole Displays the diameter of the pinhole.

Laser Wavelength

Laser Blanking Blanking of the laser during scanner movement without acquisi-
tion.

Stokes Vector

Laser Attenuator State

Scan Mode

Rotation

Crop offset

Pixel Time

Line Time

Frame Time

LSM Scan Speed

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1013


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Scan Direction

Line Step

Averaging

Averaging Mode

Averaging Method

VivaTome Grid

VivaTome Reflector

VivaTome Beam Splitter

VivaTome Filter Ex. Wave-


length

VivaTome Filter Em.


Wavelength

Channels

Channel Name Displays the name of the channel.

Channel Description Here you can enter a description of the channel. Describe the ex-
act use of the channel or what can be seen in this channel.

Dye Name Displays the name of the dye.

Channel Color Displays the pseudo color allocated to the channel.

Emission Wavelength Displays the main emission wavelength of the channel or dye
used.

Excitation Wavelength Displays the main excitation wavelength of the channel or dye
used.

Effective NA

Detection Wavelength

Imaging Device

Camera Adapter Displays which camera adapter was used to acquire the image.

EM Gain Displays the factor by which the camera signal was increased.

Exposure Time Displays the exposure time with which the image was acquired.

Depth of Focus Displays the depth of focus. This is calculated according to the
following formula: Depth of field = (2 * n * λ) / (NA)² = (2 * re-
fractive index * emission wavelength) / (numerical aperture)²

Section Thickness Displays the thickness of the optical section.

Binning Mode Displays whether binning was applied during acquisition and
how much.

Detector Type Displays which detector was used for acquisition.

Detector Gain Displays the gain setting of the detector for acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1014


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Detector Digital Gain Displays the digital gain of the detector during acquisition.

Detector Offset Displays the offset settings of the detector during acquisition.

HDR Processing

Airyscan Mode

Info
In the case of multichannel images the channel-dependent information is saved in a table.
Here the sorting of the individual information fields may differ.

9.4.1.8.5 Direct Processing Section

This section is only visible if your image was processed with Direct Processing.

Parameter Description
Processing Func- Displays the name of the function which was used for Direct Process-
tion ing.

Completed Displays the date and time when the processing was finished.

Duration Displays the duration of the processing.

9.4.1.8.6 Deconvolution Information Section

This section is only visible if the image was processed with Deconvolution. The displayed param-
eters depend on which algorithm was used.

Parameter Description
Algorithm Displays which algorithm was used for processing.

Elapsed Time Displays how long the processing took.

Aberration Correc- Displays what/if aberration correction was used for processing.
tion

GPU Acceleration Displays what/if GPU acceleration was used for processing.

Optimization Displays the optimization which was used for processing.

Quality Threshold Displays the quality threshold which was used for processing.

Normalization Displays the normalization method which was used for processing.

Strength Displays the normalization strength which was used for processing.

Stack Correction Displays what/if stack correction was used for processing.

Regularization Displays the regularization which was used for processing.

Likelihood Displays the likelihood calculation which was used for processing.

PSF Displays the PSF which was used for processing.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1015


9 Reference | 9.4 Image Views ZEISS

Parameter Description
-> Clipboard Saves the parameters to the clipboard. For reuse of parameters for
new processing, see also Step 4: Info View and Re-Using Deconvo-
lution Parameters from a Processed Image [} 600].

Convergence His- Displays the convergence history graph.


tory

9.4.1.8.7 Slide Label and Preview Section

If your image document contains a label and preview image, the images are displayed in this sec-
tion.

Parameter Description
Copy Label Image Creates and opens a new image document containing the label im-
age.

Rot. Left Rotates the label image left.

Rot. Right Rotates the label image right.

Copy Preview Im- Creates and opens a new image document containing the preview im-
age age.

9.4.1.9 Tree View

The Tree View is visible only if you have activated the Enable Tree view checkbox under Tools
> Options > Documents. The checkbox is deactivated by default.
The tree view shows a detailed list containing all meta data of the selected image.

9.4.2 Specific Image Views

These image views are only visible if the image has corresponding features. The Split view, for ex-
ample, is only visible for multichannel images.

9.4.2.1 Lambda View

In this view you can display images that are acquired in Lambda mode, see Lambda Mode. the re-
sulting images are called Lambda stacks. For that type of image the 2D View is not available.
Instead the Lambda View displays a Lambda Stack in a wavelength-coded color view as default. A
color palette, mimicking the emission wavelength of the channel, is automatically assigned to the
individual lambda images which are then displayed in a merge-type display.
On Display tab, the channel-specific settings of brightness, contrast and gamma can be handled
as described for channels in the 2D View.
In order to use other views (e.g. Split or Gallery view) or to view lambda stack data sets in ZEN
black, convert the data set using the Convert to Lambda image processing function.
The general view options on Dimension tab are adapted to the Lambda View with the following
changes:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1016


9 Reference | 9.4 Image Views ZEISS

Fig. 74: Dimensions tab changes for Lambda view

Parameter Description
Channels Displays the single channels of a Lambda stack image as a colored
button. You can handle the channels like in the 2D View. E.g. if you
click on a channel button you can show or hide the channel in the im-
age area.

Lambda Coded Activated: All channels are displayed as a merged image. Each chan-
nel is assigned to a channel color that represents the recorded emis-
sion wavelength in the lambda stack.
Deactivated: Only one channel of the Lambda Stack is displayed
without pseudo coloring. Additionally the Single Channel checkbox
is activated and cannot be changed. To display a different channel of
the Lambda Stack, click on the according channel. This will display the
chosen channel and deactivate the previously displayed channel.

9.4.2.2 Ortho View

Only visible for Z-stack images.


In this view (orthogonal section) you can analyze your Z-stack images. Here, in addition to the top
view (X/Y axis), you will also see the section views of the X/Z axes (top) and Y/Z axes (right).

See also
2 General View Options [} 1029]

9.4.2.2.1 Ortho View for Airyscan Images

Airyscan multiplex images can be directly viewed during acquisition in 3D ortho view.
Select the Ortho view tab to switch to this display mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1017


9 Reference | 9.4 Image Views ZEISS

In Ortho Display, you can adjust the areas which are sectioned for the 3D view.

Ortho Display can be combined with Airyscan SR preview processing.


To activate the preview, click on the SR button in the Airyscan tab.

Ortho Display also allows to display a Maximum Intensity Projection (MIP) in all 3 directions.
Activate the Maximum Intensity Projection (MIP) checkbox to activate this view. It is recom-
mended that only fully acquired stacks are viewed with this function.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1018


9 Reference | 9.4 Image Views ZEISS

The result is a brighter XY image, and a very bright XZ and YZ view. This is because very many
slices are projected here. It might also occur that the XZ and YZ view show stripes. This is due to
the preview processing and often disappears once the full datastack was processed and saved.

9.4.2.2.2 Ortho Display Tab

Parameter Description
Cut Lines Sets the positions (pixel values) for the section lines using the X/Y/Z
sliders or input fields.
Alternatively you can also adjust the positions directly in the image
area. To adjust the positions, move the mouse over a section line in
the image. Hold down the left mouse button and move the mouse.

- Mid Positions the relevant slider at the center of the view.

Line Width Only visible if the Show All mode is activated.


Enter the thickness of the section lines in pixels using the sliders or in-
put fields. This results in a maximum intensity projection being dis-
played over the selected pixel width.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1019


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Cut Line Opacity Only visible if the Show All mode is activated.
Here you can enter the degree of opacity of the section lines from 0%
(invisible) to 100% (completely opaque).

Maximum Inten- Activated: Displays a maximum intensity projection (MIP) across all
sity Projection planes for all 3 views. The section lines are hidden and the control ele-
(MIP) ments that are not relevant in this view are deactivated.

Measure 3D Dis- Only visible if the Show All mode is activated.


tance Activated: Activates the 3D distance measurement. The Set Start
and Set End buttons and the Distance display field are visible.
To set a starting point for the measurement, navigate the cutlines to
the desired starting point and click on the Set Start button. The Set
End button will become active. To set an end point for the measure-
ment, navigate the cutlines to the desired end point and click on the
Set End button. The pixel coordinates of the measurement points are
displayed next to the buttons. The measured distance is displayed in
the Distance display field.

New Image Creates a new image document. Select the desired view from the
dropdown list (only in Show All mode). To save the image, click on
the Create button.
The resulting image contains the image data in the same dynamics
(bit depth) as the original image and consists of the same number of
channels (in the case of multichannel images) or time points (in the
case of time lapse images) as the original image, but only contains the
Z-plane currently displayed.

9.4.2.3 Pol View

This view displays the individual polarization channels of your image as a multi image view.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1020


9 Reference | 9.4 Image Views ZEISS

1 Image View
Groups the acquired channels based on the contrast method and displays them in sepa-
rate image containers. Every polarization channel (xPol, pPol, cPol) is displayed in each
own container as well as brightfield and fluorescence channels (e.g. if there are several
brightfield channels, they are all dispalyed in one brightfield container). In the Pol View
Display Tab [} 1021] you can toggle the display of the individual contrast methods.

2 View Options
Here you have the general view option of the Dimensions Tab [} 1029] and Display Tab
[} 1043] which both control the settings of the currently selected image container. Addi-
tionally, you have the view specific controls on the Pol View Display Tab [} 1021].

9.4.2.3.1 Pol View Display Tab

Parameter Description
Channel buttons Toggles the visibility of the individual channels of the image.

Angle Displays the polarization angle.

– Not available, if rotation is connected with the synchronisation.


Plays the angle automatically.
Play

Player Speed Sets the speed for the player.

Synchronize Rota- Activated: Synchronizes the fading and the rotation for all channels.
tion

9.4.2.4 Split View

Only visible for multichannel images and not during the acquisition of LSM images.
In this view you see all channels of a multichannel image. The channels are displayed side by side,
in the channel colors that have been assigned to them. You also see the mixed image view in
which all the channels are overlaid.

Info
By double-clicking on an acquired multi-channel image, you can switch quickly to the 2D view.
Double-clicking on the image in the 2D view switches you back to the Split view. If you dou-
ble-click on one of the displayed channels, only this channel will be shown in 2D View.

See also
2 2D View [} 990]
2 General View Options [} 1029]

9.4.2.5 Unmix View

This view is only visible for multi-channel fluorescence images. It is used to:

§ display the spectra corresponding to defined ROIs (mean ROI intensity over the wavelength),
§ show the intensity values in table form, copy the table to clipboard or save the table as a text
file and
§ generate linear unmixed multi-channel images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1021


9 Reference | 9.4 Image Views ZEISS

In this view you see two areas as default. The intensity-over-wavelength diagram (1) to the left
and the image display (2) to the right. Below the image area you have the specific view options
(3).

9.4.2.5.1 Unmix Tools Tab

Here you can select various tools and use these to draw graphic elements into your images, simi-
lar to the tool bar on the Graphics tab. You can also obtain an overview of the graphic elements
that you are using in your image.
The following list describes the specific parameters for this tab:

Parameter Description
Toolbar Using the tools you can draw in certain regions of interest which are
then displayed in the intensity-over-lambda diagram and will be used
for linear unmixing.

- Use this to select the graphic elements in the image area. If you are
currently in another mode, you can switch back to the selection mode
Select
using this button.

- Use this to create an identical copy of the last graphic element drawn
in by simply clicking anywhere into the image area. To exit this mode,
Clone
either switch back to the selection mode or press the ESC key.

- Draws a rectangular Region of Interest (ROI) into the image.


Draw Rectan-
gle

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1022


9 Reference | 9.4 Image Views ZEISS

Parameter Description
- Use this to draw in a circle. This element by default also shows the
mean gray level of the image region.
Draw Circle

- With this tool you can draw a elliptical region.


Draw Ellipse

- Use this to draw in a freely selectable contour. You can either define
the corner points by a series of clicks or you can trace a contour by
Draw Spline
keeping the left mouse key pressed. Close this contour by right-click-
Contour
ing. Corners are always rounded with this tool. This element by de-
fault also shows the mean gray level of the image region.

- With this tool you can draw a polygonal region.


Draw Polygon

- With this tool you can draw a cross marker into the image, where the
Draw Cross pixel at the center of the cross is taken for the unmixing measure-
ment.
Note: The 10x10 pixel rectangle around the cross is only a visual aid
to locate the marker, the unmixing is only taking the one pixel at the
center into account and not this rectangular bounding box.

List of Spectral The list gives you an overview of the spectral data in the image, which
Data will be used for linear unmixing. The names indicates the origin, e.g. if
manually or automatically picked by ACE (see below) or loaded from
the spectra database.
To load a spectrum from the spectral database, press the Add + but-
ton for a new row. Click into the Name column and select the accord-
ing name for the needed spectrum.

Save to spectra If you click on this button you can save the selected entry to the spec-
database tra database.

Auto find/ACE... ACE stands for Automatic Component Extraction.


If you click on this button the software automatically searches for re-
gions with distinct spectral signatures and tries to find the defined
number of spectra.

Linear Unmixing Performs the linear unmixing processing of the image with the se-
lected spectra. Note: The channels of the multichannel image which
are de-selected in the Dimensions tab are not included in the calcula-
tion.

Widefield Only visible if the number of spectra is equal to the number of chan-
Crosstalk Removal nels in the image. This option allows Unmixing to be performed on
multichannel fluorescence images created without a spectral detector.
Typically this would be multichannel images acquired with a filter
based multichannel microscope system. In this case, the function will
automatically create the same number and type of channels present in
the input image for the output image of the Unmixing function.
Activated: Removes the crosstalk of widefield channels and ensures
that the channel information (emission and excitation wavelength)
and metadata of the input image are copied to the output image.
Note that the function tries to automatically identify which channel
matches which spectrum. If this fails, the function assumes that the
order of spectra matches the sequence of the channels.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1023


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Show Table Activated: Displays a table of intensity values over wavelength below
the default image area.

Normalize for dis- Activated: Normalizes the graphs of the spectra to 1.


play

Subtract back- Here you can select the list entry of a marked spectrum that should be
ground subtracted before linear unmixing.

Auto scale Activated: Automatically balances the intensity of unmixed channels


to equal levels.

Create residuals Activated: Generates an additional channel in which the intensity


channel value represent the difference between the acquired spectral data and
the fitted linear combination of the reference spectra for each pixel.
In essence, the residual value is the biggest remaining "residual" from
the least square fit routine. The residuals are a general measure for
how good the fit of the algorithm has performed.

Channel

- Raw The raw data acquired during a lambda stack is used as channels and
for spectral display.

- Spectral The intensity data of the lambda stack is calculated into channels for
each detector (Channel 1 and Channel 2).

9.4.2.5.2 Chart Options Tab

This tab provides several parameters to change the appearance and contents of the spectral
graph. For the beginning we recommend to use the default settings here.

Parameter Description
Line Interpolation Selects how the line in the diagram is interpolated. You can select
Line or Bezier.

Pattern Selects the line pattern.

Weight Selects the thickness of the line.

Area Appearance Selects the pattern type of the area below the line. The slider on the
right sets the opacity for the area.

Show Marker Activated: Displays the markers of the inflexion points of the spectral
graph.

– Auto Displays the markers with automatically selected settings.

– Fixed Enables you to select Form and Size of the markers manually.

Show Series Val- Activated: Displays the intensity values at the inflexion points of the
ues spectral graph. You can also select how the number should be dis-
played:
§ Above Horizontal
§ Above Vertical

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1024


9 Reference | 9.4 Image Views ZEISS

Parameter Description
§ Inside Vertical
§ Stacked

Decimal Places Only visible if Show Series Values is activated.

– Auto Automatically selects the number of decimal places for the series val-
ues displayed in the diagram.

– Fixed Enables you to select the number of decimal places manually.

– With Trailing Activated: Displays the values with trailing zeros.


Zeros

Y-Axis Selects the scaling of the y-axis. You can select Auto, Norm, or Fixed
scaling.

– Min/Max Only visible if Fixed is selected.


Sets the fixed minimum and maximum value for the y-axis.

9.4.2.6 SMLM View

This view becomes available after Localization Microscopy processing of a 2D- or 3D-SMLM
dataset or during online processing of a 2D-SMLM or 3D-SMLM acquisition. The displayed image
is a vector map of plotted localizations (centroids) that are by default Gauss rendered.

See also
2 Lattice SIM Family [} 1302]
2 General View Options [} 1029]
2 Center Screen Area [} 26]

9.4.2.6.1 Molecule Table

This tab enables you to view statistical parameters associated with each peak or object.

Parameter Description
Index Assigns a number to each peak/object.

First Frame Displays the number of the frame in which the peak/object appears
for the first time.

Frames Missing Displays the number of frames a peak/object was missing. For un-
grouped data this will always be 0.

X Position [nm] Displays the position in nm of a peak/object in the X direction with


the origin at the upper left corner of the image.

Y Position [nm] Displays the position in nm of a peak/object in the Y direction with


the origin at the upper left corner of the image.

Z Position [nm] Displays the position in nm of a peak/object in the Z direction with the
origin at the lowest z-plane (for 3D SMLM data sets only).

Precision [nm] Displays the calculated localization precision of a peak/object in nm in


x and y.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1025


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Precision z [nm] Displays the calculated localization precision of a peak/object in nm in
z.

Photons Displays the total number of photons of a peak/object.

Background Vari- Displays the variance of the number of background photons.


ance

Chi Square Displays the X2 value of the Gauss fit for the localization precision.

PSF Width [nm] Displays the width (1/2 FWHM) of the point spread function (PSF) cal-
culated from the Gauss fit in x,y (displayed for 2D data sets only).

Channel Indicates the designation of the channel by a number.

Z Slice Indicates the slice of a multi-stack experiment (3D SMLM data sets
only).

9.4.2.6.2 SMLM Statistics Tab

This tab enables you to view statistical parameters associated with each peak or object.

Parameter Description
Show Molecule Ta- Activated: Displays the localized molecules in a table in the image
ble area, which lists each peak (for ungrouped data) or object (for
grouped data).

Show Statistic Plot Activated: Displays a histogram or scatter plot of the parameter se-
lected as Histogram Source.

Histogram Source Selects the parameter that should be plotted in the histogram. All pa-
rameters listed in the Molecule Table are available. The selected pa-
rameter is plotted versus its frequency.

Histogram Range Sets the Quantil level for the data. The histogram is rescaled in a way
that only those x-values are displayed that accommodate the input %
value of the data starting from 0. Hence outliers with high values can
be removed from the display.

9.4.2.6.3 SMLM Filter Tab

This tab enables you to filter parameters regarding their values. Activate the respective checkbox
to activate the filter.

Parameter Description
Localization Preci- Enables you to filter for the calculated localization precision of a peak/
sion [nm] object in nm in X, Y (min=1, max = 500).

Localization Preci- Only available only for 3D data sets.


sion Z Enables you to filter for the calculated localization precision of peak/
object in Z (min = 1, max = 500).

Number of Pho- Enables you to filter for the total number of photons of a peak/object
tons (min = 1, max = 10000).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1026


9 Reference | 9.4 Image Views ZEISS

Parameter Description
First Frame Enables you to filter for the number of the frame in which the peak/
object appears for the first time (min = 1, max = number of frames of
the time series).

PSF Width [nm] Only available for 2D SMLM data sets.


Enables you to filter for the width of the point spread function (PSF)
calculated from the Gauss fit which corresponds to ½ FWHM (min =
1, max = 500).

Background Enables you to filter for the variance of the number of background
photons (min = 1, max = 5000).

Chi Square Enables you to filter for the X2 value of the Gauss fit for the localiza-
tion precision (min = 0, max = 100).

Position Z [nm] Only available for 3D SMLM data sets.


Enables you to filter for the position in nm of a peak/object in the z-
direction with the origin at the lowest z-plane (min = 0, max = defined
by the number of slices from the SMLM-Render menu).

9.4.2.6.4 SMLM Rendering Tab

This tab enables you to set the display of the data.

Parameter Description
Pixel Resolution Sets the size of the pixel in x, y in nm of the SMLM image.
XY [nm/pixel]

Z-Slice Thickness Sets the size of the voxel in z in nm of the SMLM image.
[nm/pixel]

Display Mode Selects the mode how the SMLM channel is displayed.

– Gaussian Ren- Localized peaks/objects are displayed with the localization error and
derer rendered to a Gauss function. The higher the precision, the smaller
the width of and the brighter the peak/object. Note that areas with
higher molecule densities are also brighter.

– Molecule Den- Number of peaks/objects per area (in μm). Associated with the Molec-
sity ular Density map is a scale bar that shows the color code of molecule
density in Molecules/μm2 according to the SMLM channel assigned
look up table (LUT).

Expansion Factor The set number will be multiplied with the PSF (localization precision
[xPSF] error), so the rendered peaks/objects get smaller for numbers < 1 and
bigger for numbers > 1 in X, Y and Z. A warning is displayed if the
slider value drops below 0.71 as the data will be rendered more accu-
rately than common fitting routines would allow.

Render Automatic Activated: The set value indicates the Quantil, up to which percent-
Range SR [%] age of data (stating with the lower values) will be displayed. The input
number therefore sets the threshold for the maximum range, so the
super-resolution (SR) image will be fully scaled from 0% to input num-
ber %. Higher values out of the input range would be displayed as
saturated pixels.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1027


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Extract to Image Converts the vector map of Gus rendered centroids to a bona fide
“.czi” image using pixel/voxel sizes as set in Pixel Resolution XY and
Pixel Resolution Z.

9.4.2.6.5 SMLM Drift Correction Tab

This tab enables you to perform a model based drift correction on the SR image.

Parameter Description
Apply Drift Correc- Only available if Calculate Correction has been executed.
tion in X/Y Activated: Applies the drift correction in X and Y to the image.

Apply Drift Correc- Only available if Calculate Correction has been executed.
tion in Z Activated: Applies the drift correction in Z to the image.

Show Drift Dia- Only available if Calculate Correction has been executed.
gram Activated: The drift in x, y and z direction versus the frame number
(time) is displayed as separate graphs in the drift diagram.

Calculate Correc- The software identifies a linear drift on sample structures on behalf of
tion redundant correlation and uses them to automatically correct for this
drift. The correction vector calculated from the average of all struc-
tures is then applied to the SMLM image (SR channel).

Segments Sets the number of segments used in the model based drift correc-
tion. The number of frames of the SMLM time series within each seg-
ment is determined by the total number of images divided by the
number of segments rounded up or down to obtain integer numbers.
Hence the last segment might contain less, equal, or more frames
than the preceding segments. The drift correction is performed for
each segment separately and then the drift between the segments is
corrected.

Copy to Clipboard Only available if Calculate Correction has been executed.


Copies drift data, i.e. x, y and z positions versus time, to the clipboard.
The copied drift table can then be opened in external software like
Microsoft Excel.

9.4.2.6.6 SMLM Grouping Tab

This tab enables you to assign and group identified peaks to one object (molecule).

Parameter Description
Max On Time Sets the maximum number of frames that peaks within the defined
capture radius are allowed to be detected to be considered to belong
to one molecule. If peaks at the same location are found in more con-
secutive frames, then all peaks are discarded.

Off Gap Sets the maximum number of frame peaks within the defined capture
radius that can be missing in order that the peaks are regarded to be-
long to the same molecule. If the defined number is exceeded, then
the peaks will be sorted to two molecules and not grouped.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1028


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Capture Radius Sets the maximum radius in pixels (as defined by the set rendered lo-
calization precision in x,y and z) within which peaks of consecutive
frames must lie in order to be regarded to belong to the same mole-
cule.

Group Groups events according to the set parameters.

Ungroup Only available if a grouping was performed.


Ungroups grouped events.

9.4.3 General View Options

The general view options are visible in any view.

9.4.3.1 Dimensions Tab

Here you configure the settings for how the image is displayed on the screen. You can select the
size of the display and call up information about the content of the image. In the case of multidi-
mensional images you can select here which dimension is displayed. The dimension sliders (e.g.
time, channels) help you to navigate through the single images of an experiment.
Note: The displayed settings in the tab depend on the image and experiment. Also the settings of
this tab in the 2D and 3D Correlative Workspace viewer are limited and/ or different compared to
the normal ZEN image view.

9.4.3.1.1 Slider Section

Depending on how many dimensions your image contains, several sliders are available in this sec-
tion. With the sliders you can adjust the currently displayed position for each dimension of the im-
age. The currently displayed can be seen and also set in the input field next to the slider.

Fig. 75: Slider Section (example)

The Play buttons to the right of the input fields enable you to play back the dimension au-
tomatically. This takes place at a rate of 5 images per second by default. You can change the
speed on the Player Tab [} 1034].

Info
For images with more than 3 dimensions, a scrollbar is displayed which you can use to access
the other sliders.

Depending on the available dimensions, the following sliders can be visible:

Parameter Description
Follow Acquisition By activating the Follow Acquisition checkbox during acquisition of
multi dimensional experiments (time series, tiles and z-stacks) the ac-
tual image is displayed (default value).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1029


9 Reference | 9.4 Image Views ZEISS

Parameter Description
By moving the Time slider in the Dimensions tab, this feature is dis-
abled and a button for performing a manual update of the slider
range is shown.

Update Only visible if Follow Acquisition is deactivated.


Triggers a manual update of the acquired image during the running
acquisition.

Z-Position Only visible in the case of z-stack images.


Here you can adjust the desired z-position.

X-Position Only visible for images acquired in Line scan mode.


Here you can adjust the desired x-position.

Time Only visible in the case of time series images.


Here you can adjust the desired time point.

Scene Only visible if the image contains different scenes.


Adjusts the desired scene. If you deactivate the Scene checkbox, all
scenes are displayed in an overview.

Phase Only visible for image acquisition with phases in Structured Illumina-
tion Microscopy (SIM).
Adjusts the desired phase position.

Global-Z Only visible for ZEN Connect projects with at least one z-stack.
Sets the global value for the displayed z-slices. The range of the slider
is defined by the z values of all stacks in the project.
Note: When you use the Global Z slider and are beyond the range of
a certain image, only a frame for this image is displayed to show
where the image is positioned.

Block Only visible if you have used the Experiment Designer and created
several experiment blocks.
Adjusts the desired experiment block.

Total Time Only visible if you have used the Experiment Designer.
Adjusts the duration across all blocks.

Phase Only visible for ApoTome images and if on the Apotome Tab [} 1046]
the Display Mode is set to Raw Data.
Selects the various phases of the raw images.

9.4.3.1.2 Zoom Section

This section contains tools to adjust the size of the displayed image region.

Parameter Description
Automatically sets a zoom factor at which the entire image can be
displayed visibly on the screen. Alternatively, you can use the shortcut
Fit to View
Ctrl + 0.

Shows the image without increasing or decreasing the zoom factor.


One pixel of the image corresponds to one pixel on your screen. Alter-
Normal View
natively, you can use the shortcut Ctrl + 1.
(100%)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1030


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Decreases the zoom factor. Alternatively, you can use the shortcut
Ctrl + F8.
Decrease Zoom

Increases the zoom factor. Alternatively, you can use the shortcut Ctrl
+ F7.
Increase Zoom

Here you can set the display size steplessly. The desired zoom factor
Zoom factor can be entered in the input field in percent.

Auto-Fit Activated: Adjusts the display size automatically and continuously to


the size of the window.

Synchronize View Only available for the Tomo3D view.


Area of 2D Panes Activated: Synchronizes the zoom and position for the individual 2D
image views.

9.4.3.1.3 Tools Section

Parameter Description
Activates the selection mode. Use this to e.g. select a graphic element
in the image.
Selection

Activates the zoom mode. Hold down the left mouse button and drag
out a selection rectangle. When you release the left mouse button,
Zoom Rectangle the region within the rectangle is displayed in enlarged form.
If you have a mouse with a mouse wheel, you can also use this to
move enlarged/reduce image regions.

Activates the move mode. Left-click inside an enlarged image to move


the zoomed region.
Move If you have a mouse with a mouse wheel, position the mouse pointer
inside the image region and press and hold the mouse wheel. The
mouse pointer then appears automatically as a hand icon. You can
now move the image region.

Only visible in Gallery or Multiwell view.


This function allows you to set a new zoom level for all images simul-
Inner Zoom taneously using the mouse wheel. The size of the Gallery/Multiwell
view does not change. This allows you to limit the view to one inter-
esting image region. Use the Move tool to move the view.

Activates the show values mode. If you move the mouse pointer into
the image region, a vertical arrow and a display field will appear. The
Show Pixel Values pixel values of the position to which the arrow is pointing are dis-
played in the display field.
In the first line of the display field the X/Y coordinates are displayed.
The second line displays the X/Y coordinates in scaled units. In the
other lines the gray values for each channel are shown.

Navigator Opens the Navigator window in the image area. There you will see
an overview of your image and you can navigate to different positions
using a rectangular window.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1031


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Interpolation Activated: The pixel elements of the image are shown in an interpo-
lated display. This makes it possible to avoid the pixelated display of
small or greatly enlarged images.
Deactivated: The pixel elements of the image are displayed as they
are. This function is activated by default.
You can deactivate this function in Tools > Options > Documents.

See also
2 Documents Tab [} 835]

9.4.3.1.4 Channels Section

This section contains all channels that you are using in your image. You can switch the display of
channels in images on or off and change the channel colors (pseudo color assignment).

Fig. 76: Channels section


A button is displayed for each channel. Each button has two functions:
1. The channel name is displayed in the top section. To switch a channel off/on again, left-click
on this section of the button.
2. The bottom section of the button shows the channel color. The display changes depending
on the status of the button:
§ When switched off, you see a colored line below the button.
§ When switched on, you see a color field with a dropdown list below the button. Clicking on
the dropdown list opens the color selection, see Color Selection Dialog [} 1033].

Info
For images with 8 or more channels, the Channel buttons are reduced in size. In this case it is
no longer possible to change the color channel by channel.

Parameter Description
Single-Channel Activated: Only a single channel is displayed.

Show Channel Only visible in Split view.


Color Activated: Displays the individual channels of multichannel images
with the assignment of pseudo colors.

Range Indicator Activated: Changes the display to single channel mode.


The channel is displayed in monochrome. At the same time you see
pixels that are saturated (displayed in red) and pixels that have no sig-
nal (values = 0; displayed in blue). Note that with camera systems it is
usually not possible to achieve pixel values of 0. Therefore, the blue
indicator is usually not displayed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1032


9 Reference | 9.4 Image Views ZEISS

Parameter Description
This function helps you to set your acquisition settings, camera expo-
sure or detector gain, so that saturation of the detector is avoided.
The range indicator function is not available for the sum channel of
the Airyscan.

Quick Color Setup Opens a dialog that allows you to select a color quickly for all chan-
nels of a multichannel image. The following options can be set:

- None All channels are displayed without a pseudo color.

- Grayscale All channels are displayed in monochrome (this applies in particular to


multichannel images that have been acquired using color cameras).

- BGR Channel 1: blue, channel 2: green, channel 3: red, no color assigned


to any other channels.

- GRB Channel 1: green, channel 2: red, channel 3: blue, no color assigned


to any other channels.

- RGB Channel 1: red, channel 2: green, channel 3: blue, no color assigned


to any other channels.

- Via LUT Colors for all channels are selected using a reference look-up table.
The LUT is divided up into as many sections as there are channels,
with the channel color being used at the separation point. You can
select the reference LUT using the Reference LUT button.

- Custom Opens a window to define and select custom colors.

- Dye The color of the dye used during the experiment is displayed

- Reference LUT Opens a window to select a reference LUT.

On the bottom of the tab, further controls are available:

Stage Not visible during a running continuos or live acquisition.


Activated: Displays a red cross as stage indicator over your image.
You can move the stage with the mouse by clicking and dragging the
displayed red cross in the image container.

Marks Not visible during a running continuos or live acquisition.


Activated: Allows you to define stage coordinates (marks) by clicking
into the image. The coordinates are written into the Marks table in
the Stage tool .

Selected Volume Only available in the ZEN Connect 3D View.


Selects the active volume to which the settings or transformations
should apply.

9.4.3.1.4.1 Color Selection Dialog

Here you can select a pseudo color for the selected channel. In the lower area of the dialog you
will see four buttons that offer various methods of color selection. The selected button is high-
lighted in blue. To change the method, simply click on the appropriate button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1033


9 Reference | 9.4 Image Views ZEISS

Fig. 77: Color Selection dialog

Parameter Description
Weight Sets the weighting of one channel to another channel. This is only
possible with multi-channel images.

Color Here you can choose the desired color from a default color chart. The
selected color is displayed on the color button.

LUT LUT = Look-Up Table


Here you can choose the desired color from a more complex color
look-up table.

Cust... Cust = Custom


Here you can define an own color and assign it to a color field.

None Assigns no color to the channel. Images of monochrome cameras are


black/white display. images of color cameras are displayed in real col-
ors.

9.4.3.2 Player Tab

Only visible if the Show All mode is activated.


Using the functions on this tab you can play back multidimensional images. The functions largely
correspond to the functions for playing back films.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1034


9 Reference | 9.4 Image Views ZEISS

Player Options
The following control elements are available:

Parameter Description
Plays back the image series forwards from first to last image. The di-
mensions are played back one after the other in the sequence speci-
Play
fied.

Stops the play-back of the image series.


Stop

Plays back the image series backwards from last to first image. The di-
mensions are played back one after the other in the sequence speci-
Play
fied.

Plays back the image series forwards and backwards alternately.


Play alternately

Jumps to the start of the image series.


Jump to first

Jumps to the end of the image series.


Jump to last

Parameter Description
Speed (FPS) Here you can adjust the speed at which an image series is played
back.
The speed is displayed in frames per second (FPS) in the input field.
You can also enter the desired speed directly in the input field. The
maximum play-back speed is 25 FPS.

Follow Acquisition Activated: Always displays the last acquired image during an ongo-
ing acquisition procedure, as well as the slider for the corresponding
dimension.

Dimensions Depending on the available dimension the active image a slider is dis-
played here for each dimension. Possible sliders:
§ Z-Stack
§ Time
§ Scene
§ Block

The sliders have each two adjustment handles, which you can use to
define the start and end point of the playback.
If there are several dimensions, you can determine, by activating the
corresponding checkbox, if you want the dimension to be taken into
account during the play-back.
Each slider offers as many steps as there are individual positions in the
specified dimension.
A third adjustment handle indicates the current position and cannot
be controlled directly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1035


9 Reference | 9.4 Image Views ZEISS

9.4.3.3 Graphics Tab

Here you can select various tools and use these to draw graphic elements into your images. In the
list you see the graphic elements that you have drawn in to the image.
Global Graphics In general there are two classes of graphic elements: global and custom. Each global graphic ele-
ment has a set of properties such as style or type of measurement values displayed, which can be
changed system wide for each element. Each global element can only have one formatting style
which is used every time, this element is being used. All graphic elements can be accessed
through the Graphics menu, a selection of the most important tools is also available in the
Graphics view options tab for quick access (see image below). The content of the Graphics tab
cannot be modified however.
Custom Graph- Custom graphic elements are available in the Custom Graphics tab. Here it is possible to config-
ics ure a collection of graphical elements according to personal preference. It is also possible to cre-
ate multiple copies of the same tool type with different formatting styles and measurement values
which is not possible for global graphic elements. For more information, see Custom Graphics
Tab [} 1042].

Info
Graphic elements are characterized by their formatting style, can be annotated with a free text
and can contain measurement values such as geometric or gray value measurements. Add free
text by double clicking any graphic element and typing in the desired text.

Note: You can select the graphical elements and modify them. For more information, see Editing
Graphical Elements and Measurements [} 1041].
A selection of global graphic elements to work with are available to you here. For more tools,
open the Graphics [} 822] menu.

Parameter Description
Use this to select the graphic elements in the image area. If you are
currently in another mode, you can switch back to the Selection mode
Select
using this button.

Use this to create an identical copy of the last graphic element drawn
in by simply clicking anywhere into the image area. To exit this mode,
Clone
either switch back to the Selection mode or press the ESC key.

Use this to draw in a Region of Interest (ROI) into the image.


Draw Region of In- ROI’s are only used to create subsets of images, not for annotation of
terest images. To create a subset, hold the Ctrl key pressed and move the
mouse cursor within the ROI. Then press the left mouse key and while
keeping it pressed down drag the mouse outside the ROI. A new sub-
set image document only containing the pixels within the ROI but
with all other dimensions is being created.

Use this to insert a text field into the image. With the field drawn in
start typing to add text.
Draw Text

Automatically inserts a scale bar into the bottom right corner of the
image.
Insert Scale Bar
The size is set automatically to approximately 5% of the width of the
image size. The length can be modified by selecting the scale bar in
the image and changing the length.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1036


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Use this to draw in an arrow.
Draw Arrow

Use this to draw in a rectangle that is always parallel to the edges of


the image. This element by default also shows the mean gray level of
Draw Rectangle
the image region.

Use this to draw in a circle. This element by default also shows the
mean gray level of the image region.
Draw Circle

Use this to draw in a freely selectable contour. You can either define
the corner points by a series of clicks or you can trace a contour by
Draw Spline Con-
keeping the left mouse key pressed. Close this contour by right-click-
tour
ing. Corners are always rounded with this tool. This element by de-
fault also shows the mean gray level of the image region.

Format Only active, if you have selected a graphical element in the image or
the Annotations/Measurements list.
Opens the Format Graphic Elements dialog [} 1040]. There you can
format the selected graphic element according to your preference.
Alternatively you can double-click on the list entry or right click on the
graphical element in the image and select the Format entry.

Adds a text box to the top left of the image with information on the
relative acquisition time per channel. Relative means, that the time
Relative Time
value is set to 0 at the time point, where the element is drawn in. This
makes it easier to analyze the time it took for image dimensions such
as channels or scenes to be acquired.

Adds a text box to the top left of the image with information on the
absolute acquisition time (either the image or for channel, in the case
Acquisition Time
of multichannel images).

Adds a text box with information about the relative focus position.
Relative means, that the focus value is set to 0 at the z-plane the ele-
Relative Focus
ment is drawn into. This makes it easier to interpret focus changes
when playing through the z-dimensions.

Adds a text box with information about the absolute focus position as
recorded from the focus drive of the microscope.
Focus Position

Adds a text box with information about the exposure time used by
the camera given in the format "00.000" [ss.msec].
Exposure Time

Adds a text box with the names of all the active channels.
Multi Channel
Name

Not relevant for Axioscan 7 clinical whole slide images.


Adds a text box with information on the carrier container name. This
Carrier Container
is only useful for images acquired from multiple scenes using the Tiles
Name
module. Examples are multiwell plates. With this annotation an image
can be related to the well it came from.

Keep Tool Activated: Keeps the selected tool active. This allows you to draw in
a number of the same elements one after the other.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1037


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Auto Color This parameter is only visible if Show All is activated.
Activated: Uses a new color for each element drawn in.

Snap to Pixel This parameter is only visible if Show All is activated.


Activated: Draws in the graphic elements in a way that connects
them to the image pixels. If image-pixel precise measurements shall
be done, this option must be used.
If this option is not active, the graphic elements are drawn into the
graphics layer independently of the actual image pixels.

Layers
Only visible if the Show All mode is activated.
Here you can specify which graphic element layers are active and visible in the image. To open the
shortcut menu, click on the Layers dropdown menu. Note: Whole slide images contain many dif-
ferent layers such as regions used for automatic shading correction, defined scan regions, etc.

Parameter Description
Active Layer Here you can specify which graphics layer is active in the image. The
other layers are visible but blocked. To activate a layer click on the
menu entry.

- automatic Sets the active layer automatically. This is the default setting.

- Selection Sets the Selection layer as the active layer. This layer contains graphic
elements such as ROI selection, Grid, etc.

- Annotations/ Sets the Annotation/Measurement layer as the active layer. This layer
Measurements contains most of the graphic elements which can be drawn in such as
all annotation elements or interactive measurement tools.

- Acquisition Acquisition elements are elements which have been used in experi-
ments to specify acquisition ROI’s or photomanipulation ROI’s such as
used for FRAP experiments.

Layers Here you can specify which layer is visible in the image. The other lay-
ers are not visible.

- Selection Displays the Selection layer in the image.

- Annotations/ Displays the Annotation/Measurement layer in the image.


Measurements

Table
Here you can see almost all the graphic elements that exist in your image. You can also control
the behavior of the graphic elements here, e.g. lock or hide them. You can format each graphic
element as you wish.

Info
In the list you will only see the graphic elements relating to the active graphics plane. To
change the active graphics plane, click on the Layers button. This button is only visible in
Show All mode. Select the layer that you want to display under Active Layer.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1038


9 Reference | 9.4 Image Views ZEISS

The columns of the list contain the following entries:

Parameter Description
Shows or hides a graphic element.
Visibility

Locks a graphic element to prevent changes being made.


Fix Position

Type Displays the icon for the tool type. To format a graphic element, dou-
ble-click on the icon. The Format Graphic Elements dialog then opens.

ID The parameter is only visible if Show All is activated.


Displays the ID for the graphic element. To do this, activate the
checkbox at the corresponding list entry. Note that each graphic ele-
ment has its unique ID.

A The parameter is only visible if Show All is activated.


Displays Annotations for a graphic element. To do this, activate the
checkbox at the corresponding list entry. “Annotations“ refers to all
user defined text as well as text from frequent annotations.

M The parameter is only visible if Show All is activated.


Displays Measurement data for a graphic element. To do this, acti-
vate the checkbox at the corresponding list entry.

Name Displays the name of the graphic element. To change the name, dou-
ble-click in the Name field. Then enter the text of your choice. This
can be used to label elements in your image.

Saves the selected graphic element for reusing it with other images.
Save

Loads an existing graphic element into the current image.


Load

Deletes the selected graphic element.


Delete

Dimension
The coordinates and dimensions of the selected graphic element are displayed in the correspond-
ing input fields (standard unit = image pixels):

Parameter Description
Scaled µm Activated: The dimensions are shown in scaled unit.

X Displays the X coordinate of the center point of a graphic element.


Edit the X coordinate here.

Y Displays the Y coordinate of the center point of a graphic element.


Edit the Y coordinate here.

W Displays the width of graphic elements.


Change the width here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1039


9 Reference | 9.4 Image Views ZEISS

Parameter Description
H Displays the height of graphic elements.
Change the height here.

Angle Displays the angle of rotation of graphic elements. Here the measured
angle is displayed for the graphic element Angle.
Change the angle here.

See also
2 Adding Annotations to Images or Movies [} 61]

9.4.3.3.1 Format Graphical Elements Dialog

This dialog can be called up via the menu Graphics > Format or via the Graphics view option
tab.
Note that for the Draw Region of Interest function, a reduced amount of functionalities is avail-
able.

Parameter Description
Zoom with image If activated, the size of the graphic element (e.g. line width, given in
nr. of pixels) is related to the pixel size in the image. Therefore, when
zooming into the image, the line width increases in the same way as
the image pixels.
If deactivated, the size relates to the monitor pixel size. That means
when zooming into the image, the line width e.g. does not change.

Line Here you change the line color, width and the line style (none, solid,
dashed and dotted).

Text Here you select the text font, color, size and style by selecting the ap-
propriate options. Also select the desired horizontal and vertical align-
ment from the dropdown list.
Reading direction is only active for measurement annotations of the
Line element.One direction aligns the text annotation to the edge of
the image. Two directions aligns it parallel to the line itself.

Fill Here you can adjust, if the background of the annotation should be
filled or not. Several filling options are available.

Opacity Here you can adjust the degree of opacity of the graphic element in
percent. 100% makes the graphical element completely opaque (cov-
ering the underlying image pixels), while 0% makes it completely
transparent.

Annotation Here you can change the selected annotation and add the unit.

Set as new global If you click on this button the formatting style of the graphic elements
default currently selected in the image is set to the new default.

Reset If you click on this button the formatting style of the currently se-
lected graphic element is reset to factory default.

See also
2 Graphics Tab [} 1036]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1040


9 Reference | 9.4 Image Views ZEISS

2 Adding Annotations to Images or Movies [} 61]

9.4.3.3.2 Editing Graphical Elements and Measurements

You can change the following properties of a graphical element or an interactive measurement:

§ Size and position of entire element.


§ Position of measurement result.
You can also copy, paste, and delete elements and for some tools you can change the orientation.

Moving an entire element/measurement

Prerequisite ü At least one element is visible in the Center Screen Area.


1. Select the element with the left mouse button and drag and drop it to the desired position.

Resizing an entire element/measurement

Prerequisite ü At least one element is visible in the Center Screen Area.


1. Click on the respective element.
2. Drag the sides of the bounding box.

Copying/pasting an element:

Prerequisite ü At least one element is visible in the Center Screen Area.


1. Click on the respective element.
2. Press Ctrl+C to copy or Ctrl+V to paste the selected element. Alternatively, right-click the
element and select Copy or Paste.

Rotating an entire element/measurement

Prerequisite ü At least one element is visible in the Center Screen Area.


1. Click on the respective element.
2. Select the node above the element wit the left mouse button and rotate it to the desired
position.

Deleting an entire element/measurement

Prerequisite ü At least one measurement is visible in the Center Screen Area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1041


9 Reference | 9.4 Image Views ZEISS

1. Click on the respective element.


2. Press the Del key. Alternatively, right-click the element and select Delete

Moving the measurement result


To change the properties of the measurement result:

Prerequisite ü At least one measurement is visible in the Center Screen Area.


1. Select the node by the measurement result with the left mouse button and drag it to the
desired position. Note that the node can be hard to differentiate from the bounding box of
the element.
Abc
Abc

9.4.3.4 Custom Graphics Tab

Only visible if the Show All mode is activated.


Here you can create your own preferred collection of graphic elements. You can add multiple in-
stances of the same element but assign different formats or measurement values to them. Custom
graphics should not be confused with the standard graphic elements the formatting style of
which can only be changed globally (meaning one default style per element is used system wide).
When opened for the first time, no elements exist. Click Customize to add your own graphic ele-
ments.

Parameter Description
Use this to select the graphic elements in the image area. If you are
currently in another mode, you can switch back to the Selection
Select
mode using this button.

Use this to create an identical copy of the last graphic element drawn
in by simply clicking anywhere into the image area. To exit this mode,
Clone
either switch back to the Selection mode or press the ESC key.

Customize Opens the Customize Tools dialog. In this dialog you can add up to
35 graphic elements which are organized in up to 5 tool bars. You
can make changes to their formatting style and also define which
measurement values they should show.

Keep Tool Activated: Keeps the selected tool active. This allows you to draw in
a number of the same elements one after the other.

Auto Color This parameter is only visible if Show All is activated.


Activated: Uses a new color for each element drawn in.

9.4.3.4.1 Customize Tools Dialog

This dialog is called up via the Custom Graphics view option tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1042


9 Reference | 9.4 Image Views ZEISS

Parameter Description
User Toolbar This list shows all custom graphic elements added to the Custom
Graphics tab. Select a tool and double click on it’s icon to open the
Format New Custom Graphic Tool dialog, see here [} 1040].
You can rearrange the order of elements by using the Up or Down
arrows at the bottom edge of the list. To delete a selected element
use the Delete icon at the bottom edge of the list.

Search Type in text to search for specific graphical elements.

Tools This list contains all graphical elements available. If you select an ele-
ment and double click on it, it will be added as a new entry to the top
row of the User Toolbar list. Alternatively the Button with the Plus
symbol at the bottom edge of the list can be used.

Frequent Annota- This list contains all frequent annotations available. Frequent annota-
tions tions are aligned rectangle elements preconfigured to show image
metadata such as acquisition time or focus position used during ac-
quisition.
If you select an element and double click on it, it will be added as a
new entry to the top row of the User Toolbar list. When finished,
click the Close button. The newly added elements are now shown in
the Custom Graphics tab.

9.4.3.5 Display Tab

Here you can adjust the image display. This function is particularly important if you want to dis-
play images with a very high dynamic range on the screen.
The histogram shows the brightness distribution of the pixels that are present from all channels si-
multaneously. The y-axis represents the relative frequency and the x-axis indicates the brightness.
A curve showing the corresponding distribution, the so-called display characteristic curve, is dis-
played for each channel.

Fig. 78: Display tab (Show All)


If you want to adjust the histogram for an individual channel, activate this via the relevant color
field in the Channel Selection. Alternatively you can also click on the corresponding distribution
curve directly in the histogram.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1043


9 Reference | 9.4 Image Views ZEISS

Display characteristic curve


Each channel has a display characteristic curve. Using the display characteristic curve you can set
the limit for the black value (left) and the limit for the white value (right). This allows you to influ-
ence the contrast in the image. Move the mouse pointer over the corresponding adjustment han-
dles at the bottom edge of the display histogram or to the small rectangles on the display charac-
teristic curve. Hold down the left mouse button and move the adjustment handles or rectangles
as required.
The curvature of the display characteristic curve influences the gamma value. To change the cur-
vature, move the mouse pointer to the second or fourth small rectangle on the display character-
istic curve. Hold down the left mouse button and move the rectangles up or down. The setting is
used immediately for the display. Using the middle rectangle you can move the whole display
curve. This changes the brightness of the image.
Note that some of the functionality is only visible if the Show All mode is activated!

Parameter Description
Only visible for multichannel images.
Here you can select for which channel you want to adjust the display
Channel Selection on the screen. To select all channels, click on the All button. To select
a certain channel, click on the corresponding channel field. Hovering
the mouse pointer over a color field displays the relevant channel
name.
If the image consists of more than 29 channels, a scrollbar will be dis-
played which you can use to switch to the desired channel.

Spline Mode Clicking on this button allows you to add up to 8 points to the dis-
play characteristic curve.
You can then bend the curve around these points. To do this, click on
the desired section of the display curve and move it as required. Click-
ing on the display curve again adds another point.
You can delete points by moving them along the display curve until
they lie on top of another point. In this way, even in difficult situa-
tions you can adjust the display curve so that all important image re-
gions can be displayed well.

Auto The automatic adjustment is not available during the acquisition of


LSM experiments.
Adjusts the image display automatically.
This is particularly useful in the case of a live image, in Continuous
mode or if you play back a time series image that contains changing
brightness.

Min/Max Adjusts the display characteristic curve so that the darkest pixel is
black and the brightest pixel is white in the display. Note that this
function makes an approximation to get a quick result! For detailed
information about minimum and maximum values refer to measure-
ments conducted in the Histo view.

Best Fit Adjusts the display characteristic curve so that 0.1% of the darkest
pixels contained in the image are black and 0.1% of the brightest pix-
els are white in the display.

Input fields With the two input fields to the right of the BestFit button you can
adjust the black/white values from 0.1% to values from 0 to 90% ac-
cording to your requirements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1044


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Dimension Selec- If your images contain time series, z-stacks or both, you can here se-
tion lect the aspect of an image for which the display settings should be
applied.
Note that with all settings other than Current there may be several
seconds of calculation time until the setting is applied, depending on
the number of time points/ z-planes.
The following options are available:

- Current Adjusts the display for the current image and keeps this setting for all
other time points or Z-planes.

- All T Collects the intensity values from all time points and adjusts the dis-
play according to the brightest and darkest pixels within the entire
time series.

- All Z Collects the intensity values from all Z-planes and adjusts the display
according to the brightest and darkest pixels within the entire Z-stack.

- All T+Z Collects the intensity values from all Z-planes and time points and ad-
justs the display according to the brightest and darkest pixels within
the entire Z+T series.

Here you can copy display settings to the clipboard, insert them into
other images from there or save and reload settings. This allows you
Options
to apply identical display settings to several images in order to pro-
duce comparable display conditions.

Reset Resets all parameters to the default values.

Black Displays the gray value currently set up to which all pixels are shown
as black. You can also enter a certain value here.

Gamma Displays the gamma value currently set. You can also enter a certain
value here.

0.45 Sets a gamma value of 0.45. This is the recommended setting for
most color images.

1.0 Sets a linear display characteristic curve with a gamma value of 1.0.

White Displays the gray value currently set from which all pixels are shown
as white. You can also enter a certain value here.

9.4.3.6 LSM Plus Tab

Parameter Description
Display Mode Selects which image is displayed in the image view.

– Raw Displays the confocal image.

– LSM Plus Displays the image processed with LSM Plus.

Super Resolution Sets the processing strength.

Auto Filter Sets the processing strength automatically depending on the image
properties.

Process Selects the image(s) and dimension you want to save.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1045


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Create Processed Saves the processed images.
Image(s)

9.4.3.7 Airyscan Tab

For images acquired with Airyscan, this tab offers you different image view options. During acqui-
sition of Airyscan 2 Multiplex mode images, the result can be displayed and controlled for correct
acquisition quality with this tab. Note: If you use multi-immersion objectives, the immersion
medium needs to be indicated with the MTB software to allow for correct processing of Airyscan
images.

Parameter Description
Display Mode Selects how the image is displayed in the image view. Note that the
image that is generated in this way is only temporary; the data is still
raw data and is processed anew each time it is viewed.

– Sum Channel Only visible for Airyscan SR image data.


Displays the sum channel. The sum channel is the sum of all Airyscan
elements and corresponds to the confocal non-resolution-enhanced
image.

– SR Displays the Airyscan SR or MPLX processed image with increased res-


olution, applied only to the currently displayed viewer content and
not saved.

– Preview Only visible for Airyscan MPLX image data.


Displays a partially processed image in which the Y-parallelization of
the MPLX mode has been offset (otherwise it would result in a heavily
distorted image), but without a full resolution increase.

– Raw Data Displays the raw data.

The following parameters are only visible if SR is selected:

Super Resolution Only available, if Auto Filter is deactivated.


Modifies the processing strength.

Auto Filter Sets the processing strength automatically.

Process In the dropdown list you can select the image(s) and dimension you
want to process and open as a new image. Available options:
§ Current Image (2D)
§ Current Image (3D)
§ All Images (2D)

Create Processed Processes the active images and opens them as a new image docu-
Image(s) ment.

9.4.3.8 Apotome Tab

Here you have various settings for displaying an Apotome image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1046


9 Reference | 9.4 Image Views ZEISS

Parameter Description
Display Mode Apotome images are acquired as raw data. The Display Mode sets
how the image is calculated and displayed.

– Optical Sec- The displayed image is calculated/rendered by eliminating the excita-


tioning tion and emission light that originates in regions outside of the focal
plane.

– Conventional The displayed image is calculated/rendered like a conventional fluores-


fluorescence cence image.

– Raw Data Displays the raw data as output image and disables all other parame-
ters of the function.
Displays the Phases slider on the Dimensions tab. This enables you
to select the various phases of the raw images.

Normalization Activated: The resulting images always fill the entire 16 bit dynamic
range of the image histogram, see normalization .

Enable Correction Activated: Displays the Correction dropdown list for stripe artifact
correction.

Correction Only visible if Enable Correction is activated.


Applies stripe artifact correction to the resulting image. It attempts to
remove stripe artifacts which may be caused by bleaching of the
sample during acquisition or by slight deviations in the grid phase po-
sition.

– Phase Errors Corrects phase errors in the image without additional bleaching cor-
rection.

– Local Bleach- Corrects the bleaching for each pixel individually (default setting). This
ing is usually the best method.

– Global Bleach- Corrects bleaching by means of global bleaching correction, which is


ing applied equally to the entire image.

Phase Correction Only visible if Enable Correction is activated and if you have selected
one of the two bleaching corrections for Correction.
Activated: Performs a correction of any phase deviations present in
addition to the selected bleaching correction.

Fourier Filter The Fourier filter attempts to remove residual stripes.

– Off Uses no Fourier filter to remove stripes.

– Weak Uses a weak Fourier filter to remove stripes.

– Medium Uses a medium Fourier filter to remove stripes.

– Strong Uses a strong Fourier filter to remove stripes.

Grid Displays the grid frequency used for the image in lines/mm.

Deconvolution Activated: Displays key parameters for Apotome deconvolution. De-


convolution benefits from the presence of a CUDA enabled NVIDIA
graphic card by speeding up the processing.

Aberration Correc- Only visible if Deconvolution is activated.


tion Activated: Displays parameters for aberration correction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1047


9 Reference | 9.4 Image Views ZEISS

Parameter Description
– Refractive In- Sets the refractive index of the used embedding medium .
dex Embed-
ding

– Distance to Sets the distance of the acquired structure from the side of the cover
Coverslip slip facing the embedding medium.

Set Strength Man- Only visible if Deconvolution is activated.


ually Activated: Sets the degree of restoration with the slider. To achieve
strong image restoration, move the slider towards Strong. To achieve
less image restoration, move the slider towards Weak.
Note: If the setting is too strong, image noise may be intensified and
other artifacts, such as "ringing", may appear.
Deactivated: The restoration strength for optimum image quality is
determined automatically.
The restoration strength is inversely proportional to the strength of
so-called regularization. This is determined automatically with the
help of Generalized Cross Validation (GCV).

Apply Deconvolu- Only visible if Deconvolution is activated.


tion Applies the deconvolution to the Apotome image. The result is dis-
played directly without a new document being created. To create a
separate document, click on the Create Image button.

Apotome Plus Only available if you have licensed Apotome Plus.


Activated: Displays parameters for the Apotome Plus functionality.

Algorithm Selects the Apotome deconvolution algorithm.

– Fast Iterative Uses an algorithm based on Deconvolution methods for structured il-
lumination microscopy, with some enhancements as described in the
technical note. It is faster and less memory intensive, and also purely
using the image formation model.

– Constrained Uses an algorithm based on the Generalized approach for accelerated


Iterative maximum likelihood based image restoration applied to three-dimen-
sional fluorescence microscopy, but modified to allow for joint recon-
struction and with enhancements as described in the technical note. It
offers increased robustness to noise and mismatch between the theo-
retical and real PSF.

Maximum Itera- Visible for Fast Iterative and Constrained Iterative algorithms.
tions Sets the maximum permitted number of desired iterations. In the case
of Richardson-Lucy, you should allow significantly more iterations
here.

– SIM Correc- Activated: Removes stripe artefacts created by image acquisition and
tion corrects for false phases in metadata.

– Stronger Sec- Activated: Applies a stronger optical sectioning to remove out-of-fo-


tioning cus signals based on the multiplication of the optical sectioning data.

Create Image Creates a new image document. The available settings are taken into
consideration here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1048


9 Reference | 9.4 Image Views ZEISS

9.4.3.9 PSF Tab

In most image views you will see the PSF Display tab as soon as a PSF image has been loaded.
PSF images differ from the data types of normal images. They are saved, for example, in the high-
precision floating point format. A series of important values that allow conclusions to be drawn
about the microscope system and sample conditions can also be read from PSF images.

Export PSF button


Generates a new PSF document in 16 bit gray level format, which can be processed as required to
allow it to be used in other programs.

Display Mode settings


Choose between three display options from the dropdown list:

§ Intensity PSF: The PSF is displayed in the position space, gray values are displayed in floating
point format.
§ Intensity OTF: The optical transfer function (OTF) displays the 3D PSF in the frequency space
following a 3D Fourier transformation. Gray values are displayed in floating point format.
§ Intensity Slice OTF: Displays the 2D Fourier transformation of each individual Z-plane.
Axial cut view checkbox
Activated: Displays the PSF in axial section view.
Deactivated: A slider for Z appears on the Dimensions tab. This allows you to move through the
various Z-planes.

List of PSF values


A series of important values relating to the PSF are displayed here in a table:

§ Storage type: Format in which the PSF is saved


§ Source: Shows whether the PSF has been generated by measuring a bead stack (External) or
from the theoretical calculation (Internal).
§ Used Dimensions: shows whether the PSF is 3D or 2D.
§ Instrument: shows the type of microscope used.
§ Illumination: shows the illumination conditions that applied.
§ NA Objective: Numerical aperture of the objective
§ Lateral Magnification: shows the objective magnification.
§ Working Distance: shows the working distance of the objective.
§ Illumination Wavelength: shows the wavelength of the excitation light; in the case of multi-
channel PSFs the values for all channels are shown here.
§ Detection Wavelength: shows the wavelength of the detected emission light; in the case of
multichannel PSFs the values for all channels are shown here.
§ Transverse Resolution (Rayleigh): shows the actual lateral resolution achieved according to
Rayleigh; in the case of multichannel PSFs the values for all channels are shown here.
§ Axial Resolution: shows the actual axial resolution achieved, determined according to Full
Width Half Maximum (FWHM); in the case of multichannel PSFs the values for all channels are
shown here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1049


9 Reference | 9.4 Image Views ZEISS

Info
Please note that the resolution values for measured PSFs show the performance of the entire
system, consisting of all optical and electronic components. The sample, with its optical prop-
erties and possible aberrations, therefore has a significant impact on the resolution. This
means that these values are not suitable for making statements about the quality of the objec-
tive.

9.4.4 Full Screen Mode

In this mode the image will be displayed in the full monitor size.
To start the full screen mode, position the cursor on the image area and open the context menu
via right mouse click. Click on Full Screen. You can also press F11 or click on menu Window >
Full screen as an alternative.
Toolbar
In the toolbar at the bottom you find several buttons for general and image specific functions, like
zoom function (Zoom button) or image informations (Info button). When you open a multidi-
mensional image, you find buttons for specific functions, etc. Z-Stack, Channels. To open the
functions, click on the button.
Previous button
Displays the previous document in full screen mode. You can page step by step backwards
through all open documents.
Next button
Displays the next document in full screen mode. You can page step by step forwards through all
open documents.
Exit Fullscr. button
Closes the full screen mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1050


9 Reference | 9.4 Image Views ZEISS

9.4.5 Exposé Mode

Fig. 79: Exposé mode


To open the Exposé mode click on the expose mode icon in the document bar [} 28].
In this mode all open documents will be displayed in an overview. When you click on an image in
the overview the Exposé mode will be closed and the image will be displayed in standard view.
Click on Back to go back to the standard image view.

9.4.6 Splitter Mode

To open the Splitter mode click on the splitter mode icon in the document bar [} 28].
In this mode you can generate a multi image of one or several images in order to compare them.
Drag an image of the Images and Documents gallery in Right Tool Area and drop it in a split-
ter position. The standard setting for the splitter are 2 columns and 1 row. You can modify these
setting in the Split Display tab.
Proceed similarly with further images to be displayed in the multi image. The same image can be
dropped several times in the splitter view, i.e. to compare different image scenes.
The multi image can be saved as CZSPL (Zeiss Multi Image Files) image type in the menu File >
Save As. The stored multi image is no image document, but rather a reference of the images dis-
played in the splitter mode.
Use the Split Display tab for further adjustments (i.e. arrangement) of the splitter mode. Here
you can create a single image of the multi image to be saved as CZI image file.

9.4.6.1 Split Display Tab

Arrangement section
Here you can set how much columns and rows the splitter image should have. Therefore simply
enter the desired number in the Columns/Rows input fields.

Parameter Description
Arrangement

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1051


9 Reference | 9.4 Image Views ZEISS

Parameter Description
– Columns Sets the number of columns displayed in the splitter view mode.

– Rows Sets the number of rows displayed in the splitter view mode.

Synchronize Di- Activated: The settings of the Dimensions tab (i.e. Zoom) will be ap-
mensions plied synchronously to all images in splitter mode. Does not apply to
rotations.

Synchronize Dis- Activated: The settings of the Display tab (i.e. Gamma) will be ap-
play plied synchronously to all images in splitter mode.

Show Position Activated: The cursor changes to an arrow symbol and a cross
Data marker in the image. The X/Ycoordinates with scaling unit and gray
value of the current cursor position are displayed below the image.
Furthermore additional information is displayed for multidimensional
images: i.e. the gray value for each channel of a multichannel image,
the time of each time point of a time lapse image, the focus position
of each z-position of a z-stack.

Reset By clicking on this button you can reset all adjustments applied to the
images in splitter view.

New Image From Here you can select the type of image to be generated. The available
options are depending on the dimensions of the displayed image.

- Current View Creates a two-dimensional image of all opened images visible in the
splitter mode.

- Time Series Creates a multi-dimensional image containing each time point of a


time series image.

- Z-Stack Creates a multi-dimensional image containing each z-plane of a z-


stack image.

- Rotation Creates a multi-dimensional image containing each rotation plane of a


rotation image.

Create Generates an single image of the multi image displayed in splitter


mode with the corresponding settings. The image can be saved in the
*.CZI format in File > Save as menu.

Interpolation for Only visible if the Show All mode is activated.


zoomed images Selects how interpolation is performed if a pixel is calculated from
several individual pixels.

- Nearest The output pixel is given the gray value of the input pixel that is clos-
Neighbor est to it.

- Linear The output pixel is given the gray value resulting from the linear com-
bination of the input pixels closest to it.

- Cubic The output pixel is given the gray value resulting from a polynomial
function of the input pixels closest to it.

Spacing Only visible if the Show All mode is activated.


Here you can adapt the size of the distance between the single im-
ages to values 0 up to 20. The background (distance) is displayed in
black color and appears if the splitter image is generated via the Cre-
ate button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1052


9 Reference | 9.5 File Browser ZEISS

Parameter Description
Spacing color Only visible if the Show All mode is activated.
Changes the background color of the splitter image.

Burn-in annota- Only visible if the Show All mode is activated.


tions Activated: All existing annotations and graphical elements within the
images will be burned into the resulting splitter image.

9.5 File Browser

The file browser is accessed via File > Open File Browser. You see an overview of all files (im-
ages, documents, etc.) stored on the computer. In the left column you see a file structure which is
associated with the common image or data containing folders in your file system (Images and
documents). In the right area you see the preview to the selected folder.

Info
The ZEN folders contain automatically the Auto Save folder. Here you see all auto-saved im-
ages from ZEN. Set Auto Save path in Tools > Options > Saving.

Gallery View
Here you see all files of a folder as small preview images (thumbnails). Use Tool tab to adjust pre-
view images size, sorting, etc..
Info View
Here you see a detailed list with all data the selected image contains. Find a detailed description
of all possible data under Info View [} 1010].
Table View
Here you see all files of a folder well-arranged in a table. This view is perfect for folders which
contain many files.

9.5.1 Tools Tab

Parameter Description
Icon size Set size of thumbnail images here.

Text Rows Select entries which you want to have displayed as additional text row
under the thumbnail image.

Record Switch from file to file in the selected folder by using the slider.

Sorting Arrange your files to certain properties (i.e. file name, type, etc.)

Folders Manage selected file folders here (i.e. new folder, rename folder,
etc.).

Selection Manage selected files here (i.e. copy file, or delete file).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1053


10 Systems & Components | 10.1 ApoTome.2 ZEISS

10 Systems & Components


10.1 ApoTome.2

10.1.1 Introduction

In the following chapters you will learn how to calibrate the ApoTome for a two-channel experi-
ment and acquire a two-channel image. This image will be used as a basis for demonstrating the
processing options. After this, a Z-Stack image will be acquired and processed with the help of
ApoTome deconvolution.
Phase calibration, if it has not yet been performed, is carried out from the Locate tab, while the
other steps are all performed from the Acquisition tab.
Grid Focus Calibration is an important step. It is best to perform this using the sample that you
will want to acquire later, to guarantee identical optical conditions. If your sample is prone to sig-
nificant bleaching, you can also use the calibration slide provided.
Background information on the ApoTome can be found here:

§ Principle of Imaging Using Fringe Projection [} 1054]


§ Optimum Acquisition Conditions [} 1058]
§ List of recommended objectives

10.1.2 Principle of Imaging Using Fringe Projection

The optics of a microscope are optimized for analyzing very thin samples. For a cover-slip-cor-
rected objective, all optical calculations are performed for very thin objects that lie directly be-
neath the cover slip. All cover-slip-corrected objectives from ZEISS are optimized for this particular
usage, and exhibit an optimum point spread function (PSF) for the wavelengths for which the cor-
responding objective has been specified.
In biological applications, however, the vast majority of specimens used do not satisfy these opti-
mum requirements. Sometimes thicker biological tissue slices are used, e.g. to analyze cells in the
tissue using specific fluorescent markers.
In such cases, during microscopic analysis, and particularly during documentation, the set focal
plane is hidden by parts of the image that originate from above and below the actual focal plane.
As a result the image appears "faded", the contrast is reduced, and the background becomes
bright. In extreme cases important structures and image details may be completely hidden.

Fig. 80: Input image (schematically)


The above representation of a microscopic image of cell nuclei in tissue shows this effect. A num-
ber of methods can be used to prevent or reverse this effect, such as confocal laser scanning mi-
croscopy or 3D deconvolution.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1054


10 Systems & Components | 10.1 ApoTome.2 ZEISS

Principle of fringe projection


With the ApoTome 2 the principle of fringe projection has been employed. This technology in-
volves inserting a grid structure with grid lines of a defined width into the plane of the luminous
field diaphragm of the reflected light beam path. As the plane of the luminous field diaphragm is
conjugated to the focal plane, when you look into the eyepiece you can therefore see the grid,
overlaid with the actual sample.

Fig. 81: Grid image


The image of the grid is shown schematically in the figure above. In reality the grid lines are much
thinner.

Moving the grid structure


A scanning mechanism in the ApoTome 2 slider is used to move the grid structure in at least three
defined steps within the specimen plane. The grid is moved very quickly (in less than 20 ms). A
digital image is acquired at each grid position. The next figure shows the movement of the grid
schematically:

Position 1 Position 2 Position 3

Optical section
The three raw images are combined online on the PC and displayed as an optical section. This
combined resulting image is an optical section through the sample with the following properties:

§ The grid structure has been removed from the raw images.
§ The parts of the image that are out of focus are no longer visible.
§ The sharpness and contrast of the image have been increased.
§ The image’s resolution in the axial direction has been increased.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1055


10 Systems & Components | 10.1 ApoTome.2 ZEISS

Fig. 82: Output image (schematically)

Fig. 83: Sample image: cell nuclei


The figure above shows an application image of cell nuclei (tadpole brain section) in black and
white. Above left: conventional fluorescence Below right: optical section
Why is the resulting image an optical section?

Schematic image of the grid


One possible way to explain this is to use the image of the grid in the sample:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1056


10 Systems & Components | 10.1 ApoTome.2 ZEISS

Fig. 84: Grid image (schematically)


The image of the grid provides the necessary information on the distance of the various specimen
structures from the set focal plane (see figure above). Some specimen structures are in focus,
while others lie above or below the focal plane, and enter the set focal plane.
The technique of grid projection makes use of the fact that the image of the grid above and be-
low the actual focal plane is blurred, and enters the blurred areas of the specimen. When the grid
line is moved, significant brightness differences (= contrast) appear in the focal plane.
Outside the focal plane only minor differences are produced, as the sample and the image of the
grid are practically "blurred" together. The brightness differences are detected by the algorithm
used to combine the raw images, and are used to remove the parts of the image that are out of
focus.

The Raw Data mode


To view the raw data directly switch to the Raw Data display mode on the ApoTome tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1057


10 Systems & Components | 10.1 ApoTome.2 ZEISS

You will now see the Phase slider on the Dimensions tab. Here you can locate the individual grid
positions. This view can be useful when looking for errors, e.g. to find out where residual streaks
in the processed resulting image originate from.

10.1.3 Optimum Acquisition Conditions

The following requirements should be met in order to produce optimum ApoTome images:

§ Exposure time of the camera: this should be set so that approx. 80% of the camera's dy-
namic range is used. The smaller the dynamic range of the images of the lines, the more noise
the combined resulting images will contain.
§ Correct calibration: Good results can only be achieved if calibration has been performed
correctly. Ideally you should use your own sample for calibration. If this does not lead to good
results, use the calibration slide provided.
§ Sufficient grid contrast in the sample: Good section image results can only be achieved if
the grid lines in the live image can be clearly identified in all object areas. Under certain cir-
cumstances samples with very homogeneous staining throughout may not be suitable for
ApoTome images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1058


10 Systems & Components | 10.1 ApoTome.2 ZEISS

§ Avoid vibrations during acquisition, as any movement of the grid position during acquisition
can lead to streak artifacts.
§ Number of phases: Although 3 grid positions (also called phases) can completely cover the
object structures that are in focus and are therefore sufficient for creating optical sections, the
results are significantly better when 5 or more phases are acquired. For this reason 5 phases
are acquired as standard.
§ Selection of the correct grid frequency: Under normal circumstances, the automatic grid
selection yields the best results. In the case of difficult samples, e.g. if the staining is weak, se-
lecting a different grid manually can lead to better results.
§ Avoid electronic interference: The ApoTome's scanner unit is equipped with highly precise
control. Avoid electrical interference, e.g. leaving cell phones close to the ApoTome, to pre-
vent incorrect positioning of the grid.

10.1.4 List of Recommended Objectives

The following list gives an overview about the recommended objectives and the compatibility with
several microscopes. The links give detailed information about the features of each listed objec-
tive.

Overview
§ EC Plan-Neofluar (Axio Observer/Axio Zoom.V16) EC Plan-Neofluar [} 1059]
§ LCI Plan-Neofluar (Axio Observer/Axio Zoom.V16) LCI Plan-Neofluar [} 1060]
§ Plan-Apochromat (Axio Observer/Axio Zoom.V16) Plan-Apochromat [} 1060]
§ LD LCIPlan-Apochromat (Axio Observer) LD LCIPlan-Apochromat [} 1061]
§ C-Apochromat (Axio Observer) CApochromat [} 1061]
§ LD C-Apochromat (Axio Observer) LD CApochromat [} 1061]
§ A Plan-Apochromat (Axio Observer) a Plan-Apochromat [} 1061]
§ A Plan-Fluar (Axio Observer) a Plan-Fluar [} 1062]

Microscopes
§ Objectives for Axio Observer
§ Objectives for Axio Zoom.V16

10.1.4.1 EC Plan-Neofluar

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

10x 0.3 Air 2.9 / 1.7 / 0.9 / OK OK


31.9 18.2 9.9

20x 0.5 Air 2.4 / 1.4 / 0.7 / OK OK


9.2 5.3 2.9

40x 0.75 Air 1.6 / 0.9 / 0.5 / OK OK


2.8 1.6 0.9

40x 1.3 Oil 2.5 / 1.4 / 0.8 / OK OK


2.2 1.2 0.7

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1059


10 Systems & Components | 10.1 ApoTome.2 ZEISS

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
63x 0.95 Air 1.0 / 0.6 / 0.4 / OK No
1.1 0.7 0.4

63x 1.25 Oil 1.6 / 0.9 / 0.5 / OK OK


1.5 0.9 0.5

100x 1.3 Oil 1.0 / 0.6 / 0.4 / OK OK


0.9 0.5 0.3

10.1.4.2 LCI Plan-Neofluar

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

25x 0.8 Oil, water or 2.9 / 1.7 / 0.9 / OK OK


glycerin 6.6 3.7 2.0

63x 1.3 Water or glyc- 1.5 / 0.9 / 0.5 / OK OK


erin 1.3 0.7 0.4

10.1.4.3 Plan-Apochromat

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

10x 0.45 Air 4.2 / 2.4 / 1.3 / OK OK


20.4 11.5 6.2

20x 0.8 Air 3.2 / 1.8 / 1.0 / OK OK


4.9 2.8 1.5

40x 0.95 Air 1.6 / 0.9 / 0.5 / OK OK


1.7 1.0 0.5

40x 1.3 Oil 2.5 / 1.4 / 0.8 / OK OK


2.2 1.2 0.7

40x 1.4 Oil 2.4 / 1.4 / 0.7 / OK OK


1.8 1.0 0.6

63x 1.4 Oil 1.6 / 0.9 / 0.5 / OK OK


1.2 0.7 0.4

100x 1.4 Oil 1.0 / 0.6 / 0.4 / OK OK


0.8 0.5 0.3

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1060


10 Systems & Components | 10.1 ApoTome.2 ZEISS

10.1.4.4 LD LCIPlan-Apochromat

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

25x 0.8 Oil, water or 2.9 / 1.7 / 0.9 / OK OK


glycerin 6.5 3.8 2.0

10.1.4.5 CApochromat

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

10x 0.45 Water 4.2 / 2.4 / 1.3 / OK OK


20.2 11.7 6.1

40x 1.2 Water 2.1 / 1.3 / 0.7 / OK OK


1.9 1.1 0.6

63x 1.2 Water 1.4 / 0.8 / 0.5 / OK OK


1.3 0.7 0.4

10.1.4.6 LD CApochromat

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

40x 1.1 Water 2.1 / 1.3 / 0.7 / OK OK


2.3 1.4 0.7

10.1.4.7 a Plan-Apochromat

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

63x 1.46 Oil 1.5 / 0.9 / 0.5 / OK OK


1.0 0..6 0.3

100x 1.46 Oil 1.0 / 0.6 / 0.3 / OK No


0.7 0.4 0.2

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1061


10 Systems & Components | 10.1 ApoTome.2 ZEISS

10.1.4.8 a Plan-Fluar

V NA Immersion Grid / Section Thickness DAPI DAPI


@ 490nm [RE/μm] with FS with FS
34 49
Highgrid Middlegrid Lowgrid

100x 1.45 Oil 1.0 / 0.6 / 0.3 / No No


0.7 0.4 0.2

10.1.5 Preparation: Phase Calibration

Before you can use the ApoTome for your experiments, the optimum angle of deflection of the
scanner unit must be set on the ApoTome 2. This fine adjustment of the scanner unit only has to
be performed once after the system has been set up. The mirror slide and special reflected light
reflector cube, both of which are supplied with the ApoTome 2, are used for this purpose.
Calibration only needs to be performed for one grid and one objective. It is advisable to calibrate
the grid for the low magnification range (grid marked with an "L" for "Low magnification") using
a 20x objective.
The positioning of the camera is also optimized in the dialog for phase calibration. To achieve op-
timum performance, the camera horizontal should be aligned parallel to the ApoTome 2 grid lines
with as much precision as possible.
The calibration process is supported by a wizard. Start the function by selecting the ApoTome
Phase Wizard function from the Acquisition menu.
The wizard guides you through the calibration process in 5 steps. Follow the instructions in the
text field of the wizard.
For phase calibration you will need the mirror slide provided and the calibration filter
(424930-9902-000). The filter is designed for use with white light sources such as the HXP120C
and cannot be used with the LED light source Colibri. If your ApoTome system was ordered and
supplied exclusively with Colibri, a suitable calibration filter (424930-9000-000) has already been
provided. If Colibri has been retrofitted and the calibration filter is not available, it is not possible
to perform phase calibration. In this case please contact your ZEISS sales representative.

10.1.6 Step 1: Define Channels Using Smart Setup

Aim
In this step we will set up a two-channel experiment. To do this, we will use the Smart Setup
function. The ApoTome is in the first click-stop position, i.e. in the empty position without a grid.

1. Place your sample onto the microscope stage, localize it with the help of the functions on
the Locate tab and bring it into focus.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1062


10 Systems & Components | 10.1 ApoTome.2 ZEISS

2. Now go to the Acquisition tab and create a new experiment in the Experiment Man-
ager:

3. Open the Smart Setup .

4. Select the appropriate dyes (in our case Alexa 488 and Alexa 568):

5. Close the dialog by clicking on OK.


à You will now see two channels in the Channels tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1063


10 Systems & Components | 10.1 ApoTome.2 ZEISS

6.

You have successfully set up the channels. In the live mode you can now check the focus and ex-
posure time for the two channels.

10.1.7 Step 2: Grid Focus Calibration

Aim
In this step you will calibrate the focus position of the ApoTome grid for the selected channels.
This step is essential, as without a valid calibration it is not possible to perform an ApoTome ex-
periment. Provided that no changes are made to the device settings that are important for calibra-
tion (objective, filter and illumination source, camera) the calibration remains valid for future ex-
periments. We nevertheless recommend that you repeat the calibration from time to time, espe-
cially if the sample type you are analyzing changes. Calibration takes place in a wizard, which
guides you through 3 simple steps.

1. Move the ApoTome to the second click-stop position so the grid is positioned in the beam
path.
2. From the Acquisition menu item open the ApoTome Focus Calibration Wizard … en-
try.
3. In the first step select the channel for which you want to perform calibration.

4. Click on Next to proceed.


à You will now see the Live Image. Bring the sample into focus. The ApoTome grid has
been moved to an end position to make it easier for you to focus on the sample. If you
can nevertheless see the grid lines, something that can never be avoided entirely if you
are using a 100x objective for example, click on one of the two buttons Grid To Start or
Grid To End and use the position at which the fewest grid lines can be seen.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1064


10 Systems & Components | 10.1 ApoTome.2 ZEISS

5. On the left you have the option of adjusting the exposure time and, if necessary, the illumi-
nation intensity (with corresponding light sources only).

6. To adjust the exposure time correctly, select the saturation display on the Dimensions tab.
Regions overlaid in red indicate that pixels are saturated.

7. Reduce the exposure time accordingly. The ideal situation is where approx. 70% of the his-
togram is filled for the brightest region of the sample.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1065


10 Systems & Components | 10.1 ApoTome.2 ZEISS

8. Position the rectangle in the live image and adjust its size in such a way that it covers fairly
homogeneous fluorescent structures and does not lie over the background. The grid focus
is only determined within this rectangle.

9. Click on Next to proceed to the final step.


10. Now click Start Full Scan to start the grid focus search.
à The grid contrast is displayed in the histogram.

11.
à More precise grid focusing can be achieved if you click on the Start Local Scan button.

However, this is only recommended for samples that are not particularly prone to bleach-
ing. For samples prone to significant bleaching, the results of the Local Scan would
measure considerably lower intensities and distort the result.
12. Click Finish.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1066


10 Systems & Components | 10.1 ApoTome.2 ZEISS

13. To perform calibration for another channel, answer Yes to the question "Do you want to
calibrate another channel?" in the dialog that is now displayed.
à The wizard then begins again from Step 1.
14. As soon as you have calibrated all channels, exit the wizard by clicking on No.

You have successfully performed grid focus calibration. Now continue with the next step.

10.1.8 Step 3: Perform ApoTome Experiment

Aim
In this step you will perform acquisition for a two-channel experiment. You will use the same
channels that were set up in Step 1. The objective must also be the same one used to calibrate
the grid focus.

1. Insert the desired sample into the slide holder.


2. Open the Live Image and focus on the specimen.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1067


10 Systems & Components | 10.1 ApoTome.2 ZEISS

3. Adjust the exposure time for the two channels in such a way that approx. 70% of the His-
togram is used.

4. Close the Live Image to protect the sample.


5. Open the ApoTome Mode tool on the Acquisition tab and enable the ApoTome.

6. Start acquisition by clicking on the Snap button.


à The result is a two-channel image of your specimen.
7.

You have successfully performed an ApoTome experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1068


10 Systems & Components | 10.1 ApoTome.2 ZEISS

10.1.9 Step 4: Process the Resulting Image

Aim
ApoTome images that are acquired from the Acquisition tab always take the form of raw data.
In this step, with the help of the image you acquired in Step 3, we will look at the various display
options available for ApoTome raw images. We will also create a processed resulting image,
which you can process further as required.

Prerequisite ü For this step you need to be in the 2D view [} 990].

1. In the Center Screen Area go to the ApoTome tab. This view option is only displayed for
ApoTome raw images.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1069


10 Systems & Components | 10.1 ApoTome.2 ZEISS

à If the Show all mode is deactivated you will see two view options: the Display Mode
settings & the Create Image button.

The default selection for Display Mode is the Optical Section view.
2. Select the Conventional Fluorescence option from the Display Mode dropdown list.

à The image is now no longer displayed as an optical section, but as a conventional fluo-
rescence image ("widefield"):

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1070


10 Systems & Components | 10.1 ApoTome.2 ZEISS

3. Activate the Show All mode to see additional settings for the calculation of the optical sec-
tion image.

4. To see the difference between a corrected and uncorrected image, deactivate the Enable
Correction option. Detailed information on the individual options can be found in the on-
line help.
5. If you have not yet done so, enable the correction using the Local Bleaching option.
6. Create a new, processed resulting image by clicking on the Create Image button.
You have successfully processed the ApoTome image and created a resulting image for further
processing.

10.1.10 Step 5: Perform Z-Stack Acquisition

Aim
In this step you will acquire a Z-stack image with the same channel settings as in Step 3.

1. On the Acquisition tab activate the Z-Stack acquisition dimension in the Experiment Man-
ager.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1071


10 Systems & Components | 10.1 ApoTome.2 ZEISS

2. Open the Z-Stack tool.

3. Start the Live Mode and define the dimensions of the Z-stack for your specimen. To cap-
ture the entire object three-dimensionally, you should set the upper and lower limit in such
a way that object structures can no longer be seen in focus. Set the interval between the
individual Z-planes using the Optimal button:

4. Start acquisition by clicking on the Start Experiment button.


à You can follow the progress of the experiment in the progress bar on the status bar:

You have successfully acquired a Z-stack image. Save the resulting image under a meaningful
name via File > Save (Ctrl+S).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1072


10 Systems & Components | 10.1 ApoTome.2 ZEISS

10.1.11 Step 6: Perform ApoTome Deconvolution

Aim
In this step ApoTome deconvolution will be performed for the Z-stack acquired in Step 5. This
enables you to significantly enhance the image, beyond what is possible using the normal Apo-
Tome processing functions.

Prerequisite ü The Z-stack image must be in the foreground and in the 2D view. Go to the ApoTome tab
(view option). Make sure that the Show All mode has been activated.
1. Activate the Deconvolution checkbox.

à Make sure that the Set Strength Manually option is also activated. The Strength slider
is set to Medium by default. Retain this setting for the time being.
2. Click on the Apply deconvolution button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1073


10 Systems & Components | 10.1 ApoTome.2 ZEISS

à Depending on the image size and the specifications of the computer, the processing can
take anything between a few seconds and a few minutes. Make sure that you also adjust
the brightness and contrast using the settings on the Display tab (tip: try out the Min/
Max button).

3. Examine the result by navigating through the Z-stack using the Z-Position slider on the Di-
mensions tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1074


10 Systems & Components | 10.1 ApoTome.2 ZEISS

4. Change the Strength setting on the ApoTome tab until there is an obvious improvement
and there is no disruptive background noise.

5. To obtain the result as a separate image document, click on the Create image button.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1075


10 Systems & Components | 10.1 ApoTome.2 ZEISS

6. Using the Splitter Mode [} 1051] you can now compare the resulting image with the wide-
field and the ApoTome processed version.

You have successfully performed ApoTome deconvolution, created a resulting image and com-
pared different resulting images.

See also
2 Apotome Tab [} 1046]

10.1.12 Reference

10.1.12.1 ApoTome Dialog

Parameter Description
Recommended In this section you can set the grid with which you want the ApoTome
Grid to be operated.

Automatic Grid Activated by default.


Control Activated: The appropriate grid for the selected objective is selected
automatically (in the case of ApoTome.2).
Deactivated: It is possible to select another grid from the dropdown
list that is now active, e.g. to create a thicker optical section thick-
ness. A list of recommended objectives and suitable wavelengths can
be found here.

Calibration Status Here you can see whether your ApoTome has been calibrated suc-
cessfully or whether calibration needs to be performed.

Theoretical Thick- The theoretical section thickness for the selected filter set and the ob-
ness jective used is displayed here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1076


10 Systems & Components | 10.2 Axio Observer ZEISS

10.1.12.2 ApoTome Settings Dialog

Parameter Description
Camera Here you can select the camera you wish to use to acquire your Apo-
Tome images. As soon as you have selected a camera, ApoTome im-
ages are generated automatically during acquisition (Snap). The se-
lected camera also applies to the Acquisition tab.

Live Mode Here you can choose between the No Combination, Optical Sec-
tion and Conventional Fluorescence modes for the live image.

Acquisition Mode Here you can choose between the No Combination, Optical Sec-
tion and Conventional Fluorescence modes for acquired images.

Phase Images Here you can choose between no fewer than 3 and no more than 15
phases. Each phase corresponds to a grid position. By default, 5
phases are acquired.

Filter Here you can set a filter which can be used to filter out residual
streaks from the image. You have a choice between no filtering (Off)
and three strength levels.

Image Normaliza- Activated: The gray values are extended to the maximum available
tion dynamic range following the calculation, see Normalization .

10.2 Axio Observer

10.2.1 Auto Immersion

10.2.1.1 Establishing and Renewing Immersion Manually

Prerequisite ü You have started ZEN and the microscope is operational with the Auto Immersion device
completely installed and configured.
ü The immersion fluid level in the liquid reservoir of the Auto Immersion device is Sufficient.
ü For a robust auto immersion performance, use a default setting with 50% for stage speed
and 50% for stage acceleration. The settings for the stage depend on the used objective and
the distances to be traveled. Therefore, these settings can be optimized by the user for differ-
ent applications (speed vs. robustness).
1. Focus on the sample with a low NA overview objective, e.g. 5x or 10x objective.
2. Set up your acquisition experiment and select the immersion objective in the Microscope
tool in the Right Tool Area. Alternatively, select the immersion objective with the Micro-
scope Control tool on the Locate tab. In both cases the objective is illustrated with a little
water drop icon.
à The image gets blurred.
3. In the Microscope tool in the Right Tool Area, click Create.
à The set amount of immersion fluid is applied to the objective. The image gets sharp, refo-
cusing the sample may be required.
4. Start your experiment.
5. If the immersion gets too low during the experiment, go to the Microscope tool and click
Renew.
à The immersion is renewed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1077


10 Systems & Components | 10.2 Axio Observer ZEISS

See also
2 Microscope Tool [} 1079]
2 Auto Immersion Tool [} 1080]

10.2.1.2 Establishing Immersion and Renewing it Automatically

Prerequisite ü You have started ZEN and the microscope is operational with the Auto Immersion device
completely installed and configured.
ü The immersion fluid level in the liquid reservoir of the Auto Immersion device is Sufficient.
ü For a robust auto immersion performance, use a default setting with 50% for stage speed
and 50% for stage acceleration. The settings for the stage depend on the used objective and
the distances to be traveled. Therefore, these settings can be optimized by the user for differ-
ent applications (speed vs. robustness).
1. On the Acquisition tab, activate Auto Immersion.
à Auto immersion is activated and the tool is displayed on the Acquisition tab.
2. Focus on the sample with a low NA overview objective, e.g. 5x or 10x objective.
3. Set up your acquisition experiment and select the immersion objective in the Microscope
tool in the Right Tool Area. Alternatively, select the immersion objective with the Micro-
scope Control tool on the Locate tab. In both cases the objective is illustrated with a little
water drop icon.
4. In the Microscope tool in the Right Tool Area, click Create.
à The immersion is created by adding the immersion fluid to the objective. Alternatively, if
the oil stop is activated, the auto immersion objective stays in the load position and a
pop up window is displayed asking to apply immersion or clean the objective/specimen.
By clicking Continue and Create Immersion, the selected immersion objective is going
into the work position and the immersion fluid is applied automatically.
à After clicking Create, the settings for time interval and travel distance are used for auto-
mated immersion renewal. During Live, Continuous, or an experiment the immersion
will be renewed now when the dedicated auto immersion objective is used.
à Only clicking Create in ZEN (in the Microscope tool) or Continue and Create Immer-
sion in the oil stop message for immersion change initiates the auto immersion renewal
with the global timer.
5. To configure the automatic renewal of the immersion, go to the Auto Immersion tool on
the Acquisition tab and set a time interval (in minutes) and a stage travel distance (in mm)
after which the immersion should automatically be renewed. Depending on the ventilation,
air dryer performance and the air condition, this can vary a lot between different labs. For
information about parameter values suitable for different environmental conditions, see
Settings for Automatic Immersion Renewal [} 1079].
6. Start your experiment, or a live image or continuous image acquisition.

10.2.1.3 Changing the Auto Immersion Module to New Objective on TFT

Prerequisite ü You have started ZEN and the microscope is operational with the Auto Immersion device
completely installed and configured.
ü Stand and software are switched on and in operation mode.
1. On the TFT, select Home > Settings > Extras > Immersion.
2. Press the button below Nosepiece position with Autoimmersion.
à A window opens.
3. Use the arrow keys to select the objective position with the auto immersion setup that will
be used for auto immersion experiments.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1078


10 Systems & Components | 10.2 Axio Observer ZEISS

4. Click Save, otherwise the selected objective with auto immersion is not changed.
à The selected objective is marked with a black circle on the TFT.
5. To activate the auto immersion also in the software, restart it.
à The auto immersion position is visualized by a drop within the objective icon.
à The auto immersion position can also be changed under the auto immersion module op-
tion in the MTB.

10.2.1.4 Settings for Automatic Immersion Renewal

Depending on ventilation, air dryer performance, humidity and the air condition, the settings for
auto immersion and the automatic renewal of the immersion can vary a lot. The following table
provides an overview what values might be suitable for the parameters. Note that these values
only serve as orientation.

Room Temperature 37°C


Renew every Minutes mm Minutes mm
Slide 40-75 300-500 20-40 200-400
(75x25mm)

Dish (35mm) 40-75 300-500 20-40 200-400

Chamberslide 40-75 300-500 20-40 200-400


(8x)

Multiwell (6, 40-75 300-500 20-40 200-400


12, 24, 48, 96)

10.2.1.5 Microscope Tool

Parameter Description
Objective List Selects the objectives and pre-magnification. The color bar on the ob-
jective buttons indicates the color for the respective stage limit indica-
tor inside the Navigation tab.
If you select autocorr objectives (motorized correction collar) you can
additionally adjust the relevant settings like Correction Mode, Bot-
tom Thickness or Imaging Depth.
If you have an auto immersion objective available, this objective is il-
lustrated with a little water drop icon next to the magnification.

Tank Level Displays the tank level of the auto immersion tank.
§ Sufficient (green): More than 25% of immersion fluid remains.
§ Low (red): Less than 25% immersion fluid remain, you have to refill
it.

Create Creates the first time immersion by adding the immersion fluid to the
objective and starts the global timer and distance measurement for
automated renewal of the immersion fluid..

Renew Renews the immersion by injecting a predefined amount of fluid on


the objective to compensate for losses of immersion fluid during the
experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1079


10 Systems & Components | 10.2 Axio Observer ZEISS

See also
2 Establishing and Renewing Immersion Manually [} 1077]
2 Establishing Immersion and Renewing it Automatically [} 1078]

10.2.1.6 Auto Immersion Tool

Parameter Description
Renew Every Sets the time interval in minutes (10 to 120 minutes) and/or the travel
distance (200 mm to 1000 mm) of the stage in mm, after which the
immersion is automatically renewed.

See also
2 Establishing Immersion and Renewing it Automatically [} 1078]
2 Settings for Automatic Immersion Renewal [} 1079]

10.2.1.7 Overview of the Recommended Objectives

Info
For additional information and detailed descriptions, refer to further applicable documents or
ask your ZEISS Sales & Service Partner.

Name Description/Info Recommended set-


ting for Create im-
mersion
LD LCI Plan-Apochromat 25x/0.8 Imm Corr 420852-9871-000 3
DIC M27

LD LCI Plan-Apochromat 25x/0.8 Imm Corr 420852-9871-799 3


DIC M27

C-Achroplan 32x/0.85 W Corr M27 420967-9970-000 3

LD C-Apochromat 40x/1.1 W Corr M27 421867-9970-000 2

LD LCI Plan-Apochromat 40x/1.2 Imm Corr 420862-9970-000 2


DIC M27

LD LCI Plan-Apochromat 40x/1.2 Imm Corr 420862-9970-799 2


DIC M27

C-Apochromat 40x/1.2 W Corr M27 421767-9971-000 2

C-Apochromat 40x/1.2 W Corr M27 421767-9971-711 2

C-Apochromat 40x/1.2 W Corr M27 421767-9973-000 2

C-Apochromat 40x/1.2 W Corr FCS M27 421767-9973-713 2

C-Apochromat 40x/1.2 W Corr M27 421767-9973-799 2

LD C-Apochromat 63x/1.15 W Corr M27 421887-9970-000 2

C-Apochromat 100x/1.25 W Corr M27 421797-9970-000 2

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1080


10 Systems & Components | 10.3 Axioscan ZEISS

10.3 Axioscan

10.3.1 Introduction

Fig. 85: Axioscan system


ZEN slidescan is a software package that offers all tools and functions you need to operate the
Axioscan.Z1 and Axioscan 7. Note that Axioscan refers to both the Axioscan.Z1 and the Axioscan
7 scanner. For brevity through-out this documentation, we refer to both products as Axioscan.
The software includes the possibility of creating z-stack and extended depth of focus images.
With it you can automatically generate high-resolution images (virtual slides) from your speci-
mens. The system is able to perform these scans in brightfield, polarization and also multi-channel
fluorescence mode.
The Axioscan is mainly operated through its software. For details regarding the operation of the
hardware and other hardware related procedures (like exchange of filter sets, etc.) refer to the lat-
est hardware manual of Axioscan. As Axioscan includes a built-in magazine with a 3 or 25 slide
capacity, the software deals with scanning the specimens, operating the magazine, and handling
the slides (including the status of the slides). This is visualized in the graphical user interface.
This software guide describes the specific operation of the ZEN slidescan software and not the
general ZEN functionality. For general ZEN functionality consult the general ZEN help. The infor-
mation included in this document is also available via the online help (F1). Here you can conve-
niently access the required information in the context of the function you are using.
For a proper and reliable operation of ZEN slidescan follow the standard operation procedure de-
scribed by SOP - Restart Software [} 1106].

10.3.2 Working with ZEN slidescan

The general acquisition workflow for ZEN slidescan centers around the following two main ac-
tions:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1081


10 Systems & Components | 10.3 Axioscan ZEISS

1. Setting up your scan profile(s), see Setting Up Scan Profiles [} 1082], including the advanced
setup of the profiles, see Working in the Advanced Scan Profile Editor [} 1083].
2. Starting your actual scan based on the created profiles, see Starting Your Scan Experiment
[} 1097].

10.3.2.1 Setting Up Scan Profiles

The following steps will show you how to set up brightfield, fluorescence or polarization scan
profiles. You can set up a basic profile with the Smart Profile Selection [} 1118] wizard and refine
it in the Advanced Scan Profile Editor [} 1120], or you can set up your profile directly with the
Advanced Scan Profile Editor [} 1120]. In both cases a software wizard guides you through the
necessary steps required to create scan profiles. To navigate between the steps you can use the
Next and Back buttons. In the case of the Advanced Scan Profile Editor, you can also directly
click on a specific step without the need to go through all steps all the time. If you click Cancel,
all changes you made will be discarded. When you click Finish, all changes made are stored in the
scan profile.

Info
Advanced Editor
The editor can be switched between basic mode and Show all mode . In most cases the basic
mode should be sufficient for setting up scan profiles. It is easier to use as it only contains the
most important controls. If you are missing an option, activate Show all to see all options.

10.3.2.1.1 Setting Up Profiles with the Smart Profile Selection Wizard

Info
Profiles in Smart Profile Selection
Any profile created in the Smart Profile Selection is derived from a pool of default profiles
which are installed on the system. The templates themselves cannot be changed by the user,
but the resulting user profiles can of course be further adapted. User profiles are stored in the
ZEN user data folder: C:\Users\<username>\Documents\Carl Zeiss\ZEN\Documents\Scan Pro-
files\v5

1. In the Magazine view, click Smart Profile Selection.


à The Smart Profile Selection [} 1118] wizard opens.
2. Click through the steps to set up the best suitable profile.
à You are now guided through a decision tree to find the suitable profile for your applica-
tion. The steps are illustrated with pictograms to simplify the visualization process. Once
this is complete, the software presents you with the most appropriate profile for your ap-
plication/specimen.
3. If necessary, change the Name and Description of the profile in the last step of the wiz-
ard.
4. Click Finish.
à The profile is copied to the user profile folder. You can see the profile as an additional
item in your profile list.
à The Smart Scan Profile Selection wizard closes.
You have set up a basic profile with the Smart Profile Selection wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1082


10 Systems & Components | 10.3 Axioscan ZEISS

The Advanced Scan Profile Editor [} 1120] automatically opens to give you the opportunity to fur-
ther adapt this profile to your specific needs. For more information, see Working in the Ad-
vanced Scan Profile Editor [} 1083].

10.3.2.1.2 Setting Up a New Profile Without the Smart Profile Selection Wizard

1. At the top of the Magazine view, click and select Create New Scan Profile.
2. Enter the name of your new profile and click . Alternatively, enter the name and
press Enter. The name must have at least one character.
à The new profile is created and the Advanced Scan Profile Editor [} 1120] opens.
3. Set up your profile in this advanced editor. For detailed information, see Working in the
Advanced Scan Profile Editor [} 1083].

10.3.2.2 Working in the Advanced Scan Profile Editor

In general, the work in the Advanced Scan Profile Editor includes the following work/steps:

1. In the beginning, you get an Overview [} 1120] of your current profile, see Starting the
Setup in the Advanced Scan Profile Editor [} 1083].
2. In the Label [} 1120] step, you set up the scan of the label area of your slide, see Configur-
ing the Scan of the Label Area [} 1084].
3. In the Preview [} 1123] step, you set up the preview image acquisition, see Setting Up the
Preview Acquisition [} 1085].
4. If you selected the scan camera for your preview instead of the preview camera, you set it
up in the Pre-Scan [} 1124] step, see Setting Up a Pre-Scan [} 1088].
5. In the Sample Detection Settings [} 1126] step, you define the settings to detect the re-
gions in your sample that should be scanned, see Defining the Sample Detection Settings
[} 1089].
6. Then you create a coarse and a fine focus map in the Focus Map Settings [} 1133] steps,
see Adjusting Settings for Coarse Focus Map [} 1089] and Adjusting Settings for Fine Fo-
cus Map [} 1092].
7. In the Scan [} 1138] step, you finish the setup for the scan of your slides, see Adjusting
Scan Settings [} 1093].

10.3.2.2.1 Starting the Setup in the Advanced Scan Profile Editor

Prerequisite ü You are in the Overview [} 1120] step of the Advanced Scan Profile Editor [} 1120].
ü You have given the new profile a unique name.
1. In the Description field, adapt the description of your profile, if necessary.
2. If you have started the editor either with a new or a default profile created by the Smart
Profile Selection wizard, select the Tray and Slide the profile should be based on and
click Load Slide. This step is optional, but is usually helpful as it enables you to set up the
scan parameters such as brightness and exposure time based on the samples that are
scanned later.
à You have selected the Tray and Slide the profile is based on.
3. Click Next.
à The Label [} 1120] step opens.
You have started the advanced setup of your scan profile and can continue with the Label [} 1120]
step. For more information, see Configuring the Scan of the Label Area [} 1084].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1083


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.2.2.2 Configuring the Scan of the Label Area

Prerequisite ü You are in the Label [} 1120] step of the Advanced Scan Profile Editor [} 1120].
1. Set up the acquisition for the scan of the label area and adjust the Exposure, if necessary.
à A live image is displayed in the center view of the wizard. The label is illuminated from
the top to create a reflected light appearance of the label.
2. If required, select the form of text/barcode recognition by activating OCR or Barcode re-
spectively. Note that OCR is only available if you have licensed the respective module.
à The text is displayed in the Recognized Text field below.
3. Click Next.
à The Preview [} 1123] step opens.
You have configured the scan of the label area and can continue with the Preview [} 1123] step.
For more information, see Setting Up the Preview Acquisition [} 1085].

10.3.2.2.2.1 Setting Up the Label Scan for 4"x3" Slides

If you have inserted 4”x3” slides, the Label step has some additional functions. This is based on
the fact that the preview image for the label is a montage of two images created with the pre-
view camera.

Info
Recognition and Label Orientation
In the mode for the 4”x3” slides the Recognition and Label Orientation expander is only
available in the Snap mode, thus the two stitched images are displayed.

Prerequisite ü You have inserted 4”x3” slides.


1. In the Advanced Scan Profile Editor [} 1120], open the Label [} 1120] step.
à The Live mode for the upper image is activated automatically.
2. Click Upper Side or Lower Side to see the live image of the respective view.
à The live image is displayed.
3. Check the settings for Exposure and White Balance and adapt them, if necessary.
4. Click Snap.
à Two images are acquired and stitched together.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1084


10 Systems & Components | 10.3 Axioscan ZEISS

5. If necessary, adjust the red frame that defines the acquisition region for the label.

You have set up the label scan for the special 4"x3" slides.

10.3.2.2.3 Setting Up the Preview Acquisition

Prerequisite ü You are in the Preview [} 1123] step of the Advanced Scan Profile Editor [} 1120].
1. Adjust the red frame (region of interest) in the live image to define the area, where you ex-
pect the sample to be. For more information, see Setting Up the ROI for the Preview Im-
age [} 1086].
à A live image is displayed. The slide is illuminated from below to create a transmitted light
image of the sample.
2. If necessary, adapt the camera settings like the Exposure or White Balance.
à The display of the live image is adjusted accordingly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1085


10 Systems & Components | 10.3 Axioscan ZEISS

3. Select the camera on which the sample detection is based on.


The Preview Cam is used by default to create a preview of the slide. If the sample is not
visible in the preview image due to low contrast, you can select the Scan Cam to create
the preview image. In this case an additional step is added to the editor which allows you
to setup a scan method with a suitable contrast.
Note that if a scan region (green outline) is already defined and you select the Scan Cam,
these scan regions are deleted and the scan status for the selected slide is set to the status
New.
4. Click Next.
à If you have selected the Preview Cam, the Sample Detection Settings [} 1126] step
opens. If you have selected the Scan Cam, the Pre-Scan [} 1124] step opens.
You have configured the scan of the label area and can continue with the Sample Detection Set-
tings [} 1126] or Pre-Scan [} 1124] step. For more information, see Defining the Sample Detection
Settings [} 1089] or Setting Up a Pre-Scan [} 1088] respectively.

10.3.2.2.3.1 Setting Up the ROI for the Preview Image

An important adjustment to be made is the definition of the ROI (region of interest) for the pre-
view image of the specimen area. The system takes this region of interest and captures it. The au-
tomatic sample detection (if selected) is also applied to this region of interest.

1. In the Live image, select the red rectangle.

2. Reposition the rectangle via drag and drop, if necessary. Avoid that the red frame covers
the label area of the slide.
3. To resize the rectangle, click on the respective handles and move it with pressed mouse
button, as you would resize any graphic element.
You have set up the ROI for the preview image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1086


10 Systems & Components | 10.3 Axioscan ZEISS

Info
Optimal Size of ROI
For best results when doing bright field scans, the red frame should enclose the complete slide
and some space around it. Especially for the detection of an empty area on the slide, for the
automated shading correction on glass, it is important that the red frame is not set too small
(e.g. around the tissue only). Otherwise the sample could be considered as empty region. This
would result in a sup-optimal shading correction. If you want to limit the range for the sample
detection use the red frame in the Sample Detection Settings step.

Info
Adjust Display Settings
You have the possibility to adjust the display curve (see Display Tab [} 1043] on the bottom of
the wizard). The display settings are stored within in the profile. This has also an impact on the
display of the label in the Magazine View [} 1142] as well as how the specimen area is dis-
played in the Magazine view.

10.3.2.2.3.2 Setting Up the Preview for 4"x3" Slides

If you have inserted 4”x3” slides, the Preview step has some additional functions. This is based
on the fact that the preview image of the specimen area is created by a montage of two images
from the preview camera.

Prerequisite ü You have inserted 4”x3” slides.


1. In the Advanced Scan Profile Editor [} 1120], open the Preview [} 1123] step.
à The Live mode for the upper image is activated automatically.
2. Click Upper Side or Lower Side to see the live image of the respective view.
à The live image is displayed.
3. Check the settings for Exposure and White Balance and adapt them, if necessary (usually
the standard settings should work and an adjustment is not necessary).
4. Click Snap.
à Two images are acquired and stitched together.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1087


10 Systems & Components | 10.3 Axioscan ZEISS

5. If necessary, adjust the red frame that defines the acquisition region for the scan.

You have set up the preview for the special 4"x3" slides.

10.3.2.2.4 Setting Up a Pre-Scan

Prerequisite ü In the Preview [} 1123] step, you have selected the Scan Cam because the sample is not visi-
ble in the preview image created by the preview camera due to low contrast.
ü You are in the Pre-Scan [} 1124] step of the Advanced Scan Profile Editor [} 1120].
1. In the Channels section, set up a channel for creating a pre-scan image. Select a contrast
method which is suitable to provide a good preview of the sample. This can be e.g. TIE or a
fluorescence channel.
2. Adjust the red frame to define the area where you expect the sample to be. Contrary to the
recommendation for bright field preview, select a size as small as possible to reduce scan
times.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1088


10 Systems & Components | 10.3 Axioscan ZEISS

3. To reduce pre-scan time, in the Acquisition Mode section (only visible if Show All is acti-
vated), select a high Binning and Gain as well as a short exposure time.
4. Click Find Focus to start the autofocus.
5. Adjust the exposure time and the illumination so that you can see the sample with a quality
which is sufficient to detect the sample in the Sample Detection step, either automatically
or by drawing in a scan ROI.
6. Click Start Prescan to start a pre-scan. Note: Since for creating a prescan the system does
not yet know where the sample is located, placing focus support points which lie within the
sample cannot be guaranteed. Five focus support points are placed in the sample, one in
each quadrant of the scan ROI and a fifth one in the center. Focus support points which do
not hit the sample will automatically be discarded.
7. If your sample is now correctly visible in the image, click Next.
à The step Sample Detection Settings [} 1126] opens.
You have set up your pre-scan and can continue with the setup on the Sample Detection Set-
tings [} 1126] step. For more information, see Defining the Sample Detection Settings [} 1089].

10.3.2.2.5 Defining the Sample Detection Settings

Prerequisite ü You are in the Sample Detection Settings [} 1126] step of the Advanced Scan Profile Editor
[} 1120].
1. Select the Sample Detection Processor. You have the choice to define a standard sample
detection, or you can select Custom Sample Detection to define a custom sample detec-
tion with the help of a image analysis and/or a macro.
2. In case of Custom Sample Detection, activate Use Image Analysis and/or Use Macro
and select the respective analysis setting or macro. If you activate both, the macro is exe-
cuted first and then the image analysis is performed to detect the sample.
3. In case of Standard sample detection, select the Sample Detection Mode. You have the
choice to set up the sample detection manually, interactively, or automatically. Interactive
means, that the sample detection is done automatically, but that the scan is interrupted to
allow checking the results with the Sample Detection wizard before continuing the scan.
4. If you have selected an automatic mode, select a Recognition Type and adjust the detec-
tion threshold using the histogram controls. For more information, see Sample Detection
Settings for Automatic and Interactive Mode [} 1127].
5. If you have selected the manual mode, draw your graphics into the image or define your
grid. For more information, see Sample Detection Settings for Manual Mode - Creating A
Grid [} 1131].
6. Click Next.
à The Coarse Focus Map [} 1133] step opens.
You have set up your sample detection settings and can continue with the setup on the Coarse
Focus Map [} 1133] step. For more information, see Adjusting Settings for Coarse Focus Map
[} 1089].

10.3.2.2.6 Adjusting Settings for Coarse Focus Map

In the Coarse Focus Map step, the system tries to find roughly the focus position, where the
sample is located. This is in preparation for creating the fine focus map which is used during scan-
ning. Ideally, you should use the smallest magnification objective here (5x). Image quality at this
step is not important, it must just be good enough to guarantee good focusing.
To adjust the coarse focus map, follow this description. For general information about focus
maps, see Focus Maps [} 1108].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1089


10 Systems & Components | 10.3 Axioscan ZEISS

Prerequisite ü You are in the Coarse Focus Map [} 1133] step of the Advanced Scan Profile Editor [} 1120].
1. In the Light Path Components section, select an objective with low magnification.
2. In the Channels section, add a channel which is suitable for focusing, e.g. TIE is suitable for
most biological tissues. Select a channel that distributes the signal homogeneously in the
sample. Note that if more than one channel is added here, only the reference channel is
used.
3. Navigate to the specimen with the Stage tool. Alternatively, click inside the slide shown in
the Navigation tab and the software moves to the specimen at the selected position.
4. Click Live or Snap to check the (live) image.
à The live image is displayed.
5. Click Find Focus to start the autofocus.
6. Check the image and adjust the Exposure and focus settings, if necessary. The medium
setting is usually sufficient for coarse focusing. Note that for all transmitted light channels
utilizing the flash operation the search range setting is ignored as a full z-stack is always ac-
quired quickly.
7. Go to the Focus Point section.
à By default, Use Adaptive Focus Point Distribution is activated. For more information,
see Using Adaptive Focus Point Distribution [} 1091].
8. If Use Adaptive Focus Point Distribution is deactivated, see Adding or Modifying Focus
Point Distribution Strategies [} 1090].
9. To display and verify the focus points, click Verify Support Points. Note that this option is
only available if the editor has been opened for a particular slide with existing preview.
à The Focus Point View [} 1153] opens. For more information, see Working with Focus
Points [} 1096].
10. Select a Sharpness Measure Set. For detailed information, see Focus Map Settings
[} 1133].
11. Click Next.
à The Fine Focus Map [} 1133] step opens.
You have set up your coarse focus map and can continue with the setup on the Fine Focus Map
[} 1133] step. For more information, see Adjusting Settings for Fine Focus Map [} 1092].

See also
2 Focus Point Strategy Sets [} 1135]

10.3.2.2.6.1 Adding or Modifying Focus Point Distribution Strategies

Prerequisite ü You are in the Coarse Focus Map or the Fine Focus Map step of the Advanced Scan Pro-
file Editor [} 1120].

1. Click to add a new focus point distribution strategy. Alternatively, double click an ex-
isting entry to modify it.
à The Add focus point distribution strategy dialog opens.
2. Select the desired Strategy and set its individual parameters, if necessary. For information
on the individual strategies, see Focus Point Strategy Sets [} 1135].
3. Click Add.
à The strategy is added to the table and the dialog closes.
You have added or modified a focus point distribution strategy. You can continue the setup of the
remaining parameters, see Adjusting Settings for Coarse Focus Map [} 1089] or Adjusting Set-
tings for Fine Focus Map [} 1092].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1090


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.2.2.6.2 Using Adaptive Focus Point Distribution

This functionality is only available if Show all is activated. If samples on a slide have different
sizes, it is not possible to use only one focus point distribution strategy set. For smaller samples
like Tissue Micro Arrays the set Center of Gravity would be the best choice, for mid-sized speci-
mens Every Nth tile (with n = 3), and for larger objects the Onion skin.
To resolve this issue, ZEN offers a so-called Adaptive Focus Point Distribution. With this fea-
ture you can select a focus point distribution method based on the object size.

Prerequisite ü You are in the Advanced Scan Profile Editor [} 1120], in one of the Focus Maps steps
[} 1133].
ü You have activated Show All.
1. Activate the checkbox Use Adaptive Focus Point Distribution.
à The section Adaptive Focus Point Distribution is displayed.

2. In the Settings drop down list, select DefaultAFPDSetting. This creates five size-depen-
dent focus point distribution settings from 0 to 2500 mm2.

3. Click and select New.


4. Enter a name for the setting and click .
5. You can add new strategies by clicking , or modify an existing strategy by double
clicking the entry.
à A dialog opens with the settings for the new focus point distribution.

6. Select the start size of the object (the first should always start with 0). With the dropdown
menu you can select the desired Strategy. For information on the individual strategies, see
Focus Point Strategy Sets [} 1135]. Based on the selected strategy, the dialog displays other
possible settings (e.g. for Every Nth tile the value for N).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1091


10 Systems & Components | 10.3 Axioscan ZEISS

7. Click Add.
à The distribution strategy is added to the list.
8. Repeat the previous two steps until all your strategies are added, and then click Cancel to
close the dialog.
9. Click and select Save.
You have created a set of adaptive focus point distribution strategies and saved the setup. All the
added strategies are displayed in the list of the Adaptive Focus Point Distribution section.

10.3.2.2.7 Adjusting Settings for Fine Focus Map

NOTICE
Risk of damaging the objective
Too large focusing range could lead to damage of the objective and in extreme cases to dam-
age of the slide.
4 Based on the working distance of the objectives, the maximum focusing range must not
exceed 100 µm for a Plan-APOCHROMAT 40 x 0.95. For every other objective, a focus-
ing range below 500 µm is acceptable. This considers a typical cover slip thickness (170
µm) and a thickness of a specimen of around 10 µm. It is recommended to use a flash
based contrast method (e.g. TIE). In this case, since the flash modes are acquired very
quickly, it is not necessary to restrict the fine focus range to a very narrow range. The fine
focus map will be more reliable with a slightly larger focusing range.

This step works exactly as the Coarse Focus Map step. The difference to the Coarse Focus Map
is that here the focus map is created which is used during the scan. Here the same objective
should be used as in the final scan. To adjust the fine focus map, follow this description. For gen-
eral information about focus maps, see Focus Maps [} 1108].

Prerequisite ü You are in the Fine Focus Map [} 1133] step of the Advanced Scan Profile Editor [} 1120].
1. If you want to copy the channel settings from the Coarse Focus Map step, click Copy
Previous Setting.
à All channel settings of the Coarse Focus Map step are copied into this step. The 5x ob-
jective is exchanged with the 20x automatically. If no 20x objective exist, the smaller
magnification objective with the largest numerical aperture available on the system is se-
lected.
2. If you want to change the automatically selected objective, select the objective with which
you also want to perform the actual scan in the Light Path Components or in the Experi-
ment Settings section (depending on whether Show All is activated or not).
3. In the Channels section, add a channel which is suitable for focusing. Note that if more
than one channel is added here, only the reference channel is used for focusing.
4. Navigate to the specimen with the Stage tool. Alternatively, click inside the slide shown in
the Navigation tab and the software moves to the specimen at the selected position.
5. Click Live or Snap to check the (live) image.
à The live image is displayed.
6. Click Find Focus to start the autofocus.
7. Check the image and adjust the Exposure and focus settings, if necessary.
8. Go to the Focus Point section.
à By default, Use Adaptive Focus Point Distribution is activated. For more information,
see Using Adaptive Focus Point Distribution [} 1091].
9. If Use Adaptive Focus Point Distribution is deactivated, see Adding or Modifying Focus
Point Distribution Strategies [} 1090].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1092


10 Systems & Components | 10.3 Axioscan ZEISS

10. To display and verify the focus points, click Verify Support Points. Note that this option is
only available if the editor has been opened for a particular slide with existing preview.
à The Focus Point View [} 1153] opens. For more information, see Working with Focus
Points [} 1096].
11. Select a Sharpness Measure Set. For detailed information, see Focus Map Settings
[} 1133].
12. Click Next.
à The Scan [} 1138] step opens.
You have set up your fine focus map and can continue with the setup on the Scan [} 1138] step.
For more information, see Adjusting Scan Settings [} 1093].

See also
2 Focus Point Strategy Sets [} 1135]

10.3.2.2.8 Adjusting Scan Settings

To adjust the scan settings, follow this description.

Info
Camera
When adding a channel for a contrast method, the system automatically selects the suitable
camera, for example a monochrome camera for fluorescence or a color camera for brightfield
or polarization. When mixing brightfield and fluorescence channels, only one camera can be
selected for the scan setting.

Info
Scan Settings
You can select more channels than you actually need for the experiment to make the profile
more universal, and you can select and deselect single channels at a later stage.
The focus is defined by the fine focus map. The reference channel in the Channels section is
used just for focusing during setup of the scan step and also defines the stitching reference
channel.

Prerequisite ü You are in the Scan [} 1138] step of the Advanced Scan Profile Editor [} 1120].
1. If you want to take the settings from the Fine Focus Map step, click Copy Previous Set-
ting.
à All settings of the Fine Focus Map step are copied into this step.
2. In the Light Path Components or in the Experiment Settings section (depending on
whether Show All is activated or not), select the objective.
3. In the Channels section, add all required channels for your scan.
4. Navigate to the specimen with the Stage tool. Alternatively, click inside the slide shown in
the Navigation tab and the software moves to the specimen at the selected position.
5. Click Live to check the (live) image.
à The live image is displayed.
6. Check the image and adjust the Exposure settings, if necessary.
à For brightfield or polarization, the color camera is used and automatically set to 8/24 bit.
Try to fill the image histogram well, but avoid saturation.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1093


10 Systems & Components | 10.3 Axioscan ZEISS

à For TIE or Fluorescence, the monochrome camera is automatically chosen and is set to 14
bit. Try to set exposure and lamp brightness that the structures are well visible but avoid
unnecessarily long exposure times and saturation, especially for fluorescence.
7. Click Find Focus to use the autofocus with the selected reference channel.
à Focusing during the scan is done via the coarse and fine focus strategy. Focusing during
setup of the scan experiment is only used to help setting up the conditions of the experi-
ment and also to determine possible focus offsets between channels. This is why the ref-
erence channel used for focusing in this step can be different from the channel used in
the fine focus strategy.
8. Go to the section Z-Stack Configuration and set up a z-stack acquisition, if required. For
more information in this particular context, see also Determining the Z-Stack Configura-
tion [} 1094].
9. Go to the Online Processing section.
10. Define how the stitching is carried out.
11. Select Online, if stitching should be performed during the acquisition. The standard setting
is online stitching as this provides the best performance in terms of the processing time of
the slide.
12. If you selectOffline, the image is acquired and then stitched automatically after the acquisi-
tion is finished. This method can produce better stitching results over all, but the stitching
time is added to the total scan time.
13. If you select None, no stitching is applied at all. The image is unstitched and can be
stitched later within ZEN slidescan clinical or with another software. This option reduces
processing load for the system and can sometimes be helpful when acquiring very large im-
ages.
14. If the offline mode is selected, you can activate Fuse, so the system fuses the tiles after
stitching. This can sometimes reduce shading effects. However, due to limitations in the
maximum file size accepted by the operating system, images will still consist of tiles but in
this case without overlap.
15. Activate Pyramid active (should always be activated, as this will speed up the viewing of
the image afterwards).
16. Adjust the compression settings which are applied as part of the online processing.
à If JpegXR active is deactivated, the image is saved uncompressed. Be aware, that un-
compressed Axioscan images can be quite large files on disk and that data handling can
become a challenge. This is why lossy compression is always active by default.
17. If JpegXR active is activated, you can activate Lossless Compression so the image is only
compressed to the extent that no information is lost.
18. If Lossy Compression is activated, define the degree of Quality as the compression al-
ways involves a loss of information. In the case of polarization it may be sensible to select a
lower compression level (e.g. Lossless Compression), especially when acquired at 8/24 bit
depth as the standard lossy compression could result in visible compression artefacts in the
darker, low dynamic range image areas.
à You have set up the settings for scanning.
19. Click Finish.
à The editor closes and the profile is validated. For more information, see Profile Valida-
tion [} 1096].
You have set up and adjusted your scan profile with the advanced editor.

10.3.2.2.8.1 Determining the Z-Stack Configuration

The section Z-Stack Configuration is important if you want to automatically acquire a z-stack
with or without extended depth of focus (EDF). Note that, depending on the objective, con-
denser, and camera, a 20x Plan-APOCHROMAT 0.8 has a depth of focus of around 1 µm and the

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1094


10 Systems & Components | 10.3 Axioscan ZEISS

40x Plan-APOCHROMAT 0.95 has a depth of focus of around 0.5 µm. To scan any specimen
thicker than that with such objectives can pose a challenge. Acquiring a z-stack can in such cases
be helpful to record the entirety of the specimen in focus.

1. The best way to evaluate the optimal settings is to go to a representative region of the
specimen and focus through the specimen. Note down the focus values for when the sam-
ple gets into focus and out of focus again to determine the thickness. You can use the in-
formation displayed in the Focus tab at the bottom of the screen.

2. Click Reset to set the Measure Distance value to 0, e.g. at the focus position where the
sample first gets sharp. Then focus through the sample until your start losing focus again.
Note down the offset value. Using this it is easy to determine the thickness.
3. It is recommended to repeat this procedure for a few different regions of the specimen to
capture any variability in thickness.
4. Use the largest z-range, add 20% and use the result as the height of the z-stack. (Empirical
research has shown that it is recommended to add 20% to the z-range as the autofocus is
not always exactly in the middle of the specimen.)
5. Set the interval as desired. For brightfield, sampling according to the depth of focus of the
objective usually is sufficient. For fluorescence stacks which should be used for performing
3D deconvolution, setting an interval of half the axial resolution of the objective is recom-
mended. For the 20x Plan APOCHROMAT 0.8 objective, a interval of 0.5 µm would be suit-
able. However, this will result in a larger number of z-steps and a low scanning speed.
6. If you want to get a sharp image of a thick specimen and do not want to preserve the z-
stack, you can activate the extended depth of focus (EDF active).
à If active, the software uses the captured images in different focus planes for each image
field and combines the sharp information of all image planes and combines them into a
single sharp image of the whole sample
à It is strongly recommended to use the standard parameters, as these have been selected
for their optimal fit. For brightfield usually Variance is a good choice, while for fluores-
cence stacks maximum intensity projection (MIP) is working well.

See also
2 Manual Extended Depth of Focus Tool [} 247]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1095


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.2.2.8.2 Profile Validation

The software includes a profile validation. Thus, the system validates the profile if you leave the
advanced editor.
The profile validation makes sure that only meaningful profiles are created and also that the setup
of the profile does not lead to any risk to damage the system by the repetitive use of components,
which are not suitable for these high number of cycles. This includes things like making sure that
only one camera is used and that the condenser components are not unduly stressed by the se-
lected order in which images are acquired.

NOTICE
Risk of Premature Wear of Viluma 7
The intensive use of wavelengths 555nm and 590nm in parallel in one scan can result in pre-
mature wear of the Viluma 7. The bandpass switching component is not laid out for heavy
duty cycles. The profile validation will not prohibit the usage together in one scan, but will dis-
play a warning.

The software also validates the coarse and fine focus. It ensures that only one channel is activated
for each of the focuses and that the focus channel is activated as channel.
If the correction can be done without a user feedback, the change is applied and the user does
not get a message. For certain settings, the user is warned and can change the sub-optimal set-
tings, but can also accept it and the system finishes the profile setup. Critical settings, which can
harm the system, have to be changed before the user can finish the wizard.

NOTICE
Reduced Condenser Lifetime When Switching Components
The condenser of Axioscan 7 has several motorized components. Some of these components
are not designed to be switched constantly during an experiment. This is primarily relevant for
switching the modulation disk between channels, e.g. when acquiring cPol together with
brightfield the condenser lifetime would be quickly reached. The software therefore automati-
cally switches the order in which dimensions are acquired to the All tiles per channel mode. So,
instead of switching all channels for one tile, all tiles are acquired for one channel setting, the
condenser components switch and the second channel is acquired with all tiles. The resulting
images are then automatically aligned to each other. As a significant additional benefit of this
approach, the acquisition time is markedly reduced.

NOTICE
Severe Limitation of Condenser Lifetime in All Tiles Per Channel Mode
Forcing the system to operate the condenser in All Tiles Per Channel mode will severely limit
the lifetime of the condenser. This type of use is not intended. The software posts a warning
message every time this setting is wrongly set.

10.3.2.2.9 Working with Focus Points

Prerequisite ü You have opened the Focus Point View [} 1153] in the Focus Map Settings [} 1133] steps of
the Advanced Scan Profile Editor [} 1120], or you have opened the Sample Detection wiz-
ard and have activated the functionality to verify focus points.
1. To get the live image at a particular position, double click in the overview image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1096


10 Systems & Components | 10.3 Axioscan ZEISS

à The stage and live image moves to the respective position.


2. To set a new focus point, right click the respective position in the overview image below
the table and select Insert Focus Point.
à A new focus point is added and displayed in the overview image as well as the table.
3. To move a point after it has been created, simply use drag and drop in the overview image.
à The focus point is repositioned.
4. To delete a focus point, right click it and select Delete Focus Point.
à The focus point is deleted.
5. To verify a focus point, select it in the table and click Verify.
à The autofocus starts at the selected point to verify the position. After a successful run, a
green checkmark is displayed in the table for the respective position.
à Be aware that while the system shows a circular symbol as focus point, the system will
actually place a tile around the focus point and focus using all the information coming
from the camera frame. While it might feel intuitive to place more focus points to get a
better focus, the opposite is actually true: adding too many focus points might lead to a
mathematically overfitting of the resulting focus map resulting in focusing problems.
You have successfully edited and/or verified your focus points.

10.3.2.3 Starting Your Scan Experiment

Prerequisite ü You have inserted all trays and slides that you want to scan.
ü You have set up the scan profile(s) for your specimens. For more information, see Setting Up
Scan Profiles [} 1082].
1. At the top of the Magazine view, select the scan profile you want to use for all slides with
status new.
à The scan profile is set for all slides with status new.
2. Activate all slides you want to scan.
3. If necessary, select or adapt the scan profile for each slide individually.
4. In the Naming Definition Tool [} 1148], select the naming definition for your images.
5. To create a preview scan first, click Start Preview Scan on the Scan Tab [} 1142].
à A preview scan is created for all activated slides.
6. To check and correct the sample detection results during your (preview) scan, use the Sam-
ple Detection Wizard [} 1119]. For more information, see Checking and Correcting Sample
Detection Results with the Sample Detection Wizard [} 1098].
7. To start your scan experiment, click Start Scan.
à The scan starts for all activated slides. Axioscan 7 clinical can only scan one slide at one
time.
8. To monitor your acquisition, use the Acquisition Monitoring Tool [} 1151]. For more infor-
mation, see Monitoring the Acquisition [} 1104].
You have started the scan for your slides.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1097


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.2.4 Viewing Scanned Slides

Info
Viewing/Processing Images During Scan
While it is possible to open and view scanned images while the system is still scanning slides, it
is not recommended to do image processing (using any of the functions available on the Pro-
cessing tab) while the system is active scanning. Image processing will consume computer re-
sources which are then not available for scanning slides, leading to slow down and possible in-
terruption of the scan.

Prerequisite ü The scan is finished.


1. Double click anywhere in the gray area of the row representing the slide.
à The image opens as a new document in the center screen area.
2. Using the tools of the software, you can now view the slide, change between scenes (for
multi-scene images), or channels (for multichannel images).
3. You can zoom into the image with the mouse wheel or the controls on the Dimensions
tab. To navigate on the image, use the mouse or navigator.
4. You can change the contrast by adjusting the display curve on the Display tab, annotate
the image with a scale bar or perform some simple interactive distance or size measure-
ments with the tools on the Graphics tab.

See also
2 Image Views [} 990]

10.3.2.5 Checking and Correcting Sample Detection Results with the Sample Detection Wizard

Prerequisite ü You are in the Magazine view.


ü You have started a preview scan for the respective slides.

1. Next to the scan profile of the respective slide, click and select Check and correct
sample detection results.
à The Sample Detection Wizard [} 1119] opens.
2. In the image, check the red rectangle, which defines the region where the automated sam-
ple detection is looking for specimens.
3. If necessary, adjust the red rectangle to include the specimen.
4. To mark additional regions of interest, select a graphical element in the Graphics tab and
set it up in the image.
à An additional region is added in the image. Note: Be aware that the Automatic Sample
Detection Mode will switch to Manual mode as soon as a Scan ROI is added manually.
This means that the modified scan profile is saved and will not detect tissues on other
slides any longer.
5. If necessary, adjust the settings on the left side, which are basically the same as in the Sam-
ple Detection Settings [} 1126] step of the Advanced Scan Profile Editor [} 1120].
6. If you want to see detected focus points, got to Show Focus Points and select which fo-
cus points should be displayed (of the Coarse Focus or the Fine Focus map).
à The focus points are displayed in the image. Note that you cannot adjust the region
when you are in focus mode, only when None is selected.
7. To relocate a point, use drag and drop.
8. To add an additional focus point, right click on the desired position and select Insert Focus
Point.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1098


10 Systems & Components | 10.3 Axioscan ZEISS

à A focus point is added.


9. If you want to check the sample detection results of other slides, click Previous Slide or
Next Slide to open the respective previous or next slide in this wizard.
10. If you are finished, click Finish.
à The Sample Detection Wizard [} 1119] closes.
You have checked and corrected the sample detection results of your preview scan.

10.3.2.6 Creating a Shading Reference from Tile Image

The functions Shading Reference for Acquisition (only available if you have started a profile
with acquisition) and Shading Reference for Processing are used to generate shading reference
images. The function Shading Reference for Acquisition creates a shading reference and
places it into the calibration manager. This reference can then be applied to all future scans auto-
matically to produce images without shading. With this function no separate shading reference
image is being created. The function Shading Reference for Processing creates a shading refer-
ence file as a separate document which can then be used by the Shading Correction function. It
does not place a reference into the calibration manager. This is to allow interactive shading cor-
rection of an already acquired image. Note that these processing functions cannot process z-stack
images.
While in principle applicable to all type of images, the main purpose is to be used for fluorescence
multichannel scans as creating a good shading reference is often difficult to achieve due to a lack
of suitable calibration samples. For brightfield scans, shading correction is done fully automatic
and this function should therefore not be needed.
The function Shading Reference for Acquisition creates a separate shading reference image for
every channel of the processed image. This image is stored directly to the calibration manager to
be available for the next scans.

Info
200+ Tiles needed
In order to produce a good shading reference image ideally more than 200 tiles should be
used per channel. This usually can only be achieved when scanning with 20x or higher magni-
fications. When scanning with 5x or 10x magnification, use a manual calibration available in
the channel tool of the Advanced Scan Profile Editor (--> Define).

Prerequisite ü You have created an image with all the channels for which you want to create a shading ref-
erence image. For a good reference image it is necessary to have a number of over 200 tiles
per channel.
ü Avoid any over- or underexposure in the input image.
ü Fill the dynamic range of the used camera to at least 30% of the histogram.
ü The acquisition of the input image must be done without activated shading correction.
ü It is recommended to turn off camera binning when acquiring the input image. The use of flu-
orescence slides for the creation of reference images for fluorescence has sometimes disad-
vantages (e.g. sparse distribution of the signal, bleaching). A good alternative is to use a stan-
dard H&E sample and utilize the autofluorescence of this sample. This usually produces good
shading references for a wide range of fluorescence channels (DAPI, FITC, Cy3).
ü It is advised to scan without overlap, besides the other above mentioned settings, the Smart
Profile Selection wizard provides a special profile for this purpose (reference sample). Use
this profile as a start profile for this kind of calibrations.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1099


10 Systems & Components | 10.3 Axioscan ZEISS

1. Open the image in the software.


2. In the Processing tab, under Method, select the function Shading Reference for Acqui-
sition or Shading Reference for Processing.
3. In the Input tool, open the created image.

4. Set the desired parameters. For a detailed description of the parameters, see Shading Ref-
erence for Acquisition [} 88] or Shading Reference for Processing [} 89].
5. Click Apply to start the processing function.

Info
Individual References for Multi Channel Image
While normally best to use the merge channel option, it is also possible to create individual ref-
erence files per channels. This might make it easier to assign the correct references to multi-
channel images with different channel combinations than present in the reference image.

See also
2 Creating a Shading Reference from Tile Image [} 1099]

10.3.2.7 Changing the Order of Slides and Trays

The Axioscan scans the slides in the order which is defined in the Magazine view. It is possible to
change the order of individual slides within a tray or move whole trays to another position, which
changes the order in which the system scans the slides. This can be done also while the system is
already scanning a slide. This way urgent samples can be moved forward and scanned sooner.

1. To move a slide to another position, grab the active area and drag it to the position you
want.

à The position of the slide is changed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1100


10 Systems & Components | 10.3 Axioscan ZEISS

2. To move a tray to another position, grab the border area of the tray and drag it to the posi-
tion you want.

à The position of the tray is changed.

10.3.2.8 Creating Your Own Image Naming Convention

1. In the Naming Definition tool, click and select New.


à An input field is displayed.

2. Enter a name and click . Alternatively, enter a name and press Enter.
à The Naming dialog opens.
3. Enter your naming choices for Prefix, Suffix, set the number of Digits and the Initial
Counter Value.
4. In the Format ID text field you can build your own preferred naming convention. This is
done by using variables which are listed in the information pop up window. Enter the de-
sired variable preceded by a % character, e.g. %N for the original name, %P for a fixed
prefix, %X for the date as defined in the computer date settings.
à The parameter IDs are added to and displayed in the Format input field, which would re-
sult in a string like this: %X-%P-%N. The resulting file name is displayed Name Preview
text field.
5. Click OK.
You have created your own naming convention to automatically name the acquired images.

10.3.2.9 Importing Names, Profiles and Scenes

Info
Insert the Trays
Before starting the import, you first have to insert the trays with the slides in the magazine,
only then can the software check for consistency.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1101


10 Systems & Components | 10.3 Axioscan ZEISS

This functionality can speed up the scan workflow considerably. It offers a possibility to assign
scan profiles, image names and scene names to a collection of slides and then start scanning, all
as one action. The import is done via a comma-separated values file (csv). For more information,
see General Information and Examples for Import [} 1102].

Prerequisite ü The slides you want to scan are loaded into the system and each slide has a defined tray and
slide position.
ü You know the names of the samples.
ü You have defined suitable scan profiles.
1. In the Naming Definition tool, click Import Name, Profile and Scene names.
à A file browser opens.
2. Navigate to the respective folder and select the .csv file.
3. Click Open.
The names, profiles and scenes information are imported based on the .csv file.

10.3.2.9.1 General Information and Examples for Import

The import is done via a comma-separated values file (csv). For each slide, one row has to be used
with one slide per text line in this format:

§ Tray number (absolute),


§ slide number (absolute),
§ image name,
§ profile name,
§ name for scene1, scene2, scene3, etc.
Tray and slide number have to be inserted, the other parameters are optional. It is possible to skip
certain entries and these entries are not changed by the import. The naming of the scenes starts
at the upper left object and continues to the right side. After all objects are assigned with a speci-
fied scene name the software will start at left at the second line of objects and continues to the
right side, etc.
Example for the scene name order assignment:

1 2 3 4

5 6 7 8

9 10 11 12

Examples

Example Description
Example A 1,1,Mouse1,Profile001,brain1,brain2,brain3
For the first slide of the first tray, the system defines Mouse1 as image
name and applies the Profile001. If the preview detects several
scenes, the system names the first scene brain1, the second scene as
brain2, etc.

Example B § 1,1,Mouse1
§ 1,2,Mouse2
§ 1,3,Mouse3

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1102


10 Systems & Components | 10.3 Axioscan ZEISS

Example Description
Here the system only applies the image names to the specified tray
and slide position.

Example C § 1,1,,Profile001
§ 1,2,,Profile002
§ 1,3,,Profile003

Here the system only applies the profile names to the specified tray
and slide position.

Notes
§ If the import file contains a profile which is not in the list of the available profiles, the soft-
ware displays a warning and no profile is applied (last selected profile remains selected).
§ If the import file contains a position which is not occupied by a slide, the software displays a
warning and skips the import for this slide position.
§ If you defined more scenes than the system detects during the preview, the system does not
display a warning and stops the naming assignment after the last detected scene.
§ If you defined less scenes than the system detects during the preview, the system does not
display a warning, names all the scenes where names are available and stops the naming.
However, all scenes will be scanned.
§ By default the comma (,) is used as separator. It is possible to select another separator (tabula-
tor, semicolon, space) in Tools > Options > Acquisition > Axio Scan.

10.3.2.10 Using Barcode to Define Name, Profile and Subfolder

1. In the Naming Definition tool, activate Name, Profile and Folder from Barcode.
à Several input mask fields are displayed.
2. In the input mask fields Name, Profile and Sub-Path, corresponding character numbers
defined in the barcode string. You can also define and combine number ranges similar as
you would when printing selected pages, e.g. 1-4,10-14.
3. Define the desired character numbers for the fields you want. If you do not want to use a
certain setting, simply leave the input field empty. Sub-Path defines a folder name which is
created as a subfolder in the storage path defined in the Storage Location tool where
scanned images are stored.
à If for Name a range is defined, the software inserts the text Name from barcode under
Naming (in the Magazine view), as the system does not know the naming until the bar-
code of this slide is read.
à The same applies for the profile, in this case the text is Profile from barcode. If the pro-
file is derived from the barcode, the system takes the label capture information (this in-
cludes the kind of barcode, etc.) from the profile selected on the top of the Magazine
view.
4. As coding of such profiles in the barcode is prone to errors, you can activate Match only
the beginning of scan profile name to use only the first characters to identify a profile. If
so, make sure to use a unique set of characters for the beginning of the profile you want to
use.
You have defined the name, profile or the subfolder based on the barcode. For additional infor-
mation, see Examples when Using a Barcode [} 1104].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1103


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.2.10.1 Examples when Using a Barcode

Example A
Character string encoded in barcode:

Example B
Barcode: Path_DoeJohn_003_FAST_HE

§ Path is the sub-path for saving


§ DoeJohn is the name of the image
§ 003_FAST_HE is the profile name
The barcode control for the example B above would have to look like this:

Example C
In administrating and creating profiles, you might prefer descriptive names to recognize them eas-
ier (e.g.: Brightfield-H&E-strong). The name could begin, for example, with an unique number
used as identification (use only name without the czspf extension). The profile could be named,
for example, 005_Brightfield-H&E-strong. You then enter 1-3 into the profile mask and activate
Match only the beginning of the profile name. Now, only the number 005 is used to identify
the profile. Make sure that only one profile name beginning with the characters 005 exists.

10.3.2.11 Monitoring the Acquisition

To check the image quality (e.g. focus and exposure time) during the scan, the Acquisition Moni-
toring Tool [} 1151] is available. When activated, camera frames are grabbed from the running
scan and displayed in regular intervals.

Info
Performance
Acquisition monitoring can have a negative impact on performance and should therefore be
used sparingly.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1104


10 Systems & Components | 10.3 Axioscan ZEISS

Info
Frame Rate
The frame rate is limited to 1 frame per second (fps) by default. You can globally change the
frame can rate limit under Tools > Options > Acquisition > Axioscan. Be careful when you
change this value, as this could result in e.g. black frames.

1. On the Scan tab, in the Acquisition Monitoring tool, activate Enable for current scan.
2. Click Start Scan to start your scan.
à The Acquisition Monitoring tool displays an overview of the specimen with a red rec-
tangle indicating the currently scanned region.

à An image document called Acquisition Monitoring, which displays the image of the
currently scanned region, is displayed in the Center Screen Area.

3. To check the image quality, click to stop the (live) acquisition monitoring.
à The monitoring pauses and the last acquired image is displayed. The image document
contains the complete information (e.g. the complete z-stack) which you can check.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1105


10 Systems & Components | 10.3 Axioscan ZEISS

4. Click to continue the acquisition monitoring.


You are monitoring the acquisition.

10.3.2.12 Using a Separate Folder for Temporary Files

During the scan process, the system creates temporary files, e.g. for the preview image, the label
image and others. These, together with the file for the actual scan result, are stored in the storage
location path by default. When the scan process is finished, the scan result image is saved. The
temporary files are then deleted. Sometimes, if, for example the scan results should be automati-
cally processed by some other software, the temporary files could cause these external software
to malfunction. Then it would be useful to store the temporary files in a separate folder.

Info
Location of temporary folder
This temporary folder should be located on the same physical storage device so that the final-
ized scan result can quickly be moved to the storage location.

Info
Preview and label image as individual files
You can also permanently store both preview and label image as individual files if these images
are required. For this, go to Tools > Options > Acquisition > Axioscan and activate Keep
separate label image and Keep separate preview image.

If you want to use a separate folder for temporary files, follow this instruction:

1. Go to Tools > Options > Acquisition > Axioscan.


2. Activate the checkbox Use separate folder for temporary files.
à A path for the temporary file folder is displayed.
3. If you want to change the folder, click Change Folder.
à A file browser opens.
4. Select the folder for temporary files and click OK.
5. Click OK to close the dialog.
You have set up a separate folder for saving the temporary files.

See also
2 Storage Location Tool [} 1150]

10.3.2.13 SOP - Restart Software

ZEN as application software relies on the stability and reliability of the used workstations operat-
ing system software. ZEN slidescan uses Microsoft Windows™ as operation system (currently
Windows 10). Therefore, ZEN cannot operate more reliable than the operation system itself. All
measures are taken to ensure a reliable and fast interaction between ZEN and the used operation
system, nevertheless general limitations of this operation system may apply. So it is recommended
to restart the complete system in regular intervals to ensure proper performance according the
following standard operating procedure (SOP).
Scope of application: This SOP is valid for all Axioscan system configurations (incl. control com-
puters) and all software versions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1106


10 Systems & Components | 10.3 Axioscan ZEISS

Prerequisite ü Make sure all scan processes are finished and ZEN is idle. The main status display on the de-
vice must light up continuously green.
1. Close ZEN and all other running application software.
2. Press the Standby button on the front of the Axioscan to shut down the device.
3. Shut down the control computer by means of the function provided by the operation sys-
tem.
4. Switch the control computer on by pressing the on/off button.
à The workstations operating system software has started successfully.
5. Press the Standby button on the front of the Axioscan to initialize the device and wait until
the system LED shines continuously green.
à The Axioscan system unit has been successfully initialized.
6. On the control computer, log into the Windows operating system.
7. Start the ZEN software for Axioscan (ZEN slidescan) on the control computer.
Axioscan, computer and software are now again ready for operation.
The recommended maximum period for continuous operation is five days, assuming a heavy use
of the system. While the system will likely operate for longer periods of continuous use without
problems, we still strongly encourage following this good practice and perform a restart every five
days.

10.3.3 Ensuring Correct Focus

It is important that the system scans all samples with the right focus, producing images with all
the relevant sample parts digitized sharp and not blurry. The main cause for blurry images are two
facts:
1. Samples are usually never perfectly flat
2. Microscope objectives have a narrow depth of focus
At the same time, the system must scan samples quickly. So using an autofocus routine for each
camera frame would not be a good option as this would lead to unacceptably long scan times.
ZEN slidescan clinical therefore employs a elaborate method to ensure optimal focus even with
difficult samples. Instead of continuously autofocusing, a focus map is used which allows the sys-
tem to automatically follow the sample's focus during rapid scanning. The following chapters ex-
plain this in detail.
Note: The explanations given in the following chapters assume the use of autofocusing using
classical image acquisition. Here stage and focus drives are operated in the start/stop mode. This
method is employed for all fluorescence scans. For brightfield imaging, the much faster flash
mode acquisition is used routinely, where the focus drive runs continuously and the camera ac-
quires images via a short strobe illuminated flash. Consequently, focusing is much faster for
brightfield so that the recommendations for reducing the focusing ranges to gain speed are not
as relevant. This means e.g. that the range for fine focusing in brightfield can be made larger and
therefore more robust against unexpected sample variations than recommended for fluorescence.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1107


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.3.1 Focus Maps

Fig. 86: Representation of a focus map


The focus map is simply a set of X, Y and Z coordinates that represent the surface of the detected
tissue section. While the slide is being scanned, the focus position changes continuously, follow-
ing the contours of the focus map. Each connecting point in the focus map is created as a result
of either a coarse or fine autofocus process. The following five points are important for success-
fully creating a focus map:
1. The lens used for either coarse or fine focus.
2. The 2D layout of focus points.
3. The autofocus range in coarse and fine.
4. The autofocus interval or step size in Z.
5. The autofocus algorithm used to calculate the focus.

10.3.3.2 Coarse and Fine Focus

Axioscan uses a two-step focusing method to give the best results. To understand how and why,
we need to look at a the microscope slide and specimen in terms of flatness. There are two types
of flatness that are important for Axioscan:

§ Macro-flatness: The overall tilt of the sample and/or slide


§ Micro-flatness: The small focus variations within the sample section
As a general rule: The coarse focus corrects for macro-flatness and the fine focus corrects for mi-
cro-flatness.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1108


10 Systems & Components | 10.3 Axioscan ZEISS

Fig. 87: Schematic display of macro and micro flatness


In the image above, you can see the macro-flatness variation as the range between the two heavy
black dotted lines (A). Tilt in the slide, cover slip and mounting thickness contribute to macro-flat-
ness. The specimen micro-flatness is shown as variations in sample level between the two solid
red lines (B). Both coarse and fine objectives work together to map the focus levels.

10.3.3.3 Coarse Focus Range

One of the first tasks is to define the focus range for the coarse focus objective lens. We have to
be able to find the whole sample and focus the lens on it. The size of the coarse focus range de-
pends on how macro-flat the specimen is.

As you can see in the image above, a specimen that is only slightly tilted requires a lower travel
range for the focusing mechanism than a specimen which is more strongly tilted.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1109


10 Systems & Components | 10.3 Axioscan ZEISS

Fig. 88: Measurement of macro flatness


Macro flatness can be measured by selecting a number of points of the sample (number depends
on size of section) and running an autofocus at each point using a focus range of 1000 µm to
start with. When you write down the z-position for each point (using the convenient focus tool in
the software), you can determine how macro-flat the sample is and what your optimum coarse
focus range should be.

10.3.3.4 Difference between Coarse and Fine Focus Range

A very important point is the difference between the coarse and fine focus range setup. As de-
scribed in the previous section, coarse focus can be defined using actual z-position values for the
top and bottom of the range.

Fig. 89: Relationship between coarse and fine focus range

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1110


10 Systems & Components | 10.3 Axioscan ZEISS

The image above shows the coarse focus as a range of points between two defined values (the
shown values are just exemplary, actual values will vary). Fine focus is different. Fine focus is a
range that is not defined by a top and bottom, but by the position of its middle or center. The
range is then set by defining a travel distance, for example 30µm. The result is a range that is
15um above and 15 micron below the center point. In the image, this is shown in green as the
range of 30 centered around 4010µm.
To define a focus position, the following happens:
1. 5x lens runs an autofocus over the defined range and sets a point of best focus (4000µm).
2. Axioscan changes to 20x fine focus and corrects for parfocality difference by applying an off-
set, in this case +10 µm (4000 + 10 = 4010).
3. The 20x defined range of 30 µm is then set around the new center focus value of 4010 by+
15 and -15, to give the full range of 30µm.
4. Micro-flatness variations can then vary by+/- 15µm and be successfully mapped for the scan-
ning process.

10.3.3.5 Coarse and Fine Focus Relationship

Fig. 90: Coarse and fine focus mapping


In the example shown above, several focus points have been measured by the 5x. For simplifica-
tion, only two are shown as red points 1 and 2. The coarse focus map creates a gradient between
these two points. Each fine focus point has its center position automatically placed on the red
coarse focus gradient. An autofocus point measurement is then attempted for each fine focus po-
sition. If the blue line representing the sample micro-flatness varies by less than 1Sum in either di-
rection, an autofocus point will be generated.
Green fine focus point number 2 will fail because for that position the micro-flatness variation has
a point of focus outside the fine focus range. The Axioscan will continue to map the specimen
with point 2 excluded.
There are two options here to solve this:
1. Enlarge the range of the fine focus 20x: The focus for this location is calculated, but all of
the fine focus points take longer to measure.
2. Increase the number of coarse focus points: Gives a more accurate fine focus center
point, but cannot guarantee the location of the new points.
The second option is preferable as increasing the fine focus range also increases the time it takes
for the fine focus points to be recorded.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1111


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.3.6 Overview of Coarse Focus Map in 3D

Fig. 91: Focus Point Distribution

Fig. 92: Autofocus at each point

Fig. 93: Grid lines between points

Fig. 94: Calculated coarse focus surface

Fig. 95: Interpolated focus points at each FOV

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1112


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.3.7 Autofocus Step Size (Interval)

The autofocus step size or interval is the distance between each focus point as the Axioscan scans
through the z-axis to find the best focus. The size of the interval determines the accuracy of the
autofocus result. If the interval is big, the autofocus will be less accurate or reliable. If the interval
is too small, the autofocus speed will be more precise and reliable, but the focus mapping step in
the scan will take longer. The optimal step size is one that closely matches the depth of focus
(DOF) for the lens being used.

Fig. 96: Objective lens depth of field (theoretical)


The values shown here are the sampling rate values used by the autofocus routine when set to
default and at 550nm wavelength. They are calculated as follows: according to the Abbe formula
the axial resolution of an objective is d(axial) = 2 * n (refractive index) * lambda (wavelength) / NA
(numerical aperture)^2. The Abbe value is also the one which is shown in the Info tab of an ac-
quired image. For use with the software autofocus this value is then multiplied with a oversam-
pling factor of 0.7 which produces the values shown in the chart. This default value can be halved
(Fine), doubled (Mean) or quadrupled (Coarse).
Finding the optimal step size is one of the most important factors in determining the speed of the
whole slide scanning process. Most scan protocols can be improved by changing the autofocus
step size either to speed up autofocus or make it more accurate.

10.3.3.8 Camera Settings for Focusing

It possible to use camera and illumination settings for focusing that are different to scanning. It is
important not to neglect the imaging settings for focus map creation. Autofocus algorithms work
on the basis of contrast between pixels. If the specimen is not correctly imaged (illumination and
camera), it gets harder for the algorithm to detect the correct focus level for the sample. If the
autofocus algorithm also requires color information, it is necessary to ensure the correct white
balance or color temperature. In short, it is recommended to use the same channel settings for
fine focusing as would be taken for actual scanning image setup.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1113


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.3.9 Data for Objective Lenses

Use the information in the image below to estimate the number of fields of view (FOV) that a tis-
sue section covers on the slide. This can help when assigning values for focus map point distribu-
tion density.

10.3.3.10 Information for Focus Point Distribution Strategies

A focus point distribution strategy is used to place the focus points for coarse and fine focus. As a
general recommendation, the use of the onion skin focus support point distribution method is a
good start and will work on many samples. With the ability to visualize the focus support points in
the software it is also possible to check if a selected strategy produces a reasonable focus support
point selection, see Working with Focus Points [} 1096]. However, keep in mind that it is possi-
ble to add too many support points, which leads to a problem caused by mathematical overfitting
of the focus map. Essentially this means that the focus map might have "valleys" and "mountains"
where the sample is actually flat. The following chapters describe in detail how to approach the
focus point distribution problem.

10.3.3.10.1 Recommended Focus Strategy for Small Sample Sections

Small sample sections like mouse testis or TMA cores do not usually require a large number of fo-
cus points in either coarse or fine.

Fig. 97: Small section - mouse testis

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1114


10 Systems & Components | 10.3 Axioscan ZEISS

Due to their small size and probable good macro-flatness either center of gravity or number of
points can be used for coarse focus. If number of points is the selected method, use a value of 4
for the number of points. Center of gravity always uses just 1 point per section.
Fine focus is more flexible because at 20x each section in covers about 100 FOVs (10 x 10). A
good strategy here would be to use every Nth tile with N = 2/3. A value of N higher than 3 proba-
bly results in too few focus points for a good focus map. Number of points could also deliver a
good result here with 5-6 points per section.

Fig. 98: Focus points with N = 3 at 20x for every Nth tile
All suggestions depend on sample preparation and with poor preparation even small tissue sec-
tions can be very un-flat requiring more focus points.

10.3.3.10.2 Recommended Focus Strategy for Medium Sample Sections

Medium sample sections such as mouse brains unsurprisingly need more focus points in coarse
and fine focus.

Fig. 99: Medium size sections - mouse brains


If your specimen preparation has good macro-flatness, it is possible to make the coarse focus us-
ing the number of points strategy. For a mouse brain section, the number of points should be
about 6-8. For less macro-flat preparations, it is recommended to use every Nth tile for both
coarse and fine focus.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1115


10 Systems & Components | 10.3 Axioscan ZEISS

Fig. 100: Coarse and fine point distribution using every Nth tile
You can see in the image above that for the 5x coarse focus, N=2 gives you six points and at 20x,
N=3 gives 26 points. For a slide of average flatness, this strategy would probably yield good re-
sults. In both cases it is possible to increase the number of focus points to make the focus map
more sensitive. At 5x N=1 is the same as every tile and would produce 21 focus points.
Be careful when using low values of N for fine focus. As you can see from the image, by changing
N=3 to N=2 you add an extra 31 focus points. This slows down the scan process and should be
avoided unless absolutely necessary. Some trial and error is always needed to fine the right com-
promise between speed and focus quality. As always, the flatter the sample the better.

10.3.3.10.3 Recommended Focus Strategy for Large Sample Sections

Large sample sections pose a new challenge as they cover a much larger area of the slide, some-
times all of the space under the coverslip.

Fig. 101: Large tissue sections - whole mouse embryo


Once a single section exceeds 2 cm2, it is important to ensure the focus map compensates for
macro-flatness and this is achieved with coarse focus. As a rule: if you get the coarse focus right
for a large section, the fine focus will improve dramatically.
See Coarse Focus Range [} 1109] for a description of how to measure macro-flatness. The guide-
lines for coarse focus strategy with large sections are generally the same as those for medium
sized sections. You just need more points to cover the larger sample area. However, the onion
skin strategy is useful for large sections under fine focus. Onion skin basically generates focus
points along concentric rings within the sample section. This means that the point distribution fol-
lows the shape of the section, producing a point layout with better coverage using less points
than every Nth tile.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1116


10 Systems & Components | 10.3 Axioscan ZEISS

Fig. 102: Mouse embryo with onion skin distribution at 20x (32 points)
Density is set 0.2 for the scan shown in the image above. This means the spacing of the concen-
tric ring layout used to position points is 20% of the width of the slide in the Y direction. Setting a
low number such as 0.1 and increasing the maximum number of points would result in a focus
map with more densely positioned points.

10.3.4 Reference

10.3.4.1 ZEN slidescan Wizards

The ZEN slidescan software includes different wizards:

§ Smart Profile Selection [} 1118]


§ Advanced Scan Profile Editor [} 1120]
§ Sample Detection Wizard [} 1119]
§ Slide Scanner Calibration Wizard [} 1118]
§ Slide Scanner Polarization Calibration Wizard [} 1141]
Each wizard has a certain functionality and/or provides a certain level of access to the functionality
of the Axioscan. A wizard usually contains several steps which guide you through all necessary
settings, e.g., to generate a scan profile or calibrate the scanner.
For the Advanced Profile Editor, it is not necessary to go through the wizard step by step. It is
possible to jump directly to a certain step of the wizard by double-clicking the respective step.
If certain features/settings are missing, this may be because the Show All mode is not active. On
the other hand, several settings are only available for very specific applications. If these settings
cause confusion, you can simply deactivate the Show All checkbox.
You can generate new profiles from scratch using the default settings, but in most cases it is rec-
ommended to modify existing profiles. This makes it easier and faster to adapt a profile for a new
application without checking each step of the wizard.
If you do not have a adequate profile as a source to modify, it is recommended to use the Smart
Profile Selection first to select a base profile for a certain application and modify settings after-
wards using the Advanced Profile Editor.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1117


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.4.1.1 Smart Profile Selection

In this wizard you can select pre-defined scan profiles. You can select the Contrast Method (Step
1), Sample Type (Step 2, ff.) and enter a Profile Name and Description (last step).
The system has pre-configured profile templates for the most typical slide types and applications
as well as profiles for reference samples for quality control. These templates are stored in a safe
location and cannot be changed by the user. The default scanning objective for most templates is
the 20x objective with the highest NA installed in the system.
The wizard guides you through several steps to find the best profile as a preset for further adapta-
tions by giving you easy to understand choices. You can select the desired option by double-click-
ing on it or by selecting the option and clicking on the Next button at the bottom.
When you finish the wizard, the selected profile from the profile pool are copied to the system
and the Advanced Scan Profile Editor [} 1120] opens automatically to further refine your profile.

Reference Slides
The wizard contains a section called Reference Slides. This section contains seven predefined
profiles. Five of them are used for quality control.
In the factory two specimens (if the system has the Polarization option 3 specimens) are
scanned:
1. BF 20x -> Specimen BF 03 (rat kidney; H&E) from the sample-set brightfield
(474032-9010-000) at 20x (if a 20x objective is available with the system)
2. BF 40x -> Specimen BF 03 (rat kidney; H&E) from the sample-set brightfield
(474032-9010-000) at 40x (if a 40x objective is available with the system)
3. FL 20x -> FluoCells® Prepared Slide #3 (mouse kidney; F-24630) at 20x (if a 20x objective
and fluorescence is available with the system)
4. FL 40x -> FluoCells® Prepared Slide #3 (mouse kidney; F-24630) at 40x (if a 40x objective
and fluorescence is available with the system)
5. Polarization 20x -> Specimen POL 01 (rat knee; Sirius red) from the sample-set polarization
(474032-9020-000) at 20x (if polarization is available with the system)
Using these samples and the reference profiles you can directly scan them so that the image qual-
ity can be compared with the images which were created when the system was built in the fac-
tory. The remaining two profiles are for the special purpose of performing shading correction for
fluorescence (use scanning without tile overlap, for more information refer to chapter Creating a
Shading Reference from Tile Image [} 1099] and the description for Shading Reference for Ac-
quisition [} 88]).

10.3.4.1.2 Slide Scanner Calibration Wizard

Info
Calibration by service engineer
It is strongly recommended that this procedure is done by a certified ZEISS service engineer.
While customers are allowed to perform this calibration, it is still recommended that they call a
service representative beforehand for guidance or should any problems occur.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1118


10 Systems & Components | 10.3 Axioscan ZEISS

Info
Geometric Calibration Slide
The first position of the tray must hold the geometric calibration slide, the second position the
color calibration slide. The tray with the calibration slides must be placed in the first position
within the magazine.

The following settings can be calibrated or checked:

§ Parfocality of the objectives


§ Parcentricity of the objectives
§ Adjustment between preview camera and scan camera
§ Measurement of the correct pixel size for each camera and magnification
§ Determination of the camera rotation. If the camera rotation is not in the expected range (<=
0.5°), contact ZEISS service
The wizard guides you through the process step-by-step. The steps do usually not require user in-
teraction, except the rotation of the camera, which needs physical interaction. It is only necessary
to start the action for each step. Once the action is complete, this is indicated by a green light.
You can then continue with the next step. The last step is to save the data to the system.

10.3.4.1.3 Sample Detection Wizard

This wizard is only available if a preview scan was previously generated. Once the system has
started the preview generation, you can start the wizard immediately and work in parallel.
In general, you usually work directly in the image of the specimen area to mark the region(s) of in-
terest or delete regions of interest that have been wrongly detected. For more information, see
also Checking and Correcting Sample Detection Results with the Sample Detection Wizard
[} 1098].

Parameter Description
Next Slide Navigates to the next slide.

Previous Slide Navigates to the previous slide.

Keep Display Set- Activated: Keeps the current display settings for all previews.
tings Over All Pre-
views

Sample Detection The settings are basically the same as described in the Advanced
Settings Scan Profile Editor, in the chapter Sample Detection Settings
[} 1126]

Show Focus Points Defines if and which focus points are displayed in the image. Focus
points in the image can be moved by drag and drop and added/
deleted via right click, similar to the Focus Point View [} 1153] in the
Advanced Scan Profile Editor.

– None No focus points are displayed.

– Coarse Focus Displays the focus points of the coarse focus map.

– Fine Focus Displays the focus points of the fine focus map.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1119


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.4.1.4 Advanced Scan Profile Editor

The system always shows you a live image from the corresponding cameras (preview camera/scan
camera) while also moving the slide according the input from the operator. This means that you
always work on a physical glass slide.
If you leave the editor, the software validates the profile and you will get a feedback if any correc-
tions are required.
To access all of the functions and properties described in this guide, you have to activate the
Show All mode by activating the checkbox in the upper right-hand corner of the left tool area.

General Wizard Controls

Parameter Description
Next Moves on to the next step of the wizard.

Back Moves back to the previous step of the wizard.

Cancel Cancels the wizard. No changes are applied to your settings.

Finish Saves the setup and the changes based on your progress and closes
the wizard.

10.3.4.1.4.1 Overview

Here you can define some global settings for your scan profile. The center screen area of this step
displays specific information about the currently opened profile (e.g. which camera is used for the
preview and which kind of processing is configured).

Parameter Description
Profile Displays the name of the selected scan profile. This name cannot be
changed here.

Description Shows the description of the scan profile. As the information content
of the profile name is always limited, you can insert additional infor-
mation here to highlight the most important profile settings (e.g.,
magnification/z-stack settings/focus map settings).

Slide Selection Only visible if you have started the wizard for a default profile and not
for a specific slide.
Selects the slide on which the profile adaptation is based.

– Tray Selects the tray.

– Slide Selects the slide of the currently selected tray.

– Load Slide Loads the selected slide.

See also
2 Starting the Setup in the Advanced Scan Profile Editor [} 1083]

10.3.4.1.4.2 Label

Here you can select the acquisition parameters for the label area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1120


10 Systems & Components | 10.3 Axioscan ZEISS

The label area ROI (Region Of Interest) is defined by the red rectangle shown in the live image (see
image below). It is possible to adjust the frame in size and position freely to fit with the label on
your slide. The label area is captured with reflected light and a separate microscope camera.
In case you are using the 1x 100 mm x 76 mm tray, four additional controls are displayed because
the slide in that tray is to big for the preview, so it is split in two halves.

Parameter Description
Live Only visible when using the 1x 100 mm x 76 mm tray.
Displays the live image from the active camera.

Snap Only visible when using the 1x 100 mm x 76 mm tray.


Takes a single image from the upper and lower side of the slide.

Upper Side Only visible when using the 1x 100 mm x 76 mm tray.


Displays the upper side of the slide.

Lower Side Only visible when using the 1x 100 mm x 76 mm tray.


Displays the lower side of the slide.

Parameter Description
Color Mode Selects the color mode for the camera.

– RGB Transmits the image data of a color camera unchanged. This corre-
sponds to the standard operating mode of a color camera.

– B/W Treats the image data of the color channels as grayscale. The data of
related color channels are averaged. The saturation of the camera ap-
pears reduced as a result.

Exposure

– Auto Activated: The exposure time is calculated automatically every time


an image is acquired. The exposure time in the corresponding input
field fluctuates accordingly.
Deactivated: The exposure time must be set manually.

– Set Sets the exposure time based on a one time measurement.

– Value field Sets the exposure time manually with the input field and the drop-
down selection of the time unit.

White Balance Only visible if Show All is activated.

– Auto Compensates for the color temperature of the light source automati-
cally to yield a neutral hue. The entire camera sensor area is mea-
sured. If there are no pure white areas on the sample and Auto does
not yield the desired results, you can also use Pick.

– Pick Enables you to select a reference pixel for white balance from the live
image.

Parameter Description
Orientation Selects alignment of the label on a slide. You can rotate the label im-
age 90° clockwise (CW), counter clockwise (CCW), by 180° or keep
the original orientation (Original).

Language Selects the language of the label.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1121


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
None Activated: No barcode or text recognition is used.

OCR Only available if you have an OCR license.


Activated: Uses Optical Character Recognition (OCR) to recognize the
text in the label area.

Barcode Activated: The system recognizes the barcode and saves the barcode
information as metadata within the image.
If you want to use the barcode information as part of the image
name, you have to apply automated naming and use the keyword
RecognizedCode (%N) to make the barcode part of the image name
(see also Creating Your Own Image Naming Convention [} 1101]).

Test Displays the region of interest with the given orientation and applies
the barcode recognition.

Selected Area Displays the barcode/text from the region of interest.

Recognized Text Displays the recognized text.

Info
Adjusting the Display Curve
You have the possibility to adjust the display curve (see Display tab on the bottom of the win-
dow). The display settings are stored within in the profile. This has also an impact on the dis-
play of the label in the Magazine view.

Fig. 103: Label area of a slide (red rectangle)

See also

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1122


10 Systems & Components | 10.3 Axioscan ZEISS

2 Configuring the Scan of the Label Area [} 1084]

10.3.4.1.4.3 Preview

In this step you can select the camera which is used for the sample detection.
In case you are using the 1x 100 mm x 76 mm tray, four additional controls are displayed because
the slide in that tray is to big for the preview, so it is split in two halves.

Parameter Description
Live Only visible when using the 1x 100 mm x 76 mm tray.
Displays the live image from the active camera.

Snap Only visible when using the 1x 100 mm x 76 mm tray.


Takes a single image from the upper and lower side of the slide.

Upper Side Only visible when using the 1x 100 mm x 76 mm tray.


Displays the upper side of the slide.

Lower Side Only visible when using the 1x 100 mm x 76 mm tray.


Displays the lower side of the slide.

Parameter Description
Color Mode Selects the color mode for the camera.

– RGB Transmits the image data of a color camera unchanged. This corre-
sponds to the standard operating mode of a color camera.

– B/W Treats the image data of the color channels as grayscale. The data of
related color channels are averaged. The saturation of the camera ap-
pears reduced as a result.

Exposure

– Auto Activated: The exposure time is calculated automatically every time


an image is acquired. The exposure time in the corresponding input
field fluctuates accordingly.
Deactivated: The exposure time must be set manually.

– Set Sets the exposure time based on a one time measurement.

– Value field Sets the exposure time manually with the input field and the drop-
down selection of the time unit.

White Balance Only visible if Show All is activated.

– Auto Compensates for the color temperature of the light source automati-
cally to yield a neutral hue. The entire camera sensor area is mea-
sured. If there are no pure white areas on the sample and Auto does
not yield the desired results, you can also use Pick.

– Pick Enables you to select a reference pixel for white balance from the live
image.

Parameter Description
Preview Cam Uses the preview camera for the sample detection.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1123


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Scan Cam Only available, if no scan region (green outline) is defined yet.
Uses the scan camera for the sample detection. This is only recom-
mended if the sample is not visible. The additional Pre-Scan [} 1124]
step is displayed as the next in the wizard if the Scan Cam is selected.

For information on setting the region of interest for preview images, see Setting Up the ROI for
the Preview Image [} 1086].

Info
Avoid Overexposure
Avoid any kind of over exposure of the image (especially outside the slide) when setting up
your scan profiles. This is of general importance for all steps of the editor where camera set-
tings are being adjusted. An overexposed image can result in a sub-optimal shading correction.
If the image is too dim, it will also result in a sub-optimal shading correction. Also, focusing
can suffer with images which are either too dark or saturated.
4 To avoid these issues activate the Range Indicator checkbox on the Dimensions Tab
[} 1029] to see overexposed pixels.
4 Adjust the exposure time of the camera or the Flash settings (duration, intensity) respec-
tively, depending on which acquisition mode you choose. When you see the first red pixels
showing overexposure, decrease the exposure time until the red pixels disappear. Once
the red pixels disappear, decrease the exposure time additionally somewhat to ensure that
nowhere in the image pixels are saturated.

See also
2 Setting Up the Preview Acquisition [} 1085]

10.3.4.1.4.4 Pre-Scan

This step is only visible if you have selected the Scan Cam in the previous step. Prescans are use-
ful in all cases where the preview camera is not able to produce an image with enough contrast
to function in sample detection.

Parameter Description
Only visible if you have configured a motorized focus in the MTB (Mi-
croToolBox).
Find Focus Starts an autofocus search using the current settings.

Opens Live view and shows the live image from the active camera.

Live

Acquires a single image.

Snap

Starts a prescan acquisition.


Start Prescan

Light Path Compo- Displays parameters of the Microscope Control Tool [} 980]. If Show
nents All is deactivated, only the settings for the objective magnification se-
lection are visible.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1124


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Acquisition Mode Only visible if Show All is activated.
Displays parameters of the Acquisition Mode Tool [} 874].

Channels Displays parameters of the Channels Tool [} 914]. For Axioscan spe-
cific channel settings, see also Channels Tool (Axioscan Specific)
[} 1151].

See also
2 Extended Depth of Focus [} 175]
2 Setting Up a Pre-Scan [} 1088]

10.3.4.1.4.4.1 Additional Information for Pre-Scan

Prescans are useful in all cases where the preview camera is not able to produce an image with
enough contrast to function in sample detection. Every sample is different, but here are some sug-
gestions for how to create a contrast rich preview image using the scan camera:

§ Use the 5x objective.


§ Any sample without chromogenic stain: Use TIE-Phase contrast.
§ Many samples with low contrast: Use brightfield and close the condenser aperture to the min-
imum allowed value. This will increase the depth of focus and also increase the contrast so
that many samples become visible in the preview image.
§ Fluorescently labeled sample: Select preferably one of the channels labeled in the red range to
reduce the effect of bleaching on the sample.
§ When using the monochrome camera: Increase gain and use binning 4x4 to reduce file size,
lower exposure and increase prescan speed.
§ When using the color camera: In the Acquisition Mode section, turn on downsampling to
reduce the image size.
§ For transmitted light prescans: Use the diffusor plate in the condenser to reduce shading.
When setting up the prescan in the profile editor, it is usually easy to get the sample in focus as
one has a live image. During automated scanning with a scan profile containing a prescan, the
sample is still unknown. Since the system does not yet know where the sample is on the slide, fo-
cusing is difficult. The system will use five fixed focus support points as shown here:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1125


10 Systems & Components | 10.3 Axioscan ZEISS

Any focus point which does not lie within sample containing area on the slide will not produce a
focus value and be discarded from the calculation.

10.3.4.1.4.5 Sample Detection Settings

Parameter Description
Sample Detection
Processor

– Standard Displays the standard controls to detect your sample.

– Custom Sam- Displays controls to define a custom sample detection with the help
ple Detection of a image analysis and/or a macro. The Test button allows you to
start a test run of your defined custom sample detection.

Use Image Analy- Only visible if Custom Sample Detection is selected.


sis Activated: Uses an image analysis setting to detect the sample. The
dropdown allows you to select the respective analysis setting. If you
also activate Use Macro, the macro is executed first.

Use Macro Only visible if Custom Sample Detection is selected.


Activated: Uses a macro to detect the sample. The dropdown allows
you to select the respective macro.

Sample Detection Only visible if Standard is selected.


Mode Selects the sample detection mode. Depending on the mode, differ-
ent options are available. The following modes for sample detection
are available:
§ Automatic: For more information, see Sample Detection Settings
for Automatic and Interactive Mode [} 1127].
§ Interactive: For more information, see Sample Detection Settings
for Automatic and Interactive Mode [} 1127].
§ Manually: For more information, see Sample Detection Settings
for Manual Mode - Creating A Grid [} 1131].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1126


10 Systems & Components | 10.3 Axioscan ZEISS

See also
2 Defining the Sample Detection Settings [} 1089]

10.3.4.1.4.5.1 Sample Detection Settings for Automatic and Interactive Mode

The following settings are only visible, if Automatic or Interactive is selected as Sample Detec-
tion Mode.

Parameter Description
Recognition Type

– Sample Sets the sample detection based on thresholds.

– Marker Sets the sample detection based on using a felt tipped permanent
marker to mark the tissue area.

Live Update Activated: Updates the image continuously (live) each time a value is
changed.

– Test Only visible if Live Update is deactivated.


Updates the image.

Predefined Set- Only visible if Show All is activated.


tings Selects a predefined setting from the dropdown list and allows you to
save your current parameters in a settings file. Click on for ad-
ditional options.

Region Dilation Only visible if Show All is activated.


Size/ Region If Sample is selected: Sets the Region Dilation Size in µm, a value
Shrink Size for the spacing of the border around the detected sample.
If Marker is selected: Sets the Region Shrink Size in µm.

Specimen/ Maker Displays the display curve for the specimen/markers. Here you define
the upper and lower borders of the specimen via the thresholds. If
you have activated the Live update, you see the result toward the
left of center with a certain delay. The upper border (right side) is the
border for the lighter stains and the lower border (left side) is the bor-
der to influence the darker stains. Moving the right side further to the
right marks the lighter stains. Moving the left side further to the left
marks the darker stains.

Automatic Detec- Activated: Automatically detects the distances between the intensity
tion of High Level values for pixels representing the glass itself (usually very bright) and
Threshold (of Sam- the upper threshold value for the specimen detection.
ple)

Minimum Region Sets the minimum region size in mm2 to be scanned. The system does
Size not detect regions if they are smaller than this value.

Air Border Dilate Only visible if Show All is activated.


The air border is the border around the physical glass slide, i.e., the
area outside the glass slide and inside the red frame. This value deter-
mines the dilation of this air border. It is calculated in octagon steps.
Everything inside this dilated air border is not recognized as sample/a
marker. This is a measure for ensuring that slide edges and coverslip
edges or markings at these edges are not detected as needing to be
scanned. Use a few example slides to test out a good value which in-
cludes your sample but excludes edge artifacts.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1127


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Max. Elongation Only visible if Show All is activated.
Sets the maximum elongation ratio for the detected object. This set-
ting can also help to remove coverslip edges. Coverslip edges are usu-
ally structures where the length ratio between the longer side and the
shorter side is usually high. This means that every structure that has a
lower ratio is excluded.

Reset Resets the parameters to their default.

Parameter Description
Prefer Center for Only visible if Show All is activated. Only relevant for brightfield flash
Shading Scan Area scans.
Activated: the software forces the region, which is used for the shad-
ing correction, towards the middle of the slide to avoid to be influ-
enced by e.g. the coverslip edges. By default this option is deacti-
vated. It is only useful when using objective magnifications of 20x or
more.
If you see in the scanned image tiling artefacts we recommend to ac-
tivate this option and recheck the shading quality. If this option is acti-
vated it can happen that the region used for correction is split into
smaller regions. As consequence, the shading correction scanning is
slower, but compared to the total scan time, the increase by a few
seconds has no major influence on the scanning time.

Show Shading Only visible if Show All is activated.


Scan Area Activated: Displays the area used to generate the shading reference
image for this slide. For certain scan magnifications the region is
shown even if it is not used.

Sort Order Only visible if Show All is activated.


Selects the sorting schema (numbering) for the detected objects (re-
gions/ scenes).

Sort Only visible if Show All is activated.


Sorts the detected objects according to the selection.

10.3.4.1.4.5.1.1 Case A: Automatic Mode/Sample Recognition

Prerequisites
§ For Sample Detection Mode, you have selected Automatic.
§ For Recognition Type, you have selected Sample.

Region of Interest for Sample Detection


§ The red rectangle in the live image represents the ROI for the sample detection. Only the re-
gions that are inside the ROI are presented as regions that can be scanned. Other regions out-
side the ROI and/or touching them are ignored. You can change the size of the ROI by adapt-
ing the size of the red rectangle. When manually editing automatically found scan regions or
manually adding scan regions the mode will switch to manual. The profile, if stored, contains
the scan ROI masks and would use it on any other slide.
§ All objects are listed in the Graphics tab. You can delete objects and add new ones. How-
ever, the result is only valid for this slide. If you draw your own regions, make sure that these
contain sample material. Empty space could lead to an incorrect focus map as the software
uses the entire region to create the focus point distribution.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1128


10 Systems & Components | 10.3 Axioscan ZEISS

§ If two or more objects are very close to each other and thus the two or more objects are seen
as one object, it is advisable to split these objects with the Split function which is available in
the context menu seen after a right-mouse click.
§ If Live update is turned off, click Test to test the entered parameters and show the results in
the middle part of the window. The detected objects (every object is a single scene) is pre-
sented with a green border.

§ To achieve a continuous update, you can activate Live update. Keep in mind that a refresh
can take some seconds after changing a parameter.
§ Once you have determined the appropriate settings, they are saved within the profile. If the
settings should be used in another profile, you can save them separately independent from
the scan profile using the options menu .

Sort Order
In the Sort Order section you can modify the sorting schema (numbering) for the detected ob-
jects (regions/ scenes). You can select from 8 different schemes. The first entry (e.g. Left Right)
provides the first sorting schema and the second entry (e.g. Top Bottom) the second sorting
schema.

Example 1:
Left Right/Top Bottom
The first sorting schema is from Left to Right (red arrow) and the second sorting schema is from
Top to Bottom (green arrow):

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1129


10 Systems & Components | 10.3 Axioscan ZEISS

Example 2:
Top to bottom/Left to right
The first sorting schema is from Top to bottom (red arrow) and the second sorting schema is from
Left to right (green arrow):

See also
2 Case B: Automatic Mode/Marker Recognition [} 1131]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1130


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.4.1.4.5.1.2 Case B: Automatic Mode/Marker Recognition

Prerequisites
§ For Sample Detection Mode, you have selected Automatic.
§ For Recognition Type, you have selected Marker.
The settings are limited to the definition of the marker threshold (comparable to the sample
threshold). The only further adjustable value is the Min region size, also the Shading options,
the creation of the Sort Order and the Sort button have the same functionality as in Case A.
If you use the marker on the physical glass slide, make sure that the marked regions contain speci-
mens. Empty space could lead to an incorrect focus map as the software will use the entire
marked region to create the focus point distribution.

See also
2 Case A: Automatic Mode/Sample Recognition [} 1128]

10.3.4.1.4.5.2 Sample Detection Settings for Manual Mode - Creating A Grid

Parameter Description
Draw Graphics Enables you to draw graphical elements into the view.

Use Grid Definition

– Element Type Selects the type of graphical element. You can choose between Circle
and Rectangle.

– Element Size Defines the width (W) and height (H) of the element for the Rectan-
gle, or the Radius for the Circle.

– Distance from Sets the distance/offset from the upper left-hand corner in X and Y.
Origin

– Distance Sets the distance between the individual elements.


betw. Ele-
ments

– Grid Definition Defines the number of Rows and Columns of the grid.

– Create Creates the defined grid.

Parameter Description
Prefer Center for Only visible if Show All is activated. Only relevant for brightfield flash
Shading Scan Area scans.
Activated: the software forces the region, which is used for the shad-
ing correction, towards the middle of the slide to avoid to be influ-
enced by e.g. the coverslip edges. By default this option is deacti-
vated. It is only useful when using objective magnifications of 20x or
more.
If you see in the scanned image tiling artefacts we recommend to ac-
tivate this option and recheck the shading quality. If this option is acti-
vated it can happen that the region used for correction is split into
smaller regions. As consequence, the shading correction scanning is
slower, but compared to the total scan time, the increase by a few
seconds has no major influence on the scanning time.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1131


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Show Shading Only visible if Show All is activated.
Scan Area Activated: Displays the area used to generate the shading reference
image for this slide. For certain scan magnifications the region is
shown even if it is not used.

Sort Order Only visible if Show All is activated.


Selects the sorting schema (numbering) for the detected objects (re-
gions/ scenes).

Sort Only visible if Show All is activated.


Sorts the detected objects according to the selection.

10.3.4.1.4.5.2.1 Case C: Manual Mode/Draw Graphics

Prerequisites
§ For Sample Detection Mode, you have selected Manually.
§ You have selected Draw Graphics.

Drawing in ROIs manually


If you have selected Draw Graphics, it is possible to draw regions manually within the region of
interest. To draw regions, you can use the tools on the Graphics Tab [} 1036] in the general view
options of the Center Screen Area. You can use it in the same way you would generally anno-
tate images within ZEN. The regions are saved and the same areas are used for the entire time the
profile is applied, hence this option can only be used if the regions are always defined precisely on
the slide (e.g., PAP smears).

Info
If you want to mark a sample that is very faint, you can use the Display curve to change the
display settings (particularly by adjusting the gamma curve) to make it possible to see even un-
stained sample of a reasonable thickness.
4 You have the possibility to adjust the Display curve (see Display Tab [} 1043] on the bot-
tom of the window). The display settings are stored within in the profile. This has also an
impact on the display of the label in the Magazine view.

See also
2 Case D: Manual Mode/Grid Definition [} 1132]

10.3.4.1.4.5.2.2 Case D: Manual Mode/Grid Definition

Prerequisites
§ For Sample Detection Mode, you have selected Manually.
§ You have selected Use Grid Definition.
You can define a grid with rectangles or circles as Element Types in a regular pattern. The refer-
ence point for this grid is the upper left-hand corner of the specimen area (red rectangle). Based
on this, you can define on offset from the upper left corner in x (A) and y (B) in mm and also the
distance of the elements in x (C) and y (D).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1132


10 Systems & Components | 10.3 Axioscan ZEISS

Based on the selected geometrical shape (circle or rectangle), you can define a radius or the di-
mensions in x (F) and y (E). The number of elements in x (in this example, 6) and y (in this exam-
ple, 3) defines the number of elements.

You can see the grid as an overlay in the image. It is also possible to make manual adjustments
such as those used for standard graphics in ZEN.

See also
2 Case C: Manual Mode/Draw Graphics [} 1132]

10.3.4.1.4.6 Focus Map Settings

Appropriate focus map settings are important for ensuring good focus quality throughout the
specimens. The focus map generation is done in two steps:

§ With a low magnification objective to generate the Coarse focus map. For this coarse focus
map, only some focus points are necessary. We recommend the use of the 5x Fluor for the
Coarse focus as the offset between the 5x and the scanning objective (mostly 20x) is mar-
ginal.
§ With a high magnification objective (normally the scanning objective), you generate the Fine
focus map. In this case, more focus points are needed and this is usually defined via a density.
The fine focus map is based on the coarse focus map.
The focus is not a traditional autofocus that needs to hit the z-value with the sharpest image pre-
cisely. The system acquires a z-stack (defined in the next step) and calculates a curve through the
focus value (e.g., contrast value). This curve is used to determine the peak value, which makes it
possible to cover a large range while still maintaining fast focusing. For more general information
about focus maps, see Focus Maps [} 1108].

Parameter Description
Copy Previous Set- Only visible in the Fine Focus Map step.
ting Adjusts your channel settings automatically based on the coarse focus
map.

Only visible if you have configured a motorized focus in the MTB (Mi-
croToolBox).
Find Focus Starts an autofocus search using the current settings.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1133


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Opens Live view and shows the live image from the active camera.

Live

Acquires a single image.

Snap

Light Path Compo- Displays parameters of the Microscope Control Tool [} 980]. If Show
nents All is deactivated, only the settings for the objective magnification se-
lection are visible.

Acquisition Mode Only visible if Show All is activated.


Displays parameters of the Acquisition Mode Tool [} 874].

Channels Displays parameters of the Channels tool. For information, see Chan-
nels Tool (Axioscan Specific) [} 1151].

– Add Channel Only visible if no channel is set up yet.


Opens the Add Dye or Contrasting Method dialog to select an ac-
quisition channel.

Focus section This section displays the options Mode, Quality, Search and Sam-
pling of the focus control. For detailed information about the param-
eters, see Software Autofocus Tool [} 333].

Use Adaptive Fo- Only visible if Show All is activated.


cus Point Distribu- Activated: Enables you to use adaptive focus point distribution. For
tion more information, see Using Adaptive Focus Point Distribution
[} 1091].

Verify Focus Points Only visible if Show All is activated.


Opens the Focus Point View [} 1153] to edit and verify focus points.
For more information, see also Working with Focus Points [} 1096].

Focus point distri- Only visible if Show All is activated.


bution list Displays the strategy sets for focus point distribution and their param-
eters. For a description of various strategies, see Focus Point Strategy
Sets [} 1135].

– Deletes the selected distribution strategy from the list. If you delete
xPol and pPol, the entire group is deleted.

– Opens a dialog to select and add a new focus point distribution strat-
egy to the list.

Sharpness Mea- Only visible if Show All is activated.


sure Set

– Best The autofocus is contrast based, the algorithm tries to find the high-
est contrast along the z-stack.

– HG 2^8 This is an advanced algorithm compared to Best. This algorithm fo-


cuses less on the larger stained structures and more on the smaller lo-
cal structures, so it focuses more on nuclei, for example, than on un-
stained structures (e.g., immunohistochemistry stains).
This means that HG2^8 is a good autofocus method to focus on nu-
clei.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1134


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Drawback: It is sensitive to detecting dirt, hence it should only be
used for the fine focus, not the coarse focus and not on particularly
dirty slides.

See also
2 Adjusting Settings for Coarse Focus Map [} 1089]
2 Adjusting Settings for Fine Focus Map [} 1092]

10.3.4.1.4.6.1 Focus Point Strategy Sets

A focus point strategy set is applied for each scene, i.e. as a separate detected object in each
case. If you e.g. select six fixed points for the Coarse focus, the software applies six focus points
for each scene.
Certain focus point strategies sets have an additional checkbox called Prefer Border. If this
checkbox is activated the system will put more focus points to the border of the detected speci-
men. This is advisable if the border of the specimen has significantly different focus values com-
pared to the rest of the sample.
If the setting Density is part of the focus point strategy set, this value gives the percentage of
generated focus points in relation to the total number of tiles of the object (e.g. if the object has
2000 tiles and the setting is set to 0.1 (= 10%) the system would generate 200 focus points). As
especially for larger objects too many focus point would be generated (you have to keep in mind
that not always a larger number of focus points will automatically result in higher overall focus
quality), you can define also a maximum number of focus points (Max. Number of Points),
which is advisable. It is rare that >24 focus support points yield better results.
If you use the automatic sample detection and you define a border dilation, the system subtracts
this dilatation before the focus points are distributed, so no focus point is put in the dilation zone.
This applies only for the automatic sample detection.
When using the Onion Skin method to ensure that the focus points are within the sample, the
system moves the focus points a certain number of field of views away from the border. This
value can be adjusted under Tools > Options > Acquisition > Axio Scan with the option Mini-
mum Margin of focus point distribution in tile(s). The default setting is 1. For very thin sam-
ples, e.g. needle biopsies, change this value to 2 to prevent focus support points from being
placed at the edges where little or no sample resides.

Item Description
Onion Skin This is a density focus schema. The resulting focus points are dis-
played as layers of onion skin, providing an even distribution and also
ensuring that the border in particular has enough focus points. This is
the standard setting for the fine focus map. The parameter is a den-
sity with a standard setting of 0.1. This setting means that 10% of the
total number of viewing fields will be used as focus points to calculate
the focus surface. For large specimens this number can get very large,
but a larger number of focus points does not always automatically
mean a better quality calculation of the focus surface. For this reason,
the user can also define a maximum number of focus points. This
number is normally in the range of 24 to 36 points. This focus point
strategy set is recommended for mid-sized to large objects.
Example (Density: 0.1; max number 24):

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1135


10 Systems & Components | 10.3 Axioscan ZEISS

Item Description

Every Nth Row The system will put a grid over the specimen with a distance between
and Column two focus points of the specified value (N) for the number of camera
viewing fields in the x and y direction. This is a clearly defined way to
create the focus point, even it creates more focus points and will take
longer to create the focus map. The focus point strategy set is recom-
mended for mid-sized and smaller objects.
Example (every 5th tile):

Every Tile The system focuses on every tile. This is particularly time-consuming
for scans with a large magnification and/or large samples, however, it
yields the best results for very uneven specimens.

Fixed Number of Here the user defines a fixed number of focus points per object
Points (scene). The default setting for the Coarse focus is six focus points per
scene.
Example (n = 24):

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1136


10 Systems & Components | 10.3 Axioscan ZEISS

Item Description

Density The density is similar to that of an onion skin; the difference is that
the pattern is not distributed like the layers of an onion. The distribu-
tion is more evenly spread over the specimen/scene. This setting can
also be used to define a maximum number of focus points. The cre-
ation of this focus map is more random – as shown in the example –
so usually onion skin is preferable to density.
Example (density: 0.1; max number 24):

Grid This setting defines a fixed grid over the specimen to establish the fo-
cus points for the focus surface. The value is in µm. This setting is in-
dependent from the current frame/sensor size of the camera used. If
you want to use a setting that is based on the chip size of the camera,
please use “Every Nth tile”. As seen on the sample, this schema is not
as strict as Every Nth tile, thus Every Nth tile is recommended over the
Grid cell size.
Example (1000 µm 1000 µm):

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1137


10 Systems & Components | 10.3 Axioscan ZEISS

Item Description

Center of Gravity The system will place one focus point within each scene/object. The
position of this focus point is the center of gravity, thus the whole ob-
ject has only one focus point. This is a useful setting for small objects
(e.g., Tissue micro arrays). Be aware that for certain structures (such
as a half moon), the center of gravity may lie outside the tissue, hence
the system has nothing to focus on. In such cases, select “Number of
focus points” with 1 as the parameter. The center of gravity is a valid
option, e.g., for Tissue Micro Arrays to place only one focus point in
each core.

10.3.4.1.4.7 Scan

In this wizard step you can adjust the scan settings. These settings are important as they deter-
mine the image quality that is subsequently experienced by the user in terms of exposure time,
white balance, etc.

Parameter Description
Copy Previous Set- Adjusts the experiment settings automatically based on the fine focus
ting map.

Only visible if you have configured a motorized focus in the MTB (Mi-
croToolBox).
Find Focus Starts an autofocus search using the current settings.

Opens Live view and shows the live image from the active camera.

Live

Acquires a single image.

Snap

Light Path Compo- Displays parameters of the Microscope Control Tool [} 980]. If Show
nents All is deactivated, only the settings for the objective magnification se-
lection are visible.

Acquisition Mode Only visible if Show All is activated.


Displays parameters of the Acquisition Mode Tool [} 874]. If you
have activated it in Tools > Options > Acquisition > Axioscan, you
can also set the Axioscan Acquisition Order [} 1140] here.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1138


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Channels Displays parameters of the Channels tool. For information, see Chan-
nels Tool (Axioscan Specific) [} 1151].

Z-Stack Configura-
tion

– Z-Stack Activated: Displays the options to configure a z-stack. All following


parameters are only visible, if this checkbox is active.

– Range Sets the range of the z-stack.

– Slices Sets the number of slices for the z-stack.

– Interval Sets the distance between the slices.

– Keep § Interval
Keeps the set interval between the section planes constant if you
change configuration parameters.
§ Slice
Keeps the set number of z-slices constant.

– EDF active Activated: Uses Extended Depth of Focus (EDF) for image acquisition.

– Method Only visible if EDF active is activated.


Selects a method for EDF. Following methods are available in the
dropdown:
§ Wavelets
§ Contrast
§ Maximum Projection (best for fluorescence)
§ Variance (best for brightfield)

– Defaults Resets all parameters in the Z-Stack Configuration section to their


defaults.

Online Processing Only visible if Show All is activated.

– Stitching Con- Selects the configuration that is used for stitching. The following op-
figuration tions are available:
§ None: No stitching is configured. The image is unstitched and can
be stitched later within ZEN or with another software. This option
can make sense if you are scanning large slides only sparsely popu-
lated by sample to avoid stitching artifacts in the image.
§ Online: Stitching is performed during the acquisition. This is the
standard setting as this provides the best performance in terms of
the processing time of the slide.
§ Offline: Stitching is performed after the acquisition. This can im-
prove the stitching results as opposed to online stitching here a
global optimization step can be added as all tiles are already ac-
quired. The time needed for stitching is added to the scan time
however.

– Fuse active Only visible if Offline is selected as Stitching Configuration.


Activated: Fuses the stitched tiles and blends the overlapping areas.
Can improve the shading. Be aware that such a fused scan will still

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1139


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
consist of tiles, this is technically necessary to avoid a memory limit on
the operating system which cannot handle 2D images larger than 2
GB.

– Pyramid active Activated: Creates an image pyramid to speed up the viewing of the
image afterwards.

– JpegXR active Activated: Displays option for image compression. For information
about the correlation between compression and file size, see Com-
parison Compression and File Size [} 1140].
Deactivated: Saves the image uncompressed.

– Lossless Com- Only visible if JpegXR active is activated.


pression Saves the image with a lossless compression.

– Lossy Com- Only visible if JpegXR active is activated.


pression Saves the image with a lossy compression. The degree of compression
can be set with the Quality input field.

See also
2 Extended Depth of Focus [} 175]
2 Adjusting Scan Settings [} 1093]

10.3.4.1.4.7.1 Comparison Compression and File Size

Compression regime File size


No compression 9124 MB/cm2

Lossless (JPEG XR) 4997 MB/cm2

90% JPEG XR quality 916 MB/cm2

80% JPEG XR quality 392 MB/cm2

60% JPEG XR quality 263 MB/cm2

40% JPEG XR quality 198 MB/cm2

30% JPEG XR quality 157 MB/cm2

10.3.4.1.4.7.2 Axioscan Acquisition Order

If you have activated Tools > Options > Acquisition > Axioscan > Show Acquisition Order,
you can select the Acquisition Order in the Acquisition Mode section.

Parameter Description
All channels per The system captures all channels for each tile first before it continuous
tile with the next tile. This is also the default setting and the best choice
for fluorescence scans.
Note: This order is by default only used for fluorescence, as it will
stress the condenser components and reduce the condenser lifetime
in case of TIE or polarization acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1140


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Mixed Mode This dimension order is only useful when combining brightfield, TIE
and cPol. In this case, the system would need to constantly switch
condenser elements between channels causing a large mechanical
stress on these components which might reduce the lifetime of the
condenser. The system captures all tiles for e.g. BF, afterwards it
switches the filter wheel and/or condenser position and scans all tiles
for the next optical set-up (e.g. polarization). This scheme is repeated
until all BF/TIE/Pol channels are acquired. Afterwards the system auto-
matically aligns these channels.
If the setup contains one or more additional fluorescence channels,
the workflow changes. Considering two BF/Pol channels and one fluo-
rescence channel, you have the following workflow: The system ac-
quires all tiles for one channel for channel one. For the second chan-
nel (Pol), it acquires the first tile of the second channel after it moves
the filter wheel, shutter, etc. and then acquires the fluorescence chan-
nel. Now it switches the optical setup back to the second channel, go
to the next tile, acquire the image and changes back to the fluores-
cence channel setup and acquires again an image. This is repeated
until all tiles are acquired. The reason is that now the second channel
and the fluorescence channel are perfectly aligned. The system now
aligns channel one to the other channels automatically and the fluo-
rescent channel is consequently also aligned to all channels.

All tiles per chan- The system acquires all tiles for each channel before switching any
nel other optical components. This is the fastest way to acquire multiple
transmitted light channels e.g. Brighfield and cPol. It then aligns all
channels (see above). This mode is not recommended to be used on
fluorescent channels as usually there are no common structures which
the alignment algorithm could use.
If any issues regarding a sub-optimal alignment of the channels are
seen, you should select All channels per tile as the most reliable
method.

10.3.4.1.5 Slide Scanner Polarization Calibration Wizard

Info
Geometric Calibration Slide
The first position of the tray must hold the geometric calibration slide, the second position the
color calibration slide. The tray with the calibration slides must be placed in the first position
within the magazine.

In this wizard, you can calibrate your application for polarization acquisition. You have the possi-
bility to create a (new) calibration, or continue with a previously started one. The wizard guides
you through this calibration with a setup and preparation (also of the sample) as well as the polar-
ization calibration itself.
In case the system cannot properly work with the default values, you can also adjust the parame-
ters for the calibration with a calibration file. As an example, the angle of the search area can vary
depending pon your hardware setup.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1141


10 Systems & Components | 10.3 Axioscan ZEISS

10.3.4.2 Scan Tab

Here you find the most important functions to operate the Axioscan system. The tab is closely
linked to the Magazine View [} 1142], which can be found in the Center Screen Area.

1
2

1 Start Preview Scan


Starts a preview scan of all activated/marked slides in Magazine view.
The settings to generate the preview are used as defined by the assigned profile. For
brightfield specimens, the preview consists of a snapshot of the label area (reflected
light) and of the specimen area (transmitted light). If a prescan is defined in the profile, it
is also executed. The result is shown in the Slide Overview column of the slides in the
magazine view.

2 Start Scan
Starts a scan of all activated/marked slides.
The scan consists of the preview generation (label area and specimen area), sample de-
tection, focus map, and high resolution scan of the specimen for all slides with state
New. The settings are used as defined by the assigned profile. If a preview scan was ac-
quired previously or if regions were already adjusted, they are not performed again.

3 Tool Area
Here you have Axioscan specific tools:
§ Axio Scan Tool [} 1148]
§ Naming Definition Tool [} 1148]
§ Storage Location Tool [} 1150]
§ Acquisition Monitoring Tool [} 1151]

10.3.4.3 Magazine View

This view gives you an overview of the Axioscan magazine. You can assign profiles and naming
conventions to slides, see the status, and move trays up and down (using drag and drop) to
change the scanning order. The system starts processing slides from top to bottom for all slides
that have been activated (via the checkbox in the Scan column). The view is closely linked to the
Scan Tab [} 1142].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1142


10 Systems & Components | 10.3 Axioscan ZEISS

1 Main buttons
These buttons allow you to select and create a scan profile and also to adjust the display
and settings of the magazine view. For more information, see Main Buttons [} 1143].

2 Tray information section


Here you can see an overview of all trays and the inserted slides. Every tray position has
the same structure:
The headline for every tray is the physical Tray Position (e.g. Tray position: 1) and the
tray Type which is inserted. Right-click on a tray opens the Tray Context Menu [} 1146]
with several options for magazine view or the individual trays. If you click on the little ex-
pander button in front of the tray type, you can expand or collapse the view to see the
slides of the tray.

3 Slide layout
Each row within a tray represents a slide. For more information, see Slide Layout
[} 1144]. Right-click on a slide opens the Slide Context Menu [} 1146] with several options
for the selected slide.

For additional information, see also Additional Information for Magazine View [} 1147].

See also
2 Changing the Order of Slides and Trays [} 1100]

10.3.4.3.1 Main Buttons

Parameter Description
Smart Profile Se- Opens the Smart Scan Profile Selection wizard [} 1118]. This wizard
lection helps you to open predefined profiles. This is the fastest and most in-
tuitive way to assign and generate scanning profiles.

Select Scan Profile From the dropdown list, you can select the scan profile which is used
used for all slides
for all newly inserted slides. The button opens the following
with status new
options:

– Create New Creates a new profile. If a new profile was created, it will be automat-
Scan Profile ically assigned to all slides in Magazine view.

– Create New Opens the Smart Profile Selection [} 1118] to select a predefined
Profile with profile. The user is guided through a series of questions about the
Smart Profile specimen, resulting in the most appropriate profile for the digitization
Selection Wiz- process. It is recommended to process this profile afterwards with the
ard Scan Profile Wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1143


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
– Modify profile Opens the Advanced Scan Profile Editor [} 1120] to adapt all possi-
configuration ble profile settings and allows the user to utilize the full flexibility of
for all slides the system. This wizard is recommended for experienced users.
with state
new

– Rename Renames the selected profile.

– Save as Saves the user profile under another file name.

– Delete Deletes the selected profile.

Mark All Activates all slides for processing.

Unmark All Deactivates all slides for processing.

Default Order Resets the default positions of trays and slides. Only if you have
changed the order of trays or slides.

Skip Slide This button is only active if a scan job is running. It stops the scanning
of the current slide and continues with the next slide.

Expand All Expands all trays so that you can see the slides contained within
them.

Collapse All Collapses all trays so that you can open a specific tray without being
distracted.

10.3.4.3.2 Slide Layout

Each row within a tray represents a slide. Right-click on a slide opens the Slide Context Menu
[} 1146] with several options for the selected slide. The slide columns are always the same.

Parameter Description
Scan Activated: The slide is marked for scanning/previewing.
Deactivated: The slide is not marked for scanning/previewing.

Slide Position Represents the physical position of this slide inside the tray.

Slide Overview Displays the preview image of the slide if a preview was executed. It
shows the label area and the specimen area.

Scan Profile Assigns a specific scan profile to each slide. If a profile was adapted,
the system indicates this with a save icon. Also, the profile name
changed into an edit field. A prefix e.g. T1S1 (Tray 1, Slide 1) is added
before the profile name.

If you click behind the scan profile, the following context menu
opens:

– Adapt se- Opens the Advanced Scan Profile Editor [} 1120]. In this mode, the
lected profile system takes the tray containing the slide from the magazine (only if
for scan of the tray which contains the slide is not already loaded). You can see a
this slide live image from the different cameras (preview camera/scan camera)
and navigate on the slide.
This mode is useful if you want to make any changes, e.g. change the
exposure time, check the focus strategies etc.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1144


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
– Check and Only available if a preview was generated.
correct sample
Opens the Sample Detection Wizard [} 1119].
detection re-
With the help of this wizard, you can change the region that the sys-
sults
tem scans afterwards and review the focus points. Within the wizard,
you can switch directly to the next or previous slides. It is not neces-
sary to move the physical glass slides to adjust these settings.
This wizard can be started even if the preview generation for other
slides is still running.

– Show profile Opens an XML viewer which contains all of the details for the scan
content as xml profile. This information is only of interest to more experienced users.
(view only)

Only visible if the scan profile was changed.


Here you can save a changed scan profile. The profile name can be
Save
adapted in input field.

Only visible if the scan profile was adapted.


Undo Reverts the changes done for the profile.

Scan Status Displays information about the status of the slide in the scanning
process:
§ new: no preview and no scan was executed
§ preview done: preview (and prescan) was already executed and is
displayed (in the Slide Overview column)
§ finished: the scan was successfully executed

If an error/warning comes up, this will be shown here. If you click on


the error/warning message, it will be displayed. Such an error mes-
sage could be, for example, that no focus map could be created or
that there was a problem with the bar code recognition. The pop up
window instructs you what the problem was so that you can fix it by
making changes to the scan profile settings.
Besides the status, the software also shows the elapsed time of each
single slide and the predicted time to finish the scan. The elapsed time
is the actual time needed to get to the current state, the remaining
time is a predicted time to finish the scan of this slide. The predicted
time is based on a systematic learning algorithm. For every step of the
scan process (like load slide, preform preview, sample detection, etc.)
the system stores a time.
For focus map creation and scan, the time storage is also differenti-
ated between bright field and fluorescence as these two acquisition
regimes can be very different. The calculation initially assumes the es-
timated time for acquiring one tile. If the region is not known, the
complete scan time will be taken in account and once the region is
known the single tile time will be multiplied with the number of tiles,
the z levels and channels. Over the time the software updates these
timing values to be more precise. Keep in mind that the averaging is
better if the kind of scans are similar. If you have specimen scans
which differ dramatically from these average values (e.g. very long ex-
posure times), the predicted time will be not as accurate as for the
standard scans.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1145


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Image Name Displays the name of the image which will be generated. You can in-
sert a name manually, or the system creates a name according to an
automated naming rule. The selection of the procedure to be exe-
cuted depends on the Name Assignment column.

Name Assignment Selects whether the system creates the name automatically using a
naming rule or specify a name manually. It is also possible to change
the name of the image once the preview has been generated by sim-
ply clicking on the name and then editing it. Depending on the set-
tings under Naming Definition, you can also import names via a CSV
file or you can use the barcode information to define a name as sub-
string of the barcode.

10.3.4.3.3 Tray Context Menu

Info
Accessability
This context menu for the tray can be accessed by right mouse click into the narrow gray areas
outside of the slides (left and top).

Menu Item Description


Load this tray on the stage The system moves the selected tray from the
magazine to the stage and any tray on the
stage that has already been loaded is removed
automatically.

Assign scan profile Opens a dropdown menu where the user can
assign an existing profile to all highlighted
slides

Mark all slides of selected trays for Selects all slides in the highlighted trays for
scanning scanning (it is possible to select multiple trays).

Unmark all slides of selected trays for Deselects all slides in the highlighted trays for
scanning scanning (it is possible to select multiple trays).

Expand all selected trays Expands all highlighted trays by clicking on the
mouse once. To highlight a tray, hold the Ctrl
key and click on the trays you want to high-
light.

Collapse all selected trays Collapses all highlighted trays by clicking on


the mouse once.

10.3.4.3.4 Slide Context Menu

Info
Accessability
You can access the context menu by right click in any gray area of the row representing a
slide.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1146


10 Systems & Components | 10.3 Axioscan ZEISS

Menu Item Description


Move Slide to Preview position Moves the selected slide to the preview posi-
tion.

Move Slide to Scan position Moves the selected slide to the scan position.

Assign scan profile Here you can select a scan profile and assign it
to the selected slide. If you have selected sev-
eral slides, the selected profile will be assigned
to all of them.

Open image(s) Only active if a preview was generated or the


scan was finished.
The software will open the preview or scanned
image of the slide. If you have selected several
slides, all images from these slides will be
opened.

Mark all selected slides for scanning Marks all selected (highlighted) slides for scan-
ning.

Unmark all selected slides for scanning Unmarks all selected (highlighted) slides for
scanning.

Reset Scan Status to New Resets the scan status of the slide to new.

Reset Scan Status to Previewed Resets the scan status of the slide to pre-
viewed.

10.3.4.3.5 Additional Information for Magazine View

§ If the door is closed (using hardware or software), the system detects all trays inside the mag-
azine and establishes both the tray type and the positions in the tray that are occupied with a
physical slide.
§ The system also checks all slides by default (see Scan column) and assigns the Scan Profile
(defined on the Scan tab) to every slide if new slides are inserted. It is still possible to change
the profile and other settings afterwards (if the slides are not processed or currently scanned),
even if the batch process has already started.
§ Only the inserted slides are displayed. Empty places in the tray are not shown.
§ To enlarge the label image or the preview image of the specimen area simply click on the
small preview image. You will see an enlarged view of this image for a better recognition of
the content. If the scanning for a slide is finished you do not see the overview image of the
specimen you will see a low magnification representation of the resulting image. If you want
to close the image click on the image again, move the mouse pointer of the image or click an-
other slide to enlarge another preview/scanned image. A double-click on the preview image
opens the advanced editor at the Sample Detection step.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1147


10 Systems & Components | 10.3 Axioscan ZEISS

Fig. 104: Preview image enlarged

10.3.4.4 Axio Scan Tool

Parameter Description
Tray list Displays a list of the trays. A click on the button with the tray number
jumps to the respective tray in the Magazine view and highlights it.
The signal colors in front of the buttons indicate the current status of
the trays. This is the same kind of signal that can be found on the de-
vice itself. Refer to the operation manual for a detailed description. A
double-click on the tray button inserts the mounting frame. If another
frame is mounted, it will be removed automatically.

- Unload Tray Only visible if a tray is loaded.


Unloads the tray located on the stage into the magazine.

System Overview Displays various status information of the device. It is the same infor-
mation which is displayed by the main indicator on the device itself
(e.g. ready, processing, warning).

- Working State Displays the working state.

- Door status Displays whether the door is open or closed.

- Open Opens/closes the door depending on the current status. This function
is equivalent to the Open/Close button on the device itself.

- Stage Position Displays the stage position.

10.3.4.5 Naming Definition Tool

Here you can define naming definitions for the acquired files/images. You can select several defi-
nitions for the file names from the dropdown list. The name automatically contains the detected
barcode content if the barcode detection is active for the active profile.

Parameter Description

Naming Definition
options

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1148


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
- New Creates a new naming definition. The system will ask for the name of
the definition and you can then set up the naming definition in the
Naming Dialog [} 1149]. The name must have at least one character.

- New from Creates a new naming definition based on an already existing tem-
Template plate.

- Edit Edit the current naming definition.

- Rename Renames the current naming definition.

- Save As Saves the current naming definition under another name.

- Delete Deletes the currently selected naming definition.

Naming Definition Selects the naming scheme.


dropdown list

Preview Shows a preview of the configured file name.

Import Name, Pro- Opens a file browser to import the image names and used profiles.
file and Scene You also have the option to apply scene names. When starting an im-
names port, it is necessary to insert all your slides beforehand. The software
will only apply the imported parameters for slides that have been in-
serted with the status new.
For more information on the import, see Importing Names, Profiles
and Scenes [} 1101].

Name, Profile and Activated: Uses barcode information to assign image names, profiles
Folder from Bar- and sub directories.
code For more information on the import, see Using Barcode to Define
Name, Profile and Subfolder [} 1103].

- Name Defines the positions of the characters in the string that should be
used for naming.

- Profile Defines the positions of the characters in the string that identify the
profile.

- Match only Activated: The system uses only the first characters to identify a pro-
the beginning file.
of scan profile
Deactivated: The system uses all characters to identify a profile. Note
name
that this can be very memory intensive and error prone.

- Sub-Path Defines a folder name which is created as a subfolder in the storage


path defined in the Storage Location tool where scanned images are
stored.

See also
2 Creating Your Own Image Naming Convention [} 1101]

10.3.4.5.1 Naming Dialog

Parameter Description
Prefix Defines the prefix.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1149


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Digits Defines the number of digits.

Format Displays and defines the Format IDs for the naming convention.

Initial Counter Defines the initial value for the counter.


Value

Suffix Defines the suffix.

Preview Displays a preview of the image naming based on the settings and the
Format.

Save/Restore Activated: Saves/restores the counter value.


Counter Value

Format IDs table Displays all available parameters that can be used to create a naming
convention.

– ID Displays the ID of the respective format parameter.

– Info Displays an information for the parameter.

OK Saves the setup and closes the dialog.

Cancel Closes the dialog without saving.

See also
2 Creating Your Own Image Naming Convention [} 1101]

10.3.4.6 Storage Location Tool

NOTICE
Possible data loss when saving on network share via direct network connec-
tion
When using a network share as storage path and a direct network connection, e.g. by specify-
ing UNC network addresses only, no safety measure for caching is in place and data loss is eas-
ily possible.
4 Use the "map network drive" function of the operating system. This function involves
some internal caching mechanisms in case networking problems arise.

Here you can specify the storage location of the created images. The location can be a local path
on the computer as well as a network share to store the data on a remote server. It is recom-
mended to store the images locally, as depending on the network properties the connection may
not be sufficiently reliable to store the data. If a network share is selected, a transmission rate of
1000 MB/s or better is mandatory to avoid problems especially when scanning large slides.
By default the system first stores temporary images in the storage location. For information how
to set up a separate folder for temporary files, see Using a Separate Folder for Temporary Files
[} 1106].

Parameter Description
Dropdown list Displays storage locations that have already been used before.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1150


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Opens a file browser to select a folder to store the images.

10.3.4.7 Acquisition Monitoring Tool

To check the image quality (e.g. focus and exposure time) during the scan, the tool Acquisition
Monitoring is available.

Parameter Description
Enable for current Activated: Displays an overview of the specimen with a red rectangle
scan indicating the currently scanned region. Additionally opens an image
document which displays the currently scanned region.
Note: Content is only displayed if the system is in the scanning step, it
is not displayed during other steps like the focus map steps.

Continues the live display of the currently acquired image if it has


been stopped.
Play

Pauses the monitoring and displays the last acquired image.


Stop

See also
2 Monitoring the Acquisition [} 1104]

10.3.4.8 Channels Tool (Axioscan Specific)

For Axioscan systems, you can select special contrast methods, like xPol (TL xPol) and TIE.

Info
Polarization tracks
The individual Pol tracks are synchronized, which is indicated by a lock symbol in the Channels
list. Adding the Pol contrast method in the Advanced Scan Profile Editor automatically adds
all available Pol tracks (depending on the hardware). Changing or deleting a Pol track automat-
ically changes or deletes all other tracks. Duplicating a track or changing the order for acquisi-
tion (with the arrow buttons in the channels list) is not possible for Pol tracks.

Parameter Description
Channel list Displays the currently added channel(s).

– Opens the Add Dye or Contrast Method Dialog [} 869]. In the Ad-
Add vanced Scan Profile Editor, a custom version of this dialog opens.

– Deletes the selected channel.

Delete

– Focus Ref. Sets the selected channel as reference channel for focus actions or
stitching during acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1151


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
– Opens the Channels Tool Options Menu.
Options

Lightsource Select the light source and adjusts the corresponding settings. You
can adjust the parameters of the light sources without having to save
these in the hardware settings.
If you select the Use Setting entry, the settings for the light sources
disappear. The light source parameters from the hardware settings
are used instead for the acquisition of the channel.

Dye name (e.g. TIE In the input field after the selected dye you can enter an additional
or TL xPol) name.

Camera Selects a camera and displays the currently selected one.

Exposure Sets the exposure parameters.

– Auto Exposure Only visible for Widefield acquisition.


Activated: Automatically determines the exposure time of the cam-
era for the selected channel. The manually set value is ignored.

– Set Exposure Only visible for Widefield acquisition.


Starts an exposure time measurement for the channel. After the mea-
surement the value is adopted as the exposure time setting.

– Flash intensity Only visible for flash and TIE acquisition.


Sets the flash intensity in %.

– Flash duration Only visible for flash and TIE acquisition.


Sets the flash duration in µs.

– Measure Measures the correct settings for flash intensity and flash duration to
produce an image without saturation but good dynamic range. The
determined settings will be shown in the corresponding edit fields.
Note: In flash mode the camera exposure time is always fixed and
cannot be modified by the user.

– Measure and Measures the correct settings for flash intensity and white balance.
White Balance

Time Only visible for Widefield acquisition.


Adjust the exposure time for the camera and select the unit of time
from the dropdown list.

– Intensity Sets the intensity.

TIE Setup Only visible if TIE is selected as contrast method.

– Slice Distance Sets the slice distance in µm.

– Reset Resets the slice distance.

– Contrast Selects the contrast type. You have the following two options:
§ Phase Contrast: TIE processing creates an image that looks similar
to Phase contrast.
§ DIC: TIE processing creates an image with looks similar to a DIC
(Nomarski) image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1152


10 Systems & Components | 10.3 Axioscan ZEISS

Parameter Description
Shading Selects the shading type which is applied to the image. For the shad-
ing options in case of Widefield acquisition, see Channel Settings
(Widefield) [} 920].

– None No shading is applied.

– User Enables specific shading for the current channel. You can click Define
to create a specific shading reference.

– Onslide Auto- An accumulated mean image is created for the current channel on the
matic slide when using the scan experiment on the shading area of the sam-
ple detection step. This option is part of the Axioscan workflow when
clicking Start Scan. It is recommended to use this option only for ob-
jectives with magnification 20 or higher.

– Offslide Auto- A snap image is created with no slide in the light path which is used
matic as shading reference. This option is part of the Axioscan workflow
when clicking Start Scan. It is recommended to use this option only
for objectives with magnification lower than 20.

EM Gain Sets the EM gain value.

Focus Offset Only visible if the Show All mode is activated.


Defines the focus offset of the channel to the z-position of the refer-
ence channel or to the current position. The Lock icon shows that
this setting will be synchronized between all channels of this track.

Pixel Shift Only visible if the Show All mode is activated.


Defines the pixel shift in X and Y. The defined pixel shifts are applied
to images collected with Snap, contentious or in an experiment.

Display Only visible if the Show All mode is activated.


Selects an existing predefined display setting to be automatically ap-
plied to this channel after acquisition. Note that this does not apply
for Live acquisition. There always the last used setting is applied.

10.3.4.9 Focus Point View

This view can be displayed in the main view of the Focus Map Settings [} 1133] steps of the Ad-
vanced Scan Profile Editor [} 1120]. This view enables you to see, edit and verify the focus
points created by the respective focus point strategy.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1153


10 Systems & Components | 10.3 Axioscan ZEISS

1 2

1 Focus Point Table


Displays a table of currently set focus points. For more information, see also Focus Point
Table [} 1154].

2 Live Image
Displays a live image at the current stage position.

3 Overview Image
Displays an overview image with the detected regions and focus points and allows the
setting, editing and deleting of focus points. To edit the region(s), you have to go back to
the Sample Detection Settings [} 1126] step.

See also
2 Sample Detection Wizard [} 1119]
2 Working with Focus Points [} 1096]

10.3.4.9.1 Focus Point Table

Parameter Description
Point table Displays the focus points and indicates if they are verified (by a green
checkmark). The table is linked to the overview image, selecting a fo-
cus point in one highlights it also in the other.

– Name Displays the name of the point.

– X Displays the x position of the respective focus point.

– Y Displays the y position of the respective focus point.

– Tile Region Displays the name of the tile region where the point is set.

Verify Starts the autofocus at the selected position to verify the focus point.
Be aware that the focus values you see during the verify run will not
be completely identical to the focus the tiles will assume at this posi-
tion during the scan. This is due to the fact that the focus used during
the scan is the result of the calculated focus map where the focus val-
ues are interpolated.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1154


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4 Celldiscoverer 7

10.4.1 Introduction

Celldiscoverer 7 - Your Automated Platform for Live Cell Imaging


The Celldiscoverer 7 is an automated inverted imaging platform for research applications. The
system calibrates itself, detects and focuses your samples and has adaptive optics to provide the
optimal optical settings in an automated fashion. Thanks to its next generation opto-mechanical
concept, a brand new line of dedicated objectives and a multitude of innovative built-in automa-
tion features Celldiscoverer 7 delivers benchmark data quality and easy operation. It allows to
work with a huge variety of sample carriers like wellplates, petri dishes and slides.
The system can automatically detect and calibrate the sample carrier category, measure the bot-
tom material thickness and adapt the optics automatically to deliver maximum image quality. A
built-in incubation chamber, auto immersion allow for long-term live cell imaging experiments.
The new hardware based focus system can not only hold the focus over time but find the sample
carrier surface.
The system is controlled by the ZEN Blue software package which offers all tools and functions
you need to operate the Celldiscoverer 7 efficiently and automate your imaging workflow. The
software contains some additional functions allowing the user to navigate in a safe, easy and effi-
cient way without unnecessary bleaching.
The following modules are part of the ZEN Celldiscoverer software:

§ Tiles & Positions - in combination with focus strategies this allows for easy and flexible im-
age acquisition especially for multi-position and multi wellplate experiments.
§ Advanced Processing & Image Analysis - Use the built-in image analysis functions, create
pipelines to run online image analysis and modify experiments based on those results on the
fly.
§ Automation GUI - Automate routine experiments and using scan profiles that can be started
with just one button.
§ arivis Cloud (on-site) Basic - On-site execution of arivis Cloud demo modules.
§ Experiment Designer - Configuration of inhomogeneous acquisition experiments.
§ Extended Focus - Calculation of a completely sharp 2D image out of a Z-stack.
§ Measurement - Advanced interactive measurement tools.
§ Multi Channel - Acquisition of fluorescence and transmitted light images in independent
channels.
§ Software Autofocus - Determination of the optimal focus position of the specimen.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1155


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

§ Time Series - Acquisition of time series.


§ Z-Stack - Acquisition of Z-Stacks with the help of a motorized focus drive.
Additional ZEN modules are available as option:

§ Macro Environment - Powerful Python scripts allowing to automate all kind of workflows,
export data and connect to 3rd party application required for the workflow.
§ 3Dxl - Visualization of 3D or 4D image data.
§ Airyscan - Processing of data acquired with Airyscan 2 (LSM only).
§ Airyscan 2 Basic - Multiplex acquisition with 2x parallelisation (LSM 900 only).
§ arivis Cloud (on-site) Advanced - On-site execution of individual arivis Cloud modules.
§ Automated Photomanipulation - Acquisition of multiposition experiments with photoma-
nipulation.
§ Colocalization - Quantitative colocalization analysis between two fluorescence channels.
§ Connect - Advanced functionality of ZEN Connect.
§ Connect 3D Add-on - Extension for ZEN Connect for 3D workflows.
§ Data Storage Client - Connection to ZEN Data Storage database.
§ Deconvolution - Improvement of 3D image stacks via 3D-deconvolution algorithms.
§ Direct Processing - Processing of images directly during acquisition.
§ FRAP - Fluorescence Recovery after Photobleaching (FRAP) analysis.
§ Guided Acquisition - Automatic and targeted acquisition of objects of interest.
§ HDR Confocal Basic - High Dynamic Range (HDR) acquisition mode.
§ Intellesis - Image segmentation based on machine-learning algorithm, using pixel classifica-
tion.
§ Physiology (Dynamics) - Analysis of physiological time series data.
§ Third Party Import - Import of 3rd-party microscopy images into ZEN.

10.4.2 Performing a Celldiscoverer Calibration

The Celldiscoverer calibration wizard is used for hardware calibration of the system. The individual
components can be selected for re-calibration. Calibration data are stored for comparison.
If you want to perform a calibration using the wizard, the following steps are necessary.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1156


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

1. In the menu bar > Tools > System Maintenance and Calibration...

à The System Maintenance and Calibration dialog opens.

2. Click on Continue >>.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1157


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à In the System Maintenance and Calibration dialog, the available Calibration proce-
dures will be shown.

3. Click on Celldiscoverer Calibration Wizard >>.


à The Celldiscoverer Calibration Wizard (1/2 Welcome) opens.

à Three option are available to continue:


- start a new calibration session by clicking on Create New Session
- continue with a previous calibration session by clicking on Open Session File
- read, write and compare calibration data by clicking on Manage Calibration Data
4. To perform a new Celldiscoverer calibration, click on Create New Session.
à Additionally, an edit field with a proposed session name and the Exclude Immersions
Objectives checkbox are hidden.
5. If required, edit the name of the calibration session and activate the Exclude Immersions
Objectives checkbox.
6. To start the calibration procedure, click on Create.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1158


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à The next screen of the wizard will be shown.

7. Select the steps for the calibration procedure by activating the appropriate checkboxes.
8. Click on Next > to run the calibration.
9. After the calibration is done, click Finish.
à The calibration results will be stored in a file and the System Maintenance and Cali-
bration dialog appears again. The Celldiscoverer Calibration Wizard >> item is
marked by a green checkmark.
10. Close the System Maintenance and Calibration dialog with Close.
If the window closes, you have successfully performed the Celldiscoverer calibration.

10.4.3 Using Customized Sample Carriers

The Celldiscoverer 7 allows to create customized sample carrier templates, e.g. for IBIDI multi-
chamber slides.

10.4.3.1 Designing a Customized Sample Carrier Template

This chapter describes an example of how to design a customized sample carrier template for
multichamber slides.

1. Click on Tools > Sample Carrier/Holder Templates.


à The Templates dialog opens.
2. Right click on Slide 76 x 26 mm and select Copy and Edit. It is important to select a slide.
Otherwise the sample carrier detection will not work!
à The dialog to edit the template opens.
3. Rename the template.
4. For Category, select Multichamber.
5. Add the correct dimensions of the sample carrier. It is possible to select the Default Con-
tainer that is initially approached to automatically detect the sample carrier bottom mate-
rial and thickness.
6. Click on OK.
7. Click on x to close the Templates dialog.
You have now created a customized sample carrier template.

See also
2 Combining the Slide Holder Template with the Custom Template [} 1160]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1159


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.3.2 Combining the Slide Holder Template with the Custom Template

1. On the Sample tab, under Sample Carrier, click on Select.


2. In the Select Template dialog, right click on Insert 2x Slide - Long and select Copy and
Edit.
3. Rename your sample carrier according to your designed template.
4. In the Part of Insert Carrier dropdown list, select your previously created template.
5. Click on OK.
6. In the Select Template dialog, select your template in the list and click on OK.
You have now combined a sample holder template with your custom template.

See also
2 Activating the Automatic Sample Carrier Detection for the Customized Sample Carrier Tem-
plate [} 1160]

10.4.3.3 Activating the Automatic Sample Carrier Detection for the Customized Sample Carrier
Template

1. On the Sample tab, under Prescan Options, activate Sample Carrier Detection and click
on Configure.
2. In the Configure Sample Carrier Detection dialog, select Insert 2x Slide –Long and
click on Select.
à The Select Template dialog opens.
3. Under Workgroup Templates, select your customized sample carrier and click on OK.
4. Click on OK to exit the Configure Sample Carrier Detection dialog.
The Sample Carrier Detection will now associate the customized sample carrier template with
the long slide holder. Until changed, every time the slide holder is detected, the customized sam-
ple carrier template will appear.

10.4.4 Shading References on Celldiscoverer

The ZEN celldiscoverer profile enables you to create and manage specific shading references for
your individual use cases. Those references are saved in collections and can be selected and ap-
plied to your respective experiment.

10.4.4.1 Creating Shading References

Prerequisite ü You are working with ZEN celldiscoverer.


1. On the Acquisition tab, use Smart Setup to create widefield tracks, see Smart Setup
Concept [} 862]. Alternatively, open the Channels tool.
à The track selection is displayed.
2. Add the track you want to use for acquisition
à The dialog to add dyes or contrast methods opens.
3. Select your dye(s) by double clicking and close the dialog.
à The channels are added and displayed in the list. The options for the added channels are
displayed when the channel is selected in the channel list.
4. Define the settings for your channels.
à Your channels are set up.
5. Select a channel and click Define.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1160


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à A shading reference is created for this channel and available in ZEN. It is added to the de-
fault collection in the shading management.
6. Repeat this step for every channel for which you want to define a reference. Additionally,
you can change objective and magnification with the Celldiscoverer tool in the Right
Tool Area for creating the next reference.
You have created shading references. You can now manage or apply individual references to your
experiment, see Managing Shading References [} 1161] and Applying Shading References
[} 1161].

See also
2 Shading Management Tool [} 1162]

10.4.4.2 Applying Shading References

Prerequisite ü You are working with ZEN celldiscoverer and you have created shading references, see Cre-
ating Shading References [} 1160].
ü You have set up your acquisition experiment.
1. On the Acquisition tab, open the Shading Management tool.
à The controls for shading management are displayed. The currently added channels are
displayed in the table.
2. In the Select Collection dropdown, select the collection with the shading references you
want to apply to your current experiment.
à The column Available in the table indicates, if the individual shading reference is applica-
ble/suitable for the currently configured experiment in ZEN. In case the column displays a
gray line, no reference is available for the respective channel. You can select another col-
lection or create a suitable shading reference, see Creating Shading References
[} 1160].
3. Activate the checkbox in the Apply column of the table for each shading reference you
want to apply in your current experiment and start your experiment. Alternatively, activate
Apply Shading Correction in the Channels tool.
The experiment starts and the selected shading references are automatically applied.

10.4.4.3 Managing Shading References

Prerequisite ü You are working with ZEN celldiscoverer and you have created shading references, see Cre-
ating Shading References [} 1160].
1. On the Acquisition tab, open the Shading Management tool.
à The controls for shading management are displayed.
2. Click Manage.
à The Shading References Manager dialog opens.
3. In the list on the left, select a collection. A collection can contain multiple shading refer-
ences.
à The shading references of the selected collection are displayed in the list in the middle of
the dialog.
4. Select a shading reference.
à Information about the selected reference are displayed in the Details section on the
right.
5. If you want to enter information about the Specimen, or a general Note, enter the infor-
mation in the respective text fields.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1161


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à The information is added to the current reference.


6. To copy or move a shading reference to another collection, select the reference in the list
and click Copy or Move. Alternatively, you can press alt + m to move, or alt + c to copy
the reference.
à A dialog window opens.
7. Select the Collection where you want to copy or move the reference to and click OK.
à The shading reference is copied or moved to the selected collection. You can also move a
reference to another collection via drag & drop, or copy it by pressing Ctrl during drag &
drop.
8. You can also delete an individual reference by clicking or by pressing Del.
à A dialog opens to confirm that the selected reference is deleted.
9. Additionally, you can activate an entire collection, add a new collection, or delete an entire
collection with the buttons at the bottom of the Collection list. Alternatively, you can also
activate a collection by double clicking it in the list, add a collection by pressing alt + a, or
delete it by pressing Del.
à Your collection is handled accordingly.
10. Click OK to close the dialog. Alternatively, press Esc.
You have managed your references. The changes are applied instantly, e.g. an activated collection
is directly selected and displayed in the Shading Management tool.

See also
2 Shading References Manager Dialog [} 1163]

10.4.4.4 Shading Management Tool

This tool enables you to manage shading references for your experiment.

Parameter Description
Select Collection Selects which collection of shading references is displayed and appli-
cable to your channels.

Manage Opens the Shading References Manager to manage your shading


reference collections.

Apply Available The table displays the available shading references of the currently se-
Shading Refer- lected collection.
ences

– Channel Displays the channel of the active experiment.

– Available Indicates if the respective shading reference is available for the current
experiment.

– Apply Activated: Applies the respective shading reference for the current
experiment.

See also
2 Creating Shading References [} 1160]
2 Applying Shading References [} 1161]
2 Managing Shading References [} 1161]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1162


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.4.5 Shading References Manager Dialog

This dialog enables you to manage your shading references.

Parameter Description
Collection Displays a list with all existing collections of shading references. The
details of the currently selected collection are displayed to the right of
this list in the shading reference table. A single collection includes
multiple shading references of different channels, magnifications and
hardware settings for different samples or sample carriers.

– Activate Activates the currently selected collection.

– + Add Displays a small text field and button to add a new collection.

– Deletes the currently selected collection and all its shading references.
Delete

Shading Reference This table displays all shading references of the currently selected col-
Table lection. When you select one of the references, its detailed informa-
tion are displayed in the Details section on the right.

– Dye Name Displays the name of the dye for the shading reference.

– Objective Displays the objective which was used to create the shading refer-
ence.

– Optovar Displays the optovar which was used to create the shading reference.

Details Section Displays more detailed information for the currently selected shading
reference.

– Move Opens a dialog to move the currently selected shading reference to


another collection.

– Copy Opens a dialog to copy the currently selected shading reference to an-
other collection.

– Deletes the currently selected shading reference.


Delete

– File Name Displays the file name of the currently selected shading reference.

– Specimen Displays a text field to enter information about the specimen that the
reference is used for.

– Sample Holder Displays the sample holder which was used to create the shading ref-
erence.

– Light Source Displays the light source which was used to create the shading refer-
ence.

– LEDs Displays the LEDs which were used to create the shading reference.

– Camera Displays the camera which was used to create the shading reference.

– Objective Displays the objective which was used to create the shading refer-
ence.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1163


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
– Magnification Displays the magnification changer which was used to create the
Changer shading reference.

– Emission Filter Displays the emission filter which was used to create the shading ref-
erence.

– Reflector Displays the reflector which was used to create the shading reference.

– Notes Displays a text field to enter information for the shading reference.

OK Closes the dialog.

See also
2 Managing Shading References [} 1161]

10.4.5 Running Looped Time Series Experiments on Multiple Samples

When working with ZEN Celldiscoverer, ZEN offers the functionality to define looped time se-
ries experiments on multiple samples (i.e. with multi carrier insert plates).

Prerequisite ü You have started the ZEN Celldiscoverer profile and you have configured your multi carrier,
e.g. Insert - 6x Petri Dish, or Insert - 3 slides.
1. On the Acquisition tab, activate Experiment Designer.
à The Experiment Designer tool is displayed.
2. Open the Experiment Designer tool and click Multi Carrier.
à The multi carrier mode is activated and the appearance of the tool changes. The carrier
where the stage is located is displayed with a dark blue frame, and the currently selected
carrier is highlighted with lighter blue.
3. Open the Channels or Imaging Setup tool and define the channels for the experiment of
the currently selected carrier.
à The carrier view in the Experiment Designer tool displays the number and color of the
defined channels as well as objective information in the current carrier. The magnification
of all carriers is by default set to the parameters that were configured in the Celldiscov-
erer tool when creating the experiment.
4. To change the objective or magnification, use the Celldiscoverer tool in the Right Tool
Area. Then click Get Current Magnification in the Experiment Designer tool to use this
magnification for the experiment execution.
à The changed magnification is applied to the currently selected carrier and experiment.
5. In the top part of the Acquisition tab, activate the experiment dimensions you want to ac-
quire, e.g. Z-Stack, Tiles and/or Time Series.
à The respective tools are displayed.
6. Use the tools to set up your time series or z-stack experiment.
à The carrier view in the Experiment Designer tool displays the number of defined z-
planes and time points in the current carrier.
7. In the Center Screen Area, use the controls on the two toolbars to define tile regions for
your experiments. For more detailed information about the functionality, see Tiles & Posi-
tions with Advanced Setup [} 344] and Tiles Advanced Setup [} 372].
à You have defined tiles for acquisition. The carrier view in the Experiment Designer tool
displays the number of defined tiles/positions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1164


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

8. In the carrier view of the Experiment Designer tool, select the next carrier. Alternatively,
change the position by double clicking a carrier on the Scan Position tab in the Central
Screen Area.
à The selected carrier is highlighted in light blue in the Experiment Designer tool. If the
stage is on a different carrier, a warning and a button to move the stage are displayed.
9. Define suitable experiment settings for the newly selected carrier, i.e. define channels, se-
lect and apply a magnification, define tiles, time series and/or z-stack parameters.
à The carrier view in the Experiment Designer tool displays information for the settings.
10. Repeat the previous steps for all carriers that should be part of your experiment.
à You have set up an experiment for each carrier.
11. For Amount, set the number of loops you want to run across all carriers. For Interval Be-
tween Loops, define the time between finishing one loop and starting the next.
à You have configured an acquisition loop across all carriers.
12. Click Start Experiment.
Your configured experiments across multiple samples start. The acquisition runs a loop across all
carriers as defined by your settings. If you have configured a time series for a specific carrier, the
whole experiment including time series is run before continuing to the next carrier.

See also
2 Experiment Designer (Multi Carrier Mode) [} 1182]

10.4.6 Auto Immersion

The Auto Immersion functionality is used for adding immersion fluid (water) to water immersion
objectives and automatically renewing the immersion fluid during experiments. Selecting a water
immersion objective activates Auto Immersion automatically.
The following table illustrates the default and the maximum values for respective parameters:

Parameter Default Value Maximum Value


Time Interval 120 min 720 min

Travel Distance 200 mm 1000 mm

10.4.6.1 Preparing Auto Immersion

1. In Right Tool Area, open the Celldiscoverer tool and select the water immersion objec-
tive.
à Auto immersion is initiated automatically.
à The Create Immersion and Remove Immersion buttons are available.
The immersion process can be controlled manually using the Celldiscoverer tool in the Right
Tool Area:

§ Clicking Create Immersion initiates the creation of one immersion procedure.


§ Clicking Remove Immersion initiates the removing of the immersion fluid.
The immersion creation or removing procedures are independent from the Auto Immersion -
Reimmersion Settings in the Tools > Options dialog.

See also
2 Celldiscoverer Options [} 1193]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1165


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.6.2 Using Auto Immersion for an Experiment

If you want to use Auto Immersion during an experiment, the following steps are necessary.

Prerequisite ü You have set up an experiment (e.g. a time series experiment).


ü You have read Preparing Auto Immersion [} 1165].
1. In Right Tool Area, open the Celldiscoverer tool and select the water immersion objec-
tive you want to use for the experiment.
à The auto immersion is initiated automatically.
2. To change the default parameters for auto- and reimmersion, go to Tools > Options
>Celldiscoverer > Auto Immersion - Reimmersion Settings.
à The options for auto immersion are displayed.
3. Configure the parameters for a reimmersion during the experiment. The event that takes
place first activates the renewing of the immersion during the experiment. For time series
experiments we recommend time intervals for up to 120 minutes. For tiles/multi-position
experiments we recommend the reimmersion after 200 mm travel distance. For information
about the default and maximum values, see Auto Immersion [} 1165].
4. Make sure that Apply Reimmersion Permanently is activated. This way, also without a
running experiment, reimmersion is executed after the set time (default 120 min). This, for
example, enables Guided Acquisition workflows with water immersion objectives.
5. Adjust the default pump settings for your experiment, if necessary.
6. Click OK to close the dialog and save the settings.
You have successfully configured auto immersion for an experiment. You can now execute your
experiment.

See also
2 Guided Acquisition [} 319]
2 Celldiscoverer Options [} 1193]

10.4.7 Restarting the Microscope Remotely

When working with ZEN celldiscoverer, you have the possibility to trigger a remote restart of the
microscope via the File menu.

Prerequisite ü You are working with ZEN celldiscoverer.


1. Click File > Restart Microscope.
à The Microscope Remote Restart Tool opens. The tool window display all necessary
prerequisites for a remote restart and indicates if they are met.
2. Close ZEN. Note that you must not close the Microscope Remote Restart Tool itself!
à The respective point should now be fulfilled and displayed with a checkmark in the tool
window. If all prerequisites are fulfilled, the button in the tool is activated. Depending on
the selection in ZEN, the incubation is not switched off.
3. Click Restart Microscope.
à The microscope is restarted and the tool displays a status message. Note: The LSM is not
affected by the restart.
à Once the restart of the microscope is finished, a respective status message is displayed in
the tool.
4. Close the Microscope Remote Restart Tool and restart ZEN as usual.
You have restarted the microscope remotely.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1166


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.8 Calculating the Disparity Map for Mixed Mode Acquisition

The wizard calculates the disparity map for alignment of camera and LSM frames in mixed mode
acquisition. Based on a reference image which is acquired in the wizard, the disparity map (an im-
age processing function) is generated that is applied for all LSM frames to ensure a pixelwise over-
lay with the WF frames in the mixed mode acquisition.

1. In Tools select System Maintenance and Calibration...


à The System Maintenance and Calibration dialog opens.
2. Click on Continue.
à The System Maintenance and Calibration dialog shows the available calibration pro-
cedures.

3. Click on Mixed Mode Disparity Map Wizard.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1167


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à The Mixed Mode Disparity Map Wizard Step 1/6 opens.

4. Click on Next.
à Step 2/6 of the wizard opens.

5. Load the calibration slide in the center slide position (3-slide holder) and click Load Sample
Calibration Info Tab: Display of acquisition parameters automatically set in the wizard.
• Optics: Magnification used to acquire the reference image.
• Lighting: WF track is acquired using transmitted light. Confocal track is acquired with the
640 nm laser.
• Exposure: Exposure time of camera.
• Focus: Focus position (z). The stage position and focus is set automatically. The correct
focus position can also be defined via Auto-Focus. The software autofocus settings can be
set in the Software Autofocus tab.
Acquire the WF and LSM (confocal) image:
• Activate Auto-Focus to find the correct focus position. Otherwise, select Already in fo-
cus.
6. Click on Image acquisition.
7. Click on Next.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1168


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à The disparity map is calculated and Step 3/6 of the wizard opens.

Parameters used by the RegionDisparityMap function:


• Registration Method: Affine.
• Registration Quality: High (default). If the result is not accepted and the channels do
not overlay correctly, activate the drop down menu to select between low, medium, high
and highest and press recalculate.
Image View:
• Original: Displays the overlay of WF and confocal frame without applying the disparity
map.
• Corrected: Displays the corrected overlay of WF and confocal frame.
Status:
• Successful calculation of disparity information is indicated by a green check mark.
• Successful application of the disparity map is indicated by a green check mark.
8. After successful calculation, click on Next.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1169


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

à The radial distortion is calculated and Step 4/6 of the wizard opens.

Elastic Registration Statistics: A good result is achieved when the average is in the
range of 1 pixel.
Image View:
• Original: Displays the overlay of WF and confocal frame without applying the radial dis-
tortion correction.
• Affine/Distort/Elastic: Display of the individual correction steps.
Status:
• Successful calculation of radial distortion information is indicated by a green check
mark.
• Successful application of the radial distortion map is indicated by a green check mark.
9. After successful calculation, click on Next.
à The final disparity map image is saved and Step 5/6 of the wizard opens.

Storage Location: Define the folder (C:\Users\Public\Documents\Carl Zeiss\ZEN\Docu-


ments\MixedModeDisparityMapWizard).
File Name: Define the file name (default: DisparityMap_Date_Time).
Image View:
• Original: Displays the overlay of WF and confocal frame without applying the radial dis-
tortion correction.
• Affine/Distort/Elastic: Display of the individual correction steps.
• Final: Displays the final image based on the corrections.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1170


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10. Click on Next.


à Step 6/6 of the wizard opens.

• Finish: Ends the wizard and writes the calibration.


• Cancel: Discards the calibration.
11. Click on Finish.
The wizard is closed and the successful calculation of the disparity map is indicated by a green
check mark.

10.4.9 Sample Tab (Interactive Mode)

The Sample tab is the central point of operating the Celldiscoverer 7 system. At the top of the
tab you can activate two different modes, the Interactive or the Automation mode. Usually the
interactive mode is used for the default workflow when no plate loader is present or required. The
Automation mode is especially suited for running routine experiments in an automated fashion,
see Sample Tab (Automation mode) [} 1173].
If you have selected Interactive, the following parameters are available:

Parameter Description
Load Sample Loads the inserted sample and performs various actions depending on
the selected options under Sample Carrier and under Prescan Op-
tions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1171


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
The detection of the bottom surface to measure the skirt of the sam-
ple carrier is always executed for every individual insert separately.

Eject Tray Ejects the loaded tray with the sample carrier.

State Displays the current system status.

Position Shows the current position of the sample carrier. When the tray is
ejected the position is Load, e.g. the system is ready to be loaded
with a sample carrier. When the carrier is in scan position (above the
objectives), the stated position depends on the current carrier type. As
an example it could state WellPlate or Petri Dish 6x, A1.

Sample Carrier

- Select... Opens a dialog to select the sample carrier template you want to
work with. Inside the selection dialog it is also possible to define and
specify your own custom sample carriers, for example your favorite
brand for a 384-well plate carrier. Note that you have to use the pro-
vided plates at any time to avoid collisions.
Starting with ZEN 3.8, a new 3x sample carrier is available, so make
sure to select the correct template to avoid collisions. To select the
correct 3x slide template, check the printed material number on the
frame.

- Removes the selected sample carrier template.


Delete

- Measure Bot- Activated: Measures the bottom thickness of the sample carrier using
tom Thickness special optics. Make sure the used sample carrier has the correct bot-
tom material selected. When glass or COC is selected as a material the
thickness measurement will have much smaller search range. In case
of Polysterol as the selected material the search range will be large in
any case.
Note that the measurement may not be correct for embedded sam-
ples.

- Re-Measure Performs the bottom thickness measurement again at the current XY


position.

- Determine Activated: Attempts to determine the use bottom material on de-


Bottom Mate- mand. The method can differentiate Glass/Cycle Olefin Copolymer
rial (COC)/"glass-like" materials and Polysterol (PS).

- Get Material Performs the material determination again at the current XY position.

Carrier Data After the sample carrier detection during the prescan (see Prescan
Options below), a graphical sketch of the sample carrier data will be
displayed here. Additionally detailed information about the carrier are
shown.
If the sample carrier detection option is not activated, you can enter
the sample carrier data here manually e.g. Material, Refractive In-
dex, Thickness etc..

- Material Here you can select the correct bottom material, e.g. Glass/COC or
Polystyrene (PS).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1172


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
- Refractive In- Here you can modify the pre-selected values if required.
dex

- Thickness Shows the measured bottom material thickness. You can adjust the
value if required.

- Skirt Per default this parameter can not be edited. You can switch it on un-
der Options > Celldiscoverer > General > Allow manual adapta-
tion of skirt.
This value is measured automatically for every sample as soon as the
tray is loaded. It defines the distance from the surface of the tray to
the bottom surface of the actual carrier, e.g. the well plate.

- Default Con- Specifies the container which is approached initially, e.g. to detect
tainer cover glass thickness and measure the skirt height.

- Imaging Specifies the desired penetration depth for autocor objectives.


Depth

- Max. Focus Shows the current upper z-limit of the focus drive.
Position

- DF Search This field shows whether the Definite Focus (DF) search range is re-
Range stricted by the z-limit.
If a warning is displayed you can do the following:
§ Increase the z-limit (Under Options > Celldiscoverer)
§ Reduce the imaging depth
§ Check the refractive index

Prescan Options

- Sample Carrier Activated: The system automatically detects which type sample car-
Detection rier category is used. The result is displayed in the Carrier Data sec-
tion. The Configure button allows to assign a special carrier template
to carrier category. For example the Pre-Scan recognizes a 96 well
plate (category). This "recognition event" can be assigned to sample
carrier template "MyFavorite96Plate".

- Create Carrier Activated: An overview image of the sample carrier is acquired with
Overview the Pre-Scan camera. The overview image is displayed in the image
document area after the Pre-Scan.

- Read Bar- Activated: The system automatically detects barcodes on the sample
codes carrier. Currently the system can read codes placed on the short side-
walls of well plates or on top of the carrier, e.g. on a slide.

- Automatic Activated: An automatic sample carrier calibration is performed dur-


Sample Carrier ing pre-scan. This functionality is available for multiwell plates con-
Calibration taining 48, 96, 384, or 1536 wells.

10.4.10 Sample Tab (Automation mode)

With the Automation mode it is possible to create scan profiles that combine all the pre-scan op-
tions with an actual ZEN experiment. The Automation mode can be used for special sample carrier
inserts, e.g. for 2x Slide (long or short), 3x Slide or 6x dish.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1173


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Fig. 105: Sample tab - Automation mode


If you have selected Automation mode, the following controls and functions are available:

Parameter Description
Default Scan Pro- Here you can set a default scan profile. This profile will be used if new
file sample holders are inserted.
If no profiles exists, you first have to create a new profile via the Op-
tions menu , see below:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1174


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
- Options § New Scan Profile…
Creates a new scan profile.
§ Open Profile Configuration
Opens the Profile Configuration [} 1176] dialog. There you can
edit an existing scan profile.
§ Rename
Renames the selected profile.
§ Save as
Saves the user profile under another file name.
§ Delete
Deletes the selected profile.

Start Prescan Starts a prescan of all selected slots or the inserted sample (if no plate
loader is used).
To select a slot for a prescan, go to Magazine view and activate the
corresponding checkbox in the Process column.

Start Scan Starts the scan of all selected slots or the inserted sample.

Eject Tray Ejects the tray which contains the sample holder.

Import File If you click on this button you can import a file (*.csv format) which
contains configuration data for the system.
Typically the following data can be imported:
§ Magazine, Slot, Barcode, Scan Profile,ImageFileName, Sub-
Path

Under Separator you can select the separator used in the *.csv file
(e.g. Semicolon, Tab)
If you click on Show a preview of the imported data will be displayed.

Storage Location Here you can specify the storage location (file path) for all created im-
ages.
All image sub paths, which might be read from the configuration file
will be inserted below the defined file path.

Naming Definition Here you can define naming definitions for the acquired images. You
can select several definitions for the file names from the dropdown
list. The name automatically contains the detected barcode content if
the barcode detection is active for the active profile.

Click on the Options button to define, edit or delete a defini-


tion.

Plate Loader Sta- The display of this section depends on your system configuration.
tus
If you do not use a plate loader only the sample carrier which you
have configured is displayed in the Magazine view.
If you work with a plate loader, its magazine with the different slots is
displayed. Common plate loaders can have up to 4 magazines. One
magazine can contain up to 12 slots. In the slots you put your sample
carriers containing the sample.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1175


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
The functions mentioned below only apply for the plate loader.

- Currently Shows the location (in the hotel of the loading robot) of the sample
Loaded: holder which is loaded currently.

- Detect All Checks all magazines for slots which contain sample carriers automat-
ically.

- Unload Unloads the currently selected sample carrier from the Celldiscoverer
back to its slot in the magazine.

- Reset This button is only shown in case of an error with the plate loader
(e.g. Plate loader is blocked). The respective message is shown in red.
In this case all controls will be disabled and the plate loader will stop
working. NOTICE! In case of an physical obstruction, e.g. by a
misplaced sample carrier, you first have to remove the sample
carrier before you click on Reset.
By clicking on Reset you can try to restore the system status of the
plate loader. The system then tries to solve the problem using some
internal error checking routines and additional actions.

Magazine 1 - ... Here you see the graphical display of the magazine(s) and its lots. The
magazines are numbered from 1 - 4 (depending on the available mag-
azines). Under a magazine each slot is displayed as blue button. The
slots are numbered as well (e.g. from 1- 12). The icon in front of a
button shows the loading status. Following status are possible:
§ gray = empty slot
§ blue = occupied slot
§ blue blinking = carrier is currently on the stage
§ yellow = problem detected
§ red = Error occurred during processing
§ green blinking = Slot has status prescanned
§ green = Scanning the slot is finished.

If you double-click on a slot button, the slot will be loaded or unload


from the tray (depending of the loading status). If the tray is loaded
with a carrier from a certain slot and you load a carrier from a differ-
ent slot, the currently loaded slot will be unloaded first.

10.4.10.1 Profile Configuration

Parameter Description
Selected Profile Shows the name of the selected profile. Under Profile Description
you can enter a short description, if desired.

Carrier Data Contains information about the sample carrier

- Automatic In case of the option Automatic Carrier Detection the scan profile can
Carrier Detec- contain data for different carrier types. They are visible inside the
tion Sample Carrier list view.

- Fix Carrier As- Only one specific carrier type is assigned to the scan profile. This is
signment useful when working with the same carrier type all the time.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1176


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
Options

- Create Carrier Created and save an sample carrier overview image during the pres-
Overview can which is store inside the actual image data file as an attachment.

- Detect Occu- In case of a sample carrier with multiple inserts, the systems automati-
pied Positions cally checks for empty positions.

- Read Bar- Read the barcodes from the respective position on the sample carrier
codes itself (position depends on the carrier).

- Use configura- Three different options available:


tion file
§ No configuration file: no configuration will be used.
§ Imported Data : use a configuration that must be imported be-
fore.
§ Control Barcode: Defines rules how a barcode will be interpreted.

Sample Carriers This list view allows managing the sample carrier types supported by
the current scan profile. The + button allows to add more carrier
types. The Delete button deletes the carrier type including all as-
signed scan experiments.

Carrier Configura- This area shows the respective carrier configurations and allows to
tion modify them. For normal wellplates there will be only one data set
visible, but for carriers with multiple inserts it is possible to define dif-
ferent configuration for every available insert

- Use same When activated the same configuration will be used for all sample
sample carrier carriers during the processing.
configuration
for all posi-
tions

Assigned Scan Ex- Here you can assign the actual ZEN experiments. For carriers with
periments multiple inserts it is possible to assign an individual experiment to ev-
ery insert, e.g. it is possible to run a different experiment for every
petri dish when using the 6x petri dish.

- Use same scan Allows assigning the same experiment to every individual position of
experiment the carrier, e.g. use the same experiment for all petri dishes of a 6x
for all posi- petri dish holder.
tions

10.4.11 Navigation View

When you are on the Sample tab in the left tool area, the Navigation view displays the loaded
sample carrier. In general the view is used for navigation purposes. Depending on the carrier, you
can use the Scan Position tab to navigate to the single containers of the carrier (e.g. of a petri
dish) by simply double clicking on the desired container. The stage will move automatically to the
center of the selected container. In case of carriers with multiple inserts (e.g. 6x petri dish insert)
the tab allows you the switch between the different inserts.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1177


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Fig. 106: Navigation view


The system is equipped with an automatic collision prevention system. Based on the geometry of
the objective front, the working distance of the objective, the actual carrier or insert geometry
and the skirt height the safe XYZ traveling ranges will be calculated and adapted automatically. In
the Navigation view the currently possible XY travelling ranges are always displayed. The current
active limit for the selected objective is displayed by a thick, dashed line using the respective color.
The limits for the other objectives are also shown using a thin line using the respective color. The
blue cross hair indicates the current stage position and the blue rectangle (only visible at higher
zoom levels) represents the field of view of the objective.
In case that the travel range should be increased (especially for the high magnification objectives),
the Z-Limit above Surface (Tools > Options > Celldiscoverer) can be decreased, see also
Celldiscoverer Options [} 1193].
This view changes to the Navigation & Tiles view if you select another main tab in the left tool
area. The Navigation & Tiles offers the advanced functionality to define tile regions/positions,
see also Tiles Advanced Setup [} 372].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1178


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.12 Navigation Tab

Parameter Description
New Tab Live/continuous image will be displayed in a new tab.

Separate Container Live/continuous image will be displayed in a separate container.

Navigation View Live/continuous image will be displayed in the Navigation window


(very small).

Bring Navigator Enlarges the live/continuous image to full view inside the Navigation
into View window (works for all three options New Tab, Separate Container,
Navigation View).

10.4.13 Magazine View

In general the Magazine view is used to get an overview of the status of the sample carrier(s)/
scan items in the tray of the system or in the magazine(s) of the plate loader.
The display of this view depends strongly on the system configuration. If you use the system with-
out a plate loader the configured sample carrier is displayed.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1179


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Fig. 107: Magazine View without Plate Loader


If you work with a plate loader you will see a list of the available magazines and slots. Note that
only slots which are occupied are displayed. Empty slots are not displayed in the list. We recom-
mend to perform a check for occupied slots by clicking on Detect all in Sample tab under Plate
Loader Status.
The currently loaded slot/scan item is marked by an orange rectangle.

Fig. 108: Magazine View with Plate Loader

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1180


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

The following controls are available for Magazine view:

Parameter Description
Expand All Expands all scan items so that all of them are visible including there
configurations. (This button is only visible when a plate loader is
present.)

Collapse All Collapses all scan items so that only the short information overview
and the processing status is visible. (This button is only visible when a
plate loader is present.)

Mark All Activates the processing markers for all scan items. When clicking
Start Prescan or Start Scan those items will be processed, if their
status allows for those actions (new, prescanned, stopped).

Unmark All Deactivates all processing markers.

Default Order Restores the default order of slots. Their order can be changes via
Drag & Drop. Newly detected carriers will be added at the end.

Select All Selects all items and allows the execution of a context menu entry for
all shown elements at once.

Unselect All Unselects all items.

Tray type informa-


tion

- Show Infor- Shows the results of the processing, if existing.


mation

- Show Profile Open a XML viewer to inspect the complete scan profile configura-
tion.

10.4.13.1 Magazine View Options

The options below are opened via right click on the corresponding slot (e.g. Magazine:1 Slot:1).

Parameter Description
Assign Scan Profile Open a list with all available scan profiles. A click on the desired pro-
file assigns it to the currently selected items.

Mark all scan Activates the processing checkbox for all selected slots and their scan
items of high- items.
lighted trays for
processing

Unmark all scan Deactivates the processing checkbox for all selected slots and their
items of high- scan items.
lighted trays for
processing

Show Overview Opens the sample carrier overview image.


Image

Expand all high- Opens the sample carrier overview image.


lighted holders

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1181


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
Collapse all high- Opens all selected sample carriers.
lighted holders

Reset carrier sta- Closes all selected sample carriers.


tus to New

The options below are opened via right click on an individual sample carrier inside the list (scan
item).

Parameter Description
Move to Scan Posi- Moves the stage to the respective scan position. Depends from the
tion sample carrier and a possible insert and therefor from the scan item
type.

Mark all high- Opens the resulting scan image as an individual document inside the
lighted scan items normal document area.
for processing

Unmark all high- Resets all precessing checkboxes for all selected scan items.
lighted scan items
for processing

Reset Scan status Resets the status of the scan items to "new".
to New

10.4.14 Experiment Designer (Multi Carrier Mode)

When working with ZEN Celldiscoverer, the Experiment Designer tool offers a special mode
to define a repeated experiment loop over a multi carrier insert. For information about the param-
eters of the standard mode, see Experiment Designer Tool [} 287]. When you activate the multi
carrier mode, the appearance of the tool changes and provides the following functionality:

Parameter Description
Get Current Mag- Applies the current magnification to the currently selected carrier.
nification

Copy Copies the experiment setup of the currently selected carrier.

Paste Pastes the previously copied experiment setup to the currently se-
lected carrier.

Options

– Import from Opens a dialog to import experiment blocks from existing experi-
Experiment ments, see Import Experiment Blocks Dialog [} 289].

– Export to Ex- Opens a dialog to export your current experiment blocks as an experi-
periment ment.

– Clear Selected Deletes all experiment settings for the currently selected carrier.
Carrier

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1182


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
Carrier View Displays a graphical representation of the current multi carrier. The
carrier where the stage is located is illustrated by a dark blue frame.
The currently selected carrier is highlighted in a lighter blue. If the cur-
rently selected carrier is not the one where the stage is located, a
warning is displayed below the view and you have a button to move
the stage. Each carrier also displays the information of the set experi-
ment parameters, like number of tiles, z-slices, time points and chan-
nels, as well as information about the selected magnification.

– Move Stage Only visible if the currently selected carrier is not the one where the
stage is located.
Moves the stage to the currently selected carrier to set up the focus,
exposure time, etc.

Loops Across Car- Defines the loops across all the carriers.
riers

– Amount Defines the number of loops that are run for all carriers.

– Interval Be- Defines the interval between the loops.


tween Loops

See also
2 Running Looped Time Series Experiments on Multiple Samples [} 1164]

10.4.15 Celldiscoverer Tool

The Celldiscoverer tool is located in the Right Tool Area. Note that the tool is not visible in Au-
tomation mode. The tool is used for controlling the system hardware components, like objec-
tives, beam splitter, filter wheels, light path etc..

Parameter Description
Objective List Here you can easily switch between the objectives and pre-magnifica-
tion. The color bar on the objective buttons indicates the color for the
respective stage limit indicator inside the Navigation tab.
If you select AutoCorr objectives (motorized correction collar) you can
additionally adjust the relevant settings like Bottom Thickness or
Imaging Depth.

Tank Level Shows the current filling level of the immersion fluid tank.

Create Immersion The system automatically adds the immersion fluid to the selected im-
mersion objective. If the fluid was added once, the button is grayed
out.

Remove Immersion The system automatically removes the immersion fluid from the se-
lected immersion objective.

Bottom Material Only visible if an AutoCorr objective is selected.


Dropdown Allows you to select the bottom material and thickness.

Reset Only visible if an AutoCorr objective is selected.


Resets the values for Bottom Thickness and Imaging Depth.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1183


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
Bottom Thickness Only visible if an AutoCorr objective is selected.
Sets the bottom thickness. We recommend not set the thickness here,
but to let the system determine the bottom thickness automatically by
activating Measure Bottom Thickness on the Sample tab.

Imaging Depth Only visible if an AutoCorr objective is selected.


Specifies the desired penetration depth for autocorr objectives, i.e.
which sample level should be in focus. Usually this position is equal to
the top of the carrier bottom. However, for certain samples (e.g. thick
organoids) it can be useful to adjust the imaging depth.
Note: Changing the imaging depth also changes the focus, so you
have to refocus afterwards.

Beam Splitter List Selects the desired beam splitter from the list. If you change the beam
splitter the corresponding emission filter from the list below is
changed as well.

Filter List Selects the desired emission filter from the list. A change here will not
affect the selected beam splitter.

Pipette Position If you click ON, the system moves to the pipette position, where it is
possible to add reagents to the sample. The tip of the pipette will be
located at the center of the optical axis indicated by the blue crosshair
inside the Navigation tab. Make sure the height adjustment for the
pipette tool is correctly adjusted to the current carrier geometry.

Microscope Con- Opens the Microscope Control dialog. There you can see and adjust
trol the full light path of the system. We recommend to only adjust set-
tings in the light path, if you know what you are doing.

10.4.16 Mixed Mode Settings

The Celldiscoverer 7 allows the combined acquisition of camera and LSM tracks. This unique
Mixed Mode Acquisition ensures the precise overlay of the widefield and confocal/Airyscan im-
ages. The resulting file contains image(s) of all aligned channels, e.g. for seamless analysis work-
flows.
In the Mixed Mode Settings of the Acquisition Mode window, a pixelwise overlay of the wide-
field and confocal frames is set. Optimal image alignment is achieved by registering the LSM im-
age to the camera image. Therefore, a so-called disparity map is automatically created for each
Celldiscoverer 7 system using the Mixed Mode Disparity Map wizard [} 1167]. As a result, four
different image processing functions are automatically carried out when the mixed mode acquisi-
tion is activated to correct for variations in scaling (related to total magnification and pixel size),
distortion, position/offset, and pixel numbers (cropping of the image).

See also
2 Parameters for LSM Imaging Modes [} 875]
2 Acquisition Mode Tool [} 874]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1184


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.16.1 Camera + LSM Combined

By clicking on Combined, the direct overlay of WF and confocal frames is automatically adapted
to the tracks for all zooms and magnifications. For the combined acquisition of WF and confocal
tracks in the mixed mode, no scan field offset and rotation is possible and the bit depth is fixed to
16 bit per pixel. The mixed mode is available for Widefield, LSM confocal, Airyscan HS, and
Airyscan MPLX tracks. The following tracks can be combined:

§ Widefield + LSM confocal


§ Widefield + LSM confocal + Airyscan HS
§ Widefield + Airyscan HS
§ Widefield + Airyscan MPLX HS
The WF track is automatically set as the first track.
Acquiring z-stack images:
Z-stack acquisition in mixed mode will automatically activate Full z-stack per Channel. In the ex-
periment, channel 1 is acquired for all z levels before channel 2 is acquired.

Mixed Mode Settings with Widefield and LSM confocal track:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1185


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Zoom: Zoom is automatically adapted to both camera and LSM track. The widefield image is in-
terpolated to correspond to the LSM image. Zoom is affecting image size and sampling. The num-
ber of pixels (frame size) is constant when changing the zoom.
Frame size: is adapted according to the active sampling. Changes of the frame sizes (e.g. via Pre-
sets) influence the sampling.
Sampling: The channel with highest demand for sampling is master and defines the default.

§ Confocal: xy sampling set for 1.0 x Nyquist (2 times sampling) to achieve optimal settings for
confocal resolution. The camera frame is cropped to the LSM frame.
§ Camera: Adjusts the LSM parameters to match the physical pixel size of the camera.
LSM specific settings (for more information, see Parameters for LSM Imaging Modes [} 875]):

§ Scan Speed
§ Direction Monodirectional or Bidirectional
§ Line Step
§ Averaging
Mixed Mode Setting with Widefield and Airyscan HS/ Airyscan MPLX HS track:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1186


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Sampling: The channel with highest demand for sampling is master and defines the default.

§ Confocal: xy sampling set for 1.0 x Nyquist (2 times sampling) to achieve optimal settings for
confocal resolution. The camera frame is cropped and resampled to match the LSM frame.
§ HS/ MPLX HS: xy sampling set for 1.5 x Nyquist (3 times sampling) to achieve better SNR.
The camera frame is cropped and resampled to match the LSM frame.
§ Camera: Adjusts the LSM parameters to match the physical pixel size of the camera.

10.4.16.2 Camera + LSM Separate

For separate acquisition of WF and confocal tracks, press the Separate button in the Mixed
Mode Settings. The frame size of the camera is reset to maximum. The frame size of the LSM
track is not changed.
Depending on the selected track in the channels window, the Acquisition Mode tool is adapted,
when the Separate tab in the Mixed Mode Settings is active.
For an active WF track, all camera relevant parameters are shown (for details see the chapter for
Acquisition Mode [} 874]). The frame size of the camera is reset to Maximize. Other parameters
are unaffected.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1187


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

For an active LSM track, all relevant scanning parameters are shown.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1188


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.17 Airyscan HS

The Celldiscoverer 7 contains the specific Airyscan HS (high sensitivity) mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1189


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

On the Acquisition Mode tool, the Airyscan HS specific parameter options are the following:

Parameter Description
Sampling

– HS XY sampling set for 1.5x Nyquist to achieve better SNR.

– Confocal XY sampling set for 1.0x Nyquist to achieve confocal resolution with
increased signal-to-noise with Airyscan detector.

For information about the general parameter options of the Acquisition Mode, see Acquisition
Mode Tool [} 874].

10.4.18 Airyscan MPLX HS

The Celldiscoverer 7 contains the specific Airyscan MPLX HS (high sensitivity) mode. This track
type cannot be combined with Confocal, HS or WF tracks. Mixed Mode Acquisition is not pos-
sible.
The Airyscan MPLX HS track is a selection option in the Imaging Setup.

On the Acquisition Mode tool, the Airyscan MPLX HS specific parameter options are the fol-
lowing:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1190


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
Sampling

– HS-2Y XY sampling set for 1.5x Nyquist to achieve better SNR.

– CO-2Y XY sampling set for 1.0x Nyquist to achieve confocal resolution with
increased signal-to-noise with Airyscan detector.

For information about the general parameter options of the Acquisition Mode, see Acquisition
Mode Tool [} 874].

See also
2 Acquiring LSM 900 Images with Airyscan 2 Multiplex Modes [} 1200]
2 Acquiring LSM 980 Images with Airyscan 2 Multiplex Modes [} 1202]

10.4.19 Dispensing Tool

This tool is used to set up dispensing events for certain container(s) on a sample carrier. To per-
form dispensing, the system moves the sample carrier to the dispensing position where you can
easily add dispensing fluid to the selected container(s). The Dispensing checkbox is displayed by
activating Time Series.

Parameter Description
Sample Carrier Shows the selected sample carrier which will be used for dispensing.

Options

- Repeat every Here you can adjust the interval between dispensing events during an
experiment.
E.g. if you adjust the value to 5 min, the software will pause the run-
ning experiment after 5 minutes and allows you to add a substance to
your sample.

- Dispensing Here you can adjust the total number of dispensing events for an ex-
events periment.

- Select contain- If you click on the Select button, the Container selection dialog
ers opens. There you can select the containers in which you want to add
the fluid.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1191


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Fig. 109: Container Selection Dialog

10.4.20 Perfusion

To enable perfusion experiments, insert the POC-R dispensing chamber into the Insert plate for
perfusion.

Do not connect the perfusion tubes when loading the sample to avoid any damage.

If the sample has reached the imaging position, the perfusion tubes can be connected. By clicking
Measure Bottom Thickness the skirt height and bottom thickness are determined.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1192


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

10.4.21 Celldiscoverer Options

Parameter Description
General

- Use Auto- When using the 0.5X after-magnification the chip window on the
mated Camera camera is adjusted automatically in order to remove the dark areas in-
Frame Correc- side the corners due to the limited FOV for (only!) this after-magnifica-
tion tion.

- Enable Auto- If activated and you work with a plate loader, the Automation mode
mation Mode is automatically activated on the Sample tab.
(restart re-
quired)

- Disable empty Activated: In Automation Mode, the sample is loaded without Au-
check for au- tomatic Sample Carrier Detection.
tomation We recommend this option if there are problems with the Automatic
Sample Carrier Detection in Automation Mode. The sample car-
rier type has to be defined in advance.

- Allow manual Activated (not recommended): the skirt height of the carrier can be
skirt adaption adapted manually.
Caution: This is not recommended! Modify the skirt height only if it is
known exactly. Otherwise, there is the risk of crushing the objective
into the sample carrier.

- Ask User to Activated: Shows a warning during loading of the sample carrier if
Adapt Experi- the sample carrier does not fit to the actual experiment. Allows you
ment with In- either to adapt the sample carrier or to leave the experiment un-
serted Sample changed.
Carrier Caution: The adaptation of the experiment to the actual sample car-
rier will delete all tile regions/positions.

- Do not show a Activated: Shows no warning during experiment execution.


Warning at
Activating this is recommended for automation/execution of macros
experiment
etc. to avoid stopping the experiment/workflow. ZEN sometimes asks
execution, if
for manual confirmation and this would cause the experiment or the
the validation
macro to stop.
result can be
ignored

Cover Glass Thick-


ness Detection Op-
tions

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1193


10 Systems & Components | 10.4 Celldiscoverer 7 ZEISS

Parameter Description
- Use Default Activated: Uses the default thickness detection.
Thickness De-
Deactivated: This is not recommended. Displays controls where
tection (recom-
you can adjust the cover glass thickness detection options manually
mended)
for trouble shooting.

- Use Aberra- Activated: Attempts to improve the result of the thickness measure-
tion Correc- ment by considering aberration effects. Per default this setting is de-
tion activated.

Prescan Options

- Show Images Activated: Displays the images used for recognition inside the docu-
Used for ment area after the Pre-Scan. This option should only be activated for
Recognition troubleshooting the Pre-Scan sample carrier recognition.

- Show Live Im- Activated: Displays the live images used for the automatic sample
age during carrier calibration inside the document area after the Pre-Scan. This
Automatic option should only be activated for troubleshooting the Pre-Scan sam-
Sample Carrier ple carrier recognition.
Calibration

Z-Limit above Sur- Displays controls for adjusting the default z-limits of different objec-
face tives to increase the available XY traveling range.
The icons inside the DF Search Range column indicate if the avail-
able z-range is sufficient for performing a Find Surface operation.

Auto Immersion -
Reimmersion Set-
tings

- Reset Resets all parameters to the default values.

- Reimmersion Configures the time interval and travel distance for automatic immer-
During Experi- sion events. The event that takes place first activates the renewing of
ment Every the immersion during the experiment.

- Apply Reim- Activated: Permanently enables auto immersion execution globally.


mersion Per- This way, re-immersion is automatically executed after the set time
manently (default 120 min), even without a running experiment. This enables,
for example, Guided Acquisition [} 319] workflows with water im-
mersion objectives.

Pump Settings

- Remove Wa- Adjusts the duration for the removal of the applied water. The set
ter time defines the duration for which the suction pump is switched on
(default: 5000 ms). Note that a small water droplet may remain.

- Apply Water Adjusts the duration for the application of water (default: 2500 ms).

- Waiting Time Sets the waiting time after a refill that pauses the image acquisition to
after Refill allow the water to distribute equally (default: 2000 ms).

Phase Gradient
Contrast Settings

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1194


10 Systems & Components | 10.5 Lattice Lightsheet ZEISS

Parameter Description
- Automatic A phase gradient contrast image is calculated from two single images
Half Pupil An- acquired with two different angles of the half pupil.
gle Adapta-
If activated, the optimal choice of the angles is calculated depending
tion
on the current X/Y Position insides the well.

10.4.22 Smart Setup

Airyscan HS and Airyscan MPLX HS tracks are selected as a detection mode in the drop down
menu of the LSM tab.

10.5 Lattice Lightsheet

10.5.1 Starting the Software for Lattice Lightsheet

Prerequisite ü Microscope and hardware components are switched on and are ready for operation.
ü The ZEN software is installed on your computer.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1195


10 Systems & Components | 10.5 Lattice Lightsheet ZEISS

1. Start the software as described in the general chapter Starting Software [} 22].
2. On the profile selection window, click ZEN lattice lightsheet.
à The software starts and a dialog for stage/focus calibration is displayed.
3. Click Calibrate Now to start the calibration. This step is needed to obtain absolute stage
coordinates when the hardware was newly started. You can skip this step, if the hardware
was not turned off after the last calibration.
4. On the top of the Acquisition tab, click Select in the Sample Carrier section. Alterna-
tively, click Detect for an automatic sample carrier detection.
à A dialog to select a sample carrier template opens.
5. Select the sample carrier template that is used for the experiment and click OK.
à You have selected the sample carrier for your experiment.
6. On the Acquisition tab, in the Imaging Setup tool, click +Lattice Lightsheet to add a
Lattice Lightsheet track. Alternatively, the track can also be added in the Channels tool, or
the Lightsheet/Aberation Control tool.
à You have started and prepared the software for Lattice Lightsheet. You can now set up
your experiment.

10.5.2 Stage LLS Tool

Parameter Description
Navigation Control Enables you to navigate the sample in a microscope equipped with a
motorized stage, see Stage Tool [} 985].

X-, Y-, Z-Position Displays and sets the position in x, y and z.

Joystick Speed Displays the current speed set on the Ergodrive.

– Low speed Ergodrive is set to low speed.

– High speed Ergodrive is set to high speed.

Home XYZ Defines absolute coordinates during a calibration run.

Cleaning Strokes Allows the activation of a cleaning stroke.

– Go Starts a cleaning stroke to remove wear from the stage.

– Auto Suggest Gives a suggestion to conduct a cleaning stroke after a defined num-
ber of scans.

10.5.3 Lattice Lightsheet Auto Immersion Tool

Parameter Description
Auto Immersion Activated: Enables Auto Immersion and performs it asynchronous to
the experiment.

Time Interval Sets the time interval between pump strokes.

Scheduling Selects the mode of water supply.

– Pause experi- If the set time interval has elapsed, the experiment is set on hold and
ment for im- one pump stroke is applied.
mersion

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1196


10 Systems & Components | 10.5 Lattice Lightsheet ZEISS

Parameter Description
– Wait for Ac- If the set time interval has elapsed, the system waits for the current
quisition to step to finish before applying water.
finish

Create Immersion Creates a pump stroke to fill the meniscus lens.

Renew Applies a small amount of water to the meniscus lens.

Prime Pump The immersion fluid is continuously flushed and renewed until the
Stop button is clicked to finish this process.

10.5.4 Lightsheet/Abberation Control Tool

Parameter Description
Focus Sheet Moves the light sheet perpendicular to the illumination objective lens
axis.

Focus Waist Moves the light sheet along the optical axis of the illumination objec-
tive lens axis.

Aberration Control Compensates aberrations in the detection objective lens.

– Load Loads a saved setting.

– Save Saves the current setting.

Tilt X-Axis Compensates the tilt in the x-axis.

Tilt Y-Axis Compensates the tilt in the y-axis.

10.5.5 Focus Alignment Sharpness Control Tool

Parameter Description
Find Beam Reflec- Focuses the sample on upper cover glass surface.
tion

Focus Sheet and Moves the light sheet along the optical axis of the illumination objec-
Waist tive lens as well as perpendicular to the illumination objective lens
axis; aligns the light sheet for best image quality.

Carrier Tilt Correc- Automatically levels the sample across all activated tile regions. Only
tion available if Tiles is active and at least three tile regions are defined
and activated.

Store Focus Defines the focus position in z with respect to the upper cover glass
surface.

Recall Focus Sets the focus to the defined focus position. This is only active if
Store Focus was executed.

Stop Interrupts any automatically executed process.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1197


10 Systems & Components | 10.6 Linkam Cryo Stage ZEISS

10.5.6 Deskew

Parameter Description
Settings Allows the management of settings files, see General Settings [} 83].

Interpolation Selects an algorithm for interpolation.

– Nearest Uses the Nearest Neighbor model for interpolation.


Neighbor

– Linear Uses a linear model for interpolation.

– Cubic Uses a polynomial model for interpolation.

Processing Method Selects the method that is applied for processing.

– Cover Glass Image frames are deskewed and transformed to an orthogonal coor-
Transforma- dinate system based on the coverslip geometry.
tion

– Deskew Image frames are only deskewed.

10.5.7 Lattice Lightsheet

Parameter Description
Settings Allows the management of settings files, see General Settings [} 83].

Deconvolution Activated: Displays the Deconvolution and PSF Settings tab to set
up a deconvolution. For detailed information, see Deconvolution (ad-
justable) [} 95].

Deskew Activated: Displays the Deskew tab with the functionality of the re-
spective processing function, see Deskew [} 1198].

Select Subset Creates an image subset used for processing. For detailed descriptions
of the parameters, see Create Image Subset [} 108].

10.6 Linkam Cryo Stage

To be able to acquire cryo images in ZEN, several prerequisites have to be fulfilled:

§ The Linkam Cryo stage has to be set in the MTB configuration.


§ You have licensed the Linkam Cryo Stage module.
§ You have activated under Tools > Modules Manager > Optional Hardware the module
Linkam Cryo Stage.

10.6.1 Exporting Temperature Data

You can export the temperature data which are logged during the acquisition of temperature se-
ries images (cryo images) in ZEN. The export depends on the software version you have started.

Export with all ZEN versions

Prerequisite ü You have opened the temperature series image to export the temperature data.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1198


10 Systems & Components | 10.6 Linkam Cryo Stage ZEISS

1. Click on the Measure view.


2. In the Measurement tab, click on Export Temperature Data.
à The temperature data is displayed as a chart.
3. In the Export tab, click on Export Table.
4. In the file browser, select the storage location and click on Save.
You have exported the image temperature data.

Export with licensed module Linkam Cryo Stage

Prerequisite ü You have opened the temperature series image to export the temperature data.
1. In the Cryo Temperature tool, click on Export Temperature Data.
à The temperature data is displayed as a chart.
2. In the Export tab, click on Export Table.
3. In the file browser, select the storage location and click on Save.
You have exported the image temperature data.

10.6.2 Adding Temperature Annotations to an Image

Temperature data of images is saved in the metadata. To display the information directly in the
image you need to create an annotation which can be displayed in the image.

1. Open your image in ZEN.


2. In the view options below the image, click on the Custom Graphics tab.
3. Click on Customize.
à The Customize Tools dialog opens.

4. Under Frequent Annotations, select Other and click on .


à The annotation is now visible in the User Toolbar list on the top of the dialog.
5. In the User Toolbar list, right-click on Other... and select Format Custom Graphics.
à The Format new custom graphic tool dialog opens.
6. In the Annotation drop-down list, select ....
à The Select Metadata dialog opens.
7. In the list, select your metadata (Cryo Stage Bridge Temperature, Cryo Stage Dewar Tem-
perature, Cryo Stage Chamber Temperature).
8. Click on OK to close the Select Metadata dialog.
9. If necessary, change other parameters of the graphic.
10. Click on OK.
11. Click on Close to exit the Customize Tools dialog.
Your custom graphic is now available on the Custom Graphics tab. You can add it to your image
and see the temperature information displayed directly in the image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1199


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7 LSM 900/980

10.7.1 Confocal Image Acquisition (LSM)

10.7.1.1 Acquiring LSM 900 Images with Airyscan 2 Multiplex Modes

Multiplex modes allow a faster image acquisition with Airyscan 2 detectors. The acquisition is par-
allelized in the Y-direction, which allows to process full SR or confocal resolution though not every
line in Y was scanned during acquisition. The Airyscan 2 detector has nonetheless acquired data
for all lines in the image.

1. On the Acquisition tab, in Imaging Setup select Airyscan MPLX in the drop-down list.

à The respective Airyscan mode menu will be displayed in the Acquisition Mode tool.
2. Click on SR-2Y to activate a parallelization of 2 lines in the Y-direction. Alternatively, if no
super resolution is required, click on CO-2Y.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1200


10 Systems & Components | 10.7 LSM 900/980 ZEISS

3. If 2x parallelization is not fast enough, click on SR-4Y to activate a parallelization of 4 lines


in the Y-direction. This mode always delivers super resolution results. For confocal resolu-
tion, click on CO-2Y.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1201


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.1.2 Acquiring LSM 980 Images with Airyscan 2 Multiplex Modes

Multiplex modes allow a faster image acquisition with Airyscan 2 detectors. The acquisition is par-
allelized in the Y-direction, which allows to process full SR or confocal resolution though not every
line in Y was scanned during acquisition. The Airyscan 2 detector has nonetheless acquired data
for all lines in the image.

1. On the Acquisition tab, in Imaging Setup select Airyscan MPLX in the drop-down list.

à The respective Airyscan mode menu will be displayed in the Acquisition Mode tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1202


10 Systems & Components | 10.7 LSM 900/980 ZEISS

2. Click on SR-4Y to activate a parallelization of 4 lines in the Y-direction.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1203


10 Systems & Components | 10.7 LSM 900/980 ZEISS

3. If 4x parallelization is not fast enough, click on SR-8Y to activate a parallelization of 8 lines


in the Y-direction. This mode always delivers super resolution results.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1204


10 Systems & Components | 10.7 LSM 900/980 ZEISS

4. If no superresolution is required, click on CO-8Y. The highest speed can be selected in


CO-8Y mode, with confocal resolution results.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1205


10 Systems & Components | 10.7 LSM 900/980 ZEISS

5. The slider between these buttons allows to select any sampling between these sampling
points.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1206


10 Systems & Components | 10.7 LSM 900/980 ZEISS

6. It is also possible to select a desired image format, e.g. 1024 x 1024 pixels. The slider will
then display the sampling factor deriving from the selected zoom or crop area.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1207


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Additional information for using Z-stacks:


The Z stepping is not automatically adjusted to the sampling mode, but is set to secure maximum
resolution. The button Optimal and the checkbox Optimize Sectioning and Step in the Z-
Stack menu set the acquisition for optimal oversampling in Airyscan SR resolution.
Faster volume speed can be achieved by intentionally selecting a wider Z stepping, e.g. for CO-8Y
mode. The recommendation for a fast CO-8Y stack would be 1.5x – 2x the calculated optimal in-
terval. Deselect the check box Optimize Sectioning and Step to choose your interval manually.

10.7.1.3 Using Smart Setup with Airyscan LSM 980 and LSM 900

After selecting samples and overall preference for speed (single track, more crosstalk) or signal
(multi track, less crosstalk), you can choose LSM confocal or Airyscan 2 detection modes in Smart
Setup.

LSM confocal acquisition

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1208


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Prerequisite ü Smart Setup is open.


1. Select LSM at the detection selection on the right.
2. Click on OK to activate the acquisition settings.

Airyscan 2 detection mode

Prerequisite ü Smart Setup is open.


1. Select Airyscan at the detection selection on the right.
2. Click into the triangle depending on your preference for resolution, speed and SNR/sensitiv-
ity.
3. Click in one of the areas in the lower left corner to activate available modes with super res-
olution image quality.
Depending on how close the selected area is to Speed, the amount of parallelization in
pixel acquisition will increase.
4. Click in one of the areas on the line at the right between SNR/Sensitivity and Speed to
activate modes with at least confocal image quality. Depending on how close the selected
area is to Speed, the amount of parallelization in pixel acquisition will increase.

10.7.1.4 Using the Sample Navigator with LSM 980 and LSM 900

The Sample Navigator wizard is a tool to find the focus plane and quickly acquire an overview
scan of your sample. You can also simplify the search for a region of interest for the actual imag-
ing experiment. Together with Smart Setup, it allows to set all basic settings for a new sample
without extensive search of the sample by the eyepieces.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1209


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1. In the Acquisition tab, click on the Sample Navigator button.

à A wizard shows up which guides you through the required steps. On the left you find
general settings, in the middle temporary information and steps to do.

2. Put a sample on the stage and center the sample with some structure over the center of
the objective.
The preferred objective to use is a 2.5x overview objective. Alternatively, 5x and 10x objec-
tives can be used if a Axiocam is available on your system. If no Axiocam is present, the
LSM T-PMT will be used for detection.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1210


10 Systems & Components | 10.7 LSM 900/980 ZEISS

3. Select a checkbox with the wavelength that matches the label of your sample.

à You are asked whether this sample was already focused, or if a new sample was put on
the microscope. With a new sample, you are asked to focus the objective a bit closer
than the putative focus plane. This is because the autofocus will move away from the
sample when searching for the focus plane.
4. Click on Objective is now close to the sample to confirm.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1211


10 Systems & Components | 10.7 LSM 900/980 ZEISS

5. Click on Next at the bottom of the wizard.


à This guides you to Step 2, which selects the sample carrier.
6. Select a matching sample carrier type from the selection list in the middle.
The coverage degree can be selected with the three buttons Small, Middle and Full. Full
means full coverage of the Cover slip area.

à The selected coverage is displayed by a red area on the sample carrier drawing.

7. Click on Next at the bottom of the wizard.

à This guides you to Step 3, which selects the Kondensor Filter in case the T-PMT was se-
lected as detector.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1212


10 Systems & Components | 10.7 LSM 900/980 ZEISS

8. Since Sample Navigator uses transmitted fluorescence with the T-PMT, a laser blocking
filter needs to be inserted. This filter is located in one of the DIC positions of the condenser,
and labelled T-FL. Also, correct Köhler adjustment is needed. Setups with Sample Naviga-
tor have a line marking at the condenser carrier, which helps to find the right position.

9. Click on Next at the bottom of the wizard.

à This guides you to Step 4, which is the autofocus step.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1213


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10. Click on Focus Detection to start the autofocus, and observe the image in the middle.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1214


10 Systems & Components | 10.7 LSM 900/980 ZEISS

11. If the image is over- or underexposed, the light intensity needs to be adjusted with the
slider Light Source Intensity.

12. In case the autofocus result is not sufficient, correct it by manually focussing the sample
with the focus drives or CTRL+ mouse wheel.
13. Click on Finish to start the automatic overview tile scan.

The wizard is closed and a new image container opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1215


10 Systems & Components | 10.7 LSM 900/980 ZEISS

The overview image can be used to navigate to ROIs, by a double-klick on an interesting struc-
ture. This will re-center the stage. Proceed with normal image acquisition by setting up acquisition
parameters for a higher magnification objective.

10.7.1.5 Acquiring Confocal Images

To acquire confocal images you first have to setup the acquisition parameters and configure your
experiment. Therefore we recommend to use Smart Setup as this will automatically give you cer-
tain suggestions for the experiment configuration, e.g. Airyscan acquisition or camera based ac-
quisition. In the following guide you will learn how to use Smart Setup and acquire a first confocal
image. Due to the huge variety of samples (and suitable experiment configurations) this guide
shows the necessary basics only.

Prerequisite ü You are on the Acquisition tab.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1216


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1. Click on Smart Setup.

2. Click on Add.

à The Add Dye dialog opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1217


10 Systems & Components | 10.7 LSM 900/980 ZEISS

3. Select the dyes used in your experiment. Double-click on a dye entry to add it to the list.

4. Click on OK to close Smart Setup.


5. Make sure that the cover glass of you sample points towards the objective.
Use the appropriate immersion medium for the objective.
6. Click on Live to start a live scan.

à You will see the image of your sample in the center screen area.
7. Search the desired sample area and focus with the joystick. Alternatively use the mouse
wheel while pressing the Ctrl key.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1218


10 Systems & Components | 10.7 LSM 900/980 ZEISS

8. Click on Stop to stop the live scan.

9. Click on Set Exposure to automatically adopt the sensitivity of the detector to the sample
brightness.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1219


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10. Optional: If you work with weakly stained samples, you can try to increase the laser power
under Channels > Lasers. Then repeat the last step by clicking on Set Exposure.

à The sample is adjusted correctly.


11. Click on Snap to acquire a single confocal image.

You have successfully acquired a confocal image. Save the image in the Images and Documents
tool or under File > Save.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1220


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.1.6 Optimizing the Acquisition Settings with LSM Plus

LSM Plus is an advanced imaging function in confocal mode. It delivers higher resolution and
better SNR by optimizing the acquisition settings and an additional linear deconvolution process-
ing of the data. LSM Plus can be used in confocal LSM mode with 1,0x confocal sampling and
lower sampling factors down to 0.8x Nyquist. However, the best resolution results are achieved
with higher sampling factors.

Prerequisite ü You have licensed the LSM Plus module.


ü You have set up your confocal acquisition.
1. On the Acquisition tab, in the Acquisition Mode tool, click LSM Plus.
à The Sampling is set to a default sampling of 1.2x Nyquist.
2. To gain even higher resolution results, open the Channels tool.
3. Set the Pinhole to a value below 1 AU.
à The sampling is increased automatically to a matching Nyquist value, as long as LSM Plus
is active. Clicking the 1AU button ends the automatic coupling.
You have optimized the acquisition settings for confocal acquisition. To view the confocal image
with LSM Plus processing, use the LSM Plus tab in the view options below the image, see LSM
Plus Tab [} 1045].

10.7.2 Imaging Setup

10.7.2.1 LSM Confocal

Chose LSM confocal as acquisition track for standard confocal acquisition. The following channels
are available for confocal acquisition:

§ Ch1 = Multialkaline PMT (available for all configurations)


§ ChS1 to ChS4 = GaAsP PMT (part of a 6 or 32 channel configuration)
§ ChS5 to ChS8 = GaAsP PMT (part of a 32 channel configuration)
§ Ch2 = Multialkaline PMT (part of a 6 or 32 channel configuration)
§ Ch2 = GaAsP PMT (part of a 3 channel configuration)
§ Ch3 = Multialkaline PMT (part of a 3 channel configuration)
§ ChA = GaAsP PMT (optional, part of a configuration with Airyscan)
§ T-PMT = Mulitalkaline PMT (optional multialkaline PMT in transmission)
§ GaAsP 1 and GaAsP 2 = GaAsP PMT (optional, BiG.2) detection module attached to DCout
port)

Info
LSM confocal tracks can be used in a multitrack acquisition with either NDD (Non Descanned
Detector) tracks or Airyscan SR tracks.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1221


10 Systems & Components | 10.7 LSM 900/980 ZEISS

3
7
4

8 6

10

11

Fig. 110: Imaging Setup, LSM Confocal

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1222


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1 Switch track every


Select the switch mechanism by which the hardware is changed between the tracks in
case a multitrack acquisition is set up. If a User Interface Box is connected, the TTL sig-
nals during scanning for Pixel, Line, Frame and Z-Stack will be indicated by LEDs on
the user interface box. These TTL signals can be used to synchronize other devices by
BNC cables. The TTL signal for the Z-Stack is only linked to the stack acquisition when a
Z-piezo device is used.
§ Line
Switches tracks in between every line of an image.
This mode switches between the used laser line for each track and the detection
channel(s) used for acquisition with their predefined gain and offset. Other hardware
settings like filters, pinhole or the spectral width of a channel cannot be changed in
between tracks.
This mode is especially useful for applications with high temporal correlation be-
tween the different emission signals.
§ Frame
Switches tracks in between every full image frame.
This mode allows to change all kinds of hardware in between tracks including main
dichroic beam splitters, secondary beam splitters, emission filters for Airyscan 2, fil-
ters in the reflector turret, the pinhole and the spectral width of the channel. This
provides a highly specialized acquisition mode but with a slower overall acquisition.
§ Frame Fast
Switches tracks in between every full image frame (fast).
This mode works similar to line wise switching with the difference that tracks are
switched after each full image frame. The same restrictions as with line wise switch-
ing apply to parameter changes in between tracks. This mode reduces the frequency
of sample illumination for each dye
§ Z-Stack
Switches tracks in between every full image stack.
This mode is only available for image acquisition using Z stacks. The mode switches
tracks in between every full Z stack acquisition. This reduces imaging time as switch-
ing between tracks is performed less often when for each image a frame wise multi-
track is the best choice.

2 Spectral display
Shows the emission spectrum of the selected dye(s) assigned to active or non active
channels of the displayed track and the laser lines used for excitation.

3 Detection range
A bar slider shows up for each activated channel. The slider color matches the color cho-
sen for the corresponding channel. Channel 1 to Channel 3 are aligned from left to right.
The width of the sliders represent the detection range covered by the respective channel.
Change position of a slider with the left mouse button using the cross which appears
when the cursor is moved over the slider. Accordingly, use the arrows at the edges of a
slider to expand or shrink the width of the slider. Moving and adaption is only possible
for internal channels. Channels with emission filters like BiG.2 or Airyscan 2 cannot be
adapted in their spectral range unless a different filter is selected.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1223


10 Systems & Components | 10.7 LSM 900/980 ZEISS

4 Emission filter for Airyscan


When Airyscan (ChA) is selected as detection channel the selection for Airyscan emission
filters shows up in this line area. Chose a matching emission filter from the drop down
list which opens up when clicking the arrow on the left hand side of the bar. As with the
internal channels, the setting of the SBS filter affects the detection range of the Airyscan
detector. This again is shown as a (partially) empty bar.

5 Channel selection area


This panel lists all available detection channels for LSM Confocal mode. Select/unselect
checkbox Use for activation/deactivation of individual channels. Assign a dye to a chan-
nel by clicking the Dye drop down arrow and selecting a dye from the Add Dye or Con-
trasting Method Tool Window. Assig a color to the channel by clicking the arrow in the
Color column and selecting a color from the LUT. The color can also be changed in the
Channels tool. The name changes to the name of the dye if a dye is selected for this
channel. The name can be changed in the Channels tool and then shows up also in the
Imaging Setup. The Range column displays the detection range of each channel. For in-
ternal channels the detection range can be adapted as described above. In addition it is
possible to edit the upper and lower border of the detection range by clicking into the
range column. Use the arrows or the editing field to precisely adapt the detection range
as needed.

6 Reflection
Check the box for imaging in reflection mode. This mode provides an easy tool to get a
better understanding of surface structures.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1224


10 Systems & Components | 10.7 LSM 900/980 ZEISS

7 Secondary beam splitters


The line with the drop down arrow represents the secondary beam splitter (SBS) filter
wheel. It allows to direct light to the DCout port where Big.2 or Airyscan 2 might be at-
tached. The SBS filter wheel is automatically set to mirror for LSM confocal tracks as typi-
cally only internal channels are used in this mode. Mirror directs all emission light to the
internal channels.

8 Icon to select polarization filters


The emission light can be filtered using polarization filters. The filters are set in track wise
acquisition mode for detecting S and P polarized light. With this approach polarizsation
anisotropy can be measured. Click onto the icon to select one of the two polarization fil-
ters. See Obtaining an Anisotropy Image [} 1288]for further instructions.

9 Main dichroic and laser line icon for visible lasers (445, 488, 514, 543, 561, 594,
639 nm)
The two icons are one for the main beam splitter and one for the laser line which is cou-
pled to the port facing the corresponding main dichroic filter wheel. When selecting a
laser line either in this tool window or otherwise (see Lasers Tool or Channels Tool
[} 914]) the matching main dichroic filter is set automatically. The filter changes again
upon selection of an additional laser line or a different laser line if necessary. Deactiva-
tion of a line does not change the main dichroic filter. In case no matching dichroic is
available the 80/20 dichroic is selected. You can change the dichroic to a self-chosen set-
ting if needed. Note that only after chosing an additional line or unselecting and reselect-
ing a different (combination of) line(s) the filter will be changed again automatically.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1225


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10 Main dichroic and laser line icon for in-visible lasers (405 nm, Multiphoton Laser)
The two icons are one for the main beam splitter and one for the laser line which is cou-
pled to the port facing the corresponding main dichroic filter wheel. When selecting a
laser line either in this tool window or otherwise (see Lasers Tool or Channels Tool
[} 914]) then the matching main dichroic filter is automatically set. The filter changes
again upon selection of an additional laser line or a different laser line. Deactivation of a
line does not change the main dichroic filter. In case no matching dichroic is available the
80/20 dichroic is selected. You can change the dichroic to a self-chosen setting if
needed. Note that only after chosing an additional line or reselecting a different (combi-
nation of) line(s) the filter will be changed again automatically. Make sure to deselect all
lines first before selecting a new (combination of) laser (lines).

11 Reflector Turret icon


When LSM 980 is attached to the rear port of Axio Observer it can be necessary to con-
trol the position of the reflector turret of the stand when acquiring a LSM image. For
multiphoton systems two positions of the reflector turret are equipped with specific
dichroics to reflect the emission signal to NDD channels in reflection. When using NDD
tracks (see NDD (Non Descanned Detector) [} 1231]), select the matching dichroic for
NDD detection.

10.7.2.2 Airyscan SR

Chose Airyscan SR as acquisition track for superresolution imaging with highest image quality. The
following channel is available for Airyscan SR acquisition:

§ ChA = GaAsP PMT (optional, part of a configuration with Airyscan 2)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1226


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Fig. 111: Imaging Setup, Airyscan SR


For Airyscan SR tracks the SBS filter wheel is automatically set to plate to direct all emission light
to Airyscan 2. If you have licensed the Dynamics Profiler functionality, the Imaging Setup tool
displays the Dynamics Profiler button. It enables you to start the acquisition wizard for an FCS
experiment with an Airyscan SR track. All other controls are identical to LSM confocal tracks.
Airyscan SR tracks can be combined in a multitrack acquisition with LSM confocal tracks.

1 Spectral display
Shows the emission spectrum of the selected dye assigned to Airyscan 2 and the laser
lines used for excitation.

2 Secondary beam splitters


The line with the drop down arrow represents the secondary beam splitter (SBS) filter
wheel. It allows to direct light to the DCout port to BiG.2 or Airyscan 2. The SBS filter
wheel is automatically set to plate for Airyscan SR tracks. If Airyscan SR tracks should be
combined with LSM confocal tracks, the SBS filteres can be used to split the light be-
tween the internal channels and Airyscan.

3 Emission filter for Airyscan


Select a matching emission filter from the drop down list which opens up when clicking
the arrow on the left hand side of the bar.

4 Channel selection area


This panel displays the per default activated Airyscan channel. Assign a dye to the chan-
nel by clicking the Dye drop down arrow and selecting a dye from the Add Dye or Con-
trasting Method Tool Window. Assign a color to the channel by clicking the arrow in the
Color column and selecting a color from the LUT. The color can also be changed in the
Channels tool. The name changes to the name of the dye if a dye is selected for this
channel. The name can be changed in the Channels tool and then shows up also in the
Imaging Setup. The Range column displays the detection range of the Airyscan channel.
It is dependent on the selected emission filter.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1227


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.2.3 Airyscan MPLX

Multiplex modes allow a faster image acquisition with Airyscan 2 detectors. The acquisition is par-
allelized in the Y-direction, which allows to process full SR or confocal resolution though not every
line in Y was scanned during acquisition. The Airyscan 2 detector has nonetheless acquired data
for all lines in the image.
Airyscan MPLX can be selected in the drop down list of the Imaging Setup.

For information on how to acquire LSM images with Airyscan multiplex modes, see Acquiring
LSM 900 Images with Airyscan 2 Multiplex Modes [} 1200] or Acquiring LSM 980 Images
with Airyscan 2 Multiplex Modes [} 1202].

10.7.2.4 LSM Lambda

Chose LSM Lambda as acquisition track for spectral imaging with subsequent dye unmixing (emis-
sion fingerprinting). The mode allows to separate strongly overlapping emission signals.
The following channels are available for LSM Lambda acquisition:

§ Ch1 = Multialkaline PMT (part of a 6 or 32 channel configuration)


§ ChS = GaAsP PMT (part of a 6 or 32 channel configuration)
§ Ch2 = Multialkaline PMT (part of a 6 or 32 channel configuration)
§ Ch2 = GaAsP PMT (part of a 3 channel configuration)

Info
Lambda tracks cannot be used in a multitrack acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1228


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1 Create OFP
Activates Online Fingerprinting for the currently selected lamda track, see LSM Online
Fingerprinting [} 1230] for general information.

2 Dye Selection Panel


Displays and adds the emissions spectra of the dyes to be unmixed to the spectral display
panel. By clicking + the Add Dye or Contrasting Method selection dialog opens to se-
lect the corresponding dyes for your sample. The emission spectra are displayed in the
spectral display panel.

3 Spectral Display Panel


The emission spectra of all selected dyes are displayed in this region to get a better over-
view over the needed detection range and possibly the necessary spectral resolution.

4 Resolution
Sets the spectral resolution with the drop down list. The Number of Scans that are per-
formed for the selected resolution is displayed on the right side. Depending on the scan
head configuration the acquisition of the emission fingerprint image is either done in par-
allel with one illumination of the sample (32 channel configuration with 8,9 nm or lower
spectral resolution), or in several illumination steps (32 channel configuration with
4,3 nm or higher spectral resolution; 6 and 3 channel configuration).

5 Detector Selection Panel


Activates the necessary detectors for the spectral acquisition. If the spectra do not reach
out into the far red or the lower blue range, ChS (or Ch2) suffice for image acquisition.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1229


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.2.5 LSM Online Fingerprinting

Selects LSM Online Fingerprinting as acquisition track for spectral imaging with automatic subse-
quent dye unmixing (Emission Fingerprinting). The mode allows to separate strongly overlapping
emission signals with final reduced data volume as no raw data are stored. It also speeds up data
generation in case the parameters for unmixing are known.
Online Fingerprinting can be activated also after a lambda mode acquisition has been defined
with the button Create OFP, see LSM Lambda [} 1228]. In this case all settings including detec-
tors, lasers, detection gain etc. will be transferred. Online Fingerprinting can also employ addi-
tional detectors, including the NIR detection channels.
The channel for Online Fingerprinting is selected automatically.

Info
Online Fingerprinting tracks cannot be used in a multitrack acquisition.

1 Spectral Display Panel


This area displays the emission spectra of the selected dyes.

2 Spectral Range Slider


Defines the spectral width for the collection of the fluorescent signals by moving, ex-
panding or shrinking the bar slider.

3 Resolution
Selects the spectral resolution with the drop down list. The Number of Scans that are
performed for the selected resolution is displayed on the right side. Depending on the
scan head configuration, the acquisition of the emission fingerprint image is either done
in parallel with one illumination of the sample (32 channel configuration with 8,9 nm or
lower spectral resolution), or in several illumination steps (32 channel configuration with
4,3 nm or higher spectral resolution; 6 and 3 channel configuration).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1230


10 Systems & Components | 10.7 LSM 900/980 ZEISS

4 Dye Selection
Selects one or more dyes from the unmixing spectra database. Online Fingerprinting re-
quires pre-defined spectra which are used for the automatic subsequent unmixing
process. The settings for Online Fingerprinting (resolution, spectral width) should ideally
match the acquisition parameters for the unmixing spectra.
The drop down list Reference Spectrum displays all reference spectra available for lin-
ear unmixing which have been stored at earlier sessions. A double click on the spectrum
name loads it as a reference spectrum.
For each selected spectra, a Spectral Gain slider is added to the channels menu. This
gain adjustment allows to balance the reference spectra in the unmixing result, even
when excited by the same laser line and detected mostly by the same detector(s).

10.7.2.6 NDD (Non Descanned Detector)

Chose NDD as acquisition track for multiphoton imaging. Using non descanned detectors for
imaging when exciting with a multiphoton laser provides a significantly better image quality for
deep tissue imaging.

Info
Filters in front of NDDs have to be inserted/changed manually. The indication of changed fil-
ters to ZEN software needs to be done with the MTB software. It is possible to do this when
ZEN is running by clicking on Apply after changing the filters as needed.

The following channels are available for NDD acquisition (all channels are optional; if non-des-
canned detectors are not available, NDD tracks cannot be set up; the maximum number of chan-
nels in reflection/transmission mode is limited to 5 and dependent on the type of stand used):

§ NDD.2 (2 channels) in reflection mode (for all stands)


§ NDD.2 (2 channels) in transmission mode (for Axio Observer and Axio Examiner)
§ NDD.2 single channel as channel 3 or 4 in reflection mode (only in combination with NDD.2;
all stands; for Axio Examiner also in transmission mode))
§ BiG.2 (2 channels) in reflection mode (for all stands)
§ BiG.2 (2 channels) in transmission mode (for Axio Examiner)
§ GaAsP NDD 2 channels in reflection mode (for Axio Examiner only, in addition to other chan-
nels in reflection mode)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1231


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Fig. 112: Imaging Setup, NDD

Info
NDD tracks can be used in multitrack acquisition with other NDD or LSM confocal tracks.NDD
tracks can be used in multitrack acquisition with other NDD or LSM confocal tracks. When the
tracks are switched between NDD and other modes during an experiment, the system shows a
safety warning which, however, does not impair data acquisition but is only commenting on
the intermediate state where the correct safety measures kick in.

1 Display of detection range as colored bar for NDDs positioned in reflection mode
This area displays the detection range of all selected channels. Only detectors which col-
lect the fluorescent signal reflected from the sample are represented in this line.

2 Spectral display area


The emission spectra of dyes allocated to active channels are displayed.

3 Display of detection range as colored bar for NDDs positioned in transmission


mode
This area displays the detection range of all selected channels. Only detectors which col-
lect the fluorescent signal transmitted through the sample are represented in this line.

4 Channel selection area


This panel lists all available detection channels for NDD mode. Select/unselect checkbox
Use for activation/deactivation of individual channels. Assign a dye to a channel by click-
ing the Dye drop down arrow and selecting a dye from the Add Dye or Contrasting
Method Tool Window. Assig a color to the channel by clicking the arrow in the Color col-
umn and selecting a color from the LUT. The color can also be changed in the Channels
tool. The name column lists the names of the detection channels. The name changes to
the name of the dye if a dye is selected for this channel. The name can be changed in the
Channels tool and then shows up also in the Imaging Setup. The Range column displays
the detection range of each channel which depends on the emission filter placed in front
of the channel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1232


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.2.7 LSM FCS

Fig. 113: Imaging setup. LSM FCS


The Imaging Setup tool allows to chose LSM FCS as acquisition mode for FCS/FCCS measure-
ments. This track lists all available detectors which can be used for FCS/FCCS measurements. The
number of detectors changes with the configuration of the system. A maximum of seven (32+2 ch
configuration), 5 (6+2 ch configuration) or 2 channels (2+1 ch configuration) can be selected for
FCS/FCCS. An additional 2 detectors are listed independent of the configuration in case BiG.2 is
mounted onto the DCout port of the scan head.
The following channels are available:

§ ChS1 to ChS4 = GaAsP PMT (part of a 6 or 32 channel configuration)


§ Ch2 = Multialkaline PMT (part of a 6 or 32 channel configuration)
§ Ch2 = GaAsP PMT (part of a 3 channel configuration)
§ GaAsP 1 and GaAsP 2 = GaAsP PMT (optional, BiG.2 detection module attached to DCout
port)
Activate one or more detectors as needed for the experiment. In the lower panel these detectors
can then also be activated for cross-correlation (FCCS) data analysis.

10.7.3 Image Acquisition with the Near Infrared 730nm Laser

Dyes at the extreme red end of the wavelength spectrum can be imaged with the 730nm laser
and the mandatory external 2 channel NIR detector. Both channel mode and lambda mode for
spectral unmixing are available.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1233


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.3.1 Channel Acquisition Mode with the NIR Detector

The NIR detector is displayed in the Imaging Setup [} 1221] below the internal VIS detection, due
to the external position of this detector. The channels can be activated and the split point of the
SBS is set automatically. The detection bands within the detector cannot be changed in the tool
as they are defined by the user exchangeable filter sets.

To activate the detection in confocal channel mode, you can either use Smart Setup for a fully
automatic setup, or select the respective NIR dyes and activate a matching NIR channel according
to the emission spectrum. The SBS and laser MBS positions are set automatically.

In the Channels tool, the additional channels and the 730nm laser are available like all other
channels and laser lines. Note that in photon counting mode of the channels, the 730nm laser
should be best operated at minimum power levels.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1234


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.3.2 Lambda Acquisition Mode with the NIR Detector

If you have selected LSM lambda mode for acquisition, a unified detection range slider allows you
to define the detection range including the selected NIR dyes. The appropriate detectors are auto-
matically added to cover the selected detection range. SBS and laser MBS positions are set auto-
matically as well.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1235


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.3.3 Available P&C Filter Blocks for the NIR Detector

The detection ranges available in the ZEN depend on the filter cube mounted in the NIR detector.
The NIR filter cube needs to be entered correctly in the MTB application in order to have the cor-
rect menu and automatic setting of SBS filters.

The NIR filter cubes are user exchangeable by the same mechanical interface as the BiG detector
filter cubes. The following filter sets are available for the cubes:

Filter set NIR Ch1 range NIR Ch2 range


Filter set 7 NIR for 640nm 660 - 900nm ---
laser

Filter set 8 NIR for 640nm 660 - 705nm 760 - 900nm


and 730nm laser

Filter set 9 NIR for 730nm 760 - 815nm 815 - 900nm


laser

10.7.4 Fluorescence-Lifetime Imaging Microscopy

ZEN offers the possibility to acquire images with FLIM (Fluorescence-lifetime imaging microscopy)
contrast in collaboration with PicoQuant. For this, a LSM 980 is combined with additional hard-
ware (lasers, detectors) TCSPC electronics and software by PicoQuant. The software setup used
for this case consists of two parts: ZEN (with special components in MTB and a FLIM application li-
cense) and SymPhoTime 64 by PicoQuant. SymPhoTime 64 is running on a separate PC that is
connected to the system PC. The intensities of the pulsed laser lines from PicoQuant are adjusted
via an attenuator controlled by the NI-DAQ driver. The laser power and pulse frequency is con-
trolled with SymPhoTime 64 or the FLIM Acquisition tool (via its connection to SymPhoTime 64).
The attenuator is necessary to achieve low laser intensities, which cannot be done by only reduc-
ing the electrical laser power.

10.7.4.1 Preparing ZEN for FLIM Connection

To be able to acquire images with FLIM, you have to activate a certain option that allows control
of ZEN via its macro interface.

Prerequisite ü You have started ZEN.


1. Go to Tools > Options > Macro Editor.
à The options for the macro environment in ZEN opens.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1236


10 Systems & Components | 10.7 LSM 900/980 ZEISS

2. Activate Enable TCP Macro.


à The field for the TCP Port Number is activated. This port is used for communication.
3. Click OK to close the dialog and save the changes.
You have activated the possibility to control ZEN via the port displayed/set in the options dialog.

See also
2 Setting Up and Starting a FLIM Acquisition [} 1237]

10.7.4.2 Setting Up and Starting a FLIM Acquisition

Prerequisite ü The hardware and MTB are set up. In the active MTB configuration, the FLIM Laser module
and the wavelength of the laser line are set.
ü You have set up ZEN for control via the macro interface, see Preparing ZEN for FLIM Con-
nection [} 1236].
ü ZEN is set up and running on the LSM PC.
ü You have activated the FLIM application license in Tools > Modules Manager.
ü SymPhoTime 64 by PicoQuant is set up and running on the FLIM PC.
1. On the Acquisition tab, open the Imaging Setup tool.
à The track selection is displayed.
2. Add a LSM Confocal track.
à The track is added and a FLIM button is displayed in the Imaging Setup tool. Experi-
ments that combine FLIM acquisition with other channels (e.g., Airyscan, widefield) are
not supported. Note that if you add other tracks (e.g. Airyscan), this button is not dis-
played.
3. In the Channels tool, activate the laser line for FLIM acquisition as specified in the MTB.
4. In the Imaging Setup tool, set up the beam path. If you want to use pulsed excitation, first
select the pulsed laser line and then choose a suitable MBS (mean beam splitter) at the in-
visible laser port. The MBS at the visible laser port should be set to Plate. Configure the de-
tection beam path inside the LSM scan module and select the FLIM detector. Alternatively,
load the default experiment for FLIM.
5. Go to the Acquisition Mode tool and define your settings. Make sure you have selected
Frame acquisition, set Averaging to None and use mono-directional scan. Maximum im-
age size for FLIM acquisition is 4096x4096 pixel. Note that the online display for FastFLIM is
only available for images up to 1024x1024 pixels and will be switched off for larger frame
sizes.
à In case the acquisition requirements for FLIM are not fulfilled, the FLIM button is dis-
abled and a tooltip provides further information.
6. If you want to configure a Z-Stack and/or Time Series experiment, activate the respective
checkbox on the Acquisition tab and define the settings in their respective tools.
à You have set up an acquisition experiment.
7. In the Imaging Setup tool, click FLIM.
à The FLIM Acquisition dialog opens.
8. In the Files tool, define the naming of the files. The name must not contain ".", they are
converted into "_".
9. In the Measurement Settings tool, define when the FLIM acquisition is stopped.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1237


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10. In the Laser Settings tool, adjust your laser settings for the individual laser line(s). In addi-
tion, the intensity for the shutter controlling All Lasers must be adjusted. Also define the
Repetition Rate according to the fluorescence lifetime. In general, the repetition rate
should be as high as possible to achieve the highest possible photon count rate. However,
the time window after a laser pulse should still be large enough to allow the population of
excited dye molecules to deplete completely before the next laser pulse.
11. Click Test to test your current acquisition settings.
à A continuous test acquisition starts and is displayed as image document in ZEN and Sym-
PhoTime 64. You can adjust your settings while it is running. To finish, click Stop.
12. Click Measurement to start the actual measurement experiment.
à The acquisition starts and all controls in the dialog are disabled. In the Count Display
tool, you can see statistical information.
à The measurement is stopped based on the settings in the Measurement Settings tool.

See also
2 FLIM Acquisition Dialog [} 1238]

10.7.4.3 FLIM Acquisition Dialog

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1238


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1 Experiment Information
If the configured experiment in ZEN is a Z-Stack or Time Series experiment, this section
displays the respective information (z-planes, time points). Use this information to follow
the acquisition.

2 Tabs
This section contains two tabs. The Maintain/Info tab provides further information
about the acquisition currently configured in ZEN and all metadata that are transferred to
SymPhoTime 64. This serves only information purposes, the parameters can only be
changed via the main ZEN tools (e.g. the Acquisition Mode tool). The Application tab
displays controls for acquisition settings.

3 Files Section
Here you can define names for the files, see Files Section [} 1239].

4 Measurement Settings
This section allows you to define when a running acquisition is stopped, see Measure-
ment Settings [} 1239].

5 Laser Settings
This section enables you to adjust individual laser settings, such as the intensity, see
Laser Settings [} 1240].

6 Statistics
This section displays acquisition statistics like the Sync (= laser repetition rate), the aver-
age count rate or the maximum number of photons for each channel.

7 Button Bar
This section contains the three main buttons to control the acquisition, see Button Bar
[} 1240].

See also
2 Setting Up and Starting a FLIM Acquisition [} 1237]

10.7.4.3.1 Files Section

Parameter Description
Group Defines a group name for the generated file(s).

File Name Defines the file name.

Comment Enables you to add a comment.

10.7.4.3.2 Measurement Settings

Parameter Description
Stop Manually Only visible if Z-Stack and Time Series are deactivated in ZEN.
The acquisition stops when it is stopped manually.

Stop After Elapsed Sets the time after which each acquisition is stopped. For a z-stack,
Time after the defined time the acquisition of the next z-plane is started.
For time series, after the defined time the acquisition of the next time
point is started.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1239


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Photons in Bright- Sets the number of photons after which each acquisition is stopped.
est Pixel For a z-stack, after reaching the defined photon number the acquisi-
tion of the next z-plane is started. For time series, after reaching the
defined photon number the acquisition of the next time point is
started.

Stop After Frames Sets the number of frames after which each acquisition is stopped.
For a z-stack, after the defined number of frames the acquisition of
the next z-plane is started. For time series, after the defined number
of frames the acquisition of the next time point is started.

10.7.4.3.3 Laser Settings

Parameter Description
Individual Lasers Activated: Enables you to adapt the absolute Power of the laser as
well the relative Intensity for the respective laser. Keep the default
power settings to ensure the smallest pulse width of the laser. To in-
crease the laser power, adjust the Intensity.

All Lasers Adapts the intensity for all lasers. Must be higher than 0%.

Repetition Rate Sets the repetition rate.

Laser Pattern Selects the laser pattern.

– Standard Selects the standard laser pattern which operates one pulsed laser at
a time at the defined repetition rate.

– PIE Selects Pulsed Interleaved Excitation for synchronizing several pulsed


lasers. Usually, the pulses of two lasers are delayed with respect to
each other to yield a pulse sequence with interleaved pulses for se-
quential excitation of two fluorophores.

10.7.4.3.4 Button Bar

Parameter Description
Test Starts a continuous acquisition for testing and adjusting the FLIM ac-
quisition parameters.

Measurement Starts the FLIM experiment and disables the controls in the Settings
windows of the dialog.

Stop Stops the currently running FLIM acquisition.

10.7.5 FCS (Fluorescence Correlation Spectroscopy)

FCS (FCS) records temporal changes in the fluorescence emission intensity caused by single fluo-
rophores passing the detection volume. It provides quantitative localized measurements of physi-
cal parameters including mechanisms of transport, molecular mobility, and densities of fluores-
cently labeled molecules based on temporal fluctuations which are detected via their emission sig-
nal intensity. In the most basic configuration, FCS examines the inherent correlations exhibited by
the fluctuating fluorescent signal from labeled molecules as they transit into and out of a specified

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1240


10 Systems & Components | 10.7 LSM 900/980 ZEISS

excitation volume. The most easily observed change in intensity is the fluctuation of the concen-
tration of fluorescent molecules. The temporal auto-correlation of the recorded signal intensity
provides a quantitative measurement of the strength and duration of the intensity changes. These
parameters are used to calculate the average number of molecules and their average diffusion
time through the excitation volume. From this, further parameters can be deduced like concentra-
tion and size (shape) of the molecule. The dual-color variation, termed Fluorescence Cross-Correla-
tion Spectroscopy (FCCS), is utilized to probe two species labeled with different fluorophores.
FCCS can extend investigations to the examination of biochemical reactions between two part-
ners, such as reaction rates, kinetics, fractions of binding or reacting molecules, and mobilities of
a complex formed between the partners.
For successful FCS measurements both, the used hardware and the sample must meet certain
standards. FCS-based-techniques measure fluctuations caused by single molecules within a small
volume of typically less than a femtoliter which needs to be precisely defined. Hence a high-end
objective paired with highly sensitive detectors and a low noise highly stable laser source is a pre-
requisite. Especially for FCCS measurements color shift effects of optical elements have a negative
impact onto the results. Hence one must keep the measurement spot on the optical axis/center of
the scan field when FCCS data are acquired. The stage rather than the scanner need to be used to
position the measurement spot in the very center of the scan field.
FCS measurements need a single photon counting detector and a laser wavelength suitable for
fluorophore excitation. FCCS measurements are typically performed observing two fluorophores
excited with different wavelengths and using two counting detectors.
LSM 980 provides several detectors which can be operated in counting mode and hence can be
used for FCS and FCCS measurements.
The most basic configuration includes two counting capable channels, more advanced systems
provide 5 or even 7 counting capable channels. In addition, BiG.2, an external detection unit
which can be mounted onto the scan head of each of these configurations, can be used for FCS
and FCCS.
FCS and FCCS measurements are either performed using dissolved molecules/dyes or using cul-
tured cells observing low to medium abundant proteins (few pM up to µM) at endogenous ex-
pression levels.
For successful measurements the preparation of the sample must meet some prerequisites.
When analyzing labeled molecules in solution the labeled molecule/dye should be dissolved in a
water/buffer solution and diluted such that the concentration is between 1-50 nM. After dilution,
the solution must be put into a chamber with a # 1.5 cover-glass bottom. The glass bottom thick-
ness/quality is influencing the measurement which relies on a precisely defined focal spot. Make
sure to put enough media to cover the entire bottom of the chamber. Common dyes used for this
kind of experiment are for example any kind of Alexa Fluor® dye.
For cultured cells the endogenous expression of fluorescently labeled proteins is best achieved us-
ing modern genome editing techniques. This keeps the expression level low enough for successful
FCS and FCCS measurements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1241


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.5.1 Overview Acquisition Tools

Imaging Setup

Fig. 114: Imaging Setup tool, FCS track selection


Within the Imaging Setup tool select +LSM FCS from the track selection drop down list to set
up and activate a FCS track. Only with an active FCS track, the FCS specific acquisition tools will
be displayed.

Main Action Buttons

Parameter Description
Continuous Opens a new FCS document and starts a continuos FCS measurement
according to the settings defined in the Channels Tool.

Snap Starts the FCS measurement according to the settings defined in


Channels Tool and Experiment Regions. Snap performs a FCS data
acquisition at the center of the scan field or at all FCS spots defined
and activated in Experiment Regions.

Channels Tool
For description of the parameters in the Channels tool, see Channels Tool - Measurement Set-
tings [} 1243].

Right Tool Area

Parameter Description
Detector Counting Shows counts per second (Count), correlation amplitudes (Correlate)
Tool or counts per molecule (CPM). The values are updated whenever a
FCS acquisition is running. The values displayed can be averaged over
1, 3 or 10 seconds.

Experiment Region Tool

Parameter Description
Draw FCS spot Defines positions in xy (FCS spots) for FCS measurement using the
scanner for positioning.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1242


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Update Z Allows to assign different Z positions to different FCS spots. Z-Focus
positions are only indicated and relevant for FCS spots, not for any
other experiment regions..

File Menu

Parameter Description
New FCS Docu- Opens a new FCS document in the Center Screen Area. Existing data
ment can be added to the new document by copy and paste or drag and
drop from stored documents to rearrange and combine data sets.

FCS Document View

Parameter Description
Correlation view Opens when data acquisition starts. It shows count rate and correla-
tion graphs for all active acquisition channels.

Info Shows selected information on the experiment.

Fit Provides various tools for data fitting and display.

10.7.5.1.1 Channels Tool - Measurement Settings

Parameter Description
Measurement Here you can enter the period of one measurement.
Time

Repetitions Here you can enter the number of repetitions for one measurement.

Adjust Opens the Adjust Pinhole wizard to perform an automatic count rate
versus pinhole position scan.

Z-scan Opens the Z-Scan [} 1244] wizard to perform a Z-scan ant plot the
count rate averaged value dependent on the Z position to find the op-
timal focus position.

Fit Model Here you can select a fit model for fitting the data of the selected
channel after finishing the measurement.
A different fit model can be selected for each FCS/FCCS channel.

10.7.5.1.1.1 Adjust Pinhole Wizard

Info
In case two lasers and two detectors (for the visible light path) are defined, the plot shows
more curves, one for each laser/detector pair. Potential cross-talk effects can be excluded
when defining only one laser and detector for the adjustment procedure. The curves match
the color of the detector defined in the Imaging Setup or Channels tool.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1243


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Invisible light path Only displayed if the laser with invisible light (405 nm or IR laser) is
defined for the acquisition.

– Adjust X axis Adjust the position of the pinhole on the X axis.

– Adjust Y axis Adjust the position of the pinhole on the Y axis .

– Coarse
Moves the pinhole position in X or Y over the whole range while ac-
quiring FCS data for each position. The count rate data are averaged,
fitted to match a gaussian curve and plotted against the pinhole posi-
tion. The plot is displayed in the center area in the Calibration View
tab. It is possible to change between the view tabs during acquisition.

– Fine
Moves the pinhole position in X or Y about 10 micrometer around the
currently stored value while acquiring FCS data for each position. The
count rate data are averaged, fitted to match a gaussian curve and
plotted against the pinhole position. The plot is displayed in the cen-
ter area in the Calibration View tab. It is possible to change be-
tween the view tabs during acquisition.

– Pinhole position Before the adjustment scan is started, the slider and the input box be-
sliders/ input neath the show the currently stored pinhole position in X and Y. The
box sliders can be moved and the position edited once the scan has fin-
ished. This allows to move the positions to a different value than sug-
gested by the system. The then indicated value will be stored when
clicking Finish to leave the wizard. The Pinhole position in the plot is
shown in micrometer. One micrometer corresponds to approximately
one motor step.

Visible light path Only displayed if the laser with visible light ((lasers from 445 nm to
639 nm) is defined for the acquisition.

Cancel Cancels the procedure and keeps the existing pinhole position.

Finish Takes over the new pinhole position as general position also for all
other LSM acquisition functions.

10.7.5.1.1.2 Z-Scan Wizard

Z-Scan provides an automated procedure to optimize focus position for auto- or cross correlation
measurements. The Z-Scan provides the following parameters:

Parameter Description
Current Position Displays the current position. This position is changing during the ac-
tual scan procedure.

Center Position Displays the Center Z Position of the defined range.

Range Define the range of the Z-Scan by either typing in a value or using the
scroll arrows of the Range edit box.

Step Width Define the step width by either typing a value or using the scroll ar-
rows of the Step Width edit box.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1244


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Start Perform the scan by pressing Start.
During the scan the count rate is plotted for the selected channels us-
ing the channel assigned colors.

Once the scan is complete a red bar is positioned at the Z position


with the maximum count rate. This position can be changed by mov-
ing the red bar, moving the slider beneath the Start button, typing in
a value into the edit box next to the slider, or using the scroll arrows.

Finish Click Finish to take over this Z position for the FCS measurement.

Cancel Click Cancel to discard the values and keep the original Z position

10.7.5.1.2 FCS Document View

This view contains three layers, which can be selected by clicking the corresponding tab:

Tab Description
Correlation Displays the count rate trace, the correlation function, the photon
counting histogram, the pulse density histogram, and the result table,
see Correlation Tab [} 1246].

Fit Displays the fit graph, the residuals, and the used model, see Fit Tab
[} 1250].

Info Displays the defined name, any typed in comment, and some of the
meta data, see Info Tab [} 1256].

If you close an FCS document without saving, you will be asked in the Close image dialog, if you
want to save the data.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1245


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.5.1.2.1 Correlation Tab

1 2

Fig. 115: Correlation tab

1 Count rate diagram [} 1246]

2 Pulse distance histogram [} 1247]

3 Correlation diagram [} 1248]

4 Photon counting histogram (Pulse density histogram) [} 1249]

5 Result table [} 1249]

5 FCS view options [} 1257]

10.7.5.1.2.1.1 Count Rate Diagram

In the Count Rate diagram the count rate(s) (CR) in kHz is plotted vs. running time. If a cross
correlation set-up is used, the count rate trace for each channel is displayed.
Zoom into the diagram by pressing the left mouse button and drawing a rectangle of the area
you want to zoom in. After disengaging the button, the zoom image is displayed.
Clicking the right mouse button within the diagram opens the Count rate context menu.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1246


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Reset diagram Resets to the original image size when zoomed in.
zoom

New cut region When raw data files are available, define cut regions by choosing the
New cut region option. The cut region size can be adapted by two
sliders. The cut out region is thereby displayed as a matted box. Select
independent cut regions for different channels of a cross correlation
experiments. In cross-correlation calculations, a cut region in one
channel will automatically define the same cut region in the other
channel. You can select more cut regions by repeatedly choosing this
option. These regions may overlap.

Remove cut region Removes the last cut region. By repeatedly choosing this option, the
cut regions in the reverse order of their creation will be removed.

Remove all cut re- Removes all cut regions simultaneously.


gions
The remaining parts of the count rate disrupted by cut out regions will
be separately correlated and the average will be calculated and dis-
played.

Copy text to clip Copies the diagram coordinates into the clipboard, from which they
board can be pasted into other programs like Excel.

Write text to file Stores the diagram coordinates in a .txt file. You are prompted to
choose a name and a folder before saving.

Copy graphics to Generates an image of the graph with the legend text and color
clip board coded graphs which can copied to standard windows documents.

Abscissa logarith- Displays the abscissa in a logarithmic scaling.


mic

Ordinate logarith- Displays ordinate in a logarithmic scaling.


mic

Line width Allows to select the thickness of the graph. Six settings are possible.

Tab. 1: Correlation view - Count Rate context menu

10.7.5.1.2.1.2 Pulse Distance Histogram

This diagram shows the frequency plotted against the times elapsed between two subsequent
pulses (or: photons recorded from the detector). To obtain this histogram, the time distance be-
tween two photons is evaluated using the raw data.
Zoom into the diagram by pressing the left mouse button and drawing a rectangle of the area
you want to zoom in. After disengaging the button, the zoomed area of the graph is displayed.
Clicking the right mouse button opens the Pulse Distance Histogram context menu:

Parameter Description
Reset diagram Resets to the original image size when zoomed in.
zoom

Copy text to clip Copies the diagram coordinates into the clipboard, from which they
board can be pasted into other programs like Excel.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1247


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Write text to file Stores the diagram coordinates in a .txt file. You are prompted to
choose a name and a folder before saving.

Copy graphics to Generates an image of the graph with the legend text and color
clip board coded graphs which can copied to standard windows documents.

Abscissa logarith- Displays the abscissa in a logarithmic scaling.


mic

Ordinate logarith- Displays ordinate in a logarithmic scaling.


mic

Line width Allows to select the thickness of the graph. Six settings are possible.

Tab. 2: Correlation view - Pulse Distance Histogram context menu

10.7.5.1.2.1.3 Correlation G(τ) Diagram

The diagram shows the correlation functions for each activated channel.
Zoom into the diagram by pressing the left mouse button and drawing a rectangle of the area
you want to zoom in. After disengaging the button, the zoomed area of the graph is displayed.
Clicking the right mouse button within the diagram opens the Correlation context menu:

Parameter Description
Reset diagram Resets to the original image size when zoomed in.
zoom

Copy text to clip Copies the diagram coordinates into the clipboard, from which they
board can be pasted into other programs like Excel.

Write text to file Stores the diagram coordinates in a .txt file. You are prompted to
choose a name and a folder before saving.

Copy graphics to Generates an image of the graph with the legend text and color
clip board coded graphs which can copied to standard windows documents.

Abscissa logarith- Displays the abscissa in a logarithmic scaling.


mic

Ordinate logarith- Displays ordinate in a logarithmic scaling.


mic

Line width Allows to select the thickness of the graph. Six settings are possible.

Normalize Is used to normalize the selected G(0) value corresponding to the


number of diffusing particles to 2, not the total correlation to which
also other processes like triplet state can contribute.
All other values (subtracted by 1) will than be multiplied by the correc-
tion factor defined by the ratio of 1 to [G(0)-1] and increased by 1,
hence G (τ)normalized=[1/ (G(0)-1) * (G(τ)-1)]+1. Deactivating Normalize
will display the normal correlation curve.
Normalization only works for fitted data as only then a G(0) value is
available.

Tab. 3: Correlation view - Correlation context menu

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1248


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.5.1.2.1.4 Photon Counting Histogram

This diagram (also called Photon Counting Histogram) shows the frequency plotted against the
photon number in a certain time bin. To obtain this histogram, the number of pulses (or: photons
recorded from the detector) in a moving time window are recorded and included in a histogram.
Determine the binning when loading a *.fcs file with raw data saved along with it using the
Reload button.
Zoom into the diagram by clicking+holding the left mouse button and drawing a rectangle of the
area you want to zoom in. If the button is disengaged, the zoomed area of the graph is displayed.
Clicking the right mouse button opens the Photon Counting Histogram context menu:

Parameter Description
Reset diagram Resets to the original image size when zoomed in.
zoom

Copy text to clip Copies the diagram coordinates into the clipboard, from which they
board can be pasted into other programs like Excel.

Write text to file Stores the diagram coordinates in a .txt file. You are prompted to
choose a name and a folder before saving.

Copy graphics to Generates an image of the graph with the legend text and color
clip board coded graphs which can copied to standard windows documents.

Abscissa logarith- Displays the abscissa in a logarithmic scaling.


mic

Ordinate logarith- Displays ordinate in a logarithmic scaling.


mic

Line width Allows to select the thickness of the graph. Six settings are possible.

Tab. 4: Correlation view - Photon Counting histogram context menu

10.7.5.1.2.1.5 Result Table

The Result Table below the diagrams displays the measuring results. The width of the columns
can be changed by moving the border lines. The order of the columns can be changed. For this
purpose, click on the head line of the relevant column, hold down the mouse button and move
the column to the required position. When the mouse button is released, the column is inserted in
the new position. A scrollbar at the bottom of the table allows one to view all parameters that
might not fit within the width of the table. A scrollbar on the right allows access to all repetitions.

1. Select a line in the table by clicking on it with the mouse (multiple choice is possible by
pressing the Shift or Ctrl key additionally).
à Selected lines are highlighted in color and displayed in the legends of the diagrams.
à Corresponding graphs are shown color coded in the graphic displays.
2. Select lines and define properties of the table by pressing the right mouse button, when the
cursor is within the table.
à The Result Table context menu opens offering different options.

Parameter Description
Select all Selects all measurements (rows) in the table regardless which line is
highlighted.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1249


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Select all channels Selects all rows belonging to the same channel of a repetitive mea-
surement as the highlighted row.

Select all repeti- Selects all rows belonging to the same repetitive measurement as the
tions highlighted row.

Select all positions Selects all rows belonging to the same measurement position as the
highlighted row.

Select all kinetic Selects all rows belonging to the same kinetic time point as the high-
indices lighted row.

Delete Deletes the highlighted rows.

Cut Stores in the clipboard the highlighted rows. Only if the data are
pasted in a new window, the data are deleted from the old one.

Paste Pastes rows currently stored in the clipboard into the table.

Color Allows to select a color for the selected data sets.

Copy text to clip- Copies the table contents into the clipboard, from which they can be
board pasted into other text programs.

Write text to file Stores the diagram coordinates in a .txt file. You are prompted to
choose a name and a folder before saving.

Properties Opens the Table Properties window.

Tab. 5: Result Table context menu

10.7.5.1.2.2 Fit Tab

The Fit tab provides access to the tools which allow to work with newly generated or already ex-
isting data for data analysis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1250


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1 2

Fig. 116: FCS Document, Fit tab

1 Diagram area [} 1251]

2 Channel area [} 1252]

3 Result table [} 1256]

10.7.5.1.2.2.1 Diagrams

Depending on the chosen Fit model, the diagrams differ.


When fitting to a correlation model the upper graph shows the Correlation G(τ) Fit diagram
(correlation plotted versus the correlation time) with the overlaid fit graph. It also displays the fit
range defined by the red (start value) and the blue (end value) bars. The lower Fit deviation curve
depicts the fit residuals. If an experiment is loaded or data have just been acquired for which no
fit has been conducted yet, only the measured Correlation G(τ) curve is shown and no overlaid
fit curve. The Correlation-Fit deviation diagram is still empty.
For fitting to a PCH model the upper graph shows the Frequency diagram (frequency against
count rate per bin) with the overlaid fit graph. If an experiment is loaded for which no fit has been
conducted yet or data have just been acquired , only the measured curve is shown and no fit
curve. The Frequency-Fit diagram will be empty.
Zoom into the diagrams by pressing the left mouse button and drawing a rectangle of the area
you want to zoom in. If the button is disengaged, the zoomed area is displayed.
Clicking the right mouse button within the diagrams opens a context menu each for the Correla-
tion, the PCH fit diagram, and the Fit deviation diagram.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1251


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Reset diagram Resets any zoomed image
zoom

Copy text to clip Copies the diagram coordinates into the clipboard, from which they
board can be pasted into other programs like Excel

Write text to file Stores the diagram coordinates in a .txt file. You will be prompted to
choose a name and a folder before saving.

Copy graphics to Generates an image of the graph with the legend text and color
clip board coded graphs which can be copied to standard windows documents

Abscissa logarith- Displays the abscissa in a logarithmic scaling


mic

Ordinate logarith- Displays the ordinate in a logarithmic scaling


mic
When ordinate is set to a logarithmic scale all zero frequencies will be
displayed as vertical tabs, since the log0 goes to infinity low values.

Line width Allows to select the thickness of the graph. Six settings are possible.

View measured Displays the measured Correlation or PCH curve in addition to the Fit
data curve. If this option is not selected, only the Fit curve is displayed.

Normalize Is used to normalize the selected G(0) value corresponding to the


number of diffusing particles to 2, not the total correlation to which
also other processes like triplet state can contribute. All other values
(subtracted by 1) will than be multiplied by the correction factor de-
fined by the ratio of 1 to [G(τ)-1] and increased by 1, hence G (τ)normal-
ized=[1/ (G(τ)-1) * (G(τ)-1)]+1. Normalization only works for fitted data
as only then a G(0) value is available.
This option is only available for the Fit Correlation diagram.

Show fit range Displays the start and end values of the fitted data of the correlation
text curve defined by the red and blue bars. The positions of the bars can
be adjusted by drag and drop. Start Channel and End Channel deter-
mine which part of the correlation curve should be fitted to the
model. The start and end position of the channels are displayed as
correlation times (in µs).
This option and the bars are only available for the Fit Correlation dia-
gram.

Scaling Opens the Diagram scaling window . Enter the required percentage
value (from 1 to 100) for the scaling and click on OK to rescale, Can-
cel to keep the old value. The scaling of the G(t) axis is adjusted.
This option is only available for the Fit deviation diagrams.

Tab. 6: Diagram context menu

10.7.5.1.2.2.2 Channel Area

The Channel area within the Fit View tab shows the active channel (name and color), for which
the Fit and Fit All buttons apply. If more than one row is selected (shown in blue color in the re-
sult table) the active channel is the channel in the last selected row of one or multiple selected
channels.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1252


10 Systems & Components | 10.7 LSM 900/980 ZEISS

§ Fit applies to all selected rows of all channels.


§ Fit All applies only to the rows belonging to the active channel.
The Channel area provides the interface to define and save a Fit model. This interface can only be
accessed when either:

§ a continuous FCS acquisition has been started


§ an FCS experiment has been performed
§ a new FCS document has been opened and data have been dragged into this document.
1 2

4
5
6

7
8
9
Fig. 117: Fit tab, Channel area

1 Model drop down list

2 Define... button

3 Link edit box with drop down list

4 Upper Limit display box

5 Lower Limit display box

5 Type edit box with drop down list

6 Value edit box

7 Parameters list

8 Fit action buttons [} 1255]

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1253


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Model Drop down list contains all previously defined and stored fit models.
Selecting a model by clicking onto the name in the list loads the
model and displays a set of parameters which can be individually
adapted when applying the fit model to the data set(s). The parame-
ters are updated once the fit model is applied to the data.

Define Click to define a new Fit model. For a detailed description of the avail-
able parameters, see Define Model Dialog [} 1262].

Link Links the parameter globally. Type the required letters, separated by
comma.
§ M: links the parameter over different measurements
§ K: links the parameter over kinetic indices with the same time
points
§ P: links the parameter over positions obtained from measurements
at the same site
§ R: links all repetitions of one measurement
§ C: links the parameter for the same channel

Alternatively, select the link(s) from the drop down list opened when
clicking onto the drop down arrow.
If a linkage is activated that does not apply for a measurement, it is
disregarded. Otherwise the same rules are in place as for Fit and Fit
all in terms of to which data rows the links apply.

Upper Limit Defines the upper limit value tolerated from a fit; if this value is ex-
ceeded, the fit is rejected and another (global) maximum is searched
for. The default value depends on the parameter.
The Upper Limit parameter value is only accessable if the Show Lim-
its... option is selected within the interactive selection list opened
with a right mouse click into the parameter panel.

Lower Limit Defines the lower limit value as a fit parameter; if this value falls short,
the fit is rejected and another (global) minimum is searched for.
Change the value by editing the default value in the edit box. The de-
fault value depends on the parameter, but is in most cases 0.
The Lower Limit parameter value is only accessable if the Show
Limits... option is selected within the interactive selection list opened
with a right mouse click into the parameter panel.

Type Displays whether a parameter is free floating, if its value is fixed or


whether it should be used as a start value. Choose between the op-
tions in the drop down menu by selecting Free, Start or Fixed, re-
spectively.
§ When Free is selected, the parameter will be defined as free. After
the fit, the field will contain the fit result for the parameter. The
start values of the parameter (initial guesses) will be calculated by
an algorithm.
For user defined models the option free is not available as a set-
ting for the parameter Type.
§ Fix sets a fixed parameter which is useful if the value is known
from other measurements.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1254


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
§ Start assigns a start value to the parameter and leaves the parame-
ter free to fit. In this case, no initial guesses will be made.

Value Displays the currently assigned value of the parameter. Change the
value by editing the default value in the edit box..

Parameter Displays the parameter's name. Activate or deactivate the parameter


by ticking/de-ticking the check box. Only if a parameter is active it will
be taken into account for fitting the data.

§ The parameter settings are not stored with the experiment or the fit model. They need to be
defined anew for each fit procedure.
§ A text in the state display panel warns in yellow writing on any constraints or errors of the de-
fined fit model and suggests suitable changes. For example, whenever some inconsistencies
are present, e.g having two parameters free that depend on each other, like the geometric
factor and the number of molecules, the system gives a warning about the mistake.

Info
Generally, it is accepted that non-linear fitting procedures yield more reliable results when the
number of free floating parameters is low. It is recommended to fix parameters which are
known from independent measurements. Good candidates for fixing are diffusion times of the
free dye and the free (i.e. not bound) partner, which can be determined in previous measure-
ments. Another good candidate is the structural parameter that is an instrumental parameter.

The quality of the fit is displayed in the chi2 display box of the Fit table. The χ2 (chi2) value should
approach zero for highest quality. The range of the data to be used for fitting can be defined by
re-positioning the red and blue bar originally set at the beginning and end of the correlation dia-
gram to the required start and end range positions. For the then next Fit procedure then new
range is applied.
Lower and upper limits are only displayed if selected. To select, click with the right mouse button
into the result table to open the context menu.

10.7.5.1.2.2.2.1 Fit Action Buttons

Parameter Description
Fit Performs a fit for all highlighted measurements (rows) according to
the loaded model. When the fit is completed, the free parameters are
replaced with the new fitting results and the fit graph and result table
are updated.

Fit all Performs a fit for all measurements (rows) that have the same channel
as the one displayed in the Channel display field (active channel). All
other channels are ignored. Changing to a row with a different chan-
nel loads the last assigned model for that row.

Undo Cancels a previous command. Repeatedly pressing will cancel com-


mands in the reverse of their execution.

Redo Re-executes a previously undone command and hence will become


only active, if an action was performed. Repeatedly pressing will re-
execute previous undone commands in the order of their previous ex-
ecution.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1255


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
To Method This function is not supported.

10.7.5.1.2.2.3 Result Table

The data result table in the Fit view displays the values of the fitted parameters. It is updated
when clicking the Fit button in the Model panel. Measuring rows in the Result table can be acti-
vated/deactivated by checking/unchecking the corresponding check boxes. Deactivation of these
check boxes will not exclude the relevant rows from all subsequent evaluation procedures, but
only from the average. Average curves are updated in respect to the rows taken into considera-
tion.

10.7.5.1.2.3 Info Tab

Info
The complete experiment settings, including all multidimensional acquisition settings, are
stored with the experiment when it is saved.

Fig. 118: Info tab

1 Name display box


The name of the experiment is updated whenever the experiment is saved under a de-
fined name. It cannot be edited otherwise.

2 Comment edit box


Write down any relevant information about the experiment you would like to keep with
the data.

3 Acquisition display box

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1256


10 Systems & Components | 10.7 LSM 900/980 ZEISS

The panel shows apart from the acquisition date and the pinhole size only information
about the single measurement parameters.

See also
2 Fit Action Buttons [} 1255]

10.7.5.1.2.4 FCS Document View Options

10.7.5.1.2.4.1 Correlation Tab

The Correlation action tab lists all correlation channels with their assigned channel color includ-
ing cross correlation channels.

Fig. 119: FCS Document, Correlation action tab

1 Channels dropdown menu


Displays the list of active channels and allows to change the color when clicking on the
arrow. Changes are immediately effective.

2 Diagrams
Choose the diagrams to be displayed by activating the corresponding buttons. Selected
diagrams will be highlighted in blue. By clicking on the appropriate button, the diagram
can be toggled between ON and OFF.

3 Reload ... button


Opens the Reload tool (see Reload Tool [} 1258]).

10.7.5.1.2.4.2 Table Tab

The Table action tab provides several options to sort and display the data.
1

Fig. 120: FCS document, Table action tab

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1257


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1 Order drop down list


Determine, how different measurements are grouped together. The hierarchy of group-
ing of categories is determined by their listed sequence.

2 Show standard deviation checkbox


If activated, all parameters are displayed with their values and their calculated standard
deviation from the different measurements. Only then the displayed average correlation
function can be meaningfully fitted.

3 Average drop down list with correlation measurements


In the drop down selection choose how to average the data.
§ When Fit results is selected, the single values of the parameters are averaged.
§ Selecting Correlation averages single data points of each correlation function and an
average correlation function is calculated.
Check, which measurements (Repetition, Kinetics, Positions, Correlation) should be
used to built the average by activating the corresponding checkboxes.

4 Parameters list
Only parameters set active are visible in the table. The order of the displayed parameters
can be adjusted using drag and drop in the table itself. Deactivation of these check boxes
excludes the relevant rows from all subsequent evaluation procedures like averaging.
These settings will be stored when saving the data. Immediate reactivation is possible
when activating the check box. The scroll bar allows viewing all content of the display
box.

10.7.5.1.2.4.3 Reload Tool

Whenever a *.FCS file is opened and raw FCS data (*.RAW files) have been saved during acquisi-
tion along with the *.FCS file, the Reload ... button is available in the Correlation tab in the FCS
document view.
The tool allows to redefine several parameters for

§ Correlation [} 1258]
§ Count rate [} 1260]
§ PCH (Photon Counting Histogram) [} 1260]
§ Electronic dust filter [} 1261]
The panel opens with the default settings which are applied for the original data acquisition.

10.7.5.1.2.4.3.1 Correlation

The Correlation tab allows to specify how the raw data will be processed for correlation analysis.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1258


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1
2
3
4

Fig. 121: Reload tool, Correlation tab

1 Binning time edit box


Determines the minimal binning time used in the correlation analysis and also the start
correlation time, which will be identical to minimal binning time. Chose whether to di-
rectly enter values or use the scroll arrows. Can be reset to the default value by clicking
the 0.2 button.

2 Maximum correlation time edit box


Defines the end correlation time. It cannot exceed the measurement time. Hence, the
value will only be used if equal to or smaller than 2/3 of the measurement time, else the
measurement time will be used automatically. Chose whether to directly enter values or
use the scroll arrows. Can be reset to the default value by clicking the 1000 button.

3 Tau Channels edit box


Defines the number of linear increased Tau channels per multiple Tau step. Chose
whether to directly enter values or use the scroll arrows. Can be reset to the default
value by clicking the 8 button.

4 Default button
Resets all parameters to the default values. Please note that with the default settings, the
algorithm works the fastest.

The algorithm for auto-correlation functions is as follows:


In the first correlation step all events within a certain correlation interval T are counted.
The default T in the first correlation step (n=0) equals 200 ns, which is 4x the maximum sampling
rate of 50 ns, as limited by the dead time of the detectors and the electronics. T will be changed
by the entry in the Binning display window. This corresponds to a clock speed of 20 MHz.
Thus, for this correlation interval a maximum of 4 events can be counted. These events/correlation
intervals are shifted against themselves for a time interval t. The first t equals the first T value, as a
default 200 ns = 0.2 ms. t will be changed by the entry in the Binning display window.
T is linearly increased by step sizes of 200 ns (or the entered value) for 8 times (direct tau) and
than for another 8 times (multiple Tau), i.e. the maximum correlation time in the first step is 16 x
0.2 ms = 3.2 ms using the default settings. The direct and shifted events/correlation intervals are
multiplied interval for interval and the products are added together and normalized.
The normalization result is defined as: (result x received clocks)/(pulse2) for auto-correlation or (re-
sult x received clocks)/(pulseA x pulseB) for cross-correlation. The received clocks counted equal 4x
the number of correlation intervals, which are defined by the measurement time. At the end the
relevant data for the next correlation step are processed. Here, the correlation interval is increased
by a factor of 2. Hence, the correlation interval (T) in the n-th correlation step is T = 0.2 ms x 2n
for the default settings. The initial lag time for a certain correlation step corresponds to the last
lag time of the previous correlation step added to the respective correlation interval. This value is

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1259


10 Systems & Components | 10.7 LSM 900/980 ZEISS

then linearly increased 8 times.


Therefore after step n, the correlation or lag time (t) ultimately corresponds to t = 6 x 0.20 + 8 x
0.2 x 2n ms. The doubling of the correlation interval is performed on default 25 times. Thus the
maximum is: t = 16 x 0.2 + 8 x 0.2 x 225 ms.

10.7.5.1.2.4.3.2 Count rate

The Count rate tab allows to specify the binning time used for the count rate trace.

Fig. 122: Reload tool, Count rate tab

1 Automatic checkbox
Activates dynamic binning.

2 Binning time edit box


Determines the constant binning time used in the count rate analysis. Chose whether to
directly enter values or use the scroll arrows. Can be reset to the default value by clicking
the 1 button.

3 Default button
Resets all parameters to the default values. Please note that with the default settings, the
algorithm works the fastest.

When Automatic is active, the system averages three data points and rebinds the data in depen-
dence of the measurement time. The diagram will have a mean with fluctuations above and be-
low the mean.
In constant binning, data points are not averaged. This will result in a baseline with fluctuations
above.
In (automatic) dynamic binning the count rate trace will be adjusted to the measurement length.
The count rate trace represents the averaged binned count rate versus measurement time, in
other words photons/second therefore intensity.
The bin window in dynamic binning now depends on the measurement time, whereby the bin
window doubles, if 500 values are exceeded.
In the first step, the binning time is 3.2 ms. For the next steps, the binning time (tr) becomes tr =
3.2 ms x 2n. The measurement time (td), at which the binning time doubles is calculated according
to td = 3.2 ms x 500 x 2n.

10.7.5.1.2.4.3.3 PCH

The PCH allows to specify the binning time used for the photon counting histogram.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1260


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Fig. 123: Reload tool, PCH tab

1 Automatic checkbox
Activates dynamic binning.
When Automatic is active, 32 different binning times will be used.

2 Binning time edit box


Determines the constant binning time used for the PCH. Chose whether to directly enter
values or use the scroll arrows. Can be reset to the default value by clicking the 10 but-
ton.

3 Default button
Resets all parameters to the default values. Please note that with the default settings, the
algorithm works the fastest.

Info
In automatic binning mode, binning starts with a value of 50ns, which is doubled 32 times. So
binning times are 50 x 2n, with n=1 to 32. The histogram with the best dynamic range (three
standard deviations) will be selected and displayed.

10.7.5.1.2.4.3.4 Dust Filter

The Dust filter tab allows to activate an electronic dust filter. Define a threshold in the Count
rate intensity that, if exceeded, will lead to a removal of the corresponding count rate region
from the correlation analysis.

1
2

Fig. 124: Reload tool, Dust filter tab

1 Dust filter checkbox


Activates the dust filter function.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1261


10 Systems & Components | 10.7 LSM 900/980 ZEISS

2 Deviation to erase peak in count rate edit box.


Determines the Threshold in %. Chose whether to directly enter values or use the scroll
arrows. Can be reset to the default value by clicking the 10 button.
All measurement points within a binned count rate time window having a deviation of
more than the specified value from the average count rate will be cut out and not used
for the correlation analysis.

3 Default button
Deactivates Dust filter and resets the values to default.

Note that the cut off count rate is defined as a value exceeding the average count rate during a
certain measurement period (bin window) by a certain percentage. Thus, the consecutive fast suc-
cession of low peaks might accumulate the same count rate as one high peak within a certain pe-
riod of time and hence, the cut off is not defined by the peak height but rather by the counts per
binning time.
If the integrated count rate over a certain count interval exceeds the average count rate by that
threshold, this special interval is discarded for correlation analysis. For example, if the system de-
tects a count rate in a certain time interval that exceeds the average count rate by over 30% and
the threshold was set to 30, this interval will be discarded for correlation analysis. The time inter-
vals before and after the discarded region are separately correlated and the results averaged. This
holds also true, if more than one region is discarded. In this case all the single regions that are
separated by cut out regions are separately correlated and the resulting average is displayed.
Note, that calculation of an average will be performed at the beginning of the measurement. If
peak count rates will come at the beginning, this kind of dust filter does not work. Also, due to
the necessity to average signals over a certain integration time, more than only the peak area will
be discarded. Another outcome of the necessity to average the count rate signal is that several
small peaks following close to each other will be treated as a huge peak and might be cut out.
This means, in the Automatic cut mode accumulated count rates rather than peaks are removed.
For cross-correlation experiments, any of the regions discarded in either autocorrelation function
will not be used. Cut off regions are framed by stippled boxes and appear matted in the Count
Rate window.

10.7.5.1.2.5 Define Model Dialog

Parameter Description
Correlation Create a correlation model from predefined equations, which will be
fitted analytically, see Generating a Correlation Model.

PCH Create a photon counting histogram model, which will be fitted nu-
merically, see PCH Tab [} 1263].

Formula Create a user defined model equation, which can be fitted analyti-
cally, see Formula Tab [} 1264].

10.7.5.1.2.5.1 Correlation Tab

This tab show the options for assembling a correlation model. Correlation allows assembling a
model with predefined terms.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1262


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Fig. 125: Define Model dialog, Correlation tab

1 Settings ... button


Opens a submenu for the respective term, see Terms and Term Settings [} 1276].

2 Terms list
Shows selected terms of the currently active model. The assembled equation is displayed
in the G(τ)=1 display area.
A new model can be defined by activating the requested equation terms and defining
the corresponding settings for each term.

10.7.5.1.2.5.2 PCH Tab

The PCH tab within the Define Model tool is used to determine concentrations and the molecu-
lar brightness of molecules.
PCH can be fitted only one-dimensional. If a cross-correlation measurement is activated, the PCH
model is automatically replaced by a correlation model.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1263


10 Systems & Components | 10.7 LSM 900/980 ZEISS

1
2

Fig. 126: Define Model dialog, PCH tab

1 Background
§ Type in a value if known.
§ Keep the value to zero, if no background is expected.
§ The background is no fit parameter.

2 Components
Select numbers of components (1, 2 and 3) by clicking the Components 1, 2 or 3 but-
tons. The number of active components will be highlighted in blue.

3 Specific brightness
Type in a brightness value (Hz) specific for the chosen number of components beneath
the Components button activated. If you do not know the brightness, keep the value at
1.

4 Instrumental parameters
Type in values in the respective first order, second order and third order edit boxes.
These values have to be determined in independent calibration experiments using a de-
fined dye solution with a known brightness. The parameters correct for the deviation of
the confocal volume from a true Gaussian distribution. Normally, only a correction for
the first order parameter is necessary and recommended. Hence, in the calibration fit
keep the first order parameter free and the second and third parameters fixed to zero.
Enter the determined first order number and save it with the model for later measure-
ments.

10.7.5.1.2.5.3 Formula Tab

The Formula tab allows to define own fit equations.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1264


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Fig. 127: Define Model dialog, Formula tab

1 Formula edit box


Displays the entered formula.

2 Keyboard
Used to type the required formula.

3 Clear Formula button


Finishes the variable definition process.

4 Return button
Deletes the entered formula.

5 Description panel
Displays any expected operation and syntax errors.

Note that:

§ All variables defined at the beginning are considered fixed variables, all other variables are
considered fit parameters.
§ Each defined variable must have an assigned number. This number will substitute for the vari-
able in the equation.
§ Always start a formula with G as the dependent variable in the form of G(x)=, x being any ara-
bic letter.
§ The independent variable x is considered to have the SI unit [s] and the same holds true for
any dependent parameter to it.
§ If there are no syntax errors, parameters and operations will be indicated.

10.7.5.1.2.5.4 Model Equations

The acquired correlation functions must be fitted to models in order to retrieve meaningful re-
sults. It depends on the biochemical process, which model is the most appropriate. If the underly-
ing process is known, the model can be selected prior to the start of the experiment. For example,
if diffusion in a membrane is the subject, a 2-D diffusion model should be applied. In other cases,
the process is not known, for example for free or anomalous diffusion. In this case, one can

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1265


10 Systems & Components | 10.7 LSM 900/980 ZEISS

screen different potential models and look for the best fit taken into account the χ2 value. Often
two models work nearly equally well, for example, a two component free diffusion model can
give you as satisfactorily a fit as a one component anomalous diffusion model, and without prior
knowledge about the system it will be impossible to decide, which is the better one. In principle,
models can be excluded if the fit does not work. However, a working model is only a potential
candidate but does not signify it to be the correct one. Care should be taken to minimize the free
parameters as much a possible to improve on the fit quality. It is not advisable to fit to three com-
ponents without fixing the parameters of at least one of them. For example, if the diffusion time
of a free ligand can be determined in a pre-experiment, that value should be fixed to reduce the
number of floating parameters for the evaluation of the binding experiment to its receptor.
The FCS software is designed to be flexible. That means that the user can define or assemble
equations which are useless. Care should be taken and formulas should be compared to the ones
known from literature to obtain meaningful results. Also, the presence of a model does not neces-
sarily mean, that the quality of the recorded data allows its usage. For example, anti-bunching re-
quires a lot of care in data acquisition like long measurement times and cross-correlation to re-
duce dead times of the detectors and elimination of after-pulsing artefacts. It is in the responsibil-
ity of the user to set up his or her experiments accordingly.

The correlation function

Definition of the auto-correlation function

or

where denotes the time average and describes the fluctuations around
the mean intensity.
For long time average of 1 (no bleaching) the following relation exists:

Definition of the cross-correlation function


The formalism for the cross-correlation function is identical to the auto-correlation function, with
the exception that the signal in one channel is not compared to itself, but to a signal in a second
channel. Lets assign the indices "r" and "b" for the red and blue channel, respectively, than the
cross-correlation function would read as follows:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1266


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Note that the software for FCS calculated GI functions, which do therefore converge to 1 and not
0. The acquired correlation functions are than compared to model equations.

Available model equations


In the following available equations used for the fits are given that define the accessible parame-
ters. For some equations useful conversions to other parameters are listed as well. The total corre-
lation is given by equation 2:

where d is the offset, B the background correction, A the amplitude and Gk,l(τ) the correlation for
a single process. The suffixes k and l signify correlation terms for dependent and independent pro-
cesses, respectively, that are multiplied with or added to each other.
The total correlation is therefore the amplitude multiplied to the product of the single correlation
terms that are dependent and hence convolute each other. This amplitude has to be corrected for
background and any offset. In cases, when the processes are independent from each other, the
single correlations terms add up, for example in cases where there is more than one component
all bearing the same label or of bunching terms that are independent from each other. If indepen-
dent and dependent processes are present, all independent terms will add up and are multiplied
with the dependent terms.
One can distinguish between different classes of fluctuation processes: anti-bunching, bunching
and diffusion.

10.7.5.1.2.5.4.1 Amplitudes

The amplitude of the correlation function is influenced by the offset, background and the number
of particles in dependence of the geometric factor. The amplitude is also influenced by the
process of correlation.

The "1"
In a normal correlation, the curve converges to 1, in case intensities I are correlated as is the case
with the FCS software. Note that in other cases, if fluctuations Iδ are correlated, the correlation
function converges to 0, if no bleaching occurs.

You can therefore easily convert GI(τ) to GδI(t) values by adding a fixed offset of –1.

Offset d

c is any rational number that can be negative or positive.


In the FCS software the offset can be a fit parameter or a fixed value. In some cases, especially if
very slow or immobile components are present, there can be a positive offset from 1. This offset
can be taken into account by fitting to d. On the other hand, if the offset is known, it can be
fixed. The offset will be added to each correlation value.

Background B

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1267


10 Systems & Components | 10.7 LSM 900/980 ZEISS

where Ib is the background intensity and It is the total intensity.


The FCS software treats the background always as a fixed value and never as a fit parameter. Thus
the user has to define the background.
Note that the background in this case refers to a non-correlating background. If there is no back-
ground intensity, B = 1, otherwise B < 1. The background can be determined by measuring an un-
labeled solution or cell at the same settings than the real experiment and recording the count rate
Ib. The real experiment with the labeled species will give It. A non-correlating background will re-
sult in a lower amplitude and hence overestimation of molecule numbers, if not corrected for.
Note the squared correction term.

Amplitude A

where γ is the geometric factor accounting for the point spread function (PSF) and N the mean
number of particles.
In the FCS software γ can be a fit or a predefined fixed value. In case γ is a fit value N must be
fixed in the fit procedure. N is normally a fit parameter.
Please note that γ takes different values for different fitting models depending on the assumed in-
tensity distribution of the point spread function (PSF):
γC=1.000 (cylindrical)
γ2DG=0.500 (2-D Gaussian)
γ3DG=0.350 (3-D Gaussian)
γGL=0.076 (Gaussian-Lorentzian).
γ can also be calibrated, if a known concentration c of a dye is measured. In this case N can be
fixed and γ fitted. The obtained number can be entered as the calibrated fixed number. N can be
calculated from equation

with V being the confocal volume and LA = 6.023 x 1023 mol-1 the Avogadro number.
The volume V is calculated from equation

with ωz axial focus radius and ωr the lateral focus radius. The radii themselves have to be deter-
mined by a calibration measurement using a dye with a high quantum yield and a known diffu-
sion coefficient D from the fitted diffusion time τd and the structural parameter S employing a free
diffusion model with triplet state.
The following relations exist:

for 1 photon excitation

for 2 photon excitation

Equations 5e or 5f, dependent on the excitation source, can be used to retrieve ωr; with its knowl-
edge ωz can be calculated from equation 5g.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1268


10 Systems & Components | 10.7 LSM 900/980 ZEISS

"N" can have different meanings in different fit models. For biology, normally the number of dif-
fusing particles is of interest. In this case, if photo-physical processes (triplet, blinking, stretched
exponentials) are involved, it is recommended to use their normalized forms, since then the num-
ber of molecules correspond directly to the number of diffusing particles. If photo-physical terms
are not normalized, the number measured is the total number of diffusing particles and those un-
dergoing photo-physical processes.

10.7.5.1.2.5.4.2 Anti-Bunching Terms

Anti-bunching is the phenomenon that a molecule cannot produce emitted photons as long as it
stays in the excited state. Hence during the transition time required to drop back to the ground
state, which corresponds in most of the cases to the lifetime if no other photo-physical processes
are involved, no photon can be expected, which results in anti-correlation and hence a drop of
the correlation function below 1.

Independent to other terms

where C is the amplitude and τa the transition time, also referred to as the lifetime.

Dependent in combination with other terms

where C is either a fit parameter or a fixed value and often takes the value 9/5.
There are two cases to be distinguished: First, if the anti-bunching is independent with other pro-
cesses, than equations 6a and 6b in the non-normalized or normalized form must be used and the
terms are multiplied with other correlation terms. In case the anti-bunching is treated dependent
to other processes, than equation 6c is the correct one to use and the term is added to other cor-
relation terms.

Stretched exponential – anti-bunching


This is a more general term adding frequency and stretched factors to the exponent.

not normalized

normalized
where K1 is the fraction of molecule, and τk1 the exponential decay time, k1 the frequency factor
and κ1 the stretch factor.
K1 and τk1 are fit parameters; k1 is a fixed parameter and must be user defined; κ1 is either a fit pa-
rameter or can be fixed.
Note, fixing k1 and κ1 to "1" results in a simple anti-bunching term.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1269


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Double stretched exponential – anti-bunching


This is a double exponential function, where the exponentials are subtracted.

not normalized

normalized
where K1 and K2 are the fractions of molecules, and τk1 and τk2 the exponential decay times, k1
and k2 the frequency factors and κ1 and κ2 the stretch factors.
K1, K2, τk1 and τk2are fit parameters, k1 and k2are fixed parameters and must be user defined, κ1
and κ2are fit parameters or can be fixed.

10.7.5.1.2.5.4.3 Bunching Terms

Bunching is the phenomenon of a burst of photons during a certain time interval, the duration of
which is determined by photo-physical processes including triplet, blinking, flickering and proto-
nation. These terms are exponential decay functions. Formally, they look the same, only the expo-
nential decay might be different.

Triplet

not normalized

normalized
where Tt is the triplet fraction, that is the number of molecules undergoing triplet states and τt the
triplet decay time.
Tt and τt are fitted parameters.
Triplet is based on an un-allowed intersystem crossing from the excited to the so-called triplet
state. This state lasts for 1 – 5 µs. If the electron drops back to the ground state, no photon is
emitted and hence during the triplet state the molecule is in a dark state. Triplet is indicated as a
rise in the correlation amplitude, which is indicated as a deviation from the flattening curve at
shorter correlation times. If not normalized, the triplet fraction contributes to the total number of
molecules.

Blinking

not normalized

normalized
where Tb is the blinking fraction, that is the number of molecules in the dimmer state and τb the
blinking decay time of the dimmer state. Note, if the blinking term is not normalized, the number
of blinking molecules will influence the total number of molecules.
Tb and τb are fitted parameters.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1270


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Blinking is based on the phenomenon that the electron distribution over conjugated systems can
change in dependence on the local environment, for example changes in the pH, which will lead
to molecules in a bright and dim or dark state. It is therefore a kinetic process that can be de-
scribed in the following way with the following relations:

with the constraint


with B and D representing the brighter and darker states, kF and kR the forward and backward re-
action rates and ηB and ηD the emission yields or molecular brightness of molecule species (D or B)
in Hz or the relative dimensionless brightness. In case, where darker state is completely dark
(ηD=0), equation 7h simplifies to

Note that Blinking is referred to a process that does not lead to a covalent modification in the
chemical bonds. If covalent changes occur the process is referred to as Flickering, which is for-
mally treated in the same way.

Dependent triplet and blinking


In this case the terms are just representatives for two dependent bunching terms that are linked
by addition (double exponential term). Note that the triplet fraction, if present, could be poten-
tially fitted to either of the terms.

not normalized

normalized
where T1 and T2 are the fractions of molecules in the triplet state, and τt1 and τt2 the triplet expo-
nential decay times.
T1, T2, τt1 and τt2are all fitted parameters.

Independent triplet and blinking


In this case the terms are just representatives for two dependent bunching terms that are linked
by multiplication. Note that the triplet fraction, if present, could be fitted to either of the terms.

not normalized

normalized
where T1 and T2 are the fractions of molecules in the triplet state, and τt1 and τt2 the triplet expo-
nential decay times.
T1, T2, τt1 and τt2are all fitted parameters.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1271


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Stretched exponential - bunching


In some reactions the kinetics cannot be fitted to simple exponential functions but require
stretched exponentials.

not normalized

normalized
where K1 is the fraction of molecule, and τk1 the exponential decay time, k1 the frequency factor
and κ1 the stretch factor.
K1 and τk1 are fit parameters, k1 is a fixed parameter and must be user defined, κ1 is either a fit pa-
rameter or can be fixed.
Note, fixing k1 and κ1 to "1" result s in a simple bunching term.

Double stretched exponential - bunching


This is a double exponential function, where the exponentials are added.

not normalized

normalized
where K1 and K2 are the fractions of molecules, and τk1 and τk2 the exponential decay times, k1
and k2 the frequency factors and κ1 and κ2 the stretch factors.
K1, K2, τk1 and τk2 are fit parameters, k1 and k2 are fixed parameters, κ1 and κ2 are fit parameters or
can be fixed.
This term is often required to fit protonation, with the second stretch factor and the frequency
factors are set to "1".

10.7.5.1.2.5.4.4 Diffusion Terms

Diffusion is driven by Brownian motion. We can distinguish translational, rotational and flow dif-
fusion.

Rotational diffusion
In the most general form, rotation can be described as the sum of 5 exponential terms

where Ra is the amplitude, cm the relative amplitude, rm the frequency factor and τr,m the rotational
diffusion time.
However, there are special cases that are of more use. In symmetric rotation, the general formula
reduces to:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1272


10 Systems & Components | 10.7 LSM 900/980 ZEISS

not normalized

normalized
where Ra is the rotational amplitude and τr the rotational diffusion time.
Ra and τrare fit parameters.
If rotation occurs dependent from other processes, the formula used as an additive term is de-
fined as:

Ra is either a fit parameter or a fixed value and often takes the value 4/5.
In case of asymmetric rotation, the term is as follows:

not normalized

normalized
where Ra is the amplitude, c1 and c2 are relative amplitudes, r1 and r2 frequency factors, τr,1 and
τr,1 rotational diffusion times.
Ra, τr,1 and τr,1 are fitted parameters, c1, c2, r1 and r2 are fixed values and must be user defined.
Rotational frequencies often take the following values:

r1 1
r2 10/3
The relative amplitudes dependent on the polarization of the excitation light and the analyzer in
the emission beam path and are as follows:

Ex lin. pol. lin. pol. lin. pol. unpol. unpol. unpol.

Em parallel perpen- all parallel perpen- all


dicular dicular

c1 80 20/9 860/9 5/9 215/9 20

c2 64/9 4 4 16/9 1 1

Translational diffusion
In its general form, translational diffusion is defined as:

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1273


10 Systems & Components | 10.7 LSM 900/980 ZEISS

with
the constraint
where τd,i is the diffusional correlation time of molecule species i, S the structural parameter that is
the ratio of axial to lateral focus radii, αi the anomaly parameter or temporal component of mole-
cule species I, ed1and ed2 are fixed values and have to be user defined. The following values define
1-, 2-and 3-D diffusion:

ed1 ed2 dimensionality


1/2 0 1-D

1 0 2-D

1 1 3-D

Note that in the FCS software these values are automatically selected with the choice of dimen-
sionality.
S is either a fit parameter or a fixed value. It is an instrumental parameter and can be determined
by a calibration experiment using a dye solution with a known diffusion as a fit result.
αi is either a fitted value for anomalous diffusion or a fixed value (set to "1") for free diffusion. The
following relation exists:

α Diffusion process
=1 Free diffusion

<1 Anomalous sub-diffusion

>1 Anomalous super-diffusion

Note that αi is set automatically to "1", if free diffusion is selected. If anomalous diffusion is se-
lected, the parameter will float.
τd,i are fitted parameters. They can be converted to diffusion coefficients Di using formulas 5e or
5f. The FCS software allows you to directly fit to Di values, but in this case the lateral radius ωr has
to be specified as a fixed value.
Please note that in the case of anomalous diffusion the following relations exist:

where Γ is the transport coefficient of the fractional time dimension.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1274


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Please note the following relation between D and G:

If activating the fitting to the diffusion coefficient the Γ values have to be calculated from the D
values by the following conversion:

The Φi values are fit parameters. They account for different brightness of different components. In
principle, if molecules of different brightness are present, the apparent molecular brightness is de-
fined as

where ηiis the brightness of the molecules in kHz or the dimensionless relative brightness values.
The brightness of the species has to be determined beforehand in control experiments.
Note that the brightness contributes as the square to the correlation function, in other words a
double as bright molecule will contribute 4 fold more. Therefore, the fitted number of molecules
must be corrected to obtain the real number Ndiff of diffusing particles; please note that to obtain
the diffusing particle number directly, other terms should be used in their normalized form:

If one wants to know the true fraction fi of each species, values those can be retrieved with the
known brightness from the relation

with the constraints and


If there is no brightness difference between the components, Φi will become fi.
You can fit directly to the fractions even in case of different brightness values. In this case, the
brightness values have to be fixed parameters and defined by the user. The fit formula converts
from equation 5a in combination with 8g taking into account the corrected amplitude to equation
8o:

with fixed brightness values ηi.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1275


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Flow
Flow signifies active transport either via cytoplasmic movement or directed transport.
If flow occurs in the absence of translational diffusion, the term is defined as follows:

In the presence of translational diffusion, the term alters to:

with τf representing the average residence time for flow and τd the diffusion correlation time.
Note, in the FCS software, the correct term is automatically loaded in dependence on the absence
or presence of a translational term.
With the knowledge of the lateral radius ωr given as a fixed value, the software allows to fit di-
rectly to the velocity v instead of the average residence time. The following relation exists:

10.7.5.1.2.5.5 Terms and Term Settings

Terms
Start the definition of a model by activating the checkbox of the term you want to include into
the final correlation equation. Deactivate the checkbox to remove the term from the final equa-
tion. All activated terms are assembled into the final equation that is displayed in G(τ)= display
area.
Choose from:

Term Description
Offset d Deviation from 1

Background B Unspecific non-correlating background

Amplitude A Number of molecules and geometric factor

Antibunching G a(τ) Antibunching correlation term

Triplet G t(τ) Exponential correlation terms for triplet state, blinking, flickering or
other bunching correlation terms

Rotation G r(τ) Rotational diffusion correlation term

Translation Gd(τ) Translational diffusion correlation term

Flow Gf(τ) Flow correlation term

Stretched exponen- Stretched exponential correlation term for kinetics


tial Ge(τ)

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1276


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Settings
For a selected term the Settings button becomes available. The Settings panel allows you to
choose specific equations and assign values to parameters, if applicable. The Settings Descrip-
tion box provides information on the parameter or displays the formula of the equation. In addi-
tion it provides useful conversions of the fitted parameter to other interesting parameters. For
more information the used formula see Model Equations [} 1265].
The following settings are available:

Term Settings
Offset d § Set the offset to 0 by clicking the Normalized button.
§ Define the offset by clicking the Calibrated button
Type in a value into the edit box or set a value using the scroll ar-
rows.
§ The offset can have positive or negative numbers and the value
specified will be added to all correlation values.
§ The description panel provides information on the offset.

Background B § Set an offset by typing in value in the Background selection box.


or use the scroll arrows.
§ If there is no background selected, the background correction fac-
tor is set to 1.

Amplitude A § Set a value for the geometric factor γ, which describes the point-
spread function.
§ By clicking the cylindrical, 2DG, 3DG and GL buttons a cylindrical,
2 dimensional Gaussian, 3 dimensional Gaussian (3DG) and Gauss-
ian-Lorentzian (GL) PSF can be set, respectively.
§ click the Calibrated button to type in a user defined number into
the edit box or use the scroll arrows to set a value.
§ The description panel provides information on the amplitude.
§ At least one the γ factor or the number of molecules N have to be
fixed in the fit procedure.

Antibunching G a(τ) § Choose between normalized and non-normalized anti-bunching


term by activating/deactivating Normalized.
§ Select the Dependent antibunching, rotation and translation
form by checking the respective box. This equation is used as an
additive term to rotational and translational diffusion terms.
§ Leave the amplitude value free to float or to set the value to 9/5 by
clicking the Free or 9/5 buttons, respectively. The active selection
will be highlighted in blue.
§ The description panel provides information on the anti-bunching.

Triplet G t(τ) The triplet represents bunching terms that are exponential decay
functions.
§ Choose between normalized and non-normalized triplet term by
activating/deactivating Normalized.
§ Choose, whether the bunching terms should be weighted or not by
activating or deactivating Weighted. If no weights are applied, the
fit follows the measured curve to minimize χ2. If no boundary val-
ues are set for the relaxation times, noise might also be followed

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1277


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Term Settings
and triplet fractions might show up to be too high. If weights are
applied, noise is followed less. The following weight equation is
used:

Several options are available for the bunching terms. Select the rele-
vant term from the Components drop down menu:
§ Triplet: 1 exponential function
§ Blinking: 1 exponential function
§ Independent Triplet and Blinking: Sum of 2 exponential functions
§ Dependent Triplet and Blinking: Product of 2 exponential functions

§ The name of the selected term is shown in the Components selec-


tion box.
§ The description panel provides information on the bunching terms.

Rotation G r(τ) § Choose between normalized and non-normalized rotation func-


tions by activating/deactivating Normalized.
§ Select the Dependent antibunching, rotation and translation
by activating the respective checkbox. This equation will be used as
an additive term to anti-bunching and translational diffusion terms.
Optionally leave the amplitude value free floating or setting it to
4/5 by clicking the Free or to 4/5 buttons, respectively. The active
option is highlighted in blue.
§ Choose between symmetric rotation (1 exponential term) and
asymmetric rotation (double exponential term) by activating/deacti-
vating Asymmetric.
When Asymmetric is active, it is possible to define relative ampli-
tudes and rotational frequencies (note, these parameters are no fit
values and have to be defined by the user).
Relative amplitudes are defined by selecting the excitation polariza-
tion (linear polarized or unpolarized) and the emission detection
(parallel, perpendicular or all), by clicking the corresponding
tabs, which will result in the corresponding values displayed in the
c1 and c2 display boxes. Alternatively, if others is activated, you
can type in user defined values.
Rotational frequencies can be selected by clicking the Default tab
to load the default values. The corresponding values are shown in
the r1 and r2 display boxes. By clicking the other tab, user defined
values can be entered.
§ The description panel provides information on the rotational diffu-
sion terms.

Translation Gd(τ) The following possibilities for parameter settings are available:
§ Fit to fractions (normally used when no brightness differences are
observed between different components) or to fractional intensi-
ties, by activating Fractional Intensities. Type in the absolute or
relative brightness values of the components into the Molecular
brightness edit box.
§ Fit to the diffusion time, or directly fit to the diffusion coefficient by
activatingDiffusion coefficients. Type in the radial dimension of
the confocal volume into the ωr edit box or use the scroll arrows.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1278


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Term Settings
§ In case two photon excitation is used activate 2 Photon since this
will influence the fit formula in the case the Diffusion coefficients
option was chosen.
§ Select the number of components (1, 2 and 3) by clicking the Com-
ponents 1, 2 or 3 buttons. The number of active components will
be highlighted in blue.
§ Select free/anomalous diffusion in the dropdown down menus
beneath each component button.
§ Set the diffusion Dimension in the dropdown menus beneath each
component button. Select between 1-D, 2-D and 3-D.
§ Enter brightness values in the Brightness edit boxes for each com-
ponent. These values are only displayed, if the Fractional Intensi-
ties option is selected. Type in absolute values (that must have the
same units for all components) or relative values.
§ The description panel provides information on the translational dif-
fusion terms.

Flow Gf(τ) § Determine, whether you want to fit to the diffusion time or directly
to the velocity by activating Velocity. Type in the radial dimension
of the confocal volume into the ωr edit box or use the scroll ar-
rows.
§ The description panel provides information on the flow terms.
§ Note, that the system automatically toggles between the pure flow
and flow in combination with translational diffusion in cases where
the Translation term is deactivated or activated, respectively.

Stretched exponen- § Choose between bunching and anti-bunching terms by clicking the
tial Ge(τ) Bunching or Antibunching buttons, respectively.
§ Choose between 1 (mono exponential) or 2 (double exponential)
stretched exponential terms by clicking the Components 1 or 2
buttons. The active option will be displayed in blue.
§ Choose between normalized and non-normalized stretched expo-
nential term by activating/deactivating Normalized.
§ Choose between dependent and independent stretched exponen-
tials by choosing from the Components dropdown menu. This be-
comes only available, if two components are active.
§ The description panel provides information on the strethed expo-
nential terms.
§ Note, the frequencies and stretch factors are no fit parameters and
must be defined in the Frequencies k1 and k2 as well as the
Stretch factors κ1 and κ2 display boxes. Either enter a value or
click the 1 button for the default setting.
§ For two components, only the formula for dependent processes is
presently available.

10.7.5.2 Setting up FCS/FCCS Measurement

10.7.5.2.1 FCS Measurement Setup for Labeled Molecules in Solution

Prerequisite ü Dye/Molecule dissolved in suitable solvent and at suitable concentration.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1279


10 Systems & Components | 10.7 LSM 900/980 ZEISS

ü High NA Objective selected for imaging.


ü Focus point set into the solvent maybe using imaging techniques to check on emission signal.
1. Chose FCS track in Imaging Setup tool.
2. Select detection channel for FCS in Imaging Setup tool.
3. Select laser and laser power for dye excitation in Channels tool (see Choosing the Optimal
Laser Power [} 1282]).
4. Select 1 Airy Unit for the pinhole.
5. Set up measurement parameters in Channels tool (see Setting the Parameters for the
FCS/FCCS Measurement [} 1281]).
6. Click Continuous for continuous measurement to see count rates and correlation data and
to optimize laser power.
7. Adjust Pinhole if necessary (i.e. if low count rate is registered during continuous data acqui-
sition with otherwise sufficient laser power) (see Adjusting the Pinhole [} 1282]).
8. Click Snap for a complete single dimensional measurement.

10.7.5.2.2 FCS Measurement Setup for Labeled Molecules within Cultured Cells

Prerequisite ü Dye/Molecule available/expressed in suitable concentration within cultured cell


ü High NA Objective selected for imaging
ü Pinhole adjusted with test sample previous to the measurement (if needed) (see Adjusting the
Pinhole [} 1282]
1. Focus onto the selected structure.
2. Acquire a confocal image using suitable imaging parameters (laser, laser power, detector
gain, detection range) to identify the region/point of interest for FCS measurement.
3. Open Experiment Regions tool.
4. Select FCS marker tool and position it within the acquired image onto the point of inter-
est.
5. Chose FCS track in Imaging Setup tool.
6. Select the required detection channel/s in Imaging Setup tool.
7. Select laser and laser power for dye excitation (see Choosing the Optimal Laser Power
[} 1282]).
8. Set up measurement parameters in Channels tool (see Setting the Parameters for the
FCS/FCCS Measurement [} 1281]).
9. Click Continuous for continuous measurement to see count rates and correlation data and
to optimize laser power and focus position.
10. If necessary run Z-Scan (count rate over Z stack measurement) to find optimal Z position or
correct Z position using the Z Focus of the stand (see Performing a Z-Scan [} 1283]).
11. Confirm the selected position within the Experiment Regions tool for the corresponding
measurement spot.
12. Click Snap for a single complete measurement including all selected measurement spots.

10.7.5.2.3 FCS Measurement Setup for Labeled Molecules in Solution Using a Sample Carrier

Prerequisite ü Dye/Molecule dissolved in suitable solvent and at suitable concentration distributed into a
sample carriers wells.
ü High NA Objective selected for imaging.
ü ZEN Module Tiles & Positions is available on the system.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1280


10 Systems & Components | 10.7 LSM 900/980 ZEISS

ü Focus point set into the solvent (about 100 to 200 microns above the coverslip into the sol-
vent) maybe using imaging techniques to check on emission signal.
ü FCS track is defined with suitable channel selection, laser line and power, and measurement
parameters for the actual FCS measurement.
ü Pinhole is adjusted for optimal FCS results.
1. Activate an LSM confocal track (or other imaging track).
2. Open Tiles tool.
3. Select the sample carrier matching the one used for the experiment.
4. Move the actual sample carrier to the reference point marked as yellow cross in the sample
carrier graphic and confirm with ok to close the panel.
5. Calibrate the sample carrier with the following steps:
- 1/4 -> no changes, click Next.
- 2/4 -> Click Set zero, click Next.
- 3/4 -> Chose Search Reference Point (1 Point) from the drop down list, click Next.
- 4/4 -> Set Current XY, click Finish.
6. Activate FCS track .
7. Open Tiles Viewer and zoom out to see the carrier in total.
8. Select the following tool from the Positions icons on the left: (Setup new positions
from an underlying sample carrier).
9. Mark the wells by clicking them individually (Click Ctrl ) or select by drawing a contour
around the relevant ones holding the left mouse button while moving the curser.
10. Keep the default settings: Distribute Positions by Number, Number = 1, and Bias =
None.
11. Click Plus to add one position per marked well.
12. Click Start Experiment to acquire an FCS measurement per selected well.

Info
4 Only one position per carrier well is supported.
4 Repeated measurements per well can be achieved combining this type of acquisition with
a Time series multidimensional acquisition.
4 Multiple Positions per well or tiles or combinations of tiles and positions are not supported
and will be deleted when the FCS track is activated.
4 If the sequence of the positions is changed after their initial definition the timely sequence
of the position measurement data can only be deduced from the time stamp in the result
table within the FCS document. IDs of positions and measurement data match.

10.7.5.2.4 Setting the Parameters for the FCS/FCCS Measurement

1. Set the Measurement Time.


If you do not have any idea about the behavior of your sample, start with a measurement
time of about 10 seconds. Depending on the signal-to-noise ratio of your correlation curve,
decrease or increase the measurement time. As a rule of thumb the measurement time
should be about 1000 x the diffusion time of a molecule under study. However, due to
“photon noise” (photon shot noise) a 10 s measurement time is a good start value to ob-
tain good statistical results.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1281


10 Systems & Components | 10.7 LSM 900/980 ZEISS

2. Set the Repetitions.


Start with Repetitions set to 1. If you want to obtain information about the variation of
your fitted values later on, increase the Repetitions to produce a measurement series. 10
times is a good value to start with. Repetitions can be averaged into an average correlation
function if required. This will improve statistics. An average of 10 x 10 seconds Measure-
ment Time is not as good as one 100 sec measurement. If bleaching becomes a problem, it
might help to reduce Measurement Time and increase Repetitions to obtain fairly good sta-
tistical results while reducing bleaching.

10.7.5.2.5 Choosing the Optimal Laser Power

1. Use the initially set laser power indicated in the Laser control panel in Imaging Setup or
Channels Tool.
2. Start a Continuos scan with an active FCS track and bring the Detector Counting tool
from the right tool area into view. A good starting point is a laser power which leads to a
count rate between 50 kHz and 200 kHz.
3. Change the laser power using the slider next to the active laser used for acquisition to in-
crease or decrease the values to achieve such a count rate.
4. When finished, stop Continuous scan.

Info
For most dyes, the Counts/Molecule setting should be optimized in a second step to a value
just under its maximum by adapting the laser power. If carriers of different slide thickness are
employed, the Counts/Molecule setting should be optimized by using the correction ring of
the objective. The correction ring is turned counterclockwise or clockwise until a maximum
value is obtained. The correction ring should also be used for adjusting the Counts/Molecule
setting whenever the immersion media is changed. This is especially important in cases where
the refractive index of the immersion media is different from that of the sample.

10.7.5.2.6 Adjusting the Pinhole

The pinhole is adjusted using a dye solution. For each excitation wavelength and MBS combina-
tion a suitable dye must be used.
We recommend:

§ Rhodamine 6 Green (Rh6G) or Alexa 488 for excitation lines 445, 488 and 514 nm
§ Tetra-Methyl-Rhodamine (TMR) or Alexa 546 for excitation line 543 nm or Alexa 568 for exci-
tation line 561 nm
§ Cy 5 or Alexa 633 for excitation line 639 nm
We recommend to work with a relatively concentrated solution (10-6 mol/l) and low laser power
to achieve intensity curves with low noise.

Prerequisite ü All steps from FCS Measurement Setup for Labeled Molecules in Solution [} 1279] up to
the step Pinhole Adjust have been performed.
1. Set the laser power to achieve above 100 kHz count rate, if possible.
2. Click Adjust in the pinhole panel of the Channels tool.
3. Click the Coarse button of X first and then Y to perform a coarse adjustment scan in x and
then in y.
à The pinhole will travel over the maximum range for each axis.
à The adjustment scan in y will use the optimum setting found for the x axis.
4. Perform a fine adjustment in x and y by subsequently clicking the Fine buttons.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1282


10 Systems & Components | 10.7 LSM 900/980 ZEISS

à For the fine adjustment the pinhole will travel only a limited distance (about 10 microns)
around the peak determined in the coarse adjustment or around the current stored posi-
tion of the pinhole if the coarse adjustment was skipped.
5. If the pinholes are adjusted for the first time, the coarse adjustment must be performed first
followed by the fine adjustment, each time for x and y. For subsequent readjustments, the
fine adjustment is typically sufficient.
6. In case more lasers and detectors are selected, the adjustment scan will be done for all
lasers/detectors simultaneously.
7. When using the 405 nm laser it might be necessary to adjust the collimator for optimal
overlay in Z. This should be done in advance to the pinhole adjust procedure if necessary
(see Collimators Adjustment [} 1290]). The collimating lens is pre-set at delivery and is a
function of the wavelength and objective used. In case a new objective is used with the sys-
tem this value needs to be determined anew.
8. The values determined by the adjustment scan for the X and Y position of the pinhole(s) are
indicated by the position of the line in the graph as well as the slider and the number in the
edit box. In case this value is not accepted it can be changed by moving the slider or typing
in a different value.
9. Click finish to store the indicated X and Y values as general pinhole settings for the main
dichroic used. This value will now be used for the current and future FCS/FCCS measure-
ments.
It is recommended to adjust the pinhole for FCS measurements on a regular basis.
10. The adjustment scan can be performed separately for X and Y. The values can be stored in-
dependently as well. However it is recommended to adjust both values and store them
both.

10.7.5.2.7 Performing a Z-Scan

The Z-Scan is especially suitable to position the confocal volume on a cell membrane. Due to the
shape of the confocal volume, the membrane should not be approached from the side but instead
rather from the top of the cell. Please note that it is better to use the upper membrane for mea-
surement, since the lower membrane might be too close to the glass bottom surface resulting in
disturbing reflections. Besides using the Z-Scan you can also position the membrane manually, al-
beit with less precision.

Prerequisite ü Dye/Molecule available/expressed in suitable concentration within cultured cell.


ü High NA objective selected for imaging.
ü Pinhole adjusted with test sample previous to the measurement (if needed) (see Adjusting the
Pinhole [} 1282]).
ü FCS track defined and active.
ü Cell of interest positioned in the center of the scan field and manually focused as best as pos-
sible acquiring a confocal image.
1. In Channels tool, click Z-Scan button.
2. Set the range and step width for the scan suitable for the sample.
3. Start the Z-Scan.
à The resulting graph should typically show two peaks (from the lower and upper mem-
branes). High signal intensity may correlate to the labeled membranes.
à If the glass surface happens to be in the Z-Scan range it will also give a peak. To deter-
mine its position, perform a Z-Scan at a position where there is no cell. If the glass reflec-
tion contributes so much that the peaks of the membranes are hidden due to scaling,
shorten the scan range to avoid picking up the signal.
4. Place the red line at the peak that corresponds to the membrane and select this Z-position.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1283


10 Systems & Components | 10.7 LSM 900/980 ZEISS

5. If no clear signal can be detected, or the peak of interest lies too close to the range ex-
tremes, take over the Z position most likely to represent the wanted one by moving the bar
to this position and clicking Finish.
6. Restart the Z-Scan at this Z position with an adjusted range and step width and take over
the then defined Z position for the FCS measurement.

10.7.5.2.8 Saving and Loading FCS Data

Whenever Save FCS raw data file is activated in the Acquisition Selection/LSM of the Options
tool, the raw data file is saved along with the *.FCS file in the folder selected for saving the *.FCS
file.
*.RAW files contain the same name than the *FCS.fcs file with name extensions, which identify
the repetition and the channels.
The measurements can be saved individually using the standard save tools or by activating Auto
Save in the left tool area. The *.FCS file includes the whole data set (curves, fitting results, fit pa-
rameters).
Whenever a *.FCS file is opened the data show up in the Correlation view tab of the FCS docu-
ment (see Correlation Tab [} 1246]).
The Reload function (see Reload Tool [} 1258]) is only available if raw data have been saved
along with the *.FCS file.

10.7.5.2.8.1 Format of *.RAW Files

*.RAW files are saved optionally when activating the storage of raw data in the options menu (see
Saving and Loading FCS Data [} 1284]). The *.RAW data files can be opened directly in ZEN. They
are also opened automatically if linked to a *.FCS file. In this case all raw data files associated with
the *.FCS file will be opened in the same FCS document.

Info
Raw data formats can also be opened in ZEN Black (all versions).

Info
The sampling rate is set to 15 MHz. Depending on the detector used for FCS measurements, a
maximum data rate of up to 16 Mbyte/sec is achieved.

The format describes the time distance between photons.


The format is explained in the following figure. The figure displays the raw data with an editor
program that shows the raw data in file offset, hexadecimal, and as ASCII.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1284


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Fig. 128: ZEN raw data format

Bytes Explanation
0-63 § represent the file identifier with the channel number

64-79 § measurement identifier


The identifier is a randomly created number that will be assigned to
all channels, repetitions, positions and kinetic indices of the same
measurement. Hence, in a cross-correlation experiment, the two
auto-correlation pairs that belong together can be identified.

80-83 § encode the position of the measurement


§ zero based

84-87 § encode the kinetic index


§ zero based

88-91 § encode the repetition number


§ zero based

92-95 § encode the detector frequency in Hz

96-127 § reserved for comments


§ set to 0

128-correspond- § code for the first pulse distance in detector clocks


ing to a file off-
set of 7F
(hex)=127 (dec)-
to 131

starting from § code for follow up pulse distances


132
Tab. 7: Explanation of raw data code

10.7.6 Polarization Imaging

Linear (plane) polarized light, which is light whose wave goes only one direction, exciting a fluo-
rescent molecule with a preferred dipole orientation results in polarized emitted light. It provides a
contrast-enhancing method that is especially useful in the study of molecules that are fixed in

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1285


10 Systems & Components | 10.7 LSM 900/980 ZEISS

their orientation or are greatly restricted in their rotational diffusion. Anisotropy is directly related
to polarization and is defined as the ratio of the polarized light component intensity to the total
light intensity.
In polarization microscopy using LSM systems the sample is irradiated with vertical polarized light
(in respect to the optical table) from a laser source. The emitted fluorescence is passed sequen-
tially through emission polarizers (analyzers) that are positioned before the Quasar detector. They
transmit either the vertical (IVV) or horizontal (IVH) polarized emitted light onto the Quasar detector
(L format fluorescence polarization). Since the vertical component of the emission light is parallel
polarized to the vertical polarized excitation light, it is often also referred to as the parallel compo-
nent (P Pol, Ip, I||). Likewise, the horizontal polarized emission light is also designated as the per-
pendicular ("senkrecht" in German) component (S Pol, IS, I|). In the software the "p" and "s" desig-
nations are used.
Polarization P and anisotropy Polarisation P and anisotropy r are defined as: are defined as:

and with 0 ≤ r ≤ 1.
They can be interconverted to each other in the following way:

and
In a completely polarized sample (IS = 0) the anisotropy r = 1. In a completely non-polarized sam-
ple (Is = Ip) anisotropy r = 0.
The formulas for polarization P and anisotropy r as given above are strictly true only, if the optical
transmission for both emission polarizers are identical. Any differences must be corrected by intro-
ducing a correction factor G that is multiplied with Ip. Hence the anisotropy r in such a case is cal-
culated according to:

G can be measured using horizontally polarized excitation light and is defined as

However, since in LSM systems the polarization of the excitation light can not be changed from
vertical to horizontal, G has to be determined with an isotropic fluorescent dye solution as the ra-
tio between the mean intensities Ip and Is, e.g. obtained from the histogram view.

Info
Please note that the G factor is not the mean intensity of the ratio calculation (R), where every
pixel is computed separately. It has to be calculated from the ratio of the mean intensities of
the Ip and Is images.

As the formulas implies:


Anisotropy r is the preferred display as anisotropy of single species is additive. The calculation of r
can be done using ratio formulas located in the MeanRoi View.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1286


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.6.1 Setting up Polarization Imaging

Prerequisite ü S and P Pol filters are part of the system configuration.


1. Set up a multitrack configuration using exactly the same settings with the exception of the
Pol Anisotropy filters.
2. Click the Pol Anisotropy filter wheel located under the channel selection list.
à This opens up the Pol Anisotropy selection panel.
3. Check the anisotropy filter you want to use for Track 1.
4. Switch to Track 2. Select the anisotropy filter you want to use for Track 2.
5. The options are Pol Anisotropy P Filter (for the parallel polarized light transmission) and
Pol Anisotropy S Filter (for vertical polarized light transmission) (see picture).

Info
If you want to calculate Anisotropy using the ratio imaging formulas provided by ZEN, then
choose P for Track 1 and S for Track 2.

10.7.6.2 Determining the G Factor

Prerequisite ü You have licensed the module Physiology (Dynamics).


ü Isotropic sample like a fluorescent dye at a 1 mM concentration, for example fluorescein.
ü Multitrack image acquisition set as described above (Imaging Set up for Polarization Imaging)
with excitation laser and detection beam path set for imaging the isotropic dye sample.
ü Excitation laser intensity and detector gain set to get a well balanced image without overex-
posed pixels.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1287


10 Systems & Components | 10.7 LSM 900/980 ZEISS

ü Pol Anisotropy P Filter selected for Track 1 and Pol Anisotropy P Filter selected for
Track 2.
1. Acquire a time series multitrack image with the image in Track 1 showing the emission sig-
nal filtered by the P Anisotropy filter and the image in Track 2 showing the emission signal
filtered by the S Anisotropy filter.
2. Open MeanRoi View .
3. Open Ratio action tab.

4. Activate Enable Ratio Calculation.


5. Chose Dual Wavelength as method for ratio calculation.
6. Set factor to 1,00.
7. Draw a (large) region into the image for analysis.
8. Activate Image and Chart with Table in the Layout action tab.

à The G factor is shown as mean intensity value of the Ratio_R1 channel in the intensity
chart.
The G-factor is therefore defined as:

10.7.6.3 Obtaining an Anisotropy Image

1. Set up a multitrack configuration with alternating analyzers: P in Track 1, S in Track 2, leav-


ing all other imaging settings as when obtaining the image series for determining the G fac-
tor.
2. Acquire a time series.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1288


10 Systems & Components | 10.7 LSM 900/980 ZEISS

3. In MeanROI View choose the Ratio Type 3 formula in the Ratio tab.

4. Set Background Correction to Constant.


5. Type in the value of the G Factor (as “Background Correction) as a multiplier into the nomi-
nator and 2x G Factor as (as a “Background” Correction) into the denominator. With Ch1-
T1 and Ch1-T2 corresponding to IP and Is this formula corresponds to the formula for an-
isotropy r.
6. Adjust multiplier and add value as fit to get a good image representation.
7. Alternatively, open Processing | Method | Image calculator.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1289


10 Systems & Components | 10.7 LSM 900/980 ZEISS

8. Use source 1 (S1) being the P track image (Ch1 T1) and source 2 (S2) the S track image
(Ch1 T2) with consideration of the G factor in Parameters.

10.7.7 System Maintenance

Use the System Maintenance and Calibration dialog within the Tools menu to check on es-
sential parameters of the LSM.

1. Open Tools > System Maintenance and Calibration…


2. Use the Default mode for a user's routine.
3. Perform the following maintenance procedures as described in the safety and operating
manual:
- Scanner calibration
- Pinhole to MBS calibration
4. Follow the instructions of the wizard.
à In case the test does not pass you might want to repeat the procedure. If the problem
persists you need to check with your local ZEISS service engineer.
The following additional tests provide information on the quality of the system:

§ The scanfield test provides information on the quality of the scanner calibration. If this quality
repeatedly fails although the scanners have been calibrated, it might be necessary to ex-
change the scanners. Contact your local ZEISS service engineer.
§ The sharpess test provides information on the resolution contrast. This parameter is depen-
dent on the overall alignment of the system and the quality of the detectors. If detectors de-
teriorate then this test failing might be an indication for a necessary exchange of a detector.

10.7.7.1 Collimators Adjustment

The position of the collimator(s) for lasers coupled to the invis port can be adjusted if needed. The
position is dependent on the wavelength and the objective used. The collimator position is a func-
tion of the system and the position is not part of an experiment and hence cannot be reloaded
with an experiment or re-used with an image.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1290


10 Systems & Components | 10.7 LSM 900/980 ZEISS

For tunable Multiphoton lasers it might be necessary to adjust the collimator for a given wave-
length and objective as the laser is set up together with the LSM first time at the customers.
Use the following parameters to adjust the collimator.

Parameter Description
Collimator Chose the collimator you want to adjust. In case no Multiphoton laser
lines are available only the collimator for 405 nm laser is accessible.

Position Use the slider or the editing box to change the position of the collima-
tor. Check the image of a continuously scanned sample (i.e. LSM cali-
bration objective) for highest intensity. In case you want to align the
collimator for optimal overlap with vis lasers, perform for example a
reflection line scan with vis laser and focus for highest signal. Then
adjust the collimator of the invis laser for highest image intensity. If
both reflection images show highest intensity the excitation level
matches.

Store Current Pos Stores the current position as the default position for the selected col-
limator.

Move to Stored Moves the position of the selected collimator to a stored value for the
Pos given wavelength and objective. Stored positions are automatically set
when an objective is changed or the laser is tuned (Multiphoton
laser). The current non stored settings are kept for an experiment if
the laser is not tuned or the objective is not changed.

10.7.7.2 Pinhole Adjustment

The position of the pinhole (or rather the laser beam in X-Y-coordinates) in relation to the detec-
tor makes a major contribution to image optimization.
The pinholes have already been adjusted at the factory. These settings are taken over for active
operation when a standard configuration is loaded.
If you want to create a setting that differs from the standard configurations, use the following pa-
rameters.

Parameter Description
Diameter [µm] Changes the diameter of the pinhole
slider

X Position [Vis] Changes the X position of the excitation beam of all vis lasers in rela-
tion to the pinhole

Y Position [Vis] Changes the Y position of the excitation beam of all vis lasers in rela-
tion to the pinhole

X Position [Invis] Changes the X position of the excitation beam of all invis lasers in re-
lation to the pinhole

Y Position [Invis] Changes the Y position of the excitation beam of all invis lasers in re-
lation to the pinhole

Store Current Pos Stores the current position as the default position for the given lasers
and main dichroic filter

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1291


10 Systems & Components | 10.7 LSM 900/980 ZEISS

Parameter Description
Moved to Stored Resets the pinhole position to the stored value
Pos

10.7.7.3 Periscope Adjustment

Multiphoton lasers are steered into the scan head of the LSM via a free beam coupling. The com-
ponents of the coupling kit ensure that the laser beam is enclosed within metal pipes. The cou-
pling components include a periscope which lifts the free beam up to the height it needs to have
to hit the coupling port of the scan head. The positioning of a freely coupled laser beam is subject
to temperature changes, potentially mechanical influences and the laser itself. When tuning the
laser, it very slightly changes its position. When working with two laser beams the precise overlay
of the two beams can be critical for the experiment. Hence the “Adjust Periscopes” tool provides
access to the motorized steering mirrors within the periscope to adjust for possible mismatches
between the two laser beams.
The periscope contains two sets of mirrors for each beam. One set has more influence onto the
homogeneity of the illumination, the other set is rather adjusted for a precise overlay between the
two beams. For a good coupling both the lateral position as well es the angle of the beam needs
to be adjusted to have the laser travel along the center of the optical axis.
The best reference to achieve this is an image of a structured and fluorescent sample taken with
the 488 nm laser. Such a sample can also be purchased at ZEISS.
The following controls are available:

Parameter Description
Reference Image A drop-down list opens listing all open images with the last one ac-
quired on top of the list. The selected image appears as overlay image
in the continuous image tab.

Opacity Opacity relates to the reference image display in the continuous im-
age tab. 100% does only show the reference image, 0% does only
show the continuously acquired image.

On Switches the overlay image on/off (set opacity/0% opacity) for quick
cross check on overlaid structures.

NLO 690-1300 nm Click to select the periscope mirrors for the tuneable line of the Multi-
photon laser.

NLO 1045 nm Click to select the periscope mirrors for the fixed line of the Multipho-
ton laser.

Arrow button for Depending on the selection of the laser line, the arrows move the
various directions beam and hence the continuously acquired image taken with the NLO
laser in the indicated direction. The arrows allow fine and course
movement steps. The number of steps is displayed next to the arrow
buttons.

Move to zero A current absolute position of each mirror pair can be defined as posi-
tion zero. This resets the number of moved steps to zero.

Set position zero Moves the mirrors back to the zero position. The position of the mir-
rors present at each start of the system is taken as initial zero.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1292


10 Systems & Components | 10.7 LSM 900/980 ZEISS

10.7.7.3.1 Correcting Inhomogeneous Illumination

Prerequisite ü Sample with homogeneous fluorescence is placed in the sample holder (the samples fluores-
cence must be excitable by any NLO line).
ü The preferred objective for the alignment for Axio Observer: 10x; for Axio Examiner: 20 x 1.0 .
ü The sample is in the field of view and focused.
ü The tuneable Multiphoton laser line is tuned to the desired wavelength.
ü The acquisition parameters are set to have the maximum field of view and imaging speed of 9
or 10 to quickly see the changes in the image when clicking the alignment arrows.
ü Imaging Setup is configured using one internal detection channel at relevant spectral range
with open pinhole.
ü Multiphoton laser is activated for the single channel acquisition track.
1. Open Tools > System Maintenance and Calibration.
2. Select the tool Adjust Periscopes.
3. Select laser line of which the periscope mirrors should be controlled to check/align for ho-
mogeneous illumination.
4. Start a Continuous scan.
5. Set laser power and detector gain for optimal imaging with just the first pixels in saturation
(check with range indicator LUT or the rainbow LUT).
6. In case the brightest area is not centered use arrow keys to center the brightest area.
7. Use also a profile line for better visualization of the intensity distribution.
à The motor steps of each mirror are counted to easily move back to the original value.
8. Stop continuous scan when illumination is optimized.
9. The final mirror positions can be set as new zero.
à This position will be constant unless the mirrors are moved again.

10.7.7.3.2 Correcting Overlay of both NLO Laser Lines

Prerequisite ü Sample with homogeneous fluorescence and structures with high contrast is placed in the
sample holder (the samples fluorescence must be excitable by any NLO line).
ü Chose the objective relevant for the application.
ü Higher NA allows for higher precision when checking and correcting the overlay.
ü The sample with its structured part is in the field of view and focused.
ü A single snap image using preferably the 488 nm laser is acquired as reference image with
good visibility of the structures.
ü The tuneable NLO laser line is tuned to the desired wavelength.
ü Imaging Setup is configured using one internal detection channel at relevant spectral range
with open pinhole.
ü The acquisition zoom and the stage position are kept constant and are identical to the acqui-
sition of the reference image.
1. Open Tools > System Maintenance and Calibration.
2. Select the tool Adjust Periscopes.
3. Select the just acquired single image as reference image.
4. Select laser line of which the periscope mirrors should be controlled to check/align for im-
age overlay.
5. Activate this laser for acquisition in the Channels tool.
6. Start a Continuous scan.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1293


10 Systems & Components | 10.7 LSM 900/980 ZEISS

7. Set laser power and detector gain for optimal imaging.


8. Set opacity of the reference image such that the structures of the reference image and the
continuously scanned NLO image are visible.
9. Use the arrow keys for overlay to overlay the structures of the continuously scanned image
with the reference image.
10. It might be necessary to use the overlay and illumination mirrors alternately to achieve the
optimum result.
11. The motor steps of each mirror are counted to easily move back to the original value.
12. The reference image can be quickly switched on/off for quick alternating display of the
structures.
13. The final mirror positions can be set as new zero. These positions will be constant unless
the mirrors are moved again.
14. Repeat step 4 to 12 for the other NLO laser line.

Info
If the alignment of the Multiphoton laser is off and only part of the beam or no beam is visible
in the objective plane do not attempt to align using this tool. The tool is designed to correct
for minor mismatches occurring when the laser is tuned or in case of minor temperature varia-
tions. Adjustments should only be done when the system itself has been warmed up for at
least one hour. It is assumed that the system is set up in a temperature-controlled room with-
out major air flow as is described in the system setup requirements.

10.7.7.4 Airyscan Detector Adjustment

10.7.7.4.1 Introduction

The tool provides controls for the automatic alignment of the Airyscan detector during system op-
eration. The status of the current adjustment is indicated in the status bar of ZEN whenever the
Airyscan detector is in use in Airysan SR or Airyscan Multiplex tracks.
The tool can be opened via the System Maintenance and Calibration dialog located in the
Tools menu or by clicking the arrow next to the icon of the detector in the status bar.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1294


10 Systems & Components | 10.7 LSM 900/980 ZEISS

4
5

Fig. 129: Airyscan Detector Adjustment tool

No. Parameter Description


1 Quality and Shows the adjustment status.
Status

- No signal available

- Not enough light or too much

- Alignment ongoing

- Alignment done and ok

- Manual The adjustment can be done using the sliders under Fiber posi-
Mode: tion.

- Automatic The adjustment is performed as defined in Activation.


Mode:

2 Activation Activate the alignment during Live and Continuous mode.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1295


10 Systems & Components | 10.7 LSM 900/980 ZEISS

No. Parameter Description


Activate the alignment during Time Series Acquisitions with
Interval.

3 Fiber position Use slider to change the adjustment of the fiber in x and y for
manual positioning. The slider can only be operated in Manual
Mode. Activate Store Invis correction position automatically
to keep this position until the adjustment is active again during
continuos scan in Airyscan tracks.

4 Store Current Stores the current positions of x and y for further reference.
Pos

5 Move to Moves both sliders to the stored position. Going to the stored
Stored Pos position is a good start when manually realigning the detector.

6 Detector View Shows the current intensity distribution of the emission signal
over the detector elements.

10.7.7.4.2 Adjusting the Airyscan Detector Automatically via the Status Bar

1. To access the detector adjustment, click on the detector symbol at the Status bar. Depend-
ing on the selected Airyscan mode, the illumination pattern varies in geometry. A correct
adjustment is always symmetrical and centered.

2. Start a live or continuous scan to automatically adjust the Airyscan 2 detector.


3. Activate the checkbox Adjust in live and continuous scans. Alternatively, start a time se-
ries with intervals and activate Adjust in time series with interval.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1296


10 Systems & Components | 10.7 LSM 900/980 ZEISS

The pattern of the active Airyscan detection elements might vary depending on the chosen
Airyscan detection mode.

10.7.7.4.3 Adjusting the Airyscan Detector Automatically via System Maintenance and Calibration

Info
When using 405nm laser (or a NLO laser line) in one track and any other laser in the second
track, use continuous mode with both tracks active for Airyscan detector adjustment. The
alignment for 405nm laser depends on the alignment of the other lasers first. If the tracks are
adjusted individually the alignment is mutually overwritten and cannot work properly. Activate
the checkbox Store Invis correction position automatically to keep this position until the
adjustment is active again during continuos scan in Airyscan tracks.

Info
In case the experiment requires image acquisition in multi-track mode with frame wise switch-
ing between the tracks and one track using the 405 nm laser for excitation, the following set-
ting needs to be defined to achieve an automatic adjustment of the Airyscan detector during
Continuous mode: Keep the main dichroic for the 405 laser identical between all tracks
whether the tracks work with the 405 laser or not. Otherwise the switching of the MBS be-
tween the tracks does not allow to finalize the adjustment and the system stops with an error
message. Do also check the suggestions for track setups which are made by Smart Setup.

Info
Airyscan as detector for LSM Confocal track
When Airyscan is used as detector for LSM confocal track, alignment is not needed. The align-
ment is set to the stored position.

Info
Use manual mode
Use manual mode if the alignment takes to long or does not work. Move slider to the stored
position first for a good start.

Prerequisite ü Airyscan SR or Airyscan MPLX track is set up

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1297


10 Systems & Components | 10.7 LSM 900/980 ZEISS

ü Icon for Airyscan Adjustment status visible in the status bar


1. Open Tools > System Maintenance and Calibration ...
2. Select Default as the desired user group .
3. Click on Continue.
4. Click on Airyscan Detector Adjustment.
à The Airyscan Detector Adjustment dialog appears.
5. Activate Adjust in live and continuous scans.
6. Start a Live or a Continuous scan.
à When light is reaching the detector, the distribution of the intensity over the detector el-
ements is displayed (detector view icon).
7. Keep scanning and adjust detector gain/laser power in case the light level is to high/low.
8. Increase scanning speed (for Continuous mode only) to speed up the alignment procedure.
à When the light level is ok, the icon shows in red with a yellow warning triangle and the
alignment is still ongoing.
à When the alignment is done and ok the icon turns green and quality and status ore OK;
the detector element with the brightest signal is the one in the center/middle line (de-
pending on the imaging mode SR versus MPLX).
à With stable room conditions according to the specifications (see Safety and Operation
instructions) there is no need to readjust the detector for every new experiment.

10.7.7.4.4 Adjusting the Airyscan Detector Manually

1. Click on the detector symbol at the Status bar. Depending on the selected Airyscan mode,
the illumination pattern varies in geometry. A correct adjustment is always symmetrical and
centered.

2. Deactivate all checkboxes.


3. Move the sliders for the Fiber position of X and Y until the detector symbol turns green.
4. Click on Store Current Pos to save the adjustment setting.
5. Click on Move To Stored Pos to override the position found by the check boxes and will
keep this position if live or continuous scan is off.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1298


10 Systems & Components | 10.7 LSM 900/980 ZEISS

The pattern of the active Airyscan detection elements might vary depending on the chosen
Airyscan detection mode.

10.7.7.5 Adjusting Readback Signals

The following function adjusts the readback signals of the scanner when a spline scan is per-
formed (see Parameters for LSM Imaging Modes [} 875])
To adjust the readback signals proceed as follows:

1. Set image acquisition to minimal zoom and a slow speed like 5 or 6.


2. Chose Acquisition tab > Acquisition Mode tool > Line scan mode.
3. Click Line select >> to start a continuous scan.
4. Select LineSelect tab > Spline Mode.
5. Draw a scan line ideally covering a large area of the image.
à The readback signal curve will show up as a second line.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1299


10 Systems & Components | 10.7 LSM 900/980 ZEISS

6. If this readback signal does not match with the drawn line, use the various sliders (Factor
and Position for X and Y) to achieve maximum overlay between the two lines.
7. For the spline scan itself it might then be necessary to reduce the scan speed and/or reduce
the bend of the spline curve to achieve optimal spline scan positioning.
The adjustment of the readback signal should be checked now and again if the overlay of the sig-
nal with the spline graphics does no longer sufficiently match.

10.7.8 Lasers Tool

The LSM is equipped with a variety of diode and solid state lasers. The lasers can be controlled
(switched from Standby mode to On) vie ZEN. The tool displays only lasers which are available
with the system. (For LSM 980 only.)

1 2

Fig. 130: Lasers tool

1 Laser Lines [nm] column


Lists the available laser wavelengths. For Multiphoton Lasers the tunable range and fixed
line (if available) of the laser is displayed.

2 Power column
Contains the On/Off power control buttons one for each laser line. For Multiphoton
lasers the ON/OFF effects both, the tunable and the fixed line.

3 All Lasers Off button


With one click all still active lasers can be switched off.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1300


10 Systems & Components | 10.7 LSM 900/980 ZEISS

4 Laser Properties panel


Shows the laser properties of the selected (highlighted) laser line. The listed properties al-
ways contain the current wavelength, the status of the laser and the power.
§ The status of diode or solid state lasers changes between Connected, Warming up
and Ready.
§ The status of Multiphoton lasers changes between Connected, Warming up and
Mode locked. The laser is ready for use only when in Mode locked status.
§ The status of Multiphoton lasers also changes when the laser is tuned (Tuning), the
GDD unit is adapted (GDD Positioning) or when the laser is in CW mode (CW las-
ing). In any such status the laser cannot be used for imaging.
§ For Multiphoton lasers the panel contains the control for the GDD (group dispersion
delay) unit (if available).
§ In case two Multiphoton lines are available for imaging the second (typically non tun-
able) line with its status is displayed at the bottom of the panel.

Prerequisite ü The system components are switched on


ü ZEN is running
1. In order to use a laser for imaging, click On in the drop down list in the Power column of
the desired laser.
à A warning triangle next to the activated laser line indicates the laser is now on and emits
laser light.
Some lasers need up to 1 minute to warm up to their full power level. In this status the laser line
is marked in red in the Channels tool and in the Timed/Interactive Bleaching tool. Multiphoton
lasers take several minutes to warm up to full power.
All lasers which are needed for an experiment (load experiment), a track configured using Smart
Setup or when an image is re-used to reproduce the imaging acquisition parameters, are
switched on automatically. A laser is also switched on when it is selected in the Channels tool,
the Imaging Setup tool, the Timed Bleaching tool or the Interactive Bleaching tool.
Option
Lasers can be set to automatically switch off after 30 minutes of inactivity. This function can be
activated/deactivated in Options > Acquisition > LSM. Changing this function requires to restart
ZEN.
GDD Control
The settings for the GDD unit are predefined when the system is set up. The unit will move to a
specific value when the laser wavelength is changed. The wavelength of the multiphoton laser
might be changed either in the Channels Tool, when loading an experiment or when re-using an
image.
The value for GDD can be adapted to the experiments needs. In order to achieve the shortest pos-
sible pulses for a given setting (wavelength and objective), move the slider to a different position
while scanning in Live or Continuous mode. When the image intensity is at its maximum, the
shortest possible pulses reach the sample for multiphoton excitation. Store the value to use it for
the next image acquisition using Snap or Start Experiment. The value for the current wave-
length is displayed next to GDD.
GDD values may vary also with the objective. The pre-set values assume that a large high NA ob-
jective is used. The variations between similar types of objectives can be neglected. Hence the set-
tings might only need small adaptions if at all for a given wavelength. The GDD value does not
change if a wavelength is chosen for which no value is stored. Restore sets all GDD values back to
the factory settings.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1301


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

10.8 Lattice SIM Family

The Lattice SIM family consists of Lattice SIM 3 (LSIM 3), Lattice SIM 5 (LSIM 5) and ELYRA 7 with
Lattice SIM (ELYRA 7). All Lattice SIM 3/5 and ELYRA 7 illumination/detection units are attached to
the rear port of the microscope. The ELYRA 7 module is designed for performing single molecule
localization microscopy (SMLM) and/or Lattice structured illumination microscopy (Lattice SIM) as
well as SIM Apotome. The highly integrated system design allows combining two super resolution
illumination modes, SMLM and Lattice SIM in one module. The Lattice SIM 5 module focuses on
Lattice SIM technology with high mag/high NA objective and SIM Apotome. In contrast, Lattice
SIM 3 features SIM Apotome with capabilities of Lattice SIM with medium mag/med. NA objec-
tives.
The available spectral range extends from the V to the VIS region. For visible light (VIS), you can
select from up to three lasers with wavelengths of 642nm, 561nm and 488nm. For violet light (V),
a 405nm laser is available. Coupling of the laser light is through polarization-preserving single-
mode optical fibers. One variable beam collimator provides adaptation of the respective laser
wavelength to the used objective. On ELYRA 7, acousto-optical tunable filters (AOTF) adjust the
necessary brightness for all four laser lines within microseconds. The 405nm laser is additionally
equipped with neutral density filters that allow tuning the laser power further down. In contrast,
LSIM 3 and LSIM 5 use directly modulated diode lasers.

10.8.1 Principles of Superresolution Microscopy

A point object imaged by an objective lens will always be a blurred spot, the so-called point
spread function (PSF), due to the diffraction of light. Therefore, two points cannot come closer
than a certain limit in order to still be resolved. This minimal distance in object space corresponds
to a maximal cut-off frequency in the frequency space that can be transmitted through the objec-
tive lens.
The transmittable frequencies represent the optical transfer function (OTF), which is the Fourier
transform of the PSF. As a rule of thumb, the resolution of a far field light microscope in the lat-
eral direction is approximately half the wavelength, whereas it is three fold worse in the axial di-
rection. Hence, for a light microscope lateral and axial resolutions are approximately 240nm and
600nm, respectively. In order to enhance resolution, the PSF has to be narrowed, which is synony-
mous to the OTF to be expanded. This exactly is accomplished by structured illumination mi-
croscopy (SIM) and photo activated localization microscopy (SMLM).

10.8.2 Principle of Structured Illumination Microscopy (SIM)

In SIM, a sinusoidal pattern, e.g. a 1D line grid pattern (Stripe SIM), or a 2D dot pattern (Lattice
SIM) with a defined periodicity, is positioned in the excitation path in a plane that is conjugated to
the image plane. Hence the pattern is projected onto the image and the excitation intensity is
modulated along the pattern. This results in a modulation of the fluorescence as well. The highest
modulation contrast is obtained in the focal plane. The contrast gets weaker with distance to the
focal plane, nevertheless depth discrimination in the axial direction is possible by the so-called Tal-
bot effect. The grid constant is ideally the cut off frequency of the system. The interferences of
the diffraction orders generated through the grid are used for the lateral and axial structuring of
the light.
The interference of the structured light with object structures requires that at least part of the
light is coherent and leads to so called Moiré fringes whose pattern has a longer periodicity and
hence a lower space frequency compared to the object. Each sample or object structure can be

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1302


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

regarded as a superimposition of many grids. Due to the structured illumination the object fre-
quencies will be shifted to lower frequencies due to the Moiré effect. Therefore high frequencies
that normally cannot be collected by the system can be transmitted due to their shift into lower
frequencies. Due to the diffraction nature of light, the modulation grid frequency cannot have a
periodicity that is smaller than half the wavelength, so resolution enhancement can be a maxi-
mum of two fold in each lateral and axial direction. Due to the frequency shift the image frequen-
cies are composed of non-shifted and shifted object frequencies and hence their contribution has
to be determined.
A coherent image generated with a sinusoidal line grid pattern has generally three different orders
created by interference: the 0th order from the 0th order non- diffracted beam, the 1st order cre-
ated by interferences of the ±1st order diffraction beams with the 0th order non diffracted beam
(frequencies shifted by half the modulation frequency), and the 2nd order created by the interfer-
ence between the +1st order with the – 1st order diffracted beam (frequencies shifted by the
modulation frequency). It is the 2nd order that contains the high frequency information for resolu-
tion enhancement in X and Y. The 1st order contains information for sectioning and better z-reso-
lution. The pattern generated with a linear grid is created by a three beam interference. In the
case of a 2D Lattice the pattern is generated by a 5 beam interference given rise to 7 orders.
To shift the frequencies to their correct location, a linear equation with five or thirteen unknowns
(2 x n-1, n=number of different orders, which is 3 in the case of a line grid and 7 in the case of a
2D Lattice) has to be solved. In the case of the 1 D line pattern, this can be accomplished pixel
wise by recording 5 images with a phase shifted modulation pattern. Since resolution is obtained
only in the orientation of the grid pattern, the grid has to be rotated to obtain a nearly uniform
resolution in all directions. In general one uses 3 rotations, which have proved to be sufficient for
a near isotropic resolution. Hence, the reconstruction of a SIM image requires a minimum of 3 x 5
= 15 images for a line grid pattern. Finally a back transformation from the frequency to the real
space generates the high resolution image. In Lattice SIM we have seven orders. Hence 13 (2 x 7 -
1) phase shifted images are minimally required. Since the Lattice SIM pattern is symmetrical, no
rotation is necessary.

10.8.3 Principle of Photo Activated Localization Microscopy (SMLM)

In SMLM the sample is illuminated in a regime that statistically activates only one fluorescent mol-
ecule per PSF. Hence, the center of mass of the PSF can be determined, which can be done more
precisely than the PSF itself. The localization precision depends solely on the number of collected
photons.
Since only a few molecules are active at a time, the procedure of converting molecules to the on-
state followed by deactivation to convert them to the off-state has to be repeated many times in
order to detect all labeled molecules. The aim in SMLM is to activate a few molecules at a time,
calculate their center of mass, plot them in a new coordinate system and deactivate them quickly
(preferentially after one to three frames) and repeat the process until statistically all molecules
have been activated. So a SMLM experiment easily needs 10 000 frames and more. The resulting
image is a plot of all molecules localizations with a certain precision depending on the photon
numbers obtained from the molecule.
Laser light is focused into the back focal plane of the objective to obtain widefield illumination in
the specimen. Dependent on the angle of a TIRF mirror, either Epi-, HILO- or TIRF-illumination is
achieved. Light emitted from the specimen is directed back via a reflector cube that separates the
emission from the excitation light. The fluorescence signals are directed to individual CMOS or sC-
MOS cameras.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1303


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

10.8.4 Starting the Software for Lattice SIM

1. Start the software as described in the general chapter, see Starting Software [} 22].
2. On the profile selection window, click ZEN Lattice SIM.
à The software starts and a dialog for stage/focus calibration is displayed.
3. Click Calibrate Now to start the calibration. This step is needed to obtain absolute stage
coordinates when the hardware was newly started. You can skip this step if the hardware
was not turned off after the last calibration.
à Stage/focus is calibrated and ZEN opens.
4. On the top of the Acquisition tab, go to the Sample Carrier section and click Select. Al-
ternatively, click Detect for an automatic sample carrier detection.
à A dialog to select a sample carrier template opens.
5. Select the sample carrier template that is used for the experiment and click OK.
à You have selected the sample carrier for your experiment.
6. On the Acquisition tab, open the Imaging Setup tool. Alternatively, you can also open
the Channels tool.
à The track selection is displayed.
7. Click +Lattice SIM to add a Lattice SIM track, + Apotome to add a SIM Apotome track, +
Laser Widefield to add a laser widefield track used for Localization Microscopy (SMLM), or
+ Widefield to add a widefield track using a thermal or LED light source.
You have started and prepared the software for Lattice SIM, SIM Apotome, laser widefield or
widefield, respectively . You can now set up your experiment.

10.8.5 Using SIM Processing in Direct Processing

ZEN offers the possibility to use SIM Processing in Direct Processing. For general information
about the Direct Processing functionality and the setup, refer to Direct Processing [} 219]. In
combination with SIM Processing, you have the possibility to either adjust the parameters of the
functions in the tool, or you can take the parameter settings from an already processed image,
which serves as reference image.

Prerequisite ü If you are using Direct Processing on different computers, you have connected acquisition and
processing computer, see Connecting Acquisition Computer and Processing Computer
[} 222].
ü To ensure that the processing computer reads incoming files and starts the processing, you
have clicked Start Receiving in the Direct Processing tool on the Applications tab. This is
usually active by default.
ü On the Acquisition tab, Direct Processing is activated. This activates the Auto Save tool as
well.
ü Depending on your settings, you have defined the folder where the acquired images are
stored in the Direct Processing or the Auto Save tool. Use a folder to which the processing
computer has access. For information about sharing a folder, see Sharing a Folder for Direct
Processing [} 238].
ü On the Acquisition tab, you have set up your experiment for image acquisition, with either a
Lattice SIM track, or a SIM Apotome track.
ü If you want to use the parameter settings of a reference image that has already been pro-
cessed with SIM Processing, you need to have this reference image open in ZEN.
1. On the Acquisition tab, open the Direct Processing tool.
à The parameters are displayed. In the processing pipeline, the first block is selected auto-
matically. With a configured SIM acquisition track, SIM Processing is preselected per
default.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1304


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

2. If the function is not preselected, go to the Processing Function dropdown list and select
SIM Processing.
à The parameters of the function are displayed. Note that not all parameters are available
in Direct Processing (e.g. Experimental PSF and Detrend are not possible). Additionally
the parameter for Histogram is preset to Scale to Raw, Baseline is set to Cut, and
both parameters cannot be changed.
3. Set all the parameters of the function for your experiment. For detailed information about
the parameters, see SIM Processing [} 1305].
à Your parameters are set for SIM Processing.
4. If you want to use the parameter setting from a reference image, activate Use Reference
Image and then click Select Reference Image.
à A window opens which displays all images open in ZEN.
5. Select your reference image.
à You have selected a reference image for processing. All parameters are set to the values
of the reference image and cannot be edited.
6. If you want to use another processing function after finishing SIM Processing, click Add
Function.
à A new container is added in the processing pipeline.
7. Select the new container, select the respective processing function from the dropdown,
and set the parameters for the function.
à You have defined a second processing that is executed after SIM Processing is finished.
8. Click Start Experiment to run the experiment. Note: You can pause the processing. If you
stop the experiment, requests that have been sent earlier by the acquisition computer are
not processed. However, already processed images will be retained.
à The images are stored in the folder you have defined in the Auto Save or Direct Pro-
cessing tool. When you abort the acquisition, the remote processing will not take place.
In case you have set up several processing functions, only the acquired image and the fi-
nal output image are stored.
à The processing computer reads incoming files and starts the processing. The path to the
selected folder, the currently processed image as well as the images to be processed are
displayed in the Direct Processing tool. The processed image is saved to the same
folder specified in the Direct Processing tool. If the image name already exists in this
folder, the new file is saved under a new name <oldName>-02.czi.
9. To cancel the processing on the processing computer, on the Applications tab, in the Di-
rect Processing tool, click Cancel Processing.
Once processing is finished, you are notified on the acquisition PC and can open and view the ac-
quired image as well as the processed image. This should be done on the processing computer, so
that you can immediately start a new experiment on the acquisition computer. However, you can
also automatically open the processed image on the acquisition PC with the respective setting in
the Direct Processing tool on the Acquisition tab.
Information about Direct Processing (e.g. the duration) is available on the Info view tab of the
processed image.

10.8.6 SIM Processing

Info
SIM Processing in Direct Processing
When you are using SIM Processing in Direct Processing, not all the parameters are available
and some are limited or preset to a specific value. For information on the use in Direct Process-
ing, see Using SIM Processing in Direct Processing [} 1304].

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1305


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

This method allows you to process a set of structured images acquired in SIM mode on ELYRA.
For datasets that additionally contain other types of image data ("mixed mode" files), this function
selectively processes the SIM data.

Parameter Description
Settings Enables you to manage settings, see General Settings [} 83].

Input Data Info Displays the image mode for the loaded image.

– Lattice SIM Image recorded with Lattice SIM mode.

– SIM Apotome Image recorded with SIM Apotome mode.

– Lattice SIM, Image recorded by Lattice SIM with Leap mode.


Leap

– SIM Apotome, Image recorded by SIM Apotome with Leap mode.


Leap

Time Range Selects the first and last image of a time series for processing. Default
is the full range.

Z-Range Selects the first and last plane of a z-stack for processing. Default is
the full range.

Burst Mode Switches between Block and Burst mode processing of 2D time series.
By default it is deactivated.
Activated: Uses Burst mode processing and activates sliding window
computation of a 2D time series.
Deactivated: Uses Block mode processing. Blocks of the defined
number of phases are processed.

– Sliding Win- Only available if Burst mode is activated.


dow Defines the size of the sliding window.

Adjust per Channel Only visible if your image has more than one channel.
Activated: Displays all channels of a multi channel image and all set-
tings are applied to the selected channel.
Deactivated: Settings are applied to all channels.

Processing Dimen- Selects how data should be processed (best option is selected based
sion on dimension of dataset).

– 2D Processes planes without consideration of out-of-focus light.

– 2D+ Processes planes with consideration of out-of-focus light (2D datasets


only).

– 3D Processes planes with consideration of neighboring planes (3D


datasets only).

– 3D Leap Reconstructs missing planes of leap mode recorded images (3D


datasets only).

Result Sampling Defines the sampling factor for the pixel size of the output image. By
default it is set to 2.

– 1 Maintains the pixel size of raw image in the output image.

– 2 Halves the pixel size of raw image in the output image (Nyquist sam-
pling for max. SIM resolution).

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1306


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

Parameter Description
– 3 Splits the pixel size of raw image into thirds in the output image.

– 4 Quarters the pixel size of raw image in the output image (Nyquist
sampling for max. SIM² resolution).

Processing Sam- Only available if SIM2 is selected


pling Defines the sampling factor for the pixel size of the input image. By
default it is set to 2.

– 1 Maintains pixel size of raw image, divides original pixel size in 1x1.

– 2 Halves the pixel size of raw image, divides original pixel size in 2x2.

– 3 Splits the pixel size of raw image into thirds, divides original pixel size
in 3x3.

– 4 Quarters the pixel size of raw image, divides original pixel size in 4x4.

Algorithm Selects which algorithm is used for SIM image processing.

– Widefield Selects widefield processing, i.e. averaging of phases and displays rel-
evant widefield processing parameters.

– SIM Selects SIM processing (one-step linear deconvolution) and displays


relevant SIM processing parameters.

– SIM2 Selects SIM2 processing (iterative non-linear deconvolution) and dis-


plays relevant SIM2 processing parameters.

Sharpness Settings Only available if Auto Sharpness is activated.


Selects a pre-setting for Wiener filter estimation.

– Weak Subtracts '1' from the estimated Wiener filter.

– Standard Uses the estimated Wiener filter unchanged.

– Strong Adds '1' to the estimated Wiener filter.

Auto Sharpness Sets the Wiener filter for SIM processing.


Activated: The Wiener filter is estimated automatically.
Deactivated: Sets the Wiener filter manually.

Sharpness Only available if Auto Sharpness is deactivated.


Sets the sharpness filter value via the slider (the higher the number,
the less high frequencies are filtered out).

Order Combination Selects how orders are summed up.

– Wiener Filter Sums up the orders by Wiener filtering.

– Simple Sum Uses a simple order sum (all weights are 1).

– Weighted sum Uses a sum with somewhat over-weighted higher orders.

Regularization Only visible if SIM2 is selected.


Defines the method of regularization.

– None No regularization is applied.

– Total Varia- Uses total variation to keep surfaces as flat and edges as sharp as pos-
tion sible.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1307


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

Parameter Description
– Tikhonov Uses the Tikhonov Miller method for smoothing of objects.
Miller

Regularization Sets the strength of the regularization weight with the slider (only
Weight meaningful if Total Variation or Tikhonov Miller is selected; default
is zero).

Iterations Only visible if SIM2 is selected.


Defines the number of iterations in iterative SIM processing mode.

Filter Selects a noise filter for input image.

– No Filter Applies no filter.

– Gauss Applies a Gauss filter to the input image. A Gaussian filter acts as a
low pass filter for reducing noise (high frequency components) and
blurring regions of an image. The filter is implemented as an odd
sized Symmetric Kernel (DIP version of a Matrix) which is passed
through each pixel of the Region of Interest to get the desired effect.

– Median Applies a median filter to the input image. The principle of the median
filter is to replace the gray level of each pixel by the median of the
gray levels in a neighborhood of the pixels, instead of using the aver-
age operation. For median filtering, we specify the kernel size, list the
pixel values, covered by the kernel, and determine the median level.

Fitting Selects how the parameters are fitted.

– No Fit Takes theoretical parameters.

– Fast Fit Estimates parameters for the whole image.

– Best Fit Estimates parameters for quadrants of the image.

Histogram Defines how the image is scaled according to the gray values.

– Scale to Min/ Scales the histogram rang to the maximum dynamic range.
Max

– Scale to Raw Keeps the histogram range from the raw image.

Baseline Only visible if SIM is selected.


Selects how background noise is treated.

– Cut No offset is applied with negative values clipped by setting them to


zero.

– Shifted Offset is applied with negative values kept, so that the minimal (nega-
tive) intensity becomes zero intensity.

Detrend Selects the compensation of bleaching (decrease in intensity) over


time in a 2D time series.
Activated: Applies compensation for bleaching.
Deactivated: Applies no compensation for bleaching.

Experimental PSF Activated: Allows you to attach an experimental PSF which is used
for processing.
Deactivated: Uses theoretical PSF for processing.

Defaults Resets all parameters to default values.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1308


10 Systems & Components | 10.8 Lattice SIM Family ZEISS

See also
2 General Settings [} 83]

10.8.7 Localization Microscopy Processing

Parameter Description
Settings Enables you to save and reload the adjusted settings, see also General
Settings [} 83].

Dimension Selects how events are fitted.

– 2D Fit is done according to Thompson formula with theoretical PSF.

– 3D Fit is done according to Markov simulation with experimental PSF.

Feature Size (px) Defines the peak mask size (radius) in pixels for a detected peak inten-
sity that will be used to cut out the peak and put the peak into a new
coordinate system.

Peak Finder Area to define parameters to find a peak.

Peak Quality Defines the peak intensity to noise ratio, i.e. the threshold of the sig-
nal strength of an identified peak over background at which the peak
is regarded to be genuine.

Localizer Area to define parameters to localize a peak.

Fit Model Selects the fit model used to define a peak.

– Mask Fit Uses a Gaussian mask with a defined PSF according to the set PSF
Half Width value to match the intensity distribution of a peak in x
and y as best as possible.

– Gauss Fit The intensity distributions of the identified peaks are fitted to a full 2D
Gaussian function. The fit in each direction considers the influence of
the other direction (x, y 2D Gauss).

– Experimental Allows you to attach a PSF via the Input tool to the loaded input im-
PSF age. The attached PSF will be used to fit the peak in x and y for a 2D
dataset and in x, y and z by simulation.

Overlapping Mole- Allows you to select how overlapping molecules should be treated.
cules

– Discard Only single emitters are considered and fitted, whereas all multi-emit-
ter events are discarded (single emitter setup).

– Ignore All single and multi-emitter events are considered and fitted as single
emitter events (ignore emitter setup).

– Account For Multi-emitter events are fitted considering the overlap (multi-emitter
setup).

– Maximum Selects the maximum number of molecules in the cluster that are used
Cluster Size for computation for Account For setup.

– PSF Half Sets the PSF width (1/2 FWHM) for Account For overlap setup.
Width

See also

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1309


10 Systems & Components | 10.9 Viluma 9 ZEISS

2 General Settings [} 83]

10.9 Viluma 9

10.9.1 Controlling the Viluma 9 Light Source with the Microscope Tool or Imaging
Setup Tool

Prerequisite ü The Viluma 9 is attached and connected to the microscope.


ü The light source is configured in the MTB.
ü The microscope is switched on and ZEN is started.
1. Open the Locate or the Acquisition tab.
à The respective tools for the tabs are displayed.
2. On the Locate tab, open the Microscope Control tool. If you are on the Acquisition tab,
open the Imaging Setup tool and select an acquisition track.
à The light path controls are displayed in the tool.
3. Click the icon for the Viluma 9 light source.
à The light source settings and wavelengths are displayed. The wavelengths of the inte-
grated filter wheel are displayed as a block. Note that switching between LEDs of this in-
tegrated filter wheel takes slightly longer than for the other LEDs.

4. Make sure that Show All is activated.


à All controls are available.
5. Activate all required LEDs and set the brightness.
à The light source is ready.
6. If you want to run a triggered acquisition, go to the light source settings and select Gated.
à You have switched to the Gated mode which allows the direct control of LEDs via the
trigger output of the camera.
7. On the Acquisition tab, open the Acquisition Mode tool.
à Settings for acquisition parameters are displayed.
8. Open the Fast Acquisition section and click Triggered.
à You have switched to triggered acquisition. A checkmark in a green circle indicates that
triggered acquisition is possible.
9. Start your acquisition experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1310


10 Systems & Components | 10.9 Viluma 9 ZEISS

10.9.2 Controlling the Viluma 9 Light Source with the Channels Tool

Prerequisite ü The Viluma 9 is attached and connected to the microscope.


ü The light source is configured in the MTB.
ü The microscope is switched on and ZEN is started.
1. Go to the Acquisition tab and open the Channels tool.
à The track selection is displayed.
2. Make sure that Show All is activated for the tool and select an acquisition track. Alterna-
tively, you can set up your channels with Smart Setup.
à The settings for your track are displayed.
3. From the Lightsource dropdown, select the Viluma 9.
à The light source settings and wavelengths are displayed. The wavelengths of the inte-
grated filter wheel are displayed as a block. Note that switching between LEDs of this in-
tegrated filter wheel takes slightly longer than for the other LEDs.

4. Activate all required LEDs and set the brightness.


à The light source is ready.
5. Start your acquisition by clicking Live, Continuous, or Snap.
à Your acquisition starts. The button changes to Stop to stop the running acquisition.
6. If you want to run a triggered acquisition, go to the light source settings and select Gated.
à You have switched to the Gated mode which allows the direct control of LEDs via the
trigger output of the camera.
7. On the Acquisition tab, open the Acquisition Mode tool.
à Settings for acquisition parameters are displayed.
8. Open the Fast Acquisition section and click Triggered.
à You have switched to triggered acquisition. A checkmark in a green circle indicates that
triggered acquisition is possible.
9. Start your acquisition experiment.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1311


11 Maintenance | 11.1 Creating a Service Report ZEISS

11 Maintenance
11.1 Creating a Service Report

The service report contains log files from MTB and ZEN. If you want to create a Service Report,
the following steps are necessary.

1. In the menu bar, click Help > Create Service Report...


à The Enter Information for the Service Report dialog opens.

2. Enter date, time, and an useful description of the issue occurred and the reason for creating
this service report.
3. To include additional files to the report, click Add.
à The Windows Explorer opens.
4. Open the folder with the file to be added.
5. Select the file.
6. Click on Open.
à The Windows Explorer closes. Location and file name of the added file are shown in the
display field.
7. To remove a file from the display field again, select it and click Remove.
8. If required, activate Open file location in Windows Explorer after report is created.
9. Click Create report.
The System information window appears, showing the storage progress.
If the window closes, you have successfully created the Service Report.
This process might take several minutes depending on the system, size of the logs and if the Win-
dows system information is collected too. The storage location of the Service Report is C:/Pro-
gramData/Carl Zeiss/Remote Service.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1312


11 Maintenance | 11.2 Requirements for Docker Desktop ZEISS

11.2 Requirements for Docker Desktop

For some functionality, you additionally need the software Docker Desktop on your PC to be able
to use it. This includes the download and use of dedicated AI models (e.g. for instance segmenta-
tion) and the execution of arivis Cloud modules with the arivis Cloud (on-site) functionality. You
have to install Docker Desktop by yourself (it is not provided by ZEISS via the ZEISS Microscopy In-
staller) and register/sign in with an account. Note that Docker also requires a paid subscription for
commercial use, so you need to choose a correct license. For information on how to install Docker
Desktop, always refer to the latest documentation provided by Docker itself, see https://
docs.docker.com/desktop/install/windows-install/, or generally https://docs.docker.com/.
Docker Desktop has its own system requirements, which are detailed in their documentation
(https://docs.docker.com/desktop/install/windows-install/). Always refer to the current information
provided by Docker. As of July 2024 there are the following system requirements:

§ Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version
21H2 or higher.
§ Recommended Windows 10 64-bit versions: Home or Pro 22H2 (build 19045) or higher, or
Enterprise or Education 22H2 (build 19045) or higher (Download: https://www.docker.com/
products/docker-desktop).
§ Minimum required Windows 10 64-bit versions: Home or Pro 21H2 (build 19044) or higher,
or Enterprise or Education 21H2 (build 19044) or higher.
§ For Windows 10 Enterprise LTSC 2019 (version 1809) a docker version lower than 4.24.2 is
required and can be downloaded from here: https://docs.docker.com/desktop/release-notes/
§ BIOS-level hardware virtualization support must be enabled, see also https://docs.docker.com/
desktop/troubleshoot/topics/#virtualization.
§ 64 bit processor with Second Level Address Translation (SLAT)
§ 4GB RAM. For the use of AI models the recommended hardware configuration is 8GB GPU
and 64GB RAM. Only NVIDIA GPUs and the CPU are supported.
§ The WSL 2 feature on Windows has to be installed and enabled, see also https://
docs.docker.com/desktop/windows/wsl/.
§ WSL version 1.1.3.0 or later.
§ If your version of Windows does not support the WSL2 feature, Hyper-V and Containers Win-
dows Features must be enabled.
If you cannot use WSL2, the resources allocated to Docker are not automatically managed by
Windows and might not be big enough in certain instances. In such a case, you can also adapt
the resource allocation manually.
Additionally, Docker Desktop has experimental features that are activated by default, which can
lead to an increased resource consumption (e.g. disk space). Such features can also be deacti-
vated manually.
If you work with Docker on a system with multiple Windows users, always sign-out from your
Windows account to initiate a shutdown of Docker when you have finished your work. Otherwise
the other users may have problems to use Docker with ZEN core.

Hyper-V System Performance Disclaimer


If Hyper-V is enabled in Windows, be aware that this might affect the overall PC system perfor-
mance and, therefore, could lead to longer processing times or to reduced acquisition perfor-
mance in the software. The ideal case would be to use arivis Cloud (on-site) on a dedicated,
powerful workstation that is not directly attached to a microscope. Enabling the BIOS level hard-
ware virtualization does not influence the system performance and can be left switched on.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1313


11 Maintenance | 11.2 Requirements for Docker Desktop ZEISS

Hardware Recommendations:

§ ZEISS MidRange Workstation


§ 64 GB RAM or more (32 RAM dedicated to Docker Desktop)
§ For the use of AI models the recommended hardware configuration is 8GB GPU and 64GB
RAM. Only NVIDIA GPUs and the CPU are supported.

See also
2 arivis Cloud (on-site) [} 206]
2 Downloading AI Models [} 71]
2 Importing AI Models [} 72]

11.2.1 Adapting the Resource Allocation for Docker Desktop Manually

If you cannot use WSL2, the resources allocated to docker are not managed by Windows and
might not be big enough in certain instances. In such a case, you can adapt the resources manu-
ally in Docker.

Prerequisite ü Docker is running on your PC.


1. Open Docker Desktop and go to the settings.
2. In the menu on the left, click Resources.
à The Advanced tab displays options for resource allocation on the right.

3. Adapt the resources with the individual sliders.


4. Under Resources, click File sharing.
à The option for file sharing is displayed on the right.
5. Enter any path where data is read from and put to.
6. Click Apply & restart.

11.2.2 Deactivating Experimental Docker Features

Prerequisite ü Docker is running on your PC.


1. Open Docker Desktop and go to the settings.
2. In the menu on the left, click Features in development.
3. Click Experimental features.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1314


11 Maintenance | 11.2 Requirements for Docker Desktop ZEISS

à The tab displays currently available experimental features.


4. Deactivate the feature(s) and click Apply & restart.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1315


12 FAQ | 12.1 What can I do If my image is too dark? ZEISS

12 FAQ
12.1 What can I do If my image is too dark?

Try to increase the exposure time by performing the following settings:

§ in the Locate tab click on the Set Exposure button. This will calculated the correct exposure
time automatically.
§ in the Camera tool manually adjust the Time slider until you achieve the desired result.
§ in the General View Options > Display tab adjust the display curve, see chapter Adjusting
Live Image Settings [} 35].

12.2 How can I balance my images color?

To perform an automatic or manual white balance you must use a color camera. In the Left Tool
Area > Locate tab > Camera tool the White Balance section appears. There you can perform
a white balance with one of these methods:

Auto Method:
1. Move the sample out of the Live window’s field of view, so that you only see the back-
ground (essentially the light source).
2. Click on the Auto button.
3. The white balance will be calculated automatically. Afterwards move your specimen back
into the field of view.

Interactive/Pick… Method:
1. Click on the Pick… button.
2. Click on a white area of the Live window which should be represented as white.
This area will be used as a reference for the white balance.

3200K Method:
Use this method if working with a halogen bulb.

1. If available set the light source to 3200K by pressing the 3200K button located on the
body of the microscope.
2. Click on the 3200K button.
This method is also largely depending on the quality/age of your bulb. If the color rendition is not
as desired, try the Auto or the Interactive/Pick_ methods above.

5500K Method:
Use this method if working with a LED.

1. Click on the 5500K button.


2. If the color rendition is not as desired, try the Auto or the Interactive/Pick… methods
above.
If none of the above methods produce a satisfactory result, one can additionally manually adjust
the Color Temperature slider.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1316


12 FAQ | 12.3 How can it be that my image has dust or a shadow, although my specimen is
clean? ZEISS

12.3 How can it be that my image has dust or a shadow, although my specimen is
clean?

If the dust is not on your specimen, then the best method is to clean the optical elements that lay
in the imaging pathway of your microscope. However if that poses a problem, alternatively, you
can perform a Shading Correction as shown below. This solution has some limitations, especially
if the dust is very dark or thick.

1. Move your sample out of the Field of View until you see nothing but the light source/dust.
2. In the Camera tool, in the Post Processing section, click on the Channel Specific button.
3. Move your sample back into the Field of View.

12.4 Why my image seems to look that something have burned in? (i.e. a shadow of a
previous specimen?)

Check that The Shading Correction of the previous experiment is not already adjusted.

1. In the Camera tool open the Post Processing section


2. Deactivate the Shading Correction checkbox.

12.5 How can I fix a color gradient cast?

To fix a color gradient cast, you can try the following:

1. Move your sample out of the Field of View until you see nothing but the light source.
2. In the Camera tool, in the Post Processing section, click on the Channel Specific button.
3. Move your sample back into the Field of View.
4. Perform a White Balance, see chapter How can I balance my images color? [} 1316]

See also
2 Why my live image shows extreme colors in comparison to what I see in the eyepieces?
[} 1318]

12.6 What can I do if my live image is of a low quality and looks pixelated?

1. In the Camera tool > Mode section in the Live Speed dropdown list select the entry
Slow.
2. Right-click on the live image and select the Fit to View entry.
3. Optionally, you can also , in the Dimensions tab, activate the Interpolation checkbox.

12.7 What can I do if my live image is slow?

Solution A
The live speed of your image is possibly set too slow. Increase the Live Speed.

1. In the Camera tool in the Mode section, select a faster speed from the Live Speed drop-
down menu. There are at most three choices, depending on the camera: Slow, Medium,
Fast.

Solution B
The exposure time is possibly set to high, respectively improper. Optimize your settings in the
Camera tool, in the Exposure time section.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1317


12 FAQ | 12.8 What can I do if my live image is mostly red/blue? ZEISS

1. On the Locate tab click on the Set Exposure button.


2. Alternatively in the Camera tool click on the Set Exposure button.
3. Manually adjust the Time slider until you achieve the desired result.

12.8 What can I do if my live image is mostly red/blue?

Check whether the checkbox Range Indicator is activated. If this is the case, the display switches
to the Single Channel mode. The channel will be displayed monochrome. Simultaneously you
see areas where the camera sensor is saturated, shown in red. Areas in which the pixel values = 0,
are shown in blue. If this is not needed anymore deactivate the checkbox.

12.9 What can I do if my live image is still black or white after setting the exposure?

Check to see that your display curve is not set all the way to the left/right. Try to reset the display
curve by clicking in the Display tab on the Reset button to achieve the default setting.

12.10 Why my live image shows extreme colors in comparison to what I see in the
eyepieces?

The reason could be, that your display curve is not adjusted.

1. Open the Display tab.


2. Click on the Reset button.
3. Click on the 0.45 button or set Gamma 0.45.
4. You can additionally click on Min/Max or Best Fit button.

See also
2 Why is my image color not the same that I see through the eye pieces? [} 1318]

12.11 Why is my image resolution lower than the given camera specification?

Because you chose a wrong or improper setting.

Prerequisite ü You are on the Locate tab.


1. In the Camera tool, in the AcquisitionROI section, click on the Maximize button.
2. In the Mode section check that Binning is set to 1x1.

12.12 What can I do if I do not see a focused live image?

Refocus the specimen on the microscope. You may activate the Focus Bar as an additional aid.

1. Open the context menu via right-click in the Live image.


2. Select the entry Focus Bar.
The Focus Bar will be shown within the Live image now.

12.13 Why is my image color not the same that I see through the eye pieces?

This is largely dependent on the color of your light source. The following instruction assumes that
your light source is set to white.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1318


12 FAQ | 12.14 What should I do to adjust parameters of a SWAF run prior to using it in experi-
ments? ZEISS

1. In the Camera tool, in the Settings section click on the Default button, to set the camera
back to factory default.
2. Click on the Set Exposure button.
3. In the Display tab, click the 0.45 button. If you do not see this button, activate the Show
All mode.

See also
2 How can I balance my images color? [} 1316]

12.14 What should I do to adjust parameters of a SWAF run prior to using it in


experiments?

In the first instance test the SWAF with the default settings and select an appropriate channel to
be the reference channel – remember that you can uncheck the reference channel in the Channels
tool i.e. so that it will not be imaged, but will still be used for a focus strategy or SWAF. Consider
using a transmitted light channel if possible as this will not be subject to bleaching. Remember
that the sample plane that returns a maxima from the SWAF run is not necessarily the same plane
as that which you’re interested in imaging.
If this is the case, then you need to capture z-stacks with a suitable range or make use of the fo-
cus offset function that allows each channel to be offset by a relative value in z to the reference
channel. Typically, once you have established that a maxima can be reliably found with the default
SWAF parameters you might want to consider optimising the SWAF run by modifying the parame-
ters to reduce the time required to complete it or to reduce sample exposure (phototoxic stress
levels).

12.15 The SWAF returns an error message. What does this mean and how can I correct
this?

The most typical error encountered is that the SWAF run does not find (return) a clear maxima
and hence fails (hits so called search boundary). This might be because the step size set is too
course (i.e. the maxima is missed occasionally) or the search range does not contain a clear sharp-
ness maxima e.g. due to lower contrast/ intensity (signal to noise) or a lack of signal.
This can happen, for example, at the 1st tile (upper left) of a tile region which is empty such as is
often that case in the corners of such tile regions. In this case it is possible to modify the SWAF fo-
cus strategy in the Tile Region loop such that the SWAF will be executed at the centre of the tile
region. In ZEN 2.3 and higher if a SWAF failure occurs at a given loop entity then a fall-back ap-
plies such that the initial or last known z value will be used.

12.16 SWAF returns a failure after reaching a search boundary – what`s wrong?

If you are able to optimize the SWAF and the reference channel is typically robust for this then the
solution might require that you look at the overall stability of the focus due to environmental vari-
ables such as vibrational isolation, temperature flux, evaporation of fluid from sample vessels, or
poor lighting conditions (extraneous light).
Generally, if these are optimized then better overall results can be expected, if this is not the case
then the fluctuations they cause might be the source of such reliability problems when detecting
the sharpness maxima. Other things to consider are optical disturbances such as loss or poor im-

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1319


12 FAQ | 12.17 When should I use the Full or Smart setting? ZEISS

mersion of the objective (bubbles), or artefacts caused by sample characteristics (for example (cell)
debris moving across the FOV during the SWAF run). Perhaps it is possible to use a fiducial marker
if the sample allows this (see Auto Focus ROI above).

12.17 When should I use the Full or Smart setting?

This depends entirely on the sample in question and manner in which it is imaged (e.g. reflected
or transmitted light). However, if we are to generalize then the answer might simply be given as
follows. A Full search will return the global sharpness maxima from the entire search range de-
fined in the SWAF tool. The search always runs in one direction i.e. the z-movement of the actua-
tor is unidirectional always moving against gravity.
Smart on the other hand is intended for quickly* detecting a local sharpness maxima by allowing
a bidirectional search pattern. Thus, the full setting is typically a more extensive search that takes
longer to accomplish. However, the smart setting may be suitable and saves a great deal of time
and reduces sample light exposure.
*Typically, it will be the case that Smart is faster, but under some circumstances it might be
slower. This will likely be the case when the maximum is far away from the starting position.

12.18 Can I change camera parameters in a SWAF run e.g. exposure time or binning?

In the implementation of SWAF in ZEN blue version 2.1 and earlier it was not possible to change
the acquisition parameters directly. The exposure time setting using by the SWAF is based on the
exposure time setting of the reference channel. Thus, longer exposure times of the reference
channel increase the exposure time employed by the SWAF up to a maximum of ca. 100 ms.
Thus, weak signals in the reference channel may cause an increased likely hood that no clear max-
imum will be found. Binning settings of a camera used by the reference channel are not taken
into account and SWAF always uses 1x1 binning – this may cause issues with cameras processing
smaller pixels (e.g .new AxioCam models).
In ZEN Blue version 2.3 and higher the SWAF has be further adapted to address the described lim-
itations. Thus, exposure times defined for the Reference channel are used even when these ex-
ceed 100 ms. Settings that apply to all the channels defined in the acquisition mode tool still ap-
ply to the SWAF i.e. an independent binning setting for the reference channel is not yet possible.
Thus, please take this into account when setting up your SWAF parameters. In addition, the SWAF
run has been streamlined and can make use of triggered acquisition when supported by the cam-
era making the SWAF run ca. a factor of two faster than in previous versions.

Software Manual ZEISS ZEN 3.11 | en-US | Rev.1 1320


Glossary ZEISS

Glossary
Airyscan Principle ApoTome Bleaching correction
A classic confocal microscope illumi- The main reason for residual stripe
nates one spot on your sample to de- artifacts in ApoTome images is the
tect the emitted fluorescence signal. fact, that acquiring at least 3 grid im-
Out-of-focus emission light is rejected ages for one resulting processed im-
at a pinhole, the size of which deter- age leads to bleaching of the fluores-
mines how much of the airy pattern cent dyes. This bleaching leads to
reaches the detector. You can in- brightness differences in the raw im-
crease the resolution by making the ages and to artifacts when processing
pinhole smaller, but signal-to-noise the data uncorrected. The principle
drops significantly since less valuable for correcting bleaching in widefield
emission light is passing through. data is the fact, that no matter, how
With Airyscan ZEISS introduces a new far away from the focal plane the de-
concept. Instead of throwing light tector is placed, the sum intensity
away at the pinhole, a 32 channel emitted from the sample remains the
area detector collects all light of an same. This is also true for the grid im-
Airy pattern simultaneously. Each de- ages. This fact is being used for the
tector element functions as a single, ApoTome. Two methods exist, both
very small pinhole. Knowing the of which are patented.
beampath and the spatial distribution
of each Airy pattern enables a very Binning
light efficient imaging: you can now Binning is understood to mean the
use all of the photons that your ob- combination of neighboring image el-
jective collected. ements (pixels) on the image sensor
itself, e.g., the CCD sensor in a digital
ApoTome - Global bleaching camera. Source: Wikipedia
correction
For each raw image the total (sum) Bleaching Correction
intensity is measured and a global de- The characteristics of a widefield flu-
cay curve determined. This decay fac- orescence microscope are based on
tor is used to correct the brightness the assumption that all Z-planes have
of all pixels in the raw image. This the same total brightness, irrespective
method is suitable for samples with of the focus position. Use is made of
only one fluorescent dye present. bleaching correction by applying a
correction factor to each Z-plane.
ApoTome - Local bleaching However, this assumption does not
correction apply to techniques that result in the
If more than one fluorescent dye is generation of optical sections, such
present in the sample, a single decay as confocal images.
curve cannot be used to correct
bleaching. This is the case for most Burst Mode
biological samples especially when Burst Mode is some kind of optimiza-
considering the contribution of aut- tion to enable the recording of the
ofluorescent substances to the total fastest framerates, which can be
signal detected. The solution is to use achieved by the used camera hard-
a local bleaching correction determin- ware. This mode requires some com-
ing a decay factor for each individual promises for the sake of speed: it
pixel position in each raw image supports only single channel time
which effectivel removes artifacts also lapse acquisition, an update of the
for complex dye combinations. image display is suppressed while

Software Manual ZEISS | en-US | Rev.1 1321


Glossary ZEISS

recording and the maximum time tion results from the pixel-by-pixel
lapse duration is depending from the comparison of intensities for each
size of available main memory (minus channel.
some space to breathe for the oper-
ating system). If a multi channel im- Constrained Iterative
age needs to be acquired, Burst The best image quality is achieved us-
Mode will be disabled and maximum ing the iterative maximum likelihood
frame rate can be slower then speci- algorithm (see Schaefer et al.: 'Gener-
fied in the camera hardware perfor- alized approach for accelerated maxi-
mance documentation. mum likelihood based image restora-
tion applied to three-dimensional flu-
Clipping planes orescence microscopy', J. of Mi-
The purpose of clipping planes is to croscopy, Vol. 204, Pt 2, November
cut open the calculated 3D image so 2001, pp. 99ff.). This algorithm is
that elements on the inside can be vi- able to calculate light from various
sualized. Clipping planes can cut the focal planes back to its place of ori-
volume in such a way that either the gin. Consequently, with this method
front, back or both sides of the vol- it is possible to derive the 3D struc-
ume data are no longer visible. In ad- ture from fluorescence images with
dition, the clipping plane itself can be the correct brightness distribution
given various textures. This is a very and to visualize optical sections. It is
important modeling option for ana- also possible for missing information
lyzing 3D data. to be partially restored from neigh-
boring voxels. The spatial resolution
Colocalization can be increased without artifacts up
Acquiring fluorescence images in sev- to a theoretical limit (one voxel). It is
eral channels makes it possible to vi- essential for z-stacks to have been ac-
sualize the relationship between bio- quired in accordance with Nyquist.
logical structures. A combined display Acquiring sufficient planes above and
of two channels in color overlay below the structure of interest is also
mode makes it easier to assert imperative for achieving good results.
whether the components are colocal- As this is a complex mathematical
ized, i.e. whether they are located at method, the calculation can take
the same position. Conventionally, longer, depending on the image size
two fluorescence channels are dis- and the PC being used.
played in the form of a color-coded
overlay. The most common form is Costes
the red/green overlay. Regions in Costes et al. (Biophysical Journal,
which both fluorescent dyes are 2004, vol. 86, pp 3993-4003) have
present at the same place are dis- published a statistical method with
played in yellow. It is not possible, the help of which an attempt is made
however, to make quantitative state- to determine an optimal colocaliza-
ments concerning the extent of colo- tion threshold automatically. This
calization on the basis of this display. takes place by initially maximizing the
At best, a qualitative statement is threshold for both channels and then
possible with regard to whether or gradually reducing it. With each step
not two dyes are colocalizing. The Pearson's Correlation Coefficient is
Colocalization module is able to fill determined for all pixels below the
this gap and presents the user with a set value. These steps are repeated
tool that enables colocalization to be until the Pearson value is minimized
determined quantitatively. Principle: It (ideally a value of 0 for perfectly colo-
is always the colocalization of two calizing channels). See the publication
channels that is analyzed. Colocaliza- for further details. This method has
been implemented in Colocalization.

Software Manual ZEISS | en-US | Rev.1 1322


Glossary ZEISS

Clicking on Auto initiates the above of the point spread function (PSF). If
iterative process, which, depending the PSF is known, it is possible to cor-
on the sample, can take several sec- rect the negative effects to a large
onds. The threshold now set corre- extent using deconvolution. This pro-
sponds to the confidence criterion duces a completely sharp image of
calculated. This method works very the object that is richer in contrast.
well with large, diffusely stained Deconvolution is usually performed
structures such as nucleoplasm or dif- on Z-stacks, i.e. it is used as a 3D
fuse cytoplasmic structures. Under method. However, it can also be used
certain circumstances it does not to a limited extent to improve 2D im-
function so well for small structures ages. A good review of deconvolu-
(e.g. nuclear speckles or vesicular tion can be found in Wallace et al.,
structures), particularly in the case of 2001: A Workingperson's guide to
widefield images, where the signal to deconvolution in light microscopy;
background ratio is not as good as it Biotechniques 31: 1076-1097.
is with methods that involve the gen-
eration of optical sections (e.g. LSM, Discrete Fourier Transform
TIRF or ApoTome). The Regions but- The Discrete Fourier Transform func-
ton becomes active as soon as a re- tionality is based on the publication:
gion is inserted into the scatter plot. "Multiple imaging axis microscopy
It remains active as long as regions improves resolution for thick-sample
are selected or moved there. Activat- applications", Jim Swoger, Jan
ing and deactivating the button Huisken, and Ernst H. K. Stelzer, OP-
makes it possible to switch between TICS LETTERS / Vol. 28, No. 18 / Sep-
threshold selection using the mouse tember 15, 2003
and the selection/moving of selected
regions in the scatter plot image. If Display characteristic curve
regions are defined in the scatter
plot, the corresponding data appear The display characteristic curve allows
in the table in addition to the overall you to define the range of the gray
image. value histogram of an image that you
want to display on the screen. The
limit on the left defines the gray value
Deconvolution
up to which all pixels are displayed as
Deconvolution is a method that is pure black (black value), while the
used to improve fluorescence images limit on the right defines the gray
in particular. Image information ac- value from which all pixels are dis-
quired using a microscope system can played as pure white (white value).
never fully reproduce the structures The curvature of the curve defines
of the actual object. This is because the so-called gamma value.
unavoidable distortions occur during
acquisition due to the optics and Drag&Drop
electronics. In addition, particularly in
the case of fluorescence microscopes Literally translates to "drag and
that do not offer any methods for drop". Does the moving of objects
generating optical sections, light (eg, files, icons, etc.) on the screen as
from areas of the object outside the from one folder to another. Clicking
objective's focal plane is also always the object with the left mouse but-
acquired. This covers the structures ton, holding down these, the object
that the user actually wants to see to moves with the mouse to the desired
a varying degree and therefore leads location.
to a reduction in the contrast and
consequently in the visible resolution.
These optoelectronic effects can be
described mathematically in the form

Software Manual ZEISS | en-US | Rev.1 1323


Glossary ZEISS

Dynamic range FCS


The dynamic range describes the Fluorescence Correlation Spec-
number of brightness gradations that troscopy
a camera or another detector is able
to distinguish. Modern, scientific digi- Field Feature
tal CCD cameras, for example, have a A field feature is calculated for all
dynamic range of up to 2^16 gray segmented objects of a class. The
levels. In this case we talk of 16 bit geometric or intensity parameters of
cameras. all objects of the class, e.g. the area
or the average intensity, are added
Experiment Feedback together. In addition, all objects can
Experiment feedback allows the defi- be counted, for example, or the area
nition of specific rules and actions to of the objects in relation to the total
be performed during an experiment. image area can be calculated as a
This allows changing the course of percentage.
the course of an experiment depend-
ing on the current system status or Fluorescent beads
the nature of the acquired data on Fluorescent beads are often used to
runtime. Moreover, it is possible to measure the point spread function
integrate certain tasks like data log- (PSF). The diameter of these beads is
ging or starting an external applica- usually significantly below the resolu-
tion, directly into the imaging experi- tion limit of the objective used. Based
ment. Typically, but not exclusively, on the known shape and size, various
such an experiment connects the im- optical parameters of the microscope
age pickup with an automatic image system can be determined with the
analysis. help of such objects. To measure the
PSF when using an objective with a
Fast Iterative numerical aperture of 1.4, beads with
The Fast Iterative method is an itera- a diameter of 50-170 nm should be
tive restoration method that uses used.
only one iteration per convolution
step (see Meinel, E. S.: Origins of lin- Fourier Filter
ear and nonlinear recursive restora- The processed result ApoTome image
tion algorithms. J.Opt.Soc.Am, 3 (6), can sometimes still show fine residual
1986, 787-799). No regularization is line artifacts. This is due to sample,
used in this case. Due to the fast pro- staining, dynamic range during acqui-
cessing and convergence after just a sition or exposure time used. These
few iterations, this method is suitable artifacts can be removed using the
in particular for the processing of Fourier Filter option. This function
larger time lapse images. The results makes use of the fact, that stripe arti-
of the method can quickly lead to facts appear as a group of dots in fre-
good results and remove most of the quency space. The filter masks those
out-of-focus light. They do not, how- dots and can in this way remove
ever, create quantitative brightness stripe artifacts from the image. It only
conditions in the image. If undersam- works however, if the camera had
pled images are present, artifact for- been aligned parallel to the grid lines
mation may also result. during phase calibration. Also, it is
quite a crude method and should not
FCCS be needed if all other preconditions
Fluorescence Cross-Correlation Spec- for using the ApoTome have been
troscopy met.

Software Manual ZEISS | en-US | Rev.1 1324


Glossary ZEISS

Gamma value allows you to complete even complex


The gamma value makes it possible measurement tasks in just a few min-
to correct the display of images on utes.
computer screens which do not allow
the linear display of gray value Image display
curves. By changing the gamma value A maximum range of 256 gray levels
you can emphasize certain intensity (black and white image) or 16 million
ranges within your image when it is colors can normally be displayed on a
displayed on the screen. A value <1 screen. Modern digital cameras cap-
emphasizes the ranges of medium ture a much larger range: black and
pixel intensity (medium gray values), white cameras up to 65536 values
while a value >1 emphasizes the dark and color cameras theoretically up to
and bright pixel intensities and there- (65536)3 colors (281 billion). The dis-
fore increases the contrast. The rec- play of these gray values/colors there-
ommended settings are 0.8 for fluo- fore needs to be adjusted for the
rescence images, 1.2 for phase con- monitor by the user. For this adjust-
trast or DIC images and 0.45 for true ment an upper and a lower gray/
color images. Please bear in mind color value are defined. All gray/color
that a "correct" gamma value setting values between these limits are dis-
depends on numerous parameters, played on the monitor within the 256
such as screen settings, ambient gray values/16 million colors that can
brightness, etc., and a universal set- be represented.
ting cannot therefore be given.
Image Normalization
Gaussian Distribution The processing algorithm for Apo-
The emission of fluorescent light in Tome raw images acts in a subtrac-
fact follows a Poisson distribution. If, tive manner effectively reducing the
however, detector noise predomi- gray value range of the output im-
nates during imaging, or the image age. Since all calculations are done
data are only just above the camera internally in the high precision 32 bit
noise and therefore very dark, a nor- floating point image format the nor-
mal distribution according to Gauss malize option can help to generate
tends to apply to such images. better output data. The floating point
numbers are back-converted into 16
Generalized Cross Validation (GCV) bit integer numbers using the full 16
Regularization, which lessens the in- bit dynamic range normalized to the
fluence of noise during restoration, is brightest pixel. This option makes it
normally controlled by a parameter impossible however to make quanti-
that in most cases is determined tative comparisons between images.
heuristically via trial and error. The
Generalized Cross Validation (GCV) Kymograph
method makes it possible to estimate A Kymograph is a twodimensional
this parameter even under the com- representation of a moving object
plex conditions of Poisson maximum over time. The movement of the ob-
likelihood minimization. ject is traced using a line or curve of a
given thickness and an intensity plot
Image Analysis Wizard is then generated over time. The ky-
Using the Image Analysis Wizard you mograph image displays the intensi-
can create automatic measurement ties along the line in X direction and
routines very easily. The wizard deliv- the time points are plotted in the Y
ers precise results without any need direction. With this method one can
to spend time on programming. This

Software Manual ZEISS | en-US | Rev.1 1325


Glossary ZEISS

visualize and analyze speed and ac- based on the number of available
celeration of moving objects with a GPUs. The splitting of data depends
simple 2D representation. on the size of individual 3D subsets,
the available resources of the GPUs
Maximum mode and the selected method and its pa-
In the case of a maximum intensity rameters. The methods using multi-
projection, only the pixels with the GPU are the Regularized Inverse Fil-
highest intensity are displayed along ter, Fast Iterative and Constrained It-
the observation axis. This view is well erative, but only without depth vari-
suited to the two-dimensional display ance.
of three-dimensional images, e.g. in
publications, one reason being that a NDD (Non descanned detector)
maximum transparency effect is only A detector with the shortest possible
visible in this mode. light path for the emitted light, avoid-
ing the reducing signal loss. It also
Mixed mode has no pinhole and fewer optical ele-
In Mixed mode, a volume can be dis- ments in the path.
played in both Surface mode and
Transparency mode. In the case of Nearest Neighbor
multichannel images, for example, The Nearest Neighbor method uses
structures inside a cell, such as FISH the simplest and fastest algorithm
signals or nucleoli, can be displayed (Castleman, K.R., Digital Image Pro-
in Surface mode and the cytoplasm cessing, Prentice-Hall, 1979). Its func-
around these structures can be dis- tion is based on subtraction of the
played transparently in another chan- out-of-focus information in each
nel. This means that even highly com- plane of a stack, taking the neighbor-
plex spatial relationships can be ing sections above and below the
shown convincingly. corrected Z-plane into account. This
method is applied sequentially to
Motif buttons each plane of the entire 3D stack. It
With the Motif buttons you can opti- allows you to enhance contrast
mize image acquisition regarding par- quickly, even if image stacks have not
ticular requirements like speed or been put together optimally.
quality. All parameters e.g. camera
resolution or dynamic range in Acqui- Nyquist Criterion
sition Mode or Channels tool were The Nyquist criterion states that a sig-
set automatically. They will influence nal must be detected with at least
basically camera, detector and light- double precision in order to reliably
ning settings. acquire all the frequencies in the sig-
nal. In the case of images acquired
MTB (MicroToolBox) with coarser resolution, undesired ef-
Software module mediating between fects such as aliasing may otherwise
ZEN software and hardware (stand). result. For the deconvolution of mi-
The software runs as a service on the croscope images, this means, in prac-
user PC. tical terms, that images should be ac-
quired with a pixel resolution that is
Multi-GPU at least double the optical resolution,
both in the lateral and axial direction.
For Deconvolution in ZEN, the pro-
cessing of the image data can be dis-
tributed to multiple GPUs (Graphics
Processing Units). This multi-GPU
functionality is based on data split-
ting, i.e. input data is split into tiles

Software Manual ZEISS | en-US | Rev.1 1326


Glossary ZEISS

Object Feature in three-dimensional light mi-


An object feature is calculated for an croscopy", J. Opt. Soc. Am. A, vol. 8,
individual segmented object. It de- no. 10, pp. 1601-1613, October
scribes a geometric or intensity prop- 1991).
erty of the object, e.g. its area or its
average intensity. Poisson Distribution
The emission of photons by fluo-
PCH rochromes follows a statistical distri-
Photon Counting Histogramm bution, known as a Poisson distribu-
tion. This is the preferred model
Phase Correction taken as the basis for the deconvolu-
tion calculation. It applies if the pre-
The ApoTome grid is moved in pre-
dominant proportion of image noise
cise steps during acquisition in order
is caused by shot noise ("salt and
to cover the sample fully for one sec-
pepper noise"). This assumption ap-
tion. The used steps are stored in the
plies to images that have been ac-
image metadata and used for all sub-
quired using good, low-noise detec-
sequent processing steps. In most
tors, the dynamic range of which has
cases this will work very well. How-
been utilized to a certain extent.
ever, there can be cases e.g. caused
by vibrations, when the actual grid
Position
position deviates from the reported
position causing artifacts during pro- In a tile experiment positions refer to
cessing. Phase correction analyses the independent individual image fields
actual grid positions in the raw im- (tiles) that are localized at various
ages and uses the determined values places on the sample. A position cor-
instead for processing. This option responds to a tile region consisting of
will add a bit of processing time how- just one tile. Each position is based
ever. on an X and Y coordinate of the
stage and a Z coordinate of the focus
Point Spread Function (PSF) drive. Individual positions or position
arrays (grouped individual positions)
All optoelectronic effects that influ-
are defined using the Tiles tool. After
ence the creation of a microscope im-
acquisition the individual positions
age can be described mathematically
are displayed as scenes.
in the form of the point spread func-
tion (PSF). If the PSF is known, decon-
Pseudo color assignment
volution can be used to largely re-
move the negative effects from mi- In fluorescence microscopy, pseudo
croscope images. There are three color assignment describes the as-
possible ways to determine the PSF: signment of any artificially selected
theoretically through knowledge of color to the channel of a multichan-
the key optical parameters, experi- nel fluorescence image. As it is
mentally through measurement using mostly monochrome cameras (which
fluorescent beads of a known diame- produce black and white images
ter, or blindly using a method that rather than "true colors") that are
works with less prior knowledge. In used in this area of application, we
ZEN the theoretical model according talk of pseudo coloring.
to Lanni and Gibson has been imple-
mented, which also models asymme- Pyramid Levels
tries like those that can arise due to When viewing very large images with
spherical aberrations (see S. F. Gib- many tiles on a computer, the pixels
son, F. Lanni, "Experimental test of in the image usually exceed the num-
an analytical model of aberration in ber of pixels the display has available
an oil-immersion objective lens used by orders of magnitude. To view

Software Manual ZEISS | en-US | Rev.1 1327


Glossary ZEISS

zoomed down versions of such large strategy is used, this determines and
images, the computer has to do a lot updates the Reference Z-Position dur-
of calculations for subsampling data. ing the experiment.
This is why it is helpful to create sub-
sampled version of the original im- Regularization
ages during acquisition, so that Working with real microscope images
zoomed down images can be quickly that are affected by noise leads to
displayed. Usually several zoom levels considerable difficulties with the
are calculated automatically. practical application of deconvolution
methods, which is why regularization
Raw Data Mode (e.g. according to Tikhonov-Miller-
The ApoTome combines the advan- Phillips) is essential. Regularization is
tages of widefield imaging systems a method that lessens the influence
with the advantages of optical sec- of noise by means of various penalty
tioning. Images acquired from the terms. Stronger regularization leads
Acquisition tab always contain all im- to weaker restoration and weaker
ages acquired from the grid. These regularization to stronger restoration,
grid images are also called phase- or although in this case noise is also in-
raw-images. This principle offers sev- tensified.
eral advantages: 1) all informations
acquired are kept and not discarded; Regularized Inverse Filter
2) the acquisition itself is not slowed The inverse filter is a genuine 3D
down by processing overhead; 3) you method and generally achieves better
get access to various correction results than the Nearest Neighbor al-
methods giving you flexibility in treat- gorithm. It essentially involves divid-
ing your sample in the right way after ing the Fourier transformation (FT) of
acquisition; 4) Phase (=grid-position) the volume by the FT of the PSF,
errors occuring during acquisition which can be performed very quickly.
such as caused by vibrations of the In the real space this corresponds to
microscope can be likely corrected deconvolution. In addition, a statisti-
using the phase correction option cal method (General Cross Validation
without having to redo the acquisi- – GCV) is applied, which determines
tion; 5) you can achieve a marked im- the noise component of the image
provement in resolution and contrast and automatically sets the restoration
by using the specially adapted Apo- strength to the optimum level in line
Tome deconvolution option bundled with this. This process is also known
with all systems; 6) the raw mode fa- as regularization. The method is very
cilitates easy analysis of images which well suited to the processing of sev-
show errors or artifacts in the sec- eral image stacks in order to preselect
tioned image which would otherwise images for the application of the iter-
remain obscure. ative 'high-end' method. Z-stacks
must, however, have been acquired
Reference Z-Position at the correct (Nyquist) distance. The
By default the current Z-position at additional acquisition of Z-planes
the time the experiment is started is above and below the structure of in-
set as the Reference Z-Position for ac- terest is recommended.
quisition. Z-stack experiments, for
which the center of the defined Z- Render Series
stack is set by default as the fixed To display a 3D volume on the
Reference Z-Position, form an excep- screen, each image must be recalcu-
tion to this. Offsets for channels and lated. This takes time and, in the case
Z-stacks shift acquisition in relation to of large images, cannot be done in-
the Reference Z-Position. If a focus teractively. You can, however, have a

Software Manual ZEISS | en-US | Rev.1 1328


Glossary ZEISS

series of individual images calculated refractive index. When light enters


which represent the animation that the embedding medium with the
you want. Such an image series can wrong refractive index this results in
be displayed considerably faster and "spherical aberration". The PSF be-
more fluidly than is possible interac- comes more asymmetrical the further
tively on the screen as, in this case, away from the cover slip it is mea-
the views no longer have to be reren- sured. In practical terms this becomes
dered. Furthermore, an image series noticeable in the form of an increas-
like this lends itself extremely well to ing loss of brightness as the distance
being exported as a film. from the cover slip increases. It is
possible to compensate for spherical
Scan Profile aberration either by using objectives
Scan profiles are the collection of all with correction rings or objectives
commands required to operate Ax- that have been calculated for certain
ioscan and digitize slides. They con- embedding media (e.g. aqueous solu-
tain the recording of the slide label, tions). Within certain limits, however,
creating a slide preview, setting up spherical aberration can also be com-
the optimal way for focussing and fi- pensated for during deconvolution,
nally running the scan experiment it- by taking the parameters responsible
self. They are stored as an open XML for this effect into consideration
format. when calculating the theoretical PSF.
For further details see S. F. Gibson, F.
Shading Correction Lanni, "Experimental test of an ana-
lytical model of aberration in an oil-
The Brightness of microscopic images immersion objective lens used in
often declines to the edges. This is three-dimensional light microscopy",
caused for example, by misaligned, or J. Opt. Soc. Am. A, vol. 8, no. 10, pp.
inhomogeneous lighting, inconstant 1601-1613, October 1991.
light conditions or dirty optics. ZEN is
able to correct this interference with
Surface mode
the so called Shading Correction. First
you need a white image. This func- The two modes previously described
tions as a reference for the back- display the data with soft transitions
ground of your image, which shall be or with a transparent character, de-
corrected. pending on the setting. In Surface
mode, the program calculates solid
Smart Setup surfaces ("isosurfaces") from the gray
values, which emphasizes particularly
Smart Setup is the intelligent and flat structures (e.g. cell walls of plant
convenient control center for your cells). This display can be used if you
fluorescence images. Simply select a want to draw attention to certain
fluorochrome from the more than structures, while other, internal struc-
500 dyes stored and ZEN will auto- tures are hidden.
matically provide the optimal filter
combinations and acquisition settings
Threshold
for your experiment.
Which threshold is the correct one is
Spherical Aberration a question that is frequently asked.
Unfortunately it is not possible to
Every objective requires the use of a give a definitive answer to this ques-
defined immersion medium to deliver tion, particularly because this often
the best optical resolution. In mi- depends on the problem and the
croscopy practice, particularly in the properties of the sample. Generally
area of biosciences, it is not always speaking it can only be said that the
possible, however, to embed the best approach is to determine the
sample in a medium with the correct thresholds using appropriate control

Software Manual ZEISS | en-US | Rev.1 1329


Glossary ZEISS

samples, e.g. samples without colo- improve the brightness, contrast and
calization as a negative control and vibrancy for better visual quality and
samples with biologically relevant detail eligibility.
colocalization as a positive control.
Thresholds determined in this way Transparency mode
can, under certain circumstances, be In the Transparency mode, the struc-
transferred to the sample of interest. tures in the image are rendered in a
similar fashion as in the Volume
TIE mode. The key difference is an ap-
TIE stands for Transfer of Intensity plied edge enhancement filter to al-
Equation. It refers to a method, low more focus on relevant structures
where a quantitative phase image within the data while simultaneously
can be produced by combining the fading out homogenous and less im-
information of 2 out of focus images portant areas.
with one in-focus image in brightfield
illumination to produce images with a Volume mode
phase contrast or alternatively a DIC/ In the Volume mode, the structures
Nomarski like contrast. This requires in the image are rendered as three-di-
imaging under partially coherent illu- mensional objects and illuminated by
minations conditions by closing down means of a virtual light source. Addi-
the condenser aperture. Reference: tionally, the transparency of the
Zou et al., 2017, Scientific Reports 7: structures can be adjusted to allow
7654. deeper insights into the image. This
allows a realistic representation of
Tile region the structures in the image imitating
In a tile experiment a tile region real-life observations. It also allows a
refers to a group of individual image realistic and, in contrast to the maxi-
fields (tiles) that belong together and mum projection mode, a quantitative
are arranged in the form of a grid. display of the volume.
With the help of tile regions it is pos-
sible to acquire areas with dimen- Widefield
sions that exceed the size of an indi- Classical microscopes frequently are
vidual image field. Within an experi- called widefield microscopes in order
ment a number of tile regions can be to distinguish them from microscope
acquired at various positions on the systems with optical sectioning capa-
sample. Each tile region is based on bility such as laser scanning micro-
an X and Y coordinate of the stage scopes. In contrast to such systems
and a Z coordinate of the focus drive. widefield microscopes do not possess
Tile regions are defined using the the ability to discriminate betwee im-
Tiles tool. After acquisition the indi- age information in the axial (=Z) di-
vidual tile regions are displayed as rection leading to blurred images and
scenes. therefore are only poor 3D imaging
systems per se. There are methods to
Tone Mapping add this missing axial sectioning abil-
Tone mapping refers to the compres- ity to widefield microscoped such as
sion of the dynamic range of high 3D deconvolution or structured illu-
contrast images (HDR). The contrast mination (ApoTome, Elyra-S)
range is reduced in order to display
digital HDR images on output devices
with a more limited dynamic range.
Tone Mapping applies a dynamic
range filter to the rendering result to

Software Manual ZEISS | en-US | Rev.1 1330


Glossary ZEISS

ZEISS
ZEISS is an internationally leading
technology enterprise operating in
the fields of optics and optoelectron-
ics. Further information about ZEISS
can be found at www.zeiss.com.

ZEISS Sales & Service Partner


The Sales & Service Partner is gener-
ally in the field for customer support
in a regional area and / or a clearly
defined customer group.

Software Manual ZEISS | en-US | Rev.1 1331


Index ZEISS

Index
Numerics FLIM 1237
Optimize confocal acquisition settings
2.5D View 999
1221
2D View 990
Preview image 1085
Context menu 990
Time Series images 390
Graphical elements context menu 992
Z-Stack images 395
3D
Acquisition Mode 874
Analysis objects table 528
Acquisition monitoring 1104
Analysis tab 528
Acquisition Sequence 871
3D Image Analysis 525
Acquisition tab 859
Create setting 525
Acquisition tools
Export results 527
Focus 938
Perform analysis 527
Stage 985
View results 527
Activate
3D point alignement 645
Alignment process 635
3D View 529
Adapt
Animating the 3D Volume 529
Focus values 937
Key Layout / Controls for Flight Mode
Focus values with Definite Focus 938
531
Focus values with Software Autofocus
Left tool bar 531
937
Right tool bar 532
Adaptive focus point distribution 1091
Tool bar (bottom) 532
Add
3Dxl 529
Dataset to ZEN Connect project 628
3Dxl Plus module 545
Images to ZEN Connect project 626
Measurement in ZEN Connect project
A 649
Access token 206 Tag to ZEN Data Storage image 274
ACP X Unscaled 440 Users to a group 45
ACP X Unscaled WCS 441 ZEN Data Storage data to collection
ACP Y Unscaled 441 276
ACP Y Unscaled WCS 441 Add Annotations 35
Acquire Add Dye or Contrast Method 869
Live panorama image automatically Add to collection dialog 281
260 Adjust
Acquire a first camera image 33 Scan settings 1093
Acquire ApoTome images 1054 Settings for coarse focus map 1090
Acquire Multi-channel Images 51 Settings for fine focus map 1092
Acquire Tile Image 259 Adjust Camera Orientation 344
Acquire Tiles Images Adjust live image settings
Adjusting Z Positions 341 Brightness 36
Assigning Categories to Tile Regions Contrast 36
and Positions 355 Gamma 36
Re-Positioning of your sample carrier Adjust Z positions 341
after incubation 357 Adjustment
Tiles & Positions with Advanced Setup Airyscan detector 1294
344 Collimator 1290
Using Sample Carriers 356 Pinhole 1291
Acquiring Panorama Images with ZEN lite Readback signals 1299
255 Advanced Processing 471
Acquiring the Panorama Image 258 Advanced Scan Profile Editor 1120
Acquisition

Software Manual ZEISS | en-US | Rev.1 1332


Index ZEISS

Start 1083 Charts and tables 434


Workflow 1083 Analyze Interactive Batch 159
Advanced Tile Setup Analyze to Label Image 155
Left toolbar 375 Batch 157
Advanced Tiles Setup 372 Use 81
Create Preview Scan 345 Annotation
AI Model Add to image or movie 61
Create analysis setting 429 Edit 62
AI Model Store 888 Rearrange 62
AI Model Store Dialog 889 Remove 61
AI Models ApoTome 1076
Download 71 ApoTome Mode 889
Import 72 Apotome Plus 608
Airyscan Apotome Plus (adjustable) function
Autocorrelation curve 793 609
Pair correlation of fibers 791 Apotome Plus (defaults) function 608
Airyscan 2 LSM 980 detector adjustment Create settings 619
Automatically 1296 Use in Direct Processing 618
Manually 1298 ApoTome Settings 1077
Airyscan Detector Adjustment 1294 Apply Mask tool 477
Airyscan jDCV 93 Area 442
Airyscan Joint Deconvolution 93 Area Convex 442
Airyscan multiplex modes 1228 Area Cut 442
Airyscan SR 1226 Area Cut Unscaled 442
Airyscan tab 1046 Area Filled 443
Align Area Filled Unscaled 443
Data in Connect project 656 Area Frame 443
Data in CWS project 656 Area Frame Unscaled 443
Images in z direction 641 Area Percentage 443
Images with 3D point alignment 645 Area Percentage Cut 444
Rotate 636 Area Percentage of Holes 444
Scale 638 Area Unscaled 444
Shear 638 arivis Cloud 206
Translate 636 Access token 206
Volumes in 3D 643 arivis Cloud (on-site) 206
ZEN Connect project data 635 Create path mapping 208
Z-Stack automatically 795 Download module 208
Z-Stack manually 794 Example 209
Alignment Executions browser 212
Cancel 640 Module execution tool 212
Clear 641 Module manager tool 211
Finish 641 Preliminary work 206
Reset 640 Prerequisites 206
ZEN Connect project 635 Remote execution 207
Alignment mode 635 Use module locally 209
Alignment process 635 arivis Pro
Activate 635 Pipeline 985
Alignment tab 656 Assign
Amplitude normalization 791 Category 355
Analysis objects table 528 Name 355
Analysis setting Atlas 5 project
Create 498 Load 626
Analysis tab 873 Auto Immersion
Analysis View 429

Software Manual ZEISS | en-US | Rev.1 1333


Index ZEISS

Lattice Lightsheet 1196 Bio Apps View 708


Auto Immersion Tool 1080 Bio Apps Wizard 712
Auto Save 890 BioFormats
Autofocus Import 631
Step size 1113 Bit Depth Adjustment (Camera) 886, 902
Automated Export Tool 892 Black Reference 882, 898
Automated Photomanipulation 577 Bound Back 444
Perform experiment 578 Bound Back Unscaled 444
Automated Photomanipulation tool 579 Bound Back Unscaled WCS 444
Automated Photomanipultion Bound Back WCS 444
Settings 577 Bound Bottom 445
Automated Spot Detection Bound Bottom Unscaled 445
Create setting 705 Bound Bottom Unscaled WCS 445
Specific settings 717 Bound Bottom WCS 446
Automatic segmentation 944 Bound Center 446
Automation Mode - Celldiscoverer 1173 Bound Center Unscaled 446
Celldiscoverer 1173 Bound Center Unscaled WCS 446
Axio Scan Bound Center WCS 446
Edit focus points 1096 Bound Depth 446
Verify focus points 1096 Bound Depth Unscaled 447
Axio Scan Calibration Wizard 1119 Bound Front 447
Axioscan 1081 Bound Front Unscaled 447
Introduction 1081 Bound Front Unscaled WCS 447
Scan settings 1138 Bound Front WCS 447
Workflow 1081 Bound Height 447
Bound Height Unscaled 448
B Bound Left 448
Bound Left Unscaled 448
Barcode
Bound Left Unscaled WCS 449
Define name, profile and subfolder
Bound Left WCS 449
1103
Bound Right 449
Barcode Recognition 1120
Bound Right Unscaled 450
Basic Features
Bound Right Unscaled WCS 450
Intellesis 506
Bound Right WCS 450
Batch Processing 75
Bound Top 451
Bio Apps 707
Bound Top Unscaled 451
Image Export 76
Bound Top Unscaled WCS 451
Binary 951
Bound Top WCS 452
Binning 880, 895
Bound Width 452
Bio Apps 699
Bound Width Unscaled 453
Available Bio Apps 699
Burst Mode 391
Batch Processing 707
Create setting 700
Create setting for automated spot de- C
tection 705 Calculating a ratio for one wavelength
Create setting for cell counting 701 556
Create setting for confluency 702 Calculating a ratio for two wavelengths
Create setting for gene- and protein 556
expression 703 Calibrate
Create setting for Translocation 707 Sample Carrier Template 356
Export results 708 Stage 343
Export tab 709 Camera 894
Run 700
Workflow 700
Bio Apps Tool 711

Software Manual ZEISS | en-US | Rev.1 1334


Index ZEISS

Adjust Orientation 344 Center Y Unscaled 455


Binning 880, 895 Center Y Unscaled WCS 455
Bit Depth Adjustment 886, 902 Center Y WCS 456
Camera Settings Center Z 456
Reload Camera Settings 901 Center Z Unscaled 456
Save Camera Settings 900 Center Z Unscaled WCS 456
Set Camera Settings to factory default Center Z WCS 456
901 Change
Camera tool Image order 630
Acquisition ROI section 881, 896 Scaling 91
Black Reference 882, 898 Tile border size for networks 504
Exposure Time section 894 Change border size dialog 510
Gain 897 Channel Alignment 136
Mode section 885, 901 Channel Alignment Extended 138
Post Processing section 882, 897 Channels 914
Shading Correction 883, 898 Chart export 431
White Balance section 895 Charts and tables
Cancel Analysis View 434
Alignment 640 Circularity 457
Carrier Classes
Select 656 Edit 499
Carrier / Holder in ZEN Connect project Clear
Clear 647 Alignment 641
Select 648 Carrier / Holder in ZEN Connect
Carrier tab 383 project 647
Category Clone
Assign 355 Trained model 498
Create New 355 Close
Positions 364 ZEN Connect project 631
Sort 356 Coarse and fine focus 1108
Tile Region 364 Coarse and fine focus range 1110
Cell Counting Coarse and fine focus relationship 1111
Create setting 701 Coarse focus map
Specific settings 713 Adjust settings 1090
Celldiscoverer Coarse focus map in 3D 1112
Apply shading references 1161 Coarse focus range 1109
Auto Immersion 1165 Coarse Z-Stack Alignment
Create shading references 1160 Image Processing 106
Interactive mode 1171 Setup 106
Looped time series on multiple sam- Collection
ples 1164 ZEN Data Storage 274
Magazine View 1179 Collimator adjustment 1290
Manage shading references 1161 Colocalization 214
Navigation View 1177 Colocalization View 214
Prepare auto immersion 1165 Compactness 457
Remote restart 1166 Configure
Shading references 1160 Single image export 659
Use auto immersion 1166 Stored documents table 273
Center Screen Area 26 Configure Microscope Components 31
Center X 453 Confluency
Center X Unscaled 453 Create setting 702
Center X Unscaled WCS 454 Specific settings 714
Center X WCS 454 Confocal Topography 798
Center Y 454 Module 798

Software Manual ZEISS | en-US | Rev.1 1335


Index ZEISS

Connect acquisition and processing com- 3D image analysis setting 525


puter Analysis setting 498
Direct processing 222 Apotome Plus settings 619
Connect computer Bio Apps setting 700
With discovery proxy 226 Category 355
Connect computers Collection for ZEN Data Storage 274
Without discovery proxy 223 Custom feature 427
Connect project Custom statistical feature 428
Align data 656 Deconvolution settings 601
Connected Processing PCs 237 Global Focus Surface 353
Contour Image analysis setting 403
Toolbar 377 Image analysis setting from analyzed
Contrast 36 image 426
Convert Intellesis Denoising model 514
TXM to czi 120 Local Focus Surface 351
Convexity 457 Naming convention 1101
Copy New trained model 493
Graphical element/measurement 1041 Object Classification model 521
Position 350 Point spread function 602
Tile Region 350 Positions 348, 349
Correct Preview Scan 345
Stage jitter 192 PSF 602
Correlation view 778 Sample Carrier Template 357
Count 457 Service report 1312
Count number of fluorescence signals Shading Reference From Tile Image
per nuclei 409 1099
Count number of objects in a ring around Tile Regions 346, 347
nucleus 423 ZEN Connect project 625
Count Objects Direct Subclasses 457 Create Image Subset 77
Count per mm2 457 Image Processing 108, 193
Create Create manual scaling 36
Create Sub Image 73
Crop ROI 77
Cryo
Image processing functions 105
Z-Stack alignment 118, 152
Cryo Acquisition
Linkam 1198
Cryo images
Workflow 793
Custom chart 432
Custom Dye
Copy & Paste Data 58
Data 57, 58
Data from Preset Dye 58
New 59
Custom Graphics Tab 1042
Customize Tools Dialog 1042
Cut out
Volume from z-stack 796
Cut Out Regions
Image Processing 109
CWS project

Software Manual ZEISS | en-US | Rev.1 1336


Index ZEISS

Export single image 659 Airyscan Processing 231


Apotome Plus 618
D Connect acquisition and processing
computer 222
Data storage 270, 273
Deconvolution 604
Delete Connect project from 273
Introduction 219
Delete image 272
Options 849
Delete image from 272
Overview 222
Filter images and projects 274
SIM Processing 1304
Deconvolution 588
Tool on acquisition tab 233
Adjustable 95
Tool on applications tab 237
Airyscan Joint Deconvolution 93
Use 230
Create PSF 602
Direct Processing tool
Create Settings 601
Acquisition tab 233
Default 104
Discovery proxy
Direct Processing 604
Set up 228
Image types 605
Disparity map
License and functionalities 589
Calculation 1167
Perform with default values 593
Display
PSF wizard 105
Grid in image 41
Deconvolve
Relative laser power 919
Z-stack image 595
Distribute
Deep features
Global Support Points 353
Intellesis 508
Local Support Points 351
Default Parameter for Deconvolution 607
Docker Desktop
Define
Adapt resource allocation manually
Settings for sample detection 1089
1314
Definite Focus
Deactivate experimental features
Adapt focus values 938
1314
Delete
Requirements 1313
Collection for ZEN Data Storage 275
Documents tab 835
Connect project from data storage
Download
273
arivis Cloud module 208
Graphical element/measurement 1041
Dust Filter 789
Image from data storage 272
Dye
Images from disk 629
New 59
Model 499
Dye Database 869
Tag from ZEN Data Storage image
New 59
274
Dye Editor
Denoise
Copy & Paste Data 58
Image Processing 112, 178
Creating a Custom Dye 57
Determine
Custom Dye 58, 59
Acceptor coefficient values 583
Custom Dye Data 57
Donor coefficient values 582
Data Set 59
Z-Stack Configuration 1094
Introduction 55
Detrending Filter 789
New Dye 59
Dialog
Preset Dye 58
Edit Sample Carrier Template 387
Dynamics Profiler 770
Select Sample Carrier Template 386
Diameter 457
Diameter Unscaled 458
Diffusion Coefficient 788
Diffusion view 782
Direct Processing

Software Manual ZEISS | en-US | Rev.1 1337


Index ZEISS

Acquisition Wizard 775 Multi carrier mode 1182


Autocorrelation curve 793 Experiment Feedback 289
Correlation view 778 Adaptive acquisition engine 292
Custom ωr calibration 774 Concept 289
Data region 773 Script Editor 294
Diffusion view 782 Workflow 290
Export data from chart 773 Experiment Information 925
Export data from table 772 Experiment Manager 860
Fit calculation 789 Experiment Regions Tool 926
Flow view 785 Export
Open reference image separately 773 3D analysis results 527
Run experiment 771 Bio Apps results 708
Save document with data compres- Data for SerialEM 634
sion 774 Image export method 120
Set up experiment 771 Intellesis denoising model 515
Supported lasers 771 Multichannel image 67
Use custom ωr calibration 774 Multi-channel image 660
Multiscene image 68
E Object classification model 523
Object classification model with im-
EDF
ages 523
Compare images 246
Single image 633, 659
Edit
Trained model 497
Classes 499
Video 634
Collection for ZEN Data Storage 275
ZEN Connect project 271
Graphical elements and measure-
Export with images
ments 1041
Trained model 498
Measurement in ZEN Connect project
Export/Import
650
Workflow 66
Position Arrays 365
Exporting
Positions 365
User database 50
Properties (Support Points) 389
Extended Depth of Focus 175
Sample Carrier Template 387
Extended Focus Processing 244
Single Positions 365
Extensions 874
Support Points 389
Extract
Ellipse Angle 458
PSF from image 104, 617
Ellipse Angle Unscaled 458
Ellipse Semi-Major 459
Ellipse Semi-Major Unscaled 459 F
Ellipse Semi-Minor 459 Feret Maximum 461
Ellipse Semi-Minor Unscaled 460 Feret Maximum Angle 462
Ellipsoid Semi-Major 460 Feret Maximum Unscaled 462
Ellipsoid Semi-Major Unscaled 460 Feret Minimum 462
Ellipsoid Semi-Mean 460 Feret Minimum Angle 463
Ellipsoid Semi-Mean Unscaled 461 Feret Minimum Unscaled 463
Ellipsoid Semi-Minor 461 Feret Ratio 463
Ellipsoid Semi-Minor Unscaled 461 Feret Vertical to Maximum 464
ELYRA 7 1302 Fiber Length 464
Enhance Local Contrast Fiber Length Unscaled 464
Image Processing 112 FIB-SEM stacks
Example Workflow 793
Image analysis 404, 409, 416, 423 Field of view
Z alignment 642 Width dialog 661
Experiment Designer 286 File Browser 1053
Experiment Designer tool 287 File menu 814

Software Manual ZEISS | en-US | Rev.1 1338


Index ZEISS

Fill holes 951 FRAP Efficiency Analysis 574


Filter FRET 580
Images and projects in data storage Full Screen mode 1050
274
Fine focus map G
Adjust settings 1092
Gain 897
Finish
Gallery View 994
Alignment 641
Gardient Max 472
Fit calculation 789
Gardient Sum 472
FLIM 1236
Gauss
Prepare ZEN for connection 1236
Image Processing 113, 179
Set up acquisition 1237
Gene- and Protein Expression
Start acquisition 1237
Create setting 703
Flip
Specific settings 715
Image horizontally 640
General information
Image vertically 640
Save images 891
Flow calculation 790
General View Options
Flow view 785
Airyscan tab 1046
Fluorescence-Lifetime Imaging Mi-
Dimensions Tab 1029
croscopy 1236
Player Tab 1034
Fluorofore concentration 788
Generate Image Pyramid 199
Focus map 1108
Genreal View Options
Focus Map Settings 1133
Display Tab 1043
Focus Point
Global Focus Surface 351
Edit 1096
Global scaling 36
Verify 1096
Grab
Focus point distribution
Image in ZEN Connect project 648
Recommended strategies 1114
Graphical Elements
Focus point strategy set
Customizing 1042
Center of gravity 1138
Formatting 1040
Density 1137
Graphics
Every Nth 1136
Custom 1042
Every tile 1136
Global 1036
Grid 1137
Graphics Tab 1036
Number of focus points 1136
Gray Value Compensation
Onion Skin 1135
Image Processing 120
Focus point view 1153
Grid 41
Focus Strategy Tool 928
Group Management 829
Focus Surface 366
Groups
Create Global 353
Manage group privileges 47
Create Local 351
Privileges 47
Global 351
Guided Acquisition 327
Local 351
Perform 321
Focus tool 938
Preliminary work 320
Focus values
Guided Acquisition settings 323
Adapt 937
Adapt with Definite Focus 938
Adapt with Software Autofocus 937 H
Focusing Hardware
Camera settings 1113 Instruction Manual 19
Form Circle 464 HDR Confocal Basic 327
Format Graphic Elements Dialog 1040 Heatmap 436
Förster Resonance Energy Transfer 580 Calculation 437
Frame rate 29 Hide

Software Manual ZEISS | en-US | Rev.1 1339


Index ZEISS

Region caption in a ZEN Connect Image Height 466


project 647 Image Height Unscaled 466
Region caption in Connect Project 647 Image Import
Highpass Supported File Types 125
Image Processing 113, 472 Image in ZEN
Histo View 1005 Open 629
Holder Image Index Block 466
Select 656 Image Index Position 466
Image Index Scene 466
I Image Index Time 467
Image Index Z 467
ID 465
Image Name 467
ID Object Storage 465
Image order
ID of the Parent 465
Change 630
Image
Image processing
Add annotation 61
Apotome Plus (adjustable) 609
Export single image 633, 659
Apotome Plus (defaults) 608
Filter in data storage 274
Apply Mask 477
Flip horizontally 640
Coarse Z-Stack Alignment 106
Grab in a ZEN Connect project 648
Create Image Subset 108, 193
Of ZEN Connect project in explorer
Cryo 105
629
Cut Out Regions 109
Save to data storage 270
Denoise 112, 178
Image acquisition LSM 900
Enhance Local Contrast 112
Airyscan 2 multiplex modes 1200
Gauss 113, 179
Image acquisition LSM 980
Gray Value Compensation 120
Airyscan 2 multiplex modes 1202
Highpass 113, 472
Image Acquisition Time 465
Lightsheet 159
Image Analysis
Median 115, 180
3D 525
Remove Stripes 115
Create custom feature 427
Save Settings for IP functions 83
Create custom statistical feature 428
Shading Correction 87, 116
Create new setting 403
Slice Replacement 117
Example 404, 409, 416, 423
Sort SmartFIB tiffs 117
Use trained model 502
Workflow 72
Image analysis setting
Image Scene Name 467
Create 403
Image tyes
Create from analyzed image 426
Deconvolution 605
Image analysis tool 940
Image vertically
Image analysis wizard 941
Flip 640
Image Area Percentage 465
Image Views
Image channel
FRAP View 574
Select 492
Lambda View 1016
Image Channel Name 465
SMLM view 1025
Image Container Category 465
Unmix View 1021
Image Export
Image Width 467
Export folder 132, 135
Image Width Unscaled 467
File Types 120
ImageJ tab 851
Method 120
Images and Documents Gallery 966
Naming convention 69
Imaging Setup
Naming of xml files 70
Quick Export 967
Image Focus Position 465
Image Frame Area 465
Image Frame Area Unscaled 466

Software Manual ZEISS | en-US | Rev.1 1340


Index ZEISS

Airyscan SR 1226 Interpolation Degree


For Widefield Applications 968 Select 354
LSM Confocal 1221 Introduction
LSM Lambda 1228 ZEN Connect 619
NDD 1231 Working with Focus Strategies 63
Online Fingerprinting 1230, 1231
Immersion K
Establish manually 1077
Kymograph 182
Renew automatically 1078
Renew manually 1077
Use auto immersion 1078 L
Import Label area
Add image 626 Scan 1084
BioFormats 631 Label Scan Settings 1120
Denoising model 515 Labels from binary mask
Experiment blocks 289 Import 500
Images to ZEN Connect project 631 Lambda View 1016
Labels from binary mask 500 Laplace 472
Names, profiles and scene name 1102 Lasers tool 1300
Object classification model 522 Lattice Lightsheet
Proprietary file formats 631 Start software 1195
SmartFIB stack 632, 797 Lattice SIM 1302
Third-party images 631 Start software 1304
Trained model 497 Layer Thickness Measurement 798
TXM 127 Tools 808
Import images Wizards 808
Tiles & Positions 349 Left toolbar
Importing Advanced Tile Setup 375
User database 50 Light Path 980
Index 467 Lightsheet Processing 159
Info View 1010 Registration 162
Instance Segmentation 71 Lightsheet Processing Registration 162
Intellesis Linear Unmixing 202
Neural networks 500 Linkam Cryo Stage 1198
Intellesis Denoising 511 Live panorama 841
Create model 514 Acquire panorama image automati-
Export model 515 cally 260
Import model 515 Load
Processing function 517 Atlas 5 project 626
Train model 514 ZEN Connect project 626
Use trained model 516 Local Focus Surface 351
User interface for training 512 Local variance 473
Intellesis Denoising tool 516 Localization Microscopy 1309
Intellesis Trainable Segmentation Tool Location
509 Toolbar 380
Intensity Maximum of channel 'C1' 467 Login
Intensity Mean Value of channel 'C1' 467 Active Directory 48
Intensity Minimum of channel 'C1' 467 With Windows credentials 48
Intensity Range of channel 'C1' 467 LSM
Intensity Standard Deviation of channel Online Fingerprinting 1230
'C1' 468 LSM 980
Interactive analysis 427 Maintenance 1290
Interactive Measurements 248 LSM Confocal 1221
Interactive segmentation 956 LSM Lambda 1228

Software Manual ZEISS | en-US | Rev.1 1341


Index ZEISS

LSM Plus 1221 Add annotation 61


LSM Plus Tab 1045 Quick export 67
Movie Export 127
M File Types 127
Movie Recorder 984
Macro Editor Dialog 823
Multi-Channel 327
Magazine view 1142, 1179
Multichannel image
Options 1181
Export 67
Slide layout 1143
Multi-channel image
Tray information 1143
Export 660
Maintenance
Multiple scenes chart 435
LSM 1290
Multiplex modes
Manage
LSM 900 image acquisition 1200
Access rights for user groups 46
LSM 980 image acquisition 1202
Group privileges 47
Multiscene image
Manual Extended Depth of Focus 244
Export 68
Aquire images with F12 key 245
Multiwell View 997
Aquire images with timer 245
Preparation 244
Manual scaling 36 N
Mean ROI View 566 Name
MeanROI Define by barcode 1103
Open view 552 Import via csv file 1102
Measure Naming
Point spread function using subresolu- Create convention 1101
tion beads 603 Exported images 69
PSF using subresolution beads 603 xml files of image export 70
Measure fluorescence intensity in a multi- Naming convention
channel image 404 Image export 69
Measure View 1008 Naming Definition tool 1148
Measurement 248 Navigation & Tiles 1177
Measurement Tab 658 Navigation tab 1179
Median Navigation View 1177
Image Processing 115, 180 NDD 1231
Menu bar 25 Neural Networks
Method Extended Depth of Focus 79 Intellesis 500
Microsccope Tool Normalization
With Auto Immersion 1079 Correlation curves 791
Microscope Number of the region holes 468
Remote restart for Celldiscoverer 1166
Microscope Control 980 O
Min. hole size 951
OAD (Open Application Development)
Mirror 142
ImageJ Extension 282
Model
OAD Concept 549
Delete 499
Object classification
Export with images 498
Create model 521
Rename 498
Export model 523
Module
Export model with images 523
3D Image Analysis 525
Import model 522
Move
Train model 521
Graphical element/measurement 1041
Use trained model 523
Image in ZEN Connect project 630
Objective
Measurement result 1042
Recommendations 1080
Movie
Objective lenses 1114

Software Manual ZEISS | en-US | Rev.1 1342


Index ZEISS

Online Fingerprinting 1230 Polarization imaging 1285


Open Position Array
Connect project from ZEN Data Stor- Toolbar 380
age 273 Positions 363
Image from data storage 272 Adjusting Z values 342
Image in ZEN 629 Assign Category 355
Images in ZEN Connect 3D view 623 Assign Name 355
MeanROI view 552 Category 364
ZEN Connect 623 Copy 350
ZEN Connect project 626 Create 348, 349
Optimize live image settings 35 Predefined
Options Toolbar 377
Processing 848 Pre-scan 1088
Tiles 384 Pre-Scan settings 1124
Ortho View 1017 Preview image 1085
Orthogonal Projection 142 Preview scan 376
Toolbar 376
P Preview scan settings 1123
Privileges
Pan & zoom 646
Groups 47
Panorama View 268
Processing
Password Rules 49
Localization Microscopy 1309
Paste
Polarization imaging 1285
Graphical element/measurement 1041
SIM Processing 1306
Path mapping 208
Processing tab 873
Perform
Settings Concept 83
3D image analysis 527
Workflow 72
Automated Photomanipulation experi-
Processing the Panorama Image 263
ment 578
Profile
Deconvolution with default values
Define by barcode 1103
593
Import via csv file 1102
Guided Acquisition 321
Profile validation 1096
Interactive analysis 427
Profile View 1002
Performance indicators 29
Progress bar 29
Performing deconvolution
Proprietary file formats
Configurable 595
Import 631
Perimeter 468
PSF
Perimeter Unscaled 468
Extract from image 104, 617
Photo Activated Localization Microscopy
Measure using subresolution beads
1303
603
Physiology 551
PSF Wizard 105, 602
License and functionalities 551
Mean ROI Setup 925
Workflow 558 Q
Pinhole adjustment 1291 Quick export
Pipeline Movie 67
arivis Pro 985
Pipeline tool 985 R
Pixel size 661
Radius 468
Pixel Value 29
Radius Unscaled 469
Point spread function 602
Raman image format 624
Measure using subresolution beads
Readback signals adjustment 1299
603
Region
Pol view 1020
Pol view display tab 1021

Software Manual ZEISS | en-US | Rev.1 1343


Index ZEISS

Select 647 Calibrate Template 356


Region caption Create Template 357
ZEN Connect project 647 Customize Template 357
Region Class Color 469 Distribute Support Points 353
Region Class ID 469 Edit Template dialog 387
Region Class Name 469 Re-Positioning 357
Region Class Name Parent 469 Select Template 356
Region filter editor 955 Select Template dialog 386
Region of Interest Tiles toolbar 379
Sample Detection 1128 Toolbar positions 381
ZEN Connect 648 Sample Carrier tab 432
Regions tool 663 Sample detection
Registration Check results 1098
Lightsheet Processing 162 Correct results 1098
Relative laser power Define settings 1089
Display 919 Region of Interest 1128
Remove Sorting Order 1129
Data from ZEN Connect project 629 Sample Detection Settings 1126
Image from ZEN Connect project 629 Sample Holder Calibration Wizard
Remove Stripes 692, 753
Image Processing 115 Sample navigator
Rename LSM 980 and LSM 900 1209
Image in ZEN Connect project 629 Sample tab
Trained model 498 Interactive mode 1171
Re-Positioning Save
Sample Carrier 357 Image to data storage 270
Resample 143 Images 891
Reset Saving tab 835
Alignment 640 Scale
Resize Alignment 638
Graphical element/measurement 1041 Scaling 831
Reuse function 870 Change 91
Right Tool Area 28 Create 36
Roberts 473 Scaling options 29
Rotate 144 Scan
Alignment 636 Adjust settings 1093
Graphical element/measurement 1041 Label area 1084
Z-Stack 643 Scan profile
Rotate 2D 145 Validation 1096
Roundness 470 Scan profiles
Run Setup 1082
Bio Apps 700 Scan settings
Axioscan 1138
S Scan tab 1142
Scene Name
S&F View 687
Import via csv file 1102
Sample Carrier 366
Script Editor for Experiment Feedback
294
Script runtime condition
Select 292
Section

Software Manual ZEISS | en-US | Rev.1 1344


Index ZEISS

Focus Surface 366 Shading reference from tile image


Positions 363 88, 89, 1099
Sample Carrier 366 Shading references
Segmetation model Celldiscoverer 1160
Select 950 Shading References Manager 1163
Select Share
Carrier / Holder in ZEN Connect ZEN Data Storage data with users and
project 648 groups 276
Carrier and Holder 656 Share and Manage Access dialog 282
Category 355 Sharpen 946
Image channel 492 Sharpness 914
Interpolation Degree 354 Sharpness measure set
Region 647 Best 1134
Sample Carrier Template 356 HG 2^8 1134
Sample Carrier Template dialog 386 Shear
Script runtime condition 292 Alignment 638
Segmentation model 950 Shift 147
Select template dialog 656 Shift Z 147
Selecting a Light/Dark Screen Layout 39 Show
Separate after segmentation 952 Image of ZEN Connect project in Ex-
SerialEM plorer 629
Export 634 Show All Mode 31
Service report 1312 Show/hide areas 40
Session Shuttle & Find 671
Start in ZEN Connect 630 Shuttle and Find 686
Set up SIM 1302
Discovery Proxy 228 SIM Processing 1306
Set up Physiology experiments 558 Direct Processing 1304
Set user language 30 Single Pixel Filter 180
Setting Image Smoothing 180
Automated Spot Detection 705 Processing 180
Cell Counting 701 Single Positions 363
Confluency 702 Slice Replacement
Gene- and Protein Expression 703 Image Processing 117
Settings Smart Profile Selection 1082
Automated Photomanipulation 577 Smart Profile Selection wizard 1118
Setup Smart Setup 862
by Array 348 Airyscan LSM 980 and LSM 900 1208
by Carrier (Positions) 349 SmartFIB stack
by Carrier (Tiles) 347 Import 632, 797
by Contour 346 SMLM 1302, 1303
by Location 348 Drift Correction Tab 1028
by Predefined 347 Filter Tab 1026
Coarse Z-Stack Alignment 106 Grouping tab 1028
Pre-scan 1088 Image view 1025
ROI for preview image 1086 Molecule table 1025
Shading Rendering Tab 1027
Apply references 1161 Statistics Tab 1026
Create references 1160 SMLM view 1025
Manage references 1161 Smoothing 945
Shading Correction 883, 898 Sobel filter 473
Image Processing 87, 116 Software autofocus 334
Shading Management Tool 1162 Adapt focus values 937
SOP 1106

Software Manual ZEISS | en-US | Rev.1 1345


Index ZEISS

Sort SmartFIB tiffs T


Image Processing 117
Tab
Specific View options 383
Carrier 383
Sphericity 470
Table Export tab 432
Split Display 1051
Temporary files
Split View 1021
Separate folder 1106
Splitter mode 1051
TFT
Stack Correction 90
Change auto immersion objective
Stage alignment 148
1078
Stage jitter
Third-party images
Correct 192
Import 631
Stage LLS tool 1196
Threshold 947
Stage size
Tile 328
Zen Connect 850
Tile border size
Stage tool 985
Change 504
Stage View 373
Tile Images
Stake
Calibrating Stage 343
Toolbar 378
Tile Region 328
Standard Operating Procedure 1106
Assign Category 355
Start
Assign Name 355
Advanced Scan Profile Editor 1083
Category 364
Lattice SIM 1304
Copy 350
Scan experiment 1097
Create 346, 347
Session in Connect project 630
Distribute Support Points 351
Start Preview Scan 1142
Tile Regions
Start Scan 1142
Adjusting Z-Values 341
Start software 22
Tiles 359
Status bar 28
Options 369, 384
Stitching 148
Verify Tile Regions / Positions 371
Shading correction 148
Tiles & Positions 337
Storage folder 29
Import images 349
Storage location tool 1150
License and functionalities 338
Stored documents table
Tiles advanced setup
Configure 273
Live and Stage tab 382
Structured Illumination Microscopy 1302
Tiles and Positions
Subfolder
Selecting Interpolation Degree 353
Define by barcode 1103
Setting up a simple positions experi-
Subtract BG 951
ment 340
Superresolution Microscopy 1302
Setting up a simple tiles experiment
Support Points
339
Distribute on Sample Carrier 353
Tiles Options 384
Ditribute on Tile Region 351
Time Alignment 182
Global 366, 389
Time Bleaching Tool 989
Local 366
Time Concatenation 184
Options 389
Time Series 390
Verify Z positions 354
Acquire images 390
Verifying Z-values 352
Multiple samples on Celldiscoverer
Suppress Border 952
1164
Suppress invalid 952
Time series chart 435
Surface Area 470
Toggle
Surface Area Filled 470
Region caption in a ZEN Connect
Surface Area Filled Unscaled 470
project 647
Surface Area Unscaled 470
ZEN Connect view modes 631
System Information 29
Tomo3D View 545

Software Manual ZEISS | en-US | Rev.1 1346


Index ZEISS

Tool Bar 26 Convert to czi 120


Toolbar Import 127
Contour 377
Location 380 U
Position Array 380
Undock/Dock tool window 40
Predefined 377
Upload
Preview scan 376
Images to ZEN Data Storage automat-
Sample carrier positions 381
ically 272
Sample carrier tiles 379
Use
Stake 378
Analyze to Label Image 81
Tools
Automated Photomanipulation set-
Acquisition Mode 874
tings 577
ApoTome Mode 889
Bio Apps for Batch Processing 707
Auto Save 890
Direct Processing 230
Automated Export Tool 892
User and Group Management
Camera 894
Options 49
Channels 914
User database
Experiment Information 925
Importing/exporting 50
Image Analysis 940
User interface 24
Imaging Setup 967
User management 42, 829
Interactive Measurement 249, 973
Add users to group 45
Lasers tool 1300
Create new user 43
Microscope Control 980
Manage access rights for user groups
Regions 663
46
Shuttle and Find 686
Software autofocus 334
Tiles 359 V
Time Series Tool 391 Variance 950
Z-Stack 397 Verify Z positions
Topography 798 of Support Points 354
Wizards 806 Video
Tools 806 Export 634
Total Area Direct Subclasses 470 Video export wizard 661
Total Area Direct Subclasses Percentage View
471 3D analysis results 527
Total Area Direct Subclasses Unscaled Viluma 9 1310, 1311
471 Control with Channels tool 1311
Trainable Segmentation 489 Control with Imaging Setup tool 1310
Trained model Control with Microscope tool 1310
Clone 498 Volume 471
Create 493 Volume Frame 471
Delete 499 Volume Frame Unscaled 471
Export 497 Volume Percentage 471
Export with images 498 Volume Unscaled 471
Import 497
Rename 498
W
Use for image analysis 502
Translate Whitening 181
Alignment 636 Workflow
Translocation Bio Apps 700
Create setting 707 Cryo images 793
Specific settings 719 FIB-SEM stacks 793
Tree View 1016 Image Processing 72
TXM Physiology 558
Working with MeanROI 551

Software Manual ZEISS | en-US | Rev.1 1347


Index ZEISS

Workspace configuration 25 Add Active Directory user 277


Add data to collection 276
Z Add tag to image 274
Collection 274
Z alignment
Create collection 274
Example 642
Delete collection 275
Z-Alignment 641
Delete tag from image 274
ZEISS
Edit collection 275
Portal 20
Open Connect project 273
ZEN Connect
Save ZEN Connect project 271
Add measurment in project 649
Share data with users and groups 276
Delete region of interest 649
Stored Documents dialog 277
Draw region of interest 648
Upload images automatically 272
Edit measurment in project 650
Validate settings 270
Export project 271
ZEN slidescan 1081
Functionalities 619
Introduction 1081
Introduction 619
Workflow 1081
Licensing 619
Zoom
Measurement tab 658
Pan & zoom 646
Measurment 649
Zoom to extent 646
Move stage to region of interest 649
Zoom in/out workspace 40
Open images in 3D view 623
Zooming
Region of interest 648
ZEN Connect project 628
Rename region of interest 649
Z-Stack 394, 397
Stage size 850
Acquiring Z-Stack Images 395
Toggle view modes 631
Auto-Configuration 400
ZEN Connect tool 650
Automatic alignment 795
Zoom to region of interest 649
Configure manually with center mode
ZEN Connect project
396
Add dataset 628
Configure manually with First/Last
Add images 626
Mode 396
Align 635
Configure Z-Stack automatically 395
Align data 635
Create EDF-Image 79
Close 631
Cut out volume 796
Create 625
Determine configuration 1094
Export single image 633
Manual alignment 794
Export video 634
Manual Configuration 813
Import images 631
Rotate 643
Load 626
Z-Stack Alignment 118, 150, 152
Move image 630
Z-stack image
Remove image 629
deconvolve 595
Rename image 629
Z-Stack Tool 397
Save to ZEN Data Storage 271
Zoom 628
Zoom to extent 646
ZEN Data Storage 269

Software Manual ZEISS | en-US | Rev.1 1348


Software Manual ZEISS | en-US | Rev.1
Modifications reserved.

Carl Zeiss Microscopy GmbH phone: +49 3641 64 3161


Carl-Zeiss-Promenade 10 fax: +49 3641 64 3439
07745 Jena [email protected]
Germany www.zeiss.com/microscopy

You might also like