Difference between revisions of "Files Description/Jmol 14"

From Jmol
Jump to navigation Jump to search
(added documentation sections template)
(separate this legacy info from current one for Jmol 16)
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This information is also included in Jmol distribution {{File|README}} file.
+
'''''This is valid up to some Jmol version 14.x; for later versions, see [[Files_Description]]'''''
  
{{Jmol_Documentation_Sections}}
+
'''''For Jmol versions previous to 13.2, see [[Files_Description/Jmol_12]]'''''
=== Common files in Jmol distributions ===
 
(This refers to both {{File|jmol-x.x.x-binary.zip}} and
 
{{File|jmol-x.x.x-binary.tar.gz}};
 
<br>
 
{{File|jmol-x.x.x-full.tar.gz}} contains the full source code)
 
  
 +
<!--This information is also included in Jmol distribution {{File|README}} file.-->
  
==== Jmol.jar ====
+
The Jmol distribution is available for download as 3 different files:
 +
* {{File|jmol-x.x.x-binary.zip}} contains all files needed for using Jmol, compressed using the <code>zip</code> format.
 +
* {{File|jmol-x.x.x-binary.tar.gz}}  contains the same files, in a <code>tar</code> structure and compressed using the <code>gzip</code> format.
 +
* {{File|jmol-x.x.x-full.tar.gz}} contains the full source code. This will only be useful to developers and programmers wanting to study Jmol programming design or to modify Jmol.
  
The application executable file (a program written in Java). This works as any other program: opens in its own window, can be resized or minimized, admits drag-and-drop of files over it, has a top menu, can open and save files, etc. It can be open from the command line (particulary, using the shell or batch files described below), but if Java is properly configured in your system, it's usually enough to double-click on the file.
+
Following is a description of the files contained in any of the first two downloadable files.
  
==== JmolApplet.jar ====
+
{{Jmol_Documentation_Sections}}
  
The applet, i.e. a version of the program that will only run when embedded in a web page.
+
== Files with information ==
  
This is an all-in-one or monolithic file, kept mainly for compatibility with old pages that call it explicitly. Current recommended procedure is to use the split version ({{File|JmolApplet0.jar}} etc.). In particular, {{File|Jmol.js}} uses the split version.
+
=== COPYRIGHT.txt ===
 +
The copyright explanations regarding Jmol and its 3rd-party components.
  
You may wish to use this if you want to keep your website simple or you just want to upload a single jar file whenever new versions are released.  
+
=== LICENSE.txt ===
However, this will load Jmol somewhat slower than the split versions (described below), as all the modules must get loaded onto a user's machine before any structure is displayed.
+
The GNU Lesser General Public License, under which Jmol is released.
  
To invoke JmolApplet.jar from Jmol.js, either:
+
=== README.txt ===
 +
A general description of Jmol package and sources of information, including this file list documentation.
  
a) put it in the directory containing the HTML page requiring it and
+
=== LEAME.txt ===
do not use jmolInitialize(),
+
The Spanish version of README.txt
  
or
+
=== CHANGES.txt ===
 +
A list with a history of the feature additions in each version of Jmol.
  
b) identify it explicitly in jmolInitialize(), for example:
+
<br>
jmolInitialize("directory-containing-jar-files", "JmolApplet.jar")
+
== Batch and shell files ==
 
