Difference between revisions of "Jmol Application"

From Jmol
Jump to navigation Jump to search
(right|Jmol Application window Jmol Application)
Line 19: Line 19:
 
* Double-click on a molecular coordinates file whose extension has been previously associated to Jmol ([[Support/Windows#Associating_molecular_files_.28e.g._PDB.29_in_hard_disk_with_Jmol_application|HowTo]]).
 
* Double-click on a molecular coordinates file whose extension has been previously associated to Jmol ([[Support/Windows#Associating_molecular_files_.28e.g._PDB.29_in_hard_disk_with_Jmol_application|HowTo]]).
  
=== Giving Jmol more memory to work with ===
+
=== Command line options ===
 +
 
 +
==== Giving Jmol more memory to work with ====
 
Memory available to Jmol is determined by Java. Less or more memory can be allocated by using:<br>
 
Memory available to Jmol is determined by Java. Less or more memory can be allocated by using:<br>
 
<code>java -Xmx###m -jar Jmol.jar</code>
 
<code>java -Xmx###m -jar Jmol.jar</code>
Line 28: Line 30:
 
* -Xms sets the minimum memory heap size.
 
* -Xms sets the minimum memory heap size.
 
Batch files and shell scripts included with Jmol 10.2 distribution are written to give -Xmx512m (512 Mb maximum).
 
Batch files and shell scripts included with Jmol 10.2 distribution are written to give -Xmx512m (512 Mb maximum).
 +
 +
==== Advanced options ====
 +
 +
'''Create a JVXL file directly'''
 +
 +
  Jmol -ionx iso.spt myfile.xyz > myfile.jvxl
 +
 +
where:
 +
* -i,--silent          silent startup operation
 +
* -o,--noconsole        no console -- all output to sysout
 +
* -n,--nodisplay        no display (much faster)
 +
* -x,--exit            run script and exit
 +
 +
and iso.spt is:
 +
    isosurface solvent;show isosurface
 +
 +
creates a JVXL solvent surface file.

Revision as of 19:36, 25 September 2006

Jmol Application window
Jmol Application

"Jmol Application" is the version of Jmol that runs as a standalone program, in its own window. It uses the Java programming language.

Control of the molecular model is gained through several means:

  1. The mouse (documented in Mouse Manual).
  2. The application's menu and toolbar (at the top of the window), which offer
    1. File open, export, and print functionalities.
    2. A limited set of selection and rendering options, and several tools.
  3. The pop-up menu (or context menu, opened by right-click or Ctrl+click on the model's panel), which offers most funcionality available and is identical to applet menu.
  4. The scripting language (same used by the applet); this is available through the File > Script... menu, which opens a "script console" or command-line environment.

Starting Jmol Application

Several ways:

  • Double-click on File icon.gifJmol.jar file.
  • Click on a previously created shortcut (Windows terminology) (HowTo).
  • Click on a previously created Start menu entry (Windows terminology) (HowTo).
  • Execute one of the batch files/shell scripts that are part of Jmol distribution (Windows, MacOS, Linux, Unix).
  • From the command line: java -jar Jmol.jar (of course, issued from the folder/directory where Jmol.jar is, or else pointing to it with a full path). See memory options below.
  • Double-click on a molecular coordinates file whose extension has been previously associated to Jmol (HowTo).

Command line options

Giving Jmol more memory to work with

Memory available to Jmol is determined by Java. Less or more memory can be allocated by using:
java -Xmx###m -jar Jmol.jar
where the ### must be substituted by a number in megabytes (hence the "m" after it).

Technically:

  • -Xmx sets the maximum memory heap size.
  • -Xms sets the minimum memory heap size.

Batch files and shell scripts included with Jmol 10.2 distribution are written to give -Xmx512m (512 Mb maximum).

Advanced options

Create a JVXL file directly

 Jmol -ionx iso.spt myfile.xyz > myfile.jvxl

where:

  • -i,--silent silent startup operation
  • -o,--noconsole no console -- all output to sysout
  • -n,--nodisplay no display (much faster)
  • -x,--exit run script and exit

and iso.spt is:

   isosurface solvent;show isosurface

creates a JVXL solvent surface file.