www.RasMol.org and www.OpenRasMol.org
RasMol is a program for molecular graphics visualisation originally developed by Roger Sayle. This site is provided for the convenience of users of RasMol and developers of open source versions of RasMol. The site itself is provided courtesy of Bernstein + Sons. Maintenance of RasMol, much of the development, and integration of modifications provided by the community is done at the ARCiB project at RIT. For the convenience of contributors to the RasMol project, an open source collaborative development site is used:
Members of the community are welcome to join us on the site.
Work on RasMol has been supported in part by grants from the U.S. Department of Energy, the U.S. National Science Foundation and the U.S. NIH National Institute of General Medical Sciences. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the funding agencies.
User support in the form of donations will help us to continue the development of RasMol. Registration will help us to keep you posted on new versions.
In order to ensure continuing availability of source code and documentation most programs and documents on this site are subject to copyright. This does not prevent you from using the open-source versions of RasMol, from making copies and changes, but prevents the creation of "closed source" versions out of the open source versions. Appropriate copyrights and licenses appear with the relevant sources and documents. See Copyright and NOTICE for applicable Copyright and other Notices.
Welcome to the RasMol and OpenRasMol web site. This site was established in mid-September 2000 to provide a home for developers of Open Source versions of RasMol. In May 2002, it also became a home page for users of RasMol. RasMol is an important scientific tool for visualisation of molecules created by Roger Sayle in 1992. RasMol is used by hundreds of thousands of users world-wide to view macromolecules and to prepare publication-quality images. Science is best served when the tools we use are fully understood by those who wield those tools and by those who make used of results obtained with those tools. When a scientific tool exists as software, access to source code is an important element in achieving full understanding of that tool. As our field evolves and new versions of software are required, access to source allows us to adapt our tools quickly and effectively.
There has always been free access to the source of the main line of RasMol development. With the creation of the RasMol 2.7 series of releases starting in 1999, RasMol formally became an open source program. There is some confusion about the meaning of the phrase "open source". In the early days of software development, most scientific software source code was freely and openly shared with a minimum of formalities. These days, it appears that carefully drawn legal documents are necessary to protect free access to the source code of scientific software. We are all deeply indebted to Richard Stallman for showing us how a creative combination of copyrights and seemingly restrictive licenses could give us truly unfettered freedom to use programs, to read their source code and to develop new versions. The GNU project, and the Linux project have shown that an open source approach works. Until the RasMol 2.7.3 release, we had not used the GNU General Public License (the "GPL") for OpenRasMol in the past, but the OpenRasMol conditions for use have correctly been called "GPL-like" and starting with RasMol 2.7.3, RasMol may now be distributed under the GPL. In view of the increasing used of GPL'd packages to support new features in RasMol, it is best to use the GPL for all versions from RasMol 2.7.3 onwards. This is certainly the case for binary releases from RasMol 2.7.5 onwards.
You can find a complete explanation of the OpenRasMol conditions for relases prior to the 2.7.3 release (RASLIC) in the page on Copying and Distribution. If you are a user of OpenRasMol programs, you will find that the copyrights and notices ask little more of you than that you avoid mistakes by others by keeping the notices with copies, display scientific integrity by citing your sources properly and treating this like other shared scientific developments by not inferring a warranty. If you are a software developer and wish to incorporate what you find here into new code, or to pick up bits and pieces and used them in another context, the situation becomes more complex. Read the copyrights and notices carefully. You will find that they are "infectious". Whatever you make from our Open Source code must itself be offered as Open Source code. In addition, in order to allow users to understand what has changed and to ensure orderly development you have to describe your changes.
To avoid any misunderstanding -- please note that when you contribute to RasMol by making changes and contributing code, you do not acquire a copyright in the program as a whole. We are delighted to acknowledge each author who contributes and to recognize their copyright from the moment of creation in their modifications, but once they make those modifications a part of RasMol to make what is called a "derived work" the resulting work is under the copyrights of Roger Sayle and Herbert Bernstein. This is necessary so that in the future we can have the option of ensuring that the open source licenses can be continued by transferring the copyright to another organization.
IMPORTANT NOTE:Future releases of RasMol will continue to offer the GPL and RASLIC as alternative licenses for the source code, but, in order to conform to the license conditions of various libraries to which executables may be linked, starting with RasMol 2.7.5 release, the GPL is the only valid license to use the binary distributions.
There is a lot still to be done before this site is fully functional. Many links and features need to be added. With your help, with your comments, suggestions and corrections, and with contributions of new Open Source RasMol code and documentation, hopefully this site will evolve into an increasingly useful tool for the community.
RasMol is a molecular graphics program intended for the visualisation of proteins, nucleic acids and small molecules. The program is aimed at display, teaching and generation of publication quality images. RasMol runs on wide range of architectures and operating systems including Microsoft Windows, Apple Macintosh, UNIX and VMS systems. UNIX and VMS versions require an 8, 24 or 32 bit colour X Windows display (X11R4 or later). The X Windows version of RasMol provides optional support for a hardware dials box and accelerated shared memory communication (via the XInput and MIT-SHM extensions) if available on the current X Server.
The program reads in a molecule coordinate file and interactively displays the molecule on the screen in a variety of colour schemes and molecule representations. Currently available representations include depth-cued wireframes, 'Dreiding' sticks, spacefilling (CPK) spheres, ball and stick, solid and strand biomolecular ribbons, atom labels and dot surfaces.
The X Windows version of RasMol provides optional support for a hardware dials box and accelerated shared memory communication (via the XInput and MIT-SHM extensions) if available on the current X Server.
The program reads in molecular coordinate files and interactively displays the molecule on the screen in a variety of representations and colour schemes. Supported input file formats include Protein Data Bank (PDB), Tripos Associates' Alchemy and Sybyl Mol2 formats, Molecular Design Limited's (MDL) Mol file format, Minnesota Supercomputer Center's (MSC) XYZ (XMol) format, CHARMm format, CIF format and mmCIF format files. If connectivity information is not contained in the file this is calculated automatically. The loaded molecule can be shown as wireframe bonds, cylinder 'Dreiding' stick bonds, alpha-carbon trace, space-filling (CPK) spheres, macromolecular ribbons (either smooth shaded solid ribbons or parallel strands), hydrogen bonding and dot surface representations. Atoms may also be labelled with arbitrary text strings. Alternate conformers and multiple NMR models may be specially coloured and identified in atom labels. Different parts of the molecule may be represented and coloured independently of the rest of the molecule or displayed in several representations simultaneously. The displayed molecule may be rotated, translated, zoomed and z-clipped (slabbed) interactively using either the mouse, the scroll bars, the command line or an attached dial box. RasMol can read a prepared list of commands from a 'script' file (or via inter-process communication) to allow a given image or viewpoint to be restored quickly. RasMol can also create a script file containing the commands required to regenerate the current image. Finally, the rendered image may be written out in a variety of formats including either raster or vector PostScript, GIF, PPM, BMP, PICT, Sun rasterfile or as a MolScript input script or Kinemage.
The RasMol help facility can be accessed by typing "help <topic>" or "help <topic> <subtopic>" from the command line. A complete list of RasMol commands may be displayed by typing "help commands". A single question mark may also be used to abbreviate the keyword "help". Please type "help notices" for important notices.
Released by R. Sayle (RasMol 2.1) 1993
The release of RasMol version 2.7.1 made the following changes to RasMol 2.7.0:
Released by H. J. Bernstein, 22 June 1999
The release of RasMol version 220.127.116.11 made the following changes to RasMol 2.7.1:
Released by H. J. Bernstein, 21 January 2001
The preliminary release of RasMol 2.7.2, made the following changes to RasMol 2.7.1:
This release does not include the toolbar from the UCB mods. In order to resolve some cross-platform issues we have started incorporation of the UCB code for multiple molecules and bond rotation by adding to the command interface and to the menus. We expect to be able to add a toolbar in a future release.
This release is not fully debugged and has some serious problems. This release is intended for testing and experimentation and not for production use. Comments and suggestions would be appreciated. We are aware fo the following deficiencies:
Released by H. J. Bernstein, 28 August 2000
The release of RasMol 18.104.22.168 made the following changes to RasMol 2.7.2, incorporating changes from RasMol 22.214.171.124 and some changes from RasTop 1.3:
This release should hopefully represent a move toward stability for the 2.7.2 versions. However, in order to allow for prompt release of the French and Italian versions, some pending corrections have not yet been integrated. Comments and suggestions appreciated.
Released by H. J. Bernstein, 14 April 2001
The 126.96.36.199.1 release is the final reference release for the 2.7.2 series prior to the creation of version 2.7.3. For most users there should be no operational changes from version 188.8.131.52, except for the correction to the loading of PDB exchange dictionary CIFS.
Note: Patches to command.c were included to fix the handling of load inline in the UCB multiple molecule environment. In addition conditional code controlled by STRICT was disabled to restore operation of load inline under windows. Thanks to Jan Reichert for pointing out these problems. Thanks to E. Martz for pointing out an error in the Spanish translation credits which has been corrected.
Released by H. J. Bernstein, 26 January 2004
The 2.7.3 release is the initial release of the 2.7.3 series. This release includes the base level of code for software rendering of Lee-Richards molecular surfaces, and is intended to provide a stable base for hardware-assisted rendering of molecule surfaces in future releases, and for other changes. Work on RasMol 2.7.3 has been supported in part by grants DBI-0203064, DBI-0315281 and EF-0312612 from the U.S. National Science Foundation and grant DE-FG02-03ER63601 from the U.S. Department of Energy. This release has been in alpha test since February 2005 and is believed to now be ready for beta test. There are major additional changes pending to be applied once this base level is stable, including further molecular surface code and code to apply crystallographic and non-crystallographic symmetry. This release may be distributed under the GPL.
This release is based on RasMol 184.108.40.206.1, the final reference release for the 2.7.2 series. The changes for the 2.7.3 release include:
Released by H. J. Bernstein, 6 February 2005
The major changes in RasMol 2.7.4 are:
write vrml mirror <filename>
will write a vrml file with all axes mirrored (x -> -x, y -> -y and z -> -z) and
write vrml rotate <filename>
will write a vrml file rotated 180 degrees around the x-axis (x - > x, y -> -y, z-> -z)
The svn at http://sf.net/projects/openrasmol should be consulted for details of the code changes.
Released by H. J. Bernstein 21 March 2008
This release is based on RasMol 220.127.116.11, the final reference release for the 2.7.4 series.
The changes made between the 2.7.5 release candidate release of 17 July 2009 and the formal release on 23 July 2009 were:
The major changes in RasMol 2.7.5 are:
Released by H. J. Bernstein 17 July 2009
The Unix version of RasMol supports decompression of compressed data files using pipes. Mamoru Yamanishi has prepared modifications for RasMol 18.104.22.168 to support use of decompression using the zlib (http://www.gzip.org/zlib) library, which should allow decompression of compressed data files on non-Unix platforms. These new modifications are being studied for inclusion in a future RasMol standard release for use on systems for which a pipe to a standard decompression utility is not practical to use. The source code mods to RasMol 22.214.171.124 for use of zlib under Mac OS are available for testing.
Released by Mamoru Yamanishi 13 July 2001
RasTop is a graphical interface to RasMol adapted for Windows platform, i.e. RasTop is a GUI front end for RasWin.
RasTop offers a user-friendly graphical interface around "RasMol molecular engine". No more typing on the command line; each command in the menu generates its own script that is transferred to RasMol. RasTop has numerous extensions to handle atom selections: addition and subtraction of atoms, groups, or chains, selection on screen with a lasso, ability to go back to the previous selection, copying to and pasting selections from the clipboard, new set operations such as inverse, extraction, summation, subtraction, and exclusion, and finally full saving of all user-defined atom sets under an extended script format called RSM script.
During its development, a few new capabilities were added: back clipping, 32-bit output under Windows, full centring command either on a selected atom or to the origin, variation of depthcue in slab mode, and a colouring command, shadepower, which generates new metal-like surfaces.
RasTop allows several molecules to be opened at the same time (on different windows) and provides limited editing of the molecular file.
RasTop 1.3, like RasMol 2.7.1, contains a lot of new code. Under its current version, RasTop 1.3 has been extensively tested with molecular files in pdb format and showed good stability. Nevertheless you should be careful in testing other formats.
Released by P. Valadon, 27 August 2000
This is a minor update with modifications concerning mainly correction of bugs reported for the 1.3 version. The software is now supported under Windows 2000 operating system. The software seems also stable under Windows ME. A release for 8-bit monitors is also available (although never tested on a true 256 colors monitor). A few systems are missing an updated version of the mfc42.dll file which is also available, but requires separate installation.
Operationally, there are very few changes. Maybe the most interesting for rasmol is the use of white color for carbon atoms when there are no hydrogen on the molecule on opening. The squareroot calculations for drawing ribbons at large zoom have been corrected.
Released by P. Valadon, 25 March 2001
RasTop 2.0 is a user-friendly graphical interface build on top of RasMol (version 126.96.36.199) available for Windows platforms. This is a major update over the 1.3.1 version. The interface now accepts multiple molecules. It has high color resolution and improvement of the rendering (depth queuing, multidirectional headlight, new cylinder code, better ribbons). The Richards - Connolly surfaces are now complete. A script can be started automatically on molecule opening.
Comments, suggestions, and bug reports will be extremely appreciated. The immediate goal is to obtain stable multiple molecule environment and compatibility with recent versions of Windows.
Released by P. Valadon, 20 January 2002
In the RasTop 2.1 release "numerous bugs have been corrected ... A command window similar to the one in the original RasMol program has been added. This feature was requested by numerous teachers and was initially developed by Christian Duque. RasTop is now localizable to multiple languages, see RasTop help. A 'scripting' toolbar has been added to improve the handling of scripts. Scripts located in the "rastop/scripts" folder are directly accessible on the new toolbar. Images can be saved as bmp files in 32-bit format.
Released by P. Valadon, 14 September 2004