MetaMorph Microscopy Automation & Image Analysis Software Super-Resolution Module Version 7 Installation Instructions July 2013
This document is provided to customers who have purchased Molecular Devices equipment, software, reagents, and consumables to use in the operation of such Molecular Devices equipment, software, reagents, and consumables. This document is copyright protected and any reproduction of this document, in whole or any part, is strictly prohibited, except as Molecular Devices may authorize in writing. Software that may be described in this document is furnished under a nontransferrable license. It is against the law to copy, modify, or distribute the software on any medium, except as specifically allowed in the license agreement. Furthermore, the license agreement may prohibit the software from being disassembled, reverse engineered, or decompiled for any purpose. Portions of this document may make reference to other manufacturers and/or their products, which may contain parts whose names are registered as trademarks and/or function as trademarks of their respective owners. Any such usage is intended only to designate those manufacturers products as supplied by Molecular Devices for incorporation into its equipment and does not imply any right and/or license to use or permit others to use such manufacturers and/or their product names as trademarks. Each product is shipped with documentation stating specifications and other technical information. Molecular Devices products are warranted to meet the stated specifications. Molecular Devices makes no other warranties or representations express or implied, including but not limited to, the fitness of this product for any particular purpose and assumes no responsibility or contingent liability, including indirect or consequential damages, for any use to which the purchaser may put the equipment described herein, or for any adverse circumstances arising therefrom. The sole obligation of Molecular Devices and the customer's sole remedy are limited to repair or replacement of the product in the event that the product fails to perform as warranted. For research use only. Not for use in diagnostic procedures. The trademarks mentioned herein are the property of Molecular Devices, LLC or their respective owners. These trademarks may not be used in any type of promotion or advertising without the prior written permission of Molecular Devices, LLC. Patents: http://www.moleculardevices.com/productpatents Product manufactured by Molecular Devices, LLC. 1311 Orleans Drive, Sunnyvale, California, United States of America 94089. Molecular Devices, LLC is ISO 9001 registered. 2013 Molecular Devices, LLC. All rights reserved.
Contents Installing Prerequisite Software................... 5 Installing the CUDA GPU Computing SDK............ 6 Installing the CUDA Toolkit..................... 10 Installing and Configuring the.net 4.5 Framework... 14 Installing the Wave Tracer Software............... 20 Configuring the MetaMorph Software.............. 24 Updating the Wave Tracer Software............... 27 Troubleshooting............................... 30 Wave Tracer Is Not Licensed Error............... 30 No GPU Available Error....................... 32 Not Enough Memory Error.................... 32 3
Contents 4
Installing the Super-Resolution Software Module This document describes how to install the Super-Resolution software module (also called the Wave Tracer software) so that it can be used with the MetaMorph Microscopy Automation & Image Analysis Software. Note: This document assumes that the MetaMorph Software is already installed. If the software is not yet installed, see the detailed installation instructions in article 19276 in the Molecular Devices knowledge base at http://www.moleculardevices.com/support.html. Molecular Devices strongly recommends that you install the MetaMorph Software into the default location, which is C:\MM. Installing Prerequisite Software The Super-Resolution software module can use an NVidia GPU to speed up processing if the video card you have is CUDA-enabled. To determine if your video card is CUDA-enabled, visit the NVidia web site: https://developer.nvidia.com/cuda-gpus To take advantage of the increased processing speed, install version 4.2.9 of two CUDA libraries as described in: Installing the CUDA GPU Computing SDK on page 6 Installing the CUDA Toolkit on page 10 Note: The Wave Tracer software can run without an NVidia card and can run without the CUDA libraries; however, without the card or libraries, the software will not be able to take advantage of the increased processing speed possible with the GPU. If you do not have a CUDA-enabled video card, skip this section. 5
Installing the Super-Resolution Software Module Installing the CUDA GPU Computing SDK 1. Run version 4.2.9 of the CUDA Computing SDK (32-bit or 64- bit) that matches your operating system. For example: The NVidia GPU Computing SDK installation wizard starts. 2. Click Next. 6
MetaMorph Microscopy Automation & Image Analysis Software 3. Accept the terms of the license agreement and then click Next. 7
Installing the Super-Resolution Software Module 4. Enter the requested information or select No, thanks! to skip the registration and then click Next. It may take several minutes to register the product. 5. On the Setup Type page, select All Users and then click Next. 8
MetaMorph Microscopy Automation & Image Analysis Software 6. On the Choose Destination Location page, accept the default installation directory and then click Next. 7. Click Install. 9
Installing the Super-Resolution Software Module 8. Click Finish. Installing the CUDA Toolkit 1. Run version 4.2.9 of the CUDA Toolkit (32-bit or 64-bit) that matches your operating system. For example: 10
MetaMorph Microscopy Automation & Image Analysis Software The NVidia CUDA Toolkit installation wizard starts. 2. Click Next. 3. Accept the terms of the license agreement and then click Next. 11
Installing the Super-Resolution Software Module 4. Enter the requested information or select No, thanks! to skip the registration and then click Next. 5. Click Next. 12
MetaMorph Microscopy Automation & Image Analysis Software 6. On the Setup Type page, click Complete and then click Next. 7. Click Install. 13
Installing the Super-Resolution Software Module The installation may take a few minutes, during which the status bar should update. If an Administrator Access request appears, click OK to accept the access and continue the installation. 8. Click Finish. Installing and Configuring the.net 4.5 Framework 1. Go to the Microsoft Download Center: http://www.microsoft.com/en-us/download/default.aspx 14
MetaMorph Microscopy Automation & Image Analysis Software 2. Search for.net Framework 4.5 full. 3. Download the.net Framework 4.5 full installation. 15
Installing the Super-Resolution Software Module 4. Double-click the file that you downloaded, accept the license agreement that appears, and click Install. 16
MetaMorph Microscopy Automation & Image Analysis Software Installation occurs in two steps. First, the download progress bar advances while any necessary updates are downloaded. Second, the installation progress bar advances as the software is installed. 17
Installing the Super-Resolution Software Module 5. When the installation is complete, click Finish. 6. Open a new text document using a simple text editor, such as Notepad, and then enter the text as shown below: 18
MetaMorph Microscopy Automation & Image Analysis Software 7. Save the text document as mmapp.exe.config in the directory where the MetaMorph Software is installed (C:\MM, by default). In the Save as type field, select All Files (*.*) so that the file is not saved as a.txt file. In the Encoding field, select UTF-8. Make sure the name of the file is mmapp.exe.config. 8. Click Save. When the file is saved properly, the directory where the MetaMorph Software is installed contains the mmapp.exe application, which launches the software, and the mmapp.exe.config file, which modifies how the.net Framework software operates. 19
Installing the Super-Resolution Software Module Installing the Wave Tracer Software 1. Go to the MetaMorph FTP site at: ftp://ftp.meta.moleculardevices.com/support/wavetracer/ 2. Download the version of the software (32-bit or 64-bit) that matches your operating system. 3. Navigate to the folder into which you downloaded the Wave Tracer software, and double-click the Wave Tracer installer file to launch the application. 20
MetaMorph Microscopy Automation & Image Analysis Software The Wave Tracer software installation wizard starts. 4. Click Next. 21
Installing the Super-Resolution Software Module You must install the Wave Tracer software into the same folder where the MetaMorph Software is installed (by default, C:\MM\WaveTracer\). For example, if you installed the MetaMorph Software into C:\MM7\ then you should change the installation folder on this page of the installation wizard to C:\MM7\WaveTracer\. 5. Accept the default location, enter the value in the Folder field, or use the Browse button to locate the installation folder. Note: Molecular Devices recommends that both the MetaMorph Software and the Wave Tracer software be installed in their default locations. If possible, ensure that the MetaMorph Software is installed in C:\MM\ and that the Wave Tracer software is installed in C:\MM\WaveTracer\. 6. After setting the installation directory, select Everyone if you have multiple Windows accounts and want all users to have access to the Wave Tracer software, or select Just Me to limit availability to just the current Windows user. Everyone is the preferred option but may require additional (administrative) Windows permissions. 7. Click Next to continue. 8. On the Confirm Installation page, click Next. 22
MetaMorph Microscopy Automation & Image Analysis Software The installation may take a few minutes, during which the status bar should update. If an Administrator Access request appears, click OK to accept the access and continue the installation. 9. Click Close. 23
Installing the Super-Resolution Software Module Configuring the MetaMorph Software The MetaMorph Super-Resolution Software module runs as a User Program within the MetaMorph Software. In order to run the application, you need to ensure the Run User Programs drop-in is enabled as described in this section. 1. Launch the Meta Imaging Series Administrator from the Start menu. 24
MetaMorph Microscopy Automation & Image Analysis Software 2. In the list of groups, select the MetaMorph group and then click Drop-Ins/Toolbars. 3. In the Configure Drop-ins dialog, scroll through the list of Drop-ins on the left side of the dialog and make sure that the runuser drop-in is selected. 4. In the same dialog, make sure the drop-in labeled superresolution is selected. 5. Click OK to accept the change to the drop-ins. 6. Click OK on the main Administrator dialog to exit. 25
Installing the Super-Resolution Software Module In the MetaMorph Software, the Wave Tracer software can be launched by selecting File > Run User Program. The Wave Tracer software can also be run through the journal WaveTracer.JNL, which is located in the Wave Tracer installation directory, through Stream acquisition, and through any other place in the MetaMorph Software where User Programs can be run. 26
MetaMorph Microscopy Automation & Image Analysis Software Updating the Wave Tracer Software Updating the MetaMorph Super-Resolution software module requires uninstalling the previous version of the Wave Tracer software and installing the new version. 1. Open the Windows Control Panel. 27
Installing the Super-Resolution Software Module 2. In Programs, select Uninstall a program. If you view the Control Panel in an icon view, click the Programs and Features icon. 3. In the Programs and Features control panel, scroll down until you see Wave Tracer. When you select Wave Tracer, its version number should appear at the bottom of the window. 4. Compare the version number in the control panel with the latest version available on the MetaMorph FTP site at: ftp://ftp.meta.moleculardevices.com/support/wavetracer/ 28
MetaMorph Microscopy Automation & Image Analysis Software If the versions do not match, follow the remaining steps in this section to update the software. 5. In the Programs and Features control panel, select Wave Tracer and then click Uninstall. 6. If you are asked if you want to uninstall the software, click Yes. A status bar may briefly display progress. When the uninstallation is complete, the Wave Tracer application should no longer appear in the Programs and Features control panel. 7. Install the latest version of the Wave Tracer software as described in Installing the Wave Tracer Software on page 20. 29
Installing the Super-Resolution Software Module Troubleshooting This section describes how to resolve three errors: Wave Tracer Is Not Licensed Error on page 30 No GPU Available Error on page 30 Not Enough Memory Error on page 32 Wave Tracer Is Not Licensed Error The Wave Tracer software must be licensed through your MetaMorph hardware key. If you do not have the appropriate license, when you try to start the Wave Tracer software, the following error message appears: To obtain the required license codes for your hardware key, update to version 7.7.10 or higher of the MetaMorph Software to retrieve and record the latest MetaMorph Software codes. Instructions for updating the software are available in article 19281 in the Molecular Devices knowledge base at http://www.moleculardevices.com/support.html. If you have updated the MetaMorph Software and continue to have trouble with licensing for the Wave Tracer software, please contact MetaMorph Software Technical Support: Phone: 1-800-635-5577 x1820 E-mail: support.dtn@moldev.com Online Form: http://mdc.custhelp.com/app/support_request/ask_ts No GPU Available Error The Wave Tracer software requires an NVidia CUDA-enabled graphics card in order to make use of the GPU. If an NVidia card is not enabled on your computer, the error No GPU Available appears and the Wave Tracer software will not run. Make sure your video card is on the list of CUDA-enabled cards listed on the NVidia web site at: 30
MetaMorph Microscopy Automation & Image Analysis Software https://developer.nvidia.com/cuda-gpus If your card is listed on the web site, make sure that you have current video drivers for the card and that the CUDA SDK and Toolkit are installed. See Installing Prerequisite Software on page 5 for instructions on downloading and installing the required software. If you have an NVidia card that is listed on the web site and the required software is installed but the issue is not resolved, please contact MetaMorph Software Technical Support and provide a representative with details about the hardware that is installed: Phone: 1-800-635-5577 x1820 E-mail: support.dtn@moldev.com Online Form: http://mdc.custhelp.com/app/support_request/ask_ts If you do not have an NVidia card, you will not be able to take advantage of the GPU processing available with the Wave Tracer software. To disable this functionality, in the Wave Tracer dialog, on the Advanced tab, select the CPU option. 31
Installing the Super-Resolution Software Module Not Enough Memory Error Even if your computer has sufficient memory to run an analysis or acquire images, the following error might appear: To take full advantage of the available system RAM, follow the instructions provided in Installing the CUDA Toolkit on page 10. 32