|
|
| (59 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, the native format of Hyperchem, a software sold by [http://www.hyper.com/ Hypercube Inc.].
| |
| − | | |
| − | [http://local.wasp.uwa.edu.au/~pbourke/dataformats/hyperchem/ Example] by Paul Bourke, and other [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.
| |
