Difference between revisions of "File formats"

From Jmol
Jump to navigation Jump to search
m ((Gaussian) Cube)
m
 
(60 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
{{Jmol_Documentation_Sections}}
 
(An attempt to compile information on file format specifications. It's not complete yet.)
 
(An attempt to compile information on file format specifications. It's not complete yet.)
  
Jmol [http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/ example/test data files] in all formats accepted.
+
Jmol [{{SVN Trunk}}Jmol-datafiles/ example/test data files] in all formats accepted.
  
[http://en.wikipedia.org/wiki/Chemical_file_format Chemical file formats] on Wikipedia.
+
[[:en:Chemical_file_format|Chemical file formats]] on Wikipedia.
  
 +
[http://openbabel.sourceforge.net/wiki/Category:Formats File formats] on Open Babel.
  
= Coordinates of molecule =
+
Nice description of [http://reference.wolfram.com/mathematica/guide/3DGeometryAndModelingFormats.html 3D Geometry & Modeling Formats] by Wolfram Mathematica.
  
== (MDL) MOL and SD ==
+
See the specific subsections:
Jmol reads MOL and SD files (and can write MOL files under some circumstances).
+
<div style="width:30ex;">
 
+
{{File_Formats}}
Original from Elsevier MDL.
+
</div>
 
+
<div style="clear:both;"></div>
Official document: http://www.mdl.com/downloads/public/ctfile/ctfile.pdf, copied [http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/mol/ctfile.pdf here].
 
 
 
[http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/mol/ Example files].
 
 
 
 
 
== PDB ==
 
Jmol reads PDB files.
 
 
 
(Official Protein Data Bank document) Atomic Coordinate Entry Format Description:
 
http://www.pdb.org/pdb/file_formats/pdb/pdbguide2.2/guide2.2_frame.html
 
 
 
[http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/pdb/ Example files].
 
 
 
 
 
== XYZ ==
 
Jmol reads XYZ files.
 
[http://local.wasp.uwa.edu.au/~pbourke/dataformats/xyz/ Example] by Paul Bourke.
 
 
 
[http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/xyz/ Example files].
 
 
 
 
 
== CIF ==
 
Jmol reads CIF files.
 
Crystallographic Information File, the official format from the International Union of Crystallography. [http://www.iucr.org/iucr-top/cif/standard/cifstd1.html Original documentation], Acta Cryst. (1991). A47, 655-685, and [http://www.iucr.org/iucr-top/cif/spec/version1.1/index.html 2003 update].
 
 
 
 
 
== mmCIF ==
 
Jmol reads mmCIF files.
 
Macromolecular Crystallographic Information File, an expanded format to cope with macromolecules.
 
[http://www.pdb.org/robohelp/ftp/files_formats/structures/chemical_component_format/chemical_component_mmcif_format.htm Official documentation].
 
 
 
 
 
== Gaussian ==
 
Gaussian input, output and log [http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/gaussian/ example files].
 
 
 
 
 
== (Gaussian) Cube ==
 
Jmol reads Cube files.
 
 
 
Original from Gaussian software ([http://www.gaussian.com/ Gaussian website]).
 
 
 
Description of Cube Input and Cube Output formats:
 
http://www.nersc.gov/nusers/resources/software/apps/chemistry/gaussian/g98/00000430.htm
 
 
 
[http://local.wasp.uwa.edu.au/~pbourke/dataformats/cube/ Description] by Paul Bourke.
 
 
 
[http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/cube/ Example files].
 
 
 
 
 
== (Hyperchem) HIV ==
 
Jmol reads HIV files.
 
[http://local.wasp.uwa.edu.au/~pbourke/dataformats/hyperchem/ Example] by Paul Bourke.
 
 
 
[http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/hin/ Example files].
 
 
 
 
 
== (Tripos) Alchemy ==
 
Jmol reads Alchemy and Alchemy2000 files.
 
[http://local.wasp.uwa.edu.au/~pbourke/dataformats/alc/alc3/ Alchemy example] and [http://local.wasp.uwa.edu.au/~pbourke/dataformats/alc/ Alchemy2000 description] by Paul Bourke.
 
 
 
 
 
== GAMESS ==
 
Jmol reads GAMESS files (General Atomic and Molecular Electronic Structure System, by Gordon research group at Iowa State University).
 
 
 
[http://www.msg.ameslab.gov/GAMESS/doc.menu.html Official documentation].
 
 
 
 
 
= Surfaces =
 
 
 
== Jmol Voxel (JVXL) ==
 
Jmol reads and writes JVXL files.
 
 
 
This format is unique to Jmol, stores isosurface data.
 
 
 
Documented at http://www.stolaf.edu/academics/chemapps/jmol/docs/misc/JVXL-format.pdf
 
 
 
 
 
== Pmesh ==
 
Jmol reads pmesh files for rendering pmesh surfaces, using not the <code>load</code> command, but the <code>pmesh</code> command.
 
[http://www.stolaf.edu/academics/chemapps/jmol/docs/#pmesh Description].
 
 
 
Example files [http://svn.sourceforge.net/viewvc/jmol/trunk/Jmol-datafiles/pmesh/ _1_] and [http://www.stolaf.edu/academics/chemapps/jmol/docs/misc/10x10pmesh.txt _2_].
 
 
 
 
 
== (Gaussian) Cube ==
 
 
 
See [[#(Gaussian)_Cube|above]].
 
 
 
= Scripting =
 
 
 
== Script format ==
 
Jmol reads script files, using not the <code>load</code> command, but the <code>script</code> command. These are plain-text files containing commands in the Jmol/Rasmol/Chime syntax, that will modify the way the molecular model is shown. The file can have any extension.
 
 
 
 
 
== Inline formats ==
 
Molecular data are usually contained in an external file and loaded into Jmol using the <code>load</code> command, but they can also be contained within the webpage (or fed into it using JavaScript or PHP, e.g. from a database).
 
 
 
In turn, script commands can also be contained in the molecular file.
 
 
 
To allow for this "inline" formats, several methods are implemented:
 
 
 
''[Please, note that these are advanced procedures. For normal needs, they can be avoided in favour of using normal scripting practices.]''
 
 
 
=== Molecular coordinates inline within a webpage ===
 
Can be done using direct instructions for the applet or, more easily, using functions in the Jmol.js library: <code>[http://jmol.org/jslibrary/#jmolAppletInline jmolAppletInline], [http://jmol.org/jslibrary/#jmolLoadInline jmolLoadInline], [http://jmol.org/jslibrary/#jmolLoadInlineScript jmolLoadInlineScript]</code>.
 
 
 
=== Molecular coordinates inline within a script or script file ===
 
Can be done using the <code>[http://www.stolaf.edu/academics/chemapps/jmol/docs/?ver=11.0#data data "model"]</code> command (Jmol 11 only).
 
 
 
=== Script inline within a molecular coordinates file ===
 
Scripts can be included after a <code>#jmolscript:</code> tag (case-sensitive). This must be taken as a comment by the molecular file parser, so its location depends on the file format:
 
* In a PDB file, use <code>REMARK #jmolscript:</code> in any line, followed by the script commands in the same line.
 
* In a MOL file, use <code>#jmolscript:</code> in the '''third line''', followed by the script commands in the same line. Note, however, that <code>#</code> cannot be the first character on that line, so use an initial '''space''' if nothing else.
 
* In an XYZ file, use <code>#jmolscript:</code> in the '''second line''', followed by the script commands in the same line.
 
 
 
In all cases, the script will be applied after the whole molecule has loaded.
 

Latest revision as of 22:56, 26 January 2020

Jmol + JSmol Documentation

(An attempt to compile information on file format specifications. It's not complete yet.)

Jmol example/test data files in all formats accepted.

Chemical file formats on Wikipedia.

File formats on Open Babel.

Nice description of 3D Geometry & Modeling Formats by Wolfram Mathematica.

See the specific subsections: