Image Analysis Software
Super-Resolution Module
Version 7
Installation Instructions
July 2013
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 non- transferrable 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.
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.
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
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
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.
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: 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.
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.
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.
3. Accept the terms of the license agreement and then click Next.
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.
6. On the Choose Destination Location page, accept the default installation directory and then click Next.
7. Click Install.
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:
The NVidia CUDA Toolkit installation wizard starts.
2. Click Next.
3. Accept the terms of the license agreement and then click Next.
4. Enter the requested information or select “No, thanks!” to skip the registration and then click Next.
5. Click Next.
6. On the Setup Type page, click Complete and then click Next.
7. Click Install.
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
2. Search for “.NET Framework 4.5 full”.
3. Download the .NET Framework 4.5 full installation.
4. Double-click the file that you downloaded, accept the license agreement that appears, and click Install.
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.
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:
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.
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.
The Wave Tracer software installation wizard starts.
4. Click Next.
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.
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.
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\.
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.
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.
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.
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.
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.
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/
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.
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:
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.
“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.