+
These can be used to start Jmol application from a command line and, particularly, to impose a certain combination of parameters (see [[Jmol_Application#Command_line_options|command line options]]).
==== JmolAppletSigned.jar ====
 
 
 
An equivalent version of the applet, but this is a "signed" applet (a term in Java security language). This means it must be authorized by the web page visitor for it to run, but then it will have less security restrictions for file access. For example, it can access files on any part of the user's hard disk or from any other web server.
 
 
 
Typically users get a message asking if they want to accept the
 
"certificate" or if they "trust" the applet, but this security feature is not always enabled.
 
JmolAppletSigned.jar should be used with this in mind. Other than reading
 
files, Jmol does not currently utilize other capabilities of signed
 
applets, such as accessing the System clipboard or writing files. Use only
 
if you know what you are doing and have considered the security issues.
 
 
 
To invoke JmolAppletSigned.jar from Jmol.js, use:
 
jmolInitialize("directory-containing-jar-files", "JmolAppletSigned.jar")
 
 
 
==== Jmol.js ====
 
 
 
The library, written in JavaScript language, that assists in the programming of web pages that use Jmol applet, without the need to know and write detailed JmolApplet code.
 
 
 
This library uses by default the split version of the applet (unsigned or signed).
 
 
 
Fully documented at http://jmol.org/jslibrary/
 
 
 
==== jmol ====
 
  
 +
=== jmol ===
 
???? (Some kind of batch file)
 
???? (Some kind of batch file)
  
==== jmol.bat ====
+
=== jmol.bat ===
 
 
 
A batch file to start Jmol application under Windows.
 
A batch file to start Jmol application under Windows.
  
==== jmol.mac ====
+
=== jmol.mac ===
 
 
 
??? (Some kind of batch file)
 
??? (Some kind of batch file)
  
==== jmol.sh ====
+
=== jmol.sh ===
 
 
 
A shell script to start Jmol application under Unix-like systems, like Linux, BSD, Solaris and Cygwin for Windows.
 
A shell script to start Jmol application under Unix-like systems, like Linux, BSD, Solaris and Cygwin for Windows.
  
==== COPYRIGHT.txt ====
+
Under Linux, there are a number of ways to start Jmol as a standalone program using the {{file|jmol.sh}} script:<br>
 +
(1)
 +
sh jmol.sh                      // start Jmol under the jmol-xxx folder
 +
sh yourpath/jmol-xxx/jmol.sh    // start Jmol from anywhere
 +
(2)
 +
chmod +x jmol.sh                // make the ''jmol.sh'' script executable
 +
jmol.sh                        // start Jmol inside the jmol-xxx directory, or 
 +
yourpath/jmol-xxx/jmol.sh      // start Jmol anywhere
 +
(3)
 +
chmod +x jmol.sh                // make the ''jmol.sh'' script executable 
 +
ln -s yourpath/jmol-xxx/jmol.sh /usr/local/bin/jmol.sh //create a symbolic link under /usr/local/bin
 +
Add the following shell variable in the shell script {{file|$HOME/.bash_profile}}
 +
export JMOL_HOME="/yourpath/jmol-xxx/"
 +
Reboot your computer or execute
 +
source $HOME/.bash_profile
 +
Then
 +
jmol.sh                          // start Jmol anywhere
 +
(4) Move the {{file|jmol-xxx}} folder to {{file|/usr/bin/}} or {{file|/usr/local/bin/}}
 +
chmod +x jmol.sh                  // make the ''jmol.sh'' script executable
 +
ln -s /usr/bin/jmol-xxx/jmol.sh /usr/bin/jmol.sh          // or
 +
ln -s /usr/bin/jmol-xxx/jmol.sh /usr/local/bin/jmol.sh    // or
 +
ln -s /usr/local/bin/jmol-xxx/jmol.sh /usr/bin/jmol.sh    //or
 +
ln -s /usr/local/bin/jmol-xxx/jmol.sh /usr/local/bin/jmol.sh
 +
jmol.sh                          // start Jmol from anywhere
  
The copyright explanations.
+
<br>
 +
== Files of Jmol application ==
 +
This is used as a standalone program.
  
==== LICENSE.txt ====
+
=== Jmol.jar ===
 +
The application executable file (a program written in Java). This works as any other program: opens in its own window, can be resized or minimized, admits drag-and-drop of files over it, has a top menu bar, can open and save files, etc. It can be open from the command line (particulary, using the shell or batch files described above), but if Java is properly configured in your system, it's usually enough to double-click on the file (see [[Jmol_Application#Starting_Jmol_Application|Starting Jmol Application]] for more details).
  
The GNU Lesser General Public License, under which Jmol is released.
+
=== JmolData.jar ===
 +
This is a slimmed down version of Jmol.jar that lacks all visualization capabilities. So, it betrays the whole (classic) concept of what Jmol is, but with JmolData and some clever scripting you can get just about any information you want out of a model and output it any way you want.
  
==== README.txt ====
+
It operates only from the command line, designed for extracting data from a model or set of models. You are limited to commands that don't have to do with visualization: there are bonds but no "sticks", atoms but no "dots", helices but no "cartoons".
  
A general description of Jmol package and sources of information, including this file list documentation.
+
=== JmolLib.jar ===
 +
This is a library, meant to make Jmol a module or part of a bigger project, that is, to integrate Jmol viewer inside another software.
  
 +
<br>
 +
== Files of the Jmol object ==
 +
=== jsmol.zip ===
 +
This file includes in compressed form all the files for using J(S)mol inside web pages, such as:
 +
* Applet files (for the Java modality of Jmol object)
 +
* Javascript libraries (for the definition of the Jmol object in all cases, and specifically for the HTML5 modality of Jmol object)
  
=== Files specific to Jmol versions up to 11.1.29 ===
+
For details on the files contained, their purpose and how to use them, please see [[Jmol_JavaScript_Object#Installation]]
 
 
==== JmolApplet0.jar, JmolApplet1.jar, ... JmolApplet6.jar, JmolApplet_i18n.jar ====
 
 
 
The applet divided up into several pieces, hopefully for faster loading. The set of these files is equivalent to the single {{File|JmolApplet.jar}}. This split version is used by default by {{File|Jmol.js}}.
 
 
 
{{File|JmolApplet_i18n.jar}} is the localization module of the applet (i.e., translation of the interface into several languages).
 
This must accompany the {{File|JmolApplet#.jar}} set if you want the interface in a language different from English. (The language shown will depend on the operating system's language.)
 
 
 
==== JmolAppletSigned0.jar, JmolAppletSigned1.jar, ... JmolAppletSigned6.jar, JmolAppletSigned_i18n.jar ====
 
 
 
The signed version of the above split applet. (See JmolAppletSigned.jar above for description of what a "signed" applet is.)
 
 
 
 
 
=== Files specific to Jmol versions after 11.1.36 ===
 
 
 
==== JmolApplet0.jar, JmolApplet0''(severalSuffixes)''.jar ====
 
 
 
The applet is divided up into several pieces according to their  
 
function, so that if a page does not require a component, that
 
component is not downloaded from the server.
 
It is still recommended that you put all JmolApplet0*.jar
 
files on your server even if your page does not use the capabilities
 
provided by some of the files, because the pop-up menu and Jmol console
 
both allow users to access parts of Jmol you might not have considered.
 
 
 
The set of these files is equivalent to the single {{File|JmolApplet.jar}}.
 
 
 
This split version is the one that will be used by default if you use {{File|Jmol.js}}.
 
For that, use the simplest form of jmolInitialize(), just
 
indicating the directory containing the set of jar files:
 
jmolInitialize("directory-containing-jar-files")
 
for example,
 
jmolInitialize(".")  // jar files are in the same folder as the web page
 
jmolInitialize("../jmol") // jar files are in a parallel folder, named 'jmol'.
 
 
 
==== JmolAppletSigned0.jar, JmolAppletSigned0''(severalSuffixes)''.jar ====
 
 
 
The signed version of the new split applet.
 
This version allows the user to access files anywhere on a hard drive and from any location on the web.
 
Typically users get a message asking if they want to accept the
 
certificate for '''each''' of the 16 loadable files. For this reason,
 
this version may not be of general use.
 
 
 
To use this with Jmol.js, use the form:
 
jmolInitialize("directory-containing-jar-files", true)
 
or
 
jmolInitialize("directory-containing-jar-files", "JmolAppletSigned0.jar")
 
 
 
=== Notes ===
 
 
 
# Given the descriptions, you will realize that the distribution package contains 4 full copies of the applet (signed or unsigned, split or not).
 

Latest revision as of 15:14, 18 April 2024

This is valid up to some Jmol version 14.x; for later versions, see Files_Description

For Jmol versions previous to 13.2, see Files_Description/Jmol_12


The Jmol distribution is available for download as 3 different files:

  • File icon.gifjmol-x.x.x-binary.zip contains all files needed for using Jmol, compressed using the zip format.
  • File icon.gifjmol-x.x.x-binary.tar.gz contains the same files, in a tar structure and compressed using the gzip format.
  • File icon.gifjmol-x.x.x-full.tar.gz contains the full source code. This will only be useful to developers and programmers wanting to study Jmol programming design or to modify Jmol.

Following is a description of the files contained in any of the first two downloadable files.

Jmol + JSmol Documentation

Files with information

COPYRIGHT.txt

The copyright explanations regarding Jmol and its 3rd-party components.

LICENSE.txt

The GNU Lesser General Public License, under which Jmol is released.

README.txt

A general description of Jmol package and sources of information, including this file list documentation.

LEAME.txt

The Spanish version of README.txt

CHANGES.txt

A list with a history of the feature additions in each version of Jmol.


Batch and shell files

These can be used to start Jmol application from a command line and, particularly, to impose a certain combination of parameters (see command line options).

jmol

???? (Some kind of batch file)

jmol.bat

A batch file to start Jmol application under Windows.

jmol.mac

??? (Some kind of batch file)

jmol.sh

A shell script to start Jmol application under Unix-like systems, like Linux, BSD, Solaris and Cygwin for Windows.

Under Linux, there are a number of ways to start Jmol as a standalone program using the File icon.gifjmol.sh script:
(1)

sh jmol.sh                      // start Jmol under the jmol-xxx folder 
sh yourpath/jmol-xxx/jmol.sh    // start Jmol from anywhere 

(2)

chmod +x jmol.sh                // make the jmol.sh script executable 
jmol.sh                         // start Jmol inside the jmol-xxx directory, or  
yourpath/jmol-xxx/jmol.sh       // start Jmol anywhere

(3)

chmod +x jmol.sh                // make the jmol.sh script executable  
ln -s yourpath/jmol-xxx/jmol.sh /usr/local/bin/jmol.sh //create a symbolic link under /usr/local/bin

Add the following shell variable in the shell script File icon.gif$HOME/.bash_profile

export JMOL_HOME="/yourpath/jmol-xxx/"

Reboot your computer or execute

source $HOME/.bash_profile 

Then

jmol.sh                          // start Jmol anywhere 

(4) Move the File icon.gifjmol-xxx folder to File icon.gif/usr/bin/ or File icon.gif/usr/local/bin/

chmod +x jmol.sh                  // make the jmol.sh script executable 
ln -s /usr/bin/jmol-xxx/jmol.sh /usr/bin/jmol.sh          // or
ln -s /usr/bin/jmol-xxx/jmol.sh /usr/local/bin/jmol.sh    // or
ln -s /usr/local/bin/jmol-xxx/jmol.sh /usr/bin/jmol.sh    //or
ln -s /usr/local/bin/jmol-xxx/jmol.sh /usr/local/bin/jmol.sh
jmol.sh                          // start Jmol from anywhere


Files of Jmol application

This is used as a standalone program.

Jmol.jar

The application executable file (a program written in Java). This works as any other program: opens in its own window, can be resized or minimized, admits drag-and-drop of files over it, has a top menu bar, can open and save files, etc. It can be open from the command line (particulary, using the shell or batch files described above), but if Java is properly configured in your system, it's usually enough to double-click on the file (see Starting Jmol Application for more details).

JmolData.jar

This is a slimmed down version of Jmol.jar that lacks all visualization capabilities. So, it betrays the whole (classic) concept of what Jmol is, but with JmolData and some clever scripting you can get just about any information you want out of a model and output it any way you want.

It operates only from the command line, designed for extracting data from a model or set of models. You are limited to commands that don't have to do with visualization: there are bonds but no "sticks", atoms but no "dots", helices but no "cartoons".

JmolLib.jar

This is a library, meant to make Jmol a module or part of a bigger project, that is, to integrate Jmol viewer inside another software.


Files of the Jmol object

jsmol.zip

This file includes in compressed form all the files for using J(S)mol inside web pages, such as:

  • Applet files (for the Java modality of Jmol object)
  • Javascript libraries (for the definition of the Jmol object in all cases, and specifically for the HTML5 modality of Jmol object)

For details on the files contained, their purpose and how to use them, please see Jmol_JavaScript_Object#Installation