Template:Jmol application instructions: Difference between revisions

(8 intermediate revisions by the same user not shown)

Line 1:

*'''Put Jmol.jar in your working folder''': Create a folder (directory) on your computer in which to work. Go to [http://jmol.org Jmol.Org], select Download (upper right), go to the Jmol Downloads Page, and download the current version as a binary.zip file. ~~Unzip~~ the file ~~(this is automatic on Macs)~~, and copy the file Jmol.jar (one of a large number of files in the zipped download). This is the Jmol application. Paste it into your working folder.

*'''Put Jmol.jar in your working folder''': Create a folder (directory) on your computer in which to work. Go to [http://jmol.org Jmol.Org], select Download (upper right), go to the Jmol Downloads Page, and download the current version as a binary.zip file. Double click the zip file to unzip it, and copy the file Jmol.jar (one of a large number of files in the zipped download). This is the Jmol application. Paste it into your working folder.

* '''Free java memory''' if your project involves large molecules or assemblies. This is not necessary if your molecule(s) are modest in size (up to ~30,000 atoms). If you skip this step and Jmol gives you an "Out Of Memory" error, then come back and do this step. Close any java-based programs. Close all browser windows or tabs that contain the Jmol applet. Close the Jmol application. You can check Jmol's java memory usage by clicking on ''Jmol'' (in either the applet or the application), then on the main menu, About, System.

<!--* This is probably no longer important: '''Free java memory''' if your project involves large molecules or assemblies. This is not necessary if your molecule(s) are modest in size (up to ~30,000 atoms). If you skip this step and Jmol gives you an "Out Of Memory" error, then come back and do this step. Close any java-based programs. Close all browser windows or tabs that contain the Jmol applet. Close the Jmol application. You can check Jmol's java memory usage by clicking on ''Jmol'' (in either the applet or the application), then on the main menu, About, System.

**Alternatively, or if you still get an ''Out Of Memory'' error, you can [http://wiki.jmol.org/index.php/Jmol_Application#Giving_Jmol_more_memory_to_work_with give Jmol more memory to work with].-->

*'''Run the Jmol application''': Double-click Jmol.jar in your working folder, and a black window will appear titled "Jmol".

**Important for macOS: The first time you run Jmol.jar, right click on it and select "Open with Jar Launcher.app", and then give permission. After doing this once, you can simply double-click on Jmol.jar to run it.

*'''~~Run~~ the Jmol ~~application~~'''~~: Double-click Jmol.jar in your working folder, and a black window will appear titled "Jmol".~~ If the white "Jmol Script Console" window does not appear, use Jmol's File menu (at the top), Console to open it. Now you are ready to enter commands (see the [http://chemapps.stolaf.edu/jmol/docs/ Jmol Interactive Scripting Manual]).

*'''Open the ''Jmol Script Console'':''' If the white "Jmol Script Console" window does not appear, use Jmol's File menu (at the top), Console to open it. Now you are ready to enter commands (see the [http://chemapps.stolaf.edu/jmol/docs/ Jmol Interactive Scripting Manual]).

*'''Copying and pasting:''' To copy or paste commands in the white Jmol Script Console window, use Ctrl-C and Ctrl-V, '''even if working on an Apple Mac OS X!'''. In java windows, the usual Apple Cmd-C and Cmd-V don't work!

@@ Line 1: / Line 1: @@
-*'''Put Jmol.jar in your working folder''': Create a folder (directory) on your computer in which to work. Go to [http://jmol.org Jmol.Org],  select Download (upper right), go to the Jmol Downloads Page, and download the current version as a binary.zip file. Unzip the file (this is automatic on Macs), and copy the file Jmol.jar (one of a large number of files in the zipped download). This is the Jmol application. Paste it into your working folder.
+*'''Put Jmol.jar in your working folder''': Create a folder (directory) on your computer in which to work. Go to [http://jmol.org Jmol.Org],  select Download (upper right), go to the Jmol Downloads Page, and download the current version as a binary.zip file. Double click the zip file to unzip it, and copy the file Jmol.jar (one of a large number of files in the zipped download). This is the Jmol application. Paste it into your working folder.
-* '''Free java memory''' if your project involves large molecules or assemblies. This is not necessary if your molecule(s) are modest in size (up to ~30,000 atoms). If you skip this step and Jmol gives you an "Out Of Memory" error, then come back and do this step. Close any java-based programs. Close all browser windows or tabs that contain the Jmol applet. Close the Jmol application. You can check Jmol's java memory usage by clicking on ''Jmol'' (in either the applet or the application), then on the main menu, About, System.
+<!--* This is probably no longer important: <font color="gray">'''Free java memory''' if your project involves large molecules or assemblies. This is not necessary if your molecule(s) are modest in size (up to ~30,000 atoms). If you skip this step and Jmol gives you an "Out Of Memory" error, then come back and do this step. Close any java-based programs. Close all browser windows or tabs that contain the Jmol applet. Close the Jmol application. You can check Jmol's java memory usage by clicking on ''Jmol'' (in either the applet or the application), then on the main menu, About, System.
+**Alternatively, or if you still get an ''Out Of Memory'' error, you can [http://wiki.jmol.org/index.php/Jmol_Application#Giving_Jmol_more_memory_to_work_with give Jmol more memory to work with].</font>-->
+*'''Run the Jmol application''': Double-click Jmol.jar in your working folder, and a black window will appear titled "Jmol".
+**Important for macOS: The first time you run Jmol.jar, right click on it and select "Open with Jar Launcher.app", and then give permission. After doing this once, you can simply double-click on Jmol.jar to run it.
-*'''Run the Jmol application''': Double-click Jmol.jar in your working folder, and a black window will appear titled "Jmol". If the white "Jmol Script Console" window does not appear, use Jmol's File menu (at the top), Console to open it. Now you are ready to enter commands (see the [http://chemapps.stolaf.edu/jmol/docs/ Jmol Interactive Scripting Manual]).
+*'''Open the ''Jmol Script Console'':''' If the white "Jmol Script Console" window does not appear, use Jmol's File menu (at the top), Console to open it. Now you are ready to enter commands (see the [http://chemapps.stolaf.edu/jmol/docs/ Jmol Interactive Scripting Manual]).
-*'''Copying and pasting:''' To copy or paste commands in the white Jmol Script Console window, use Ctrl-C and Ctrl-V, '''even if working on an Apple Mac OS X!'''. In java windows, the usual Apple Cmd-C and Cmd-V don't work!
+<!--*This no longer seems necessary for OS X: <font color="gray">'''Copying and pasting:''' To copy or paste commands in the white Jmol Script Console window, use <font color="red">'''Ctrl-C'''</font> and <font color="red">'''Ctrl-V'''</font>, '''even if working on an Apple Mac OS X!'''. In java windows, the usual Apple Cmd-C and Cmd-V don't work! You can also select blocks of text with your mouse, then drag and drop them.</font>-->