JMV FAQ
JMV Frequently Asked Questions
Table of Contents
1. About JMV1.1 What is JMV?
1.2 What do I need to run JMV?
1.3 Why should I use JMV?
1.4 Who makes JMV?
1.5 Where can I get JMV?
2. Starting with JMV
2.1 What mouse controls are there in JMV?
2.2 What kind of files can I load in JMV?
2.3 How do I run JMV as a standalone application?
3. Installation
3.1 What do I need to install to run JMV?
3.2 I try to run JMV, but it says "Plug in not found". What do I do?
3.3 The Plug-In runs, but the applet window says it can't find Java3D
3.4 For Windows, which version of Java3D should I download?
4. Exceptions and Errors
4.1 I installed Java and Java3D, but I still get an error: "java.lang.NoClassDefFoundError: com/sun/j3d/utils/applet/JMainFrame".
4.2 I tried loading a molecule, but got a message saying there wasn't enough memory.
4.3 I tried switching representations, but got a message saying there wasn't enough memory.
4.4 I tried loading a molecule, but got a message saying it couldn't be found.
4.5 I tried loading a molecule, but got a message saying I didn't have permission to access the file.
4.6 I just downloaded and installed Java, but I got a message saying that the plugin could not be found.
4.7 I just downloaded and installed Java and Java3D, but when I load a molecule, the cylinders are rotated the wrong way.
4.8 I just started JMV, but the dropdown menus won't drop down.
4.9 When I save a jpeg on Windows, the picture isn't getting saved properly.
4.10 When I reload a page running JMV, I get a long error message starting with: "Unexpected signal:"
4.11 JMV says it cannot find Java3D, even though I have it installed.
4.12 I installed Java3D, but it gives me an UnsatisfiedLinkError saying: "J3D.dll A device attached to the system is not functioning"
1. About JMV
1.2: What do I need to run JMV?
To view JMV in a web browser, you need to install Java Runtime Environment which provides the Java Plug-In, and also Java3D. See the installation instruction page for more information. Once these are installed, you may view the demo or download the demo applet or source code for yourself.
1.4: Who makes JMV?
JMV is created and maintained by the Theoretical Biophysics Group at Beckman Institute at the University of Illinois. The developers are Michael Bach, Robert Brunner, John Stone, and Kirby Vandivort. Please email jmv@ks.uiuc.edu to contact the JMV development team.
1.5: Where can I get JMV?
JMV samples are available for download from http://www.ks.uiuc.edu/Research/jmv/jmv-0.8/. You can download a sample applet, which includes an html file, a jar file, and a readme file. You can also download the source code. The files you can download are:
(Note:In the following text, <version-number> refers to the most current version of JMV. For example, for version 0.80, jmv-<version-number>.applet.tar.gz would be jmv-0.80.applet.tar.gz)
jmv-<version-number>.applet.tar.gz: The Unix version of the applet. It contains 3 files:
jmv-<version-number>.jar: The jar file containing the class files needed by the applet
JMV.html: the html file
README.TXT: a readme file
Extract the files with the commands:
gunzip jmv-<version-number>.applet.tar.gz;
This will create a directory called jmv-<version-number> containing the 3 files mentioned above. Test JMV by opening JMV.html in a browser.
tar xvf jmv-<version-number>.applet.tar;
jmv-<version-number>.applet.zip: The Windows version of the applet. It contains 3 files:
jmv-<version-number>.jar: The jar file containing the class files needed by the applet
JMV.html: the html file
README.TXT: a readme file
Extract the files with WinZip.
This will create a directory called jmv-<version-number> containing the 3 files mentioned above. Test JMV by opening JMV.html in a browser.
jmv-<version-number>.src.tar.gz: The source code for JMV. It contains source code, benchmark applications, sample molecules, applet files, and the makefile for developers to develop with JMV on their own.
Extract the files with the commands:
gunzip jmv-<version-number>.src.tar.gz;
This will create a directory called jmv containing the source code directories.
tar xvf jmv-<version-number>.src.tar;
2. Starting with JMV
2.2: What kind of files can I load in JMV?
JMV currently reads PDB files, although expansion for more types of files is planned. Using the "Load a file" button, you may load files from a URL, from your local disk, or from the RCSB site with a 4-digit code. Note: To load files not on the applet's host, the applet must be signed. For more on signing applets, see here.
3.1: What do I need to install to run JMV?
To view JMV in a web browser, you need to install Java Runtime Environment which provides the Java Plug-In, and also Java3D. Linux users can download Blackdown's implementation of Java3d here. See the installation instruction page for more information.
3.2: I try to run JMV, but it gives me an error saying: "Plug in not found". What do I do?
To view JMV in a web browser, you need to install Java Runtime Environment which provides the Java Plug-In. Note: You need to have administrator privileges when installing Java in order for the Plug In to be recognized by the browser.
3.3: The Plug-In runs, but the applet window says it can't find Java3D
The browser cannot find Java3D. See Sun's Java3D download site to download Java3D for Windows and Unix, or Blackdown's site for Java3D for Linux.
3.4: For Windows, which version of Java3D should I download?
To run JMV, you only need to download one of the JRE versions, not the SDK. For Windows, there are 2 different versions of Java3D. One is the OpenGL version, the other is the DirectX version. Either one should suffice, although different graphics cards may give different performances depending on which you download. See a comparison between the two at j3d.org here for more information.
4. Exceptions and Errors
4.1: I installed Java and Java3D, but I still get an error: "java.lang.NoClassDefFoundError: com/sun/j3d/utils/applet/JMainFrame".
This often occurs when Java3D is not installed with the version of Java that the browser is using. When there is more than one version of Java installed, Java3D may not get installed with the right one. This can usually be fixed by uninstalling previous versions of Java, and reinstalling Java and Java3D. Or, you can change the path that the Java Plug-In uses for its Java path.
Start the Java Plug-In Control Panel (with the command "ControlPanel" on Suns). In the "Advanced" tab, the "Use Java Plug-In Default" will probably be selected by default. If the dropdown box has a more specific choice, try selecting that. If more than one path appears, select a JRE that has Java3D installed on it. Click "Apply" and try running JMV again.
4.2: I tried loading a molecule, but got a message saying there wasn't enough memory.
If a molecule is too large, the Java Virtual Machine may not have enough memory to create it. If the representation is very memory intensive, such as Bonds or CPK, it may not have enough memory to create the representation. In either case, JMV will give you an error message, and attempt to revert the scene to the last known molecule and representation. If the recovery attempt fails, it will notify you again and clear the screen. You may change the amount of memory in the Java Virtual Machine for your browser by running the Java ControlPanel, and adding the parameter "-Xmx[n]", where [n] is the size of the memory to allow. If n ends with "k", the number is in kilobytes. If n ends with "m", the number is in megabytes.
4.3: I tried switching representations, but got a message saying there wasn't enough memory.
If a representation is very memory intensive, such as Bonds or CPK, it may not have enough memory to create the representation. In either case, JMV will give you an error message, and attempt to revert the scene to the last known molecule and representation. If the recovery attempt fails, it will notify you again and clear the screen. You may change the amount of memory in the Java Virtual Machine for your browser by running the Java ControlPanel, and adding the parameter "-Xmx[n]", where [n] is the size of the memory to allow. If n ends with "k", the number is in kilobytes. If [n] ends with "m", the number is in megabytes.
4.4: I tried loading a molecule, but got a message saying it couldn't be found.
Double check the URL, code, or file path you entered. Make sure the path is correct and spelled correctly.
4.5: I tried loading a molecule, but got a message saying I didn't have permission to access the file.
In order for an applet to access files that are not on its host server, the jar file must be signed. See here for more information on signing jar files.
4.7: I just downloaded and installed Java and Java3D, but when I load a molecule, the cylinders are rotated the wrong way.
This has been seen on occasion. Restarting your computer should fix the problem.
4.8: I just started JMV, but the dropdown menus won't drop down.
We're not sure what's causing this, but to fix it, just move the browser window. The menus should drop down then.
4.9: When I save a jpeg on Windows, the picture isn't getting saved properly.
On Windows, the canvas on which the molecule is displayed must be completely in view and unobscured. If there is another window over the canvas, the window will be in the jpeg. If the canvas is not fully shown in the browser, only the part that is displayed will appear in the browser.
4.10: When I reload a page running JMV, I get a long error message starting with: "Unexpected signal:"
This happens when reloading a page with JMV. This often causes an error in Java, so please try to refrain from reloading a page running JMV.
4.11: JMV says it cannot find Java3D, even though I have it installed.
Start the Java Plug-In Control Panel (with the command "ControlPanel" on Suns). In the "Advanced" tab, the "Use Java Plug-In Default" will probably be selected by default. If the dropdown box has a more specific choice, try selecting that. If more than one path appears, select a JRE that has Java3D installed on it. Click "Apply" and try running JMV again.
4.12: I installed Java3D, but it gives me an UnsatisfiedLinkError saying: "J3D.dll A device attached to the system is not functioning".
Make sure that Java3D is properly installed. On Windows, if the DirectX version of Java3D is installed but DirectX is not, it may produce this error. You may wish to install the OpenGL version instead.
Please direct any other questions or comments to jmv@ks.uiuc.edu.
