RASMOL(1)

📦 version 2.7.4.2, in opensuse-leap 16.0

✨ NAME ✨

rasmol — Molecular Graphics Visualisation Tool v2.7.4.1

okok so bestie, welcome to RasMol 💅 this is the manual page for the molecular graphics visualisation tool, version v2.7.4.1, and we're gonna get through it together. Buckle up. 🧚

🫶 SYNOPSIS 🫶

here's the whole vibe of how you launch it:

rasmol [-nodiplay] [[-format ] filename] [-script scriptfile]

that's it, that's the door. 🚪✨

🌈 FORMATS 🌈

okay so these are the file formats it knows how to read, and you tell it which one with a flag — each one maps to a format name, no cap:

-pdb — Protein Data Bank
-mdl — MDL's MOL File Format
-mol2 — Tripos' Sybyl MOL2 Format
-xyz — MSC's XYZ (XMol) Format
-mopac — MOPAC Input or Output File Format
-alchemy — Alchemy File Format
-charmm — CHARMm File Format
-cif — IUCr CIF or CIF File Format

🎀 NOTICES 🎀

okay so this is the part where we give credit where credit is due, because this software was literally assembled from several sources and that's iconic of it. 🫶

Much of the code is from RasMol 2.6, as created by Roger Sayle. The torsion angle code, new POVRAY3 code and other features are derived from the RasMol2.6x1 revisions by Arne Mueller. The Ramachandran printer plot code was derived from fisipl created by Frances C. Bernstein. See the Protein Data Bank program tape. 📼

The code to display multiple molecules and to allow bond rotation is derived in large part from the UCB mods by Gary Grossman and Marco Molinaro, included with permission of Eileen Lewis of the ModularCHEM Consortium. king behavior honestly 👑

The CIF modifications make use of a library based in part on CBFlib by Paul J. Ellis and Herbert J. Bernstein. Parts of CBFlib is loosely based on the CIFPARSE software package from the NDB at Rutgers university. 🌸

Please type the RasMol commands help copying, help general, help IUCR, help CBFlib, and help CIFPARSE for applicable notices. Please type help copyright for copyright notices. If you use RasMol V2.6 or an earlier version, type the RasMol command help oldnotice.

like, genuinely, go type those. the receipts are in there 💀

💖 COPYING 💖

so this version is based directly on RasMol version 2.7.4, on RasMol version 2.7.3.1, on RasMol version 2.7.3, on RasMol version 2.7.2.1.1, Rasmol version 2.7.2, RasMol version 2.7.1.1 and RasTop version 1.3, and indirectly on the RasMol 2.5-ucb and 2.6-ucb versions and version 2.6_CIF.2, RasMol 2.6x1 and RasMol_2.6.4. that's a whole family tree fr fr 🌳

RasMol 2.7.4.1 may be distributed under the terms of the GNU General Public License (the GPL), see

http://www.gnu.org/licenses/gpl.txt

or the file GPL or type the command help GPL

or RasMol 2.7.4.1 may be distributed under the RASMOL license. See the file NOTICE or type the command help RASLIC

📜 GPL — GNU GENERAL PUBLIC LICENSE, Version 2, June 1991 📜

okay bestie, this next bit is a license, and you literally cannot vibe-edit a license, so here it is word for word. don't come for me, the lawyers said so 😭💀

GNU GENERAL PUBLIC LICENSE Version 2, June 1991

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Preamble

The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too.

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.

To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.

For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.

We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software.

Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.

Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.

The precise terms and conditions for copying, distribution and modification follow.

GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you".

Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.

1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.

You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.

2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:

a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.
c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program.

In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.

3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:

a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
b) — ok so this option is literally "Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange". three whole years minimum bestie, that's the vibe 💅
c) — or "Accompany it with the information you received as to the offer to distribute corresponding source code". and the parenthetical, because there's always a parenthetical: "(This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.)" 🎀

okay now for the definition of the thing we keep talking about. "The source code for a work means the preferred form of the work for making modifications to it." that's the whole point, no cap. "For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable." all of it. every crumb. 🍓

but here's the exception, and it's a real one: "However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable." so like, you don't have to ship the whole kernel, bestie, calm down 😭

and this part is iconic: "If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code." mirror it, that's it, that's the deal ✨

4. "You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance." 💀 so if you go rogue you lose your rights, but everyone downstream who's behaving keeps theirs. generous queen behavior tbh 👑

5. "You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it." 👀 you didn't sign anything, but if you touch it, you're in. that's the plot twist.

6. "Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License." 🫶 the license just. keeps going. it's giving chain letter but make it legal.

7. okay this is the long one, stay with me: "If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program." 😭 so: conflict = don't distribute. that's the whole escape hatch.

then: "If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances." 🌸

and the why, because people always ask why: "It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice." 🔥 the author decides, not the licensee. rules are rules.

then the little closer: "This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License." 💜

8. "If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License." 🌈 geo-restrictions are allowed and they count as if they were literally written into the license. noted.

9. "The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns." new versions drop sometimes, same energy, different details ✨

"Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation." 👑 your pick, bestie.

10. "If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally." 🎀 just ask. email exists.

🌸 NO WARRANTY 🌸

this whole section is in all caps in the original and honestly it's yelling for a reason. it's the "don't come for us" section. read it, it matters. 😭

11. "BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION." 💀 free means free, and the risk is yours.

12. "IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES." 🙈 all caps again. it's serious. no cap.

🦋 END OF TERMS AND CONDITIONS 🦋

💖 How to Apply These Terms to Your New Programs 💖

okay so you wrote something and you want the whole world to be able to share it? "If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms." literally the dream, periodt 🌟

"To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found." 👑

here's the template, copy it exactly bestie, put your own bits in the angle brackets:

<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year>  <name of author>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

"Also add information on how to contact you by electronic and paper mail." 📬 yes, both kinds, it's giving old school but it's the rule.

"and if the program is interactive, make it output a short notice like this when it starts in an interactive mode:" — okay so that's the next bit, and honestly the interactive startup notice is its own whole moment, so 💅

...and here's the rest of that sample notice, bestie — literally copy it, just swap the names:

Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.

okay so the hypothetical commands show w and show c should show the appropriate parts of the General Public License — cute, right? And yes, of course, the commands you use may be called something other than show w and show c; they could even be mouse-clicks or menu items — whatever suits your program. whatever suits your program, periodt.

You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names:

Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.

<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice

This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. like, the GPL's whole thing is not letting people close it off — if you need that, there's a whole separate license for it, iykyk.

🎀 RASLIC 🎀

If you do not use the GPL, the following license terms apply:

RasMol License

Even though the authors of the various documents and software found here have made a good faith effort to ensure that the documents are correct and that the software performs according to its documentation, and we would greatly appreciate hearing of any problems you may encounter, the programs and documents and any files created by the programs are provided AS IS without any warranty as to correctness, merchantability or fitness for any particular or general use. no promises, bestie — they tried their best, but they're not guaranteeing anything.

THE RESPONSIBILITY FOR ANY ADVERSE CONSEQUENCES FROM THE USE OF PROGRAMS OR DOCUMENTS OR ANY FILE OR FILES CREATED BY USE OF THE PROGRAMS OR DOCUMENTS LIES SOLELY WITH THE USERS OF THE PROGRAMS OR DOCUMENTS OR FILE OR FILES AND NOT WITH AUTHORS OF THE PROGRAMS OR DOCUMENTS. that's you. you're the user. it's on you. 😭

Subject to your acceptance of the conditions stated above, and your respect for the terms and conditions stated in the notices below, if you are not going to make any modifications or create derived works, you are given permission to freely copy and distribute this package, provided you do the following:

Either include the complete documentation, especially the file NOTICE, with what you distribute or provide a clear indication where people can get a copy of the documentation; and
Please give credit where credit is due citing the version and original authors properly; and
Please do not give anyone the impression that the original authors are providing a warranty of any kind.

If you would like to use major pieces of RasMol in some other program, make modifications to RasMol, or in some other way make what a lawyer would call a "derived work", you are not only permitted to do so, you are encouraged to do so. In addition to the things we discussed above, please do the following:

Please explain in your documentation how what you did differs from this version of RasMol; and
Please make your modified source code available.

This version of RasMol is not in the public domain, but it is given freely to the community in the hopes of advancing science. If you make changes, please make them in a responsible manner, and please offer us the opportunity to include those changes in future versions of RasMol. science bestie behaviour only, pls. 🧚

✨ General Notice ✨

The following notice applies to this work as a whole and to the works included within it:

Creative endeavors depend on the lively exchange of ideas. There are laws and customs which establish rights and responsibilities for authors and the users of what authors create. This notice is not intended to prevent you from using the software and documents in this package, but to ensure that there are no misunderstandings about terms and conditions of such use.
Please read the following notice carefully. If you do not understand any portion of this notice, please seek appropriate professional legal advice before making use of the software and documents included in this software package. In addition to whatever other steps you may be obliged to take to respect the intellectual property rights of the various parties involved, if you do make use of the software and documents in this package, please give credit where credit is due by citing this package, its authors and the URL or other source from which you obtained it, or equivalent primary references in the literature with the same authors. yes, actually read it — if something's confusing, go ask a real lawyer, not me. 🙈
Some of the software and documents included within this software package are the intellectual property of various parties, and placement in this package does not in any way imply that any such rights have in any way been waived or diminished.
With respect to any software or documents for which a copyright exists, ALL RIGHTS ARE RESERVED TO THE OWNERS OF SUCH COPYRIGHT. all of them. every single right. reserved. periodt.
Even though the authors of the various documents and software found here have made a good faith effort to ensure that the documents are correct and that the software performs according to its documentation, and we would greatly appreciate hearing of any problems you may encounter, the programs and documents and any files created by the programs are provided AS IS without any warranty as to correctness, merchantability or fitness for any particular or general use.
THE RESPONSIBILITY FOR ANY ADVERSE CONSEQUENCES FROM THE USE OF PROGRAMS OR DOCUMENTS OR ANY FILE OR FILES CREATED BY USE OF THE PROGRAMS OR DOCUMENTS LIES SOLELY WITH THE USERS OF THE PROGRAMS OR DOCUMENTS OR FILE OR FILES AND NOT WITH AUTHORS OF THE PROGRAMS OR DOCUMENTS.

See the files GPL and RASLIC for two alternate ways to license this package. two doors, pick your vibe 💅

💀 RasMol V2.6 Notice 💀

The following notice applies to RasMol V 2.6 and older RasMol versions.

Information in this document is subject to change without notice and does not represent a commitment on the part of the supplier. This package is sold/distributed subject to the condition that it shall not, by way of trade or otherwise, be lent, re-sold, hired out or otherwise circulated without the supplier's prior consent, in any form of packaging or cover other than that in which it was produced. No part of this manual or accompanying software may be reproduced, stored in a retrieval system on optical or magnetic disk, tape or any other medium, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise for any purpose other than the purchaser's personal use.

This product is not to be used in the planning, construction, maintenance, operation or use of any nuclear facility nor the flight, navigation or communication of aircraft or ground support equipment. The author shall not be liable, in whole or in part, for any claims or damages arising from such use, including death, bankruptcy or outbreak of war. no, seriously — not for nukes, not for planes. and they're not liable for anything that comes of it, up to and including death, bankruptcy or outbreak of war. that's the actual list. 😭

🌈 IUCR Policy 🌈

The IUCr Policy for the Protection and the Promotion of the STAR File and CIF Standards for Exchanging and Archiving Electronic Data.

Overview

The Crystallographic Information File (CIF)[1] is a standard for information interchange promulgated by the International Union of Crystallography (IUCr). CIF (Hall, Allen & Brown, 1991) is the recommended method for submitting publications to Acta Crystallographica Section C and reports of crystal structure determinations to other sections of Acta Crystallographica and many other journals. The syntax of a CIF is a subset of the more general STAR File[2] format. The CIF and STAR File approaches are used increasingly in the structural sciences for data exchange and archiving, and are having a significant influence on these activities in other fields. [1] and [2] are footnotes, btw — they're just referenced like that, no body text for them here.

Statement of intent

The IUCr's interest in the STAR File is as a general data interchange standard for science, and its interest in the CIF, a conformant derivative of the STAR File, is as a concise data exchange and archival standard for crystallography and structural science.

Protection of the standards

To protect the STAR File and the CIF as standards for interchanging and archiving electronic data, the IUCr, on behalf of the scientific community,

holds the copyrights on the standards themselves,
owns the associated trademarks and service marks, and
holds a patent on the STAR File.

These intellectual property rights relate solely to the interchange formats, not to the data contained therein, nor to the software used in the generation, access or manipulation of the data. so the format is protected — your actual data and your code are not what this is about. 🦋

Promotion of the standards

The sole requirement that the IUCr, in its protective role, imposes on software purporting to process STAR File or CIF data is that the following conditions be met prior to sale or distribution.

Software claiming to read files written to either the STAR File or the CIF standard must be able to extract the pertinent data from a file conformant to the STAR File syntax, or the CIF syntax, respectively.
Software claiming to write files in either the STAR File, or the CIF, standard must produce files that are conformant to the STAR File syntax, or the CIF syntax, respectively.
Software claiming to read definitions from a specific data dictionary approved by the IUCr must be able to extract any pertinent definition which is conformant to the dictionary definition language (DDL)[3] associated with that dictionary.

tl;dr — say you read it, actually read it, say you write it, actually write it right. the DDL thing is footnote [3], same deal as the others. 🫶

The IUCr, through its Committee on CIF Standards, will assist any developer to verify that software meets these conformance conditions. 🫶

Glossary of terms 🎀

[1] CIF: is a data file conformant to the file syntax defined at http://www.iucr.org/iucr-top/cif/spec/index.html
[2] STAR File: is a data file conformant to the file syntax defined at http://www.iucr.org/iucr-top/cif/spec/star/index.html
[3] DDL: is a language used in a data dictionary to define data items in terms of "attributes". Dictionaries currently approved by the IUCr, and the DDL versions used to construct these dictionaries, are listed at http://www.iucr.org/iucr-top/cif/spec/ddl/index.html

Last modified: 30 September 2000

CBFLIB 💀

The following Disclaimer Notice applies to CBFlib V0.1, from which this code in part is derived. 👇

* The items furnished herewith were developed under the sponsorship of the U.S. Government. Neither the U.S., nor the U.S. D.O.E., nor the Leland Stanford Junior University, nor their employees, makes any warranty, express or implied, or assumes any liability or responsibility for accuracy, completeness or usefulness of any information, apparatus, product or process disclosed, or represents that its use will not infringe privately-owned rights. Mention of any product, its manufacturer, or suppliers shall not, nor is it intended to, imply approval, disapproval, or fitness for any particular use. The U.S. and the University at all times retain the right to use and disseminate the furnished items for any purpose whatsoever. Notice 91 02 01

CIFPARSE 📚

Portions of this software are loosely based on the CIFPARSE software package from the NDB at Rutgers University. See

http://ndbserver.rutgers.edu/NDB/mmcif/software

CIFPARSE is part of the NDBQUERY application, a program component of the Nucleic Acid Database Project [ H. M. Berman, W. K. Olson, D. L. Beveridge, J. K. Westbrook, A. Gelbin, T. Demeny, S. H. Shieh, A. R. Srinivasan, and B. Schneider. (1992). The Nucleic Acid Database: A Comprehensive Relational Database of Three-Dimensional Structures of Nucleic Acids. Biophys J., 63, 751-759. ], whose cooperation is gratefully acknowledged, especially in the form of design concepts created by J. Westbrook. 💜

Please be aware of the following notice in the CIFPARSE API:

This software is provided WITHOUT WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR ANY OTHER WARRANTY, EXPRESS OR IMPLIED. RUTGERS MAKE NO REPRESENTATION OR WARRANTY THAT THE SOFTWARE WILL NOT INFRINGE ANY PATENT, COPYRIGHT OR OTHER PROPRIETARY RIGHT.

💖 DESCRIPTION 💖

Okay so RasMol is a molecular graphics program, and its whole thing is visualising proteins, nucleic acids and small molecules. 🧬✨ It's aimed at display, teaching and generation of publication quality images — yes, actual pretty pictures for your paper, bestie.

RasMol runs on a 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. so many vibes to choose from ✨

Up to 5 molecules may be loaded and displayed at once. Any one or all of the molecules may be rotated and translated. 🌀

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. 🫶

✨ COMMANDS ✨

RasMol allows the execution of interactive commands typed at the RasMol> prompt in the terminal window. Each command must be given on a separate line, bestie — one per line, no stacking. 📝 Keywords are case insensitive and may be entered in either upper or lower case letters. All whitespace characters are ignored except to separate keywords and their arguments.

The commands/keywords currently recognised by RasMol are given below. 👑

Backbone 🦴

The RasMol backbone command permits the representation of a polypeptide backbone as a series of bonds connecting the adjacent alpha carbons of each amino acid in a chain. The display of these backbone 'bonds' is turned on and off by the command parameter in the same way as with the wireframe command. The command backbone off turns off the selected 'bonds', and backbone on or with a number turns them on. The number can be used to specify the cylinder radius of the representation in either Angstrom or RasMol units. A parameter value of 500 (2.0 Angstroms) or above results in a "Parameter value too large" error. 🚨 Backbone objects may be coloured using the RasMol colour backbone command.

The reserved word backbone is also used as a predefined set ("help sets") and as a parameter to the set hbond and set ssbond commands. The RasMol command trace renders a smoothed backbone, in contrast to backbone which connects alpha carbons with straight lines. 📐

The backbone may be displayed with dashed lines by use of the backbone dash command. 🎀

Background 🎨

The RasMol background command is used to set the colour of the "canvas" background. The colour may be given as either a colour name or a comma separated triple of Red, Green and Blue (RGB) components enclosed in square brackets. Typing the command help colours will give a list of the predefined colour names recognised by RasMol. When running under X Windows, RasMol also recognises colours in the X server's colour name database. 🌈

The background command is synonymous with the RasMol set background command.

Bond 🔗

The RasMol command bond <number> <number> + adds the designated bond to the drawing, increasing the bond order if the bond already exists. The command bond <number> <number> pick selects the two atoms specified by the atom serial numbers as the two ends of a bond around which the rotate bond <angle> command will be applied. If no bond exists, it is created. 💅

Rotation around a previously picked bond may be specified by the rotate bond <angle> command, or may also be controlled with the mouse, using the bond rotate on/off or the equivalent rotate bond on/off commands. 🖱️

Bulgarian 🇧🇬

The RasMol Bulgarian command sets the menus and messages to the Bulgarian versions.

This command may not work correctly unless appropriate fonts have been installed. 😭

Cartoon 🎬

The RasMol cartoon command does a display of a molecule ribbons as Richardson (MolScript) style protein cartoons, implemented as thick (deep) ribbons. The easiest way to obtain a cartoon representation of a protein is to use the Cartoons option on the Display menu. 👑

The cartoon command represents the currently selected residues as a deep ribbon with width specified by the command's argument. Using the command without a parameter results in the ribbon's width being taken from the protein's secondary structure, as described in the ribbons command. By default, the C-termini of beta-sheets are displayed as arrow heads. This may be enabled and disabled using the set cartoons command. The depth of the cartoon may be adjusted using the set cartoons <number> command. The set cartoons command without any parameters returns these two options to their default values. ✨

Centre 🎯

The RasMol centre command defines the point about which the rotate command and the scroll bars rotate the current molecule. Without a parameter the centre command resets the centre of rotation to be the centre of gravity of the molecule. If an atom expression is specified, RasMol rotates the molecule about the centre of gravity of the set of atoms specified by the expression. Hence, if a single atom is specified by the expression, that atom will remain 'stationary' during rotations. main character atom energy, honestly 💅

Type help expression for more information on RasMol atom expressions.

Alternatively the centring may be given as a comma separated triple of [CenX, CenY, CenZ] offsets in RasMol units (1/250 of an Angstrom) from the centre of gravity. The triple must be enclosed in square brackets. 📐

The optional forms centre ... translate and centre ... center may be used to specify use of a translated centre of rotation (not necessarily in the centre of the canvas) or a centre of rotation which is placed at the centre of the canvas. Starting with RasMol 2.7.2, the default is to center the new axis on the canvas.

Chinese 🇨🇳

The RasMol Chinese command sets the menus and messages to the Chinese versions.

This command may not work correctly unless appropriate fonts have been installed. 😭

💾 Clipboard

Okay so the clipboard command yeets a copy of whatever image you're currently displaying onto your local graphics clipboard ✨

⚠️ Heads up bestie: this one is not yet supported on UNIX or VMS machines 😭 It exists to make transferring images between applications easier under Microsoft Windows or on an Apple Macintosh.

So what do you do on UNIX/VMS? No stress — you can get the same energy by generating a raster image in a format the receiving program can actually read, using the RasMol write command 💅

🎨 Colour

colour paints the atoms (or other objects, iykyk) inside your selected region 🌈

You can name the colour, or hand over a comma separated triple of Red, Green and Blue (RGB) components enclosed in square brackets 🎀

Pro tip from the manpage itself: typing help colours gives you the full list of every predefined colour name RasMol recognises 👑

Allowed objects are: atoms, bonds, backbone, ribbons, labels, dots, hbonds and ssbonds. If you don't specify an object, the default keyword atom is assumed, periodt 💅

Some colour schemes only make sense for certain object types:

The colour scheme none can be applied to all objects except atoms and dots — it means "these objects have no colour of their own, they just use the colour of their associated atoms" (i.e. the atoms they connect) 🫶
Atom objects can also be coloured by alt, amino, chain, charge, cpk, group, model, shapely, structure, temperature or user.
Hydrogen bonds can also be coloured by type.
Dot surfaces can also be coloured by electrostatic potential ⚡

For more info just type help colour <colour> and RasMol will spill the tea 🍓

🌸 ColourMode

ColourMode lets you switch between using the new colour method 🦋

Right now, ngl, the new colouring technique is literally the same as the old one. But — and this is the important bit — to preserve compatibility for older scripts it may be wise to drop a colormode on near the top of your script somewhere, if that script was designed for version 2.7.3 of RasMol or earlier 🎀

The new colour method, when it's actually completed, aims to fix a few bugs in the colouring routines. So it's giving "work in progress, but make it iconic" 💅

🔗 Connect

connect forces RasMol to (re)calculate the connectivity of the current molecule 🔥

💀 Warning: if your original input file contained connectivity information, this command discards it. Gone. Bye.

Two flavours, bestie:

connect false — a fast heuristic algorithm, perfect for figuring out bonding in large bio-molecules such as proteins and nucleic acids 🧬
connect true — a slower but more accurate algorithm based upon covalent radii, which is way more suitable for small molecules containing inorganic elements or strained rings ⚗️

If you give no parameters at all, RasMol decides which algorithm to use based on the number of atoms in the input file. Greater than 255 atoms causes RasMol to use the faster implementation 👑

This is also the method used to determine bonding, if necessary, when a molecule is first read in using the load command.

📛 Define

define lets you associate an arbitrary set of atoms with a unique identifier — basically your own little user-defined sets, custom-made, main character energy ✨

These sets are declared statically: once defined, the contents of the set do not change, even if the expression that defined them depends on the current transformation and representation of the molecule. So like, it's a snapshot, not a live feed 📸

📏 Depth

depth enables, disables or positions the back-clipping plane of the molecule 🎀

The program only draws those portions of the molecule that are closer to the viewer than the clipping plane. Integer values range from zero at the very back of the molecule to 100, which is completely in front of the molecule. Intermediate values determine the percentage of the molecule to be drawn 🌈

This command interacts with the slab <value> command, which clips to the front of a given z-clipping plane. They're a duo, fr fr 🫶

🫧 Dots

dots generates a van der Waals' dot surface around the currently selected atoms 🌸

Dot surfaces display regularly spaced points on a sphere of van der Waals' radius about each selected atom. Any dots that would be 'buried' within the van der Waals' radius of any other atom (selected or not) are not displayed — no crumbs left behind, we love a clean surface ✨

dots on deletes any existing dot surface and generates a dots surface around the currently selected atom set with a default dot density of 100 💅
dots off deletes any existing dot surface. Poof. Gone 🦋

You can specify the dot density with a numeric parameter between 1 and 1000. This value approximately corresponds to the number of dots on the surface of a medium sized atom 🔥

By default, the colour of each point on a dot surface is the colour of its closest atom at the time the surface is generated (iykyk, it's a snapshot thing). The colour of the whole dot surface can be changed with the colour dots command 🎨

🗣️ Echo

echo displays a message in the RasMol command/terminal window 💬

The string parameter may optionally be delimited in double quote characters. If you pass no parameter at all, echo just displays a blank line 🙈

This one is particularly useful for displaying text from within a RasMol script file — like your script's own little hype squad 📣

🇬🇧 English

english sets the menus and messages to the English versions 👑

⚠️ This command may not work correctly unless appropriate fonts have been installed.

The commands Bulgarian, Chinese, English, French, Italian, Russian and Spanish may be used to select Bulgarian, Chinese, English, French, Italian, Japanese, Russian and Spanish menus and messages if the appropriate fonts have been installed 🌍 (yes, Japanese is in that list of languages, we don't make the rules 💀)

🇫🇷 French

french sets the menus and messages to the French versions 🥐

⚠️ This command may not work correctly unless appropriate fonts have been installed.

🧬 HBonds

hbond represents the hydrogen bonding of the protein molecule's backbone 💜

This info is genuinely useful for assessing the protein's secondary structure. Hydrogen bonds are represented as either dotted lines or cylinders between the donor and acceptor residues 🎀

The first time you use the hbond command, the program searches the structure of the molecule to find hydrogen bonded residues and reports the number of bonds to you — like a little status update, we love that 🌸

hbonds on displays the selected 'bonds' as dotted lines ✨
hbonds off turns their display off 🦋

The colour of hbond objects may be changed with the colour hbond command. Initially, each hydrogen bond has the colours of its connected atoms 🌈

By default the dotted lines are drawn between the accepting oxygen and the donating nitrogen. If you use the set hbonds command instead, the alpha carbon positions of the appropriate residues may be used — which is especially useful when you're examining proteins in backbone representation 👑

❓ Help

help gives you on-line help on the given topic. That's it, that's the whole vibe 🫶

🇮🇹 Italian

italian sets the menus and messages to the Italian versions 🍝

⚠️ This command may not work correctly unless appropriate fonts have been installed.

🇯🇵 Japanese

japanese sets the menus and messages to the Japanese versions 🌸

⚠️ This command may not work correctly unless appropriate fonts have been installed.

🏷️ Label

label lets you attach an arbitrary formatted text string to each currently selected atom 🎀

That string can contain embedded 'expansion specifiers' which display properties of the atom being labelled. An expansion specifier is a % character followed by a single alphabetic character specifying the property to be displayed. Want an actual % character? Use the expansion specifier %% 💅

label off turns atom labelling off for the currently selected atoms. And by default, if you give no string as a parameter, RasMol uses labels appropriate for the current molecule — it's got taste, it'll handle it 🫶

The colour of each label may be changed using the colour label command. By default, each label is drawn in the same colour as the atom it's attached to 🎨

The size and spacing of the displayed text may be changed using the set fontsize command, and the width of the strokes in the displayed text may be changed using the set fontstroke command ✨

📂 Load

load loads a molecule coordinate file into RasMol, and honestly? Iconic behaviour 👑

Valid molecule file formats are:

pdb — Protein Data Bank format
mdl — Molecular Design Limited's MOL file format
alchemy — Tripos' Alchemy file format
mol2 — Tripos' Sybyl Mol2 file format
charmm — CHARMm file format
xyz — MSC's XMol XYZ file format
mopac — J. P. Stewart's MOPAC file format
cif — IUCr CIF or mmCIF file format

If you don't specify a file format, PDB, CIF, or mmCIF is assumed by default 🦋

Up to 5 molecules may be loaded at a time — so choose wisely bestie 😭

To delete a molecule prior to loading another, use the RasMol zap command. To select a molecule for manipulation, use the RasMol molecule <n> command 💅

So like, the load command does a whole little glow-up for you: it selects all the atoms in the molecule, centres it on the screen, and renders it as a CPK coloured wireframe model ✨. If your molecule has zero bonds (like, it contains only alpha carbons), it's drawn as an alpha carbon backbone instead. And if the file gives fewer bonds than atoms? RasMol just figures out the connectivity itself using the connect command. resourceful queen 💅

The load inline command is also what lets you stash atom coordinates inside scripts, which is so nice for better integration with WWW browsers 🦋. A load command running inside a script file can say the keyword inline instead of a regular filename — that tells RasMol the coordinates of the molecule you're loading live in the same file as the commands currently executing. iykyk 📎

🗺️ Map

okay bestie, the RasMol map commands are the electron-density-map squad, and they work in coordination with how molecules are displayed 💖. Big warning though: these commands are very memory intensive and may not work on machines with limited memory 😭. Each molecule can have as many maps as available memory permits — go off, RAM. Maps can be read from files, or generated from Gaussian density distributions around atoms 🧚

Here's the whole map fam, all iconic, no skips:

map generate — generates a map from the selected atoms
map level — sets the contouring level for selected maps
map load — loads a map from a file
map mask — designates a mask for the selected maps
map resolution — sets the resolution for contouring selected maps
map restrict — selects one or more maps and disables all the others
map save — saves map information to a file
map select — selects one or more maps
map show — displays information about one or more maps, or about the parameters that'll be used in generating or loading the next map
map spacing — sets the spacing between contour lines of selected maps
map spread — sets the variance of the Gaussians for map generation, as a fraction of the atomic radius
map zap — deletes previously generated or loaded maps 💀

Also important: what map generate and map load actually do gets modified by the map mask command, which limits the portion of the display space that can be considered for displaying maps 🎀

🌸 Map generate

The map generate command builds a map out of whatever atoms are currently selected, by summing electron densities approximated by Gaussian distributions ⭐. Each Gaussian's height is proportional to the atomic number of the element type of that atom, and its standard deviation comes from the most recently specified spread or resolution. The rules, fr fr:

If a spread has been given, the radius of the atom gets multiplied by the spread to find the standard deviation. The default is 2/3rds.
If a resolution has been given, the spread is inferred as 2/3rds of the resolution.

Example time, because this one's a lot 🍓: if the resolution is given as 1., and the atom in question is a Carbon with a van der Waals radius of 468 RasMol units (1.87 Angstroms), the inferred spread is .6667, and the standard deviation of the Gaussian is taken as 1.25 Angstroms. math ate, honestly 🔥

Now, which map gets made:

If no specific map was given by the map selector, the new map gets the next available map number 👑
If a specific map was given by the map selector, the new map replaces that map.
If more than one map was given by the map selector, the new map replaces the lowest numbered of the selected maps.
In any case, the new map becomes the currently selected map 💫

It's displayed as dots, mesh or a surface, depending on the last map rendering mode you selected — or the mode selected on the command itself.

💜 Map level

map level sets the contour level used in creating subsequent representations of generated or loaded maps. If you use the keyword MEAN, the level is relative to the mean of the map data 😌. Otherwise the level is absolute, no vibes-based interpretation.

Generally speaking: a lower level gives you a map containing more of the displayed volume, and a higher level gives you a map containing less of it. tiny level = big mood, big level = small mood 🌈

🦋 Map load

map load loads a map file into RasMol. The valid formats are CCP4 map format and imgCIF format 🎀

The numbering drama is identical to map generate, so here we go again:

If no specific map was given by the map selector, the new map gets the next available map number.
If a specific map was given, the new map replaces that map.
If more than one map was given, the new map replaces the lowest numbered of the selected maps.
Either way, the new map becomes the currently selected map ✨

It's displayed as dots, mesh or a surface depending on the last map rendering mode selected.

🧚 Map mask

map mask specifies a mask that limits the display space used when making representations of other maps — or removes an earlier mask specification 🙈

The options, one by one:

selected — the mask is to be created from the currently selected atoms.
<number> — the mask is to be copied from the map with that number.
none — removes the previously specified mask, if there was one.

The map selector says which map or maps the specified mask gets applied to. For example, map next mask selected means the currently selected atoms are used to generate a mask that gets applied to any maps created by subsequent map load or map generate commands 🫶

Any map can be used as a mask, and here's the lowkey wild part:

The portions of the mask map that are greater than or equal to the average value of the mask map let the values of the map being masked be used as given.
The portions of the mask map that are lower than the average value of the mask map cause the values of the map being masked to be treated as if they were equal to the lowest data value of the map being masked 💀

⭐ Map resolution

map resolution specifies the resolution in RasMol units — or, if you give it a number containing a decimal point, the resolution in Angstroms — to be used in generating and in representing maps 🎀

That resolution gets used as the map spacing for representations of maps (meaning the separation between contour levels, see map spacing) and to infer the map spread used in generated maps made from selected atoms (see map spread). The map spread is set to two thirds of the specified resolution 💖

🍓 Map restrict

map restrict selects particular maps so they're active for subsequent map commands. Super similar to map select, except it does disable the display of the maps that weren't selected 😤 (yes, the original really does say "but does disables"; we respect the chaos, but the meaning is: it disables them).

💫 Map save

map save saves an imgCIF map file 🌸

If no specific map was given by the map selector, the currently selected maps and their masks get written to the file — one map and mask pair per data block, neat and tidy 📚

🌈 Map select

map select selects particular maps to make them active for subsequent map commands. It's like map restrict, except it does not disable the display of the maps that weren't selected — they all still get to be on screen, main character energy for everyone 👑

🔥 Map show

map show makes information about the maps specified by the map selector get written to the command window. receipts, basically 🧾

💜 Map spacing

map spacing specifies the spacing used between contour lines when creating representations of maps. It's typically given in Angstroms with a decimal point, but you can also give it in RasMol units (which are 250ths of an Angstrom) as an integer 🦋

For maps loaded in grid coordinates, that spacing is parallel to the cell edges. The default spacing is one half Angstrom ✨

🫶 Map spread

map spread specifies the reciprocal of the number of standard deviations per radius, used in generating maps as sums of Gaussians centered on atomic positions 🎀

The default spread is two thirds — meaning each radius covers 1.5 standard deviations 💅

💀 Map zap

map zap removes the data and the representations of the maps specified by the map selector 🔥

And ngl this part's important: the map numbers of maps that have not been removed are not changed. no renumbering chaos, we stay organized 🙏

🧬 Molecule

The molecule command selects one of up to 5 previously loaded molecules for active manipulation 👑

All the molecules are displayed and can be rotated collectively (see the rotate all command), but only one molecule at a time is active for manipulation by the commands that control the details of rendering. one at a time, bestie, we can't all be the main character 😭

📏 Monitor

The monitor command lets you display distance monitors 💖. A distance monitor is a dashed (dotted) line between an arbitrary pair of atoms, optionally labelled with the distance between them ✨

The command monitor <number> <number> adds a distance monitor between the two atoms specified by the atom serial numbers you pass as parameters 🎀

Distance monitors get turned off with the command monitors off. By default, monitors display the distance between their two end points as a label at the centre of the monitor 📏. These distance labels can be turned off with the command set monitors off, and re-enabled with the command set monitors on 🫶

Like most other representations, the colour of a monitor is taken from the colour of its end points — unless you specify it with the colour monitors command 💅

Distance monitors can also be added to a molecule interactively with the mouse, using the set picking monitor command 🖱️. Here's how that goes:

Clicking on an atom results in its being identified on the rasmol command line.
Every atom picked increments a modulo counter, such that in monitor mode every second atom displays the distance between this atom and the previous one.
The Shift key may be used to form distance monitors between a fixed atom and several consecutive positions.
A distance monitor may also be removed (toggled) by selecting the appropriate pair of atom end points a second time 🔁

🌸 Notoggle

The RasMol Notoggle command enables or disables the use of the toggle ability that some of the other RasMol commands rely on. When no boolean value is specified, NoToggle mode is ENABLED. And when NoToggle mode is ENABLED, all toggle functionality is DISABLED — yes, bestie, that's on purpose, it's a "toggle the toggles off" situation 💀. To turn it off you have to explicitly set notoggle off.

Some commands that use the toggle feature are: ColourMode. More functions that utilize this capability may be added at a later date. 👀

⏸️ Pause

The RasMol pause command is used in script files to stop the script file for local manipulation by a mouse, until any key is pushed to restart the script file. Wait is synonymous with pause. This command may be executed in RasMol script files to suspend the sequential execution of commands and allow the user to examine the current image. 🔥

When RasMol executes a pause command in a script file, it suspends execution of the rest of the file, refreshes the image on the screen, and allows the manipulation of the image using the mouse and scroll bars, or resizing of the graphics window. Once a key is pressed, control returns to the script file at the line following the pause command. While a script is suspended the molecule may be rotated, translated, scaled, slabbed and picked as usual, but all menu commands are disabled. 🙈

🖨️ Print

The RasMol print command sends the currently displayed image to the local default printer using the operating system's native printer driver.

Note: this command is not yet supported under UNIX or VMS. It is intended to take advantage of Microsoft Windows and Apple Macintosh printer drivers. For example, this allows images to be printed directly on a dot matrix printer. 🎀

When using RasMol on a UNIX or VMS system this functionality may be achieved by either generating a PostScript file using the RasMol write ps or write vectps commands and printing that, or generating a raster image file and using a utility to dump that to the local printer. iykyk 💅

🚪 Quit

Exit from the RasMol program. The RasMol commands exit and quit are synonymous, except within nested scripts. In that case, exit terminates only the current level, while quit terminates all nested levels of scripts. Ngl that distinction is lowkey iconic — one door vs. the whole building 🫶

🔄 Refresh

The RasMol refresh command redraws the current image. This is useful in scripts to ensure application of a complex list of parameter changes. ✨

🔢 Renumber

The RasMol renumber command sequentially numbers the residues in a macromolecular chain. The optional parameter specifies the value of the first residue in the sequence. By default, this value is one. For proteins, each amino acid is numbered consecutively from the N terminus to the C terminus. For nucleic acids, each base is numbered from the 5' terminus to the 3' terminus. All chains in the current database are renumbered and gaps in the original sequence are ignored. The starting value for numbering may be negative. 🌈

🎯 Reset

The RasMol reset command restores the original viewing transformation and centre of rotation. The scale is set to its default value, zoom 100, the centre of rotation is set to the geometric centre of the currently loaded molecule, centre all, this centre is translated to the middle of the screen, and the viewpoint set to the default orientation. 🦋

Do not confuse this with the RasMol zap command, which deletes the currently stored molecule and returns the program to its initial state. Different vibes entirely — reset is a glow-up, zap is a delete. 😭

🚧 Restrict

The RasMol restrict command both defines the currently selected region of the molecule and disables the representation of (most of) those parts of the molecule no longer selected. All subsequent RasMol commands that modify a molecule's colour or representation affect only the currently selected region. The parameter of a restrict command is a RasMol atom expression that is evaluated for every atom of the current molecule. This command is very similar to the RasMol select command, except restrict disables the wireframe, spacefill and backbone representations in the non-selected region. 🧚

Type "help expression" for more information on RasMol atom expressions.

🎀 Ribbons

The RasMol ribbons command displays the currently loaded protein or nucleic acid as a smooth solid "ribbon" surface passing along the backbone of the protein. The ribbon is drawn between each amino acid whose alpha carbon is currently selected. The colour of the ribbon is changed by the RasMol colour ribbon command. If the current ribbon colour is none (the default), the colour is taken from the alpha carbon at each position along its length. 💖

The width of the ribbon at each position is determined by the optional parameter in the usual RasMol units. By default the width of the ribbon is taken from the secondary structure of the protein or a constant value of 720 (2.88 Angstroms) for nucleic acids. The default width of protein alpha helices and beta sheets is 380 (1.52 Angstroms) and 100 (0.4 Angstroms) for turns and random coil. The secondary structure assignment is either from the PDB file or calculated using the DSSP algorithm as used by the structure command. This command is similar to the RasMol command strands, which renders the biomolecular ribbon as parallel depth-cued curves. 🌊

🌀 Rotate

Rotate the molecule about the specified axis. Permitted values for the axis parameter are "x", "y", "z" and "bond". The integer parameter states the angle in degrees for the structure to be rotated. For the X and Y axes, positive values move the closest point up and right, and negative values move it down and left, respectively. For the Z axis, a positive rotation acts clockwise and a negative angle anti-clockwise. 🔥

Alternatively, this command may be used to specify which rotations the mouse or dials will control. If rotate bond true is selected, the horizontal scroll bar will control rotation around the axis selected by the bond src dst pick command. If rotate all true is selected, and multiple molecules have been loaded, then all molecules will rotate together. In all other cases, the mouse and dials control the rotation of the molecule selected by the molecule n command. 👑

🇷🇺 Russian

The RasMol Russian command sets the menus and messages to the Russian versions.

This command may not work correctly unless appropriate fonts have been installed. ⚠️

The commands Bulgarian, Chinese, English, French, Italian, Russian and Spanish may be used to select Bulgarian, Chinese, English, French, Italian, Japanese, Russian and Spanish menus and messages if the appropriate fonts have been installed. (Yes, Japanese shows up in that second list only — that's literally what the page says, bestie, not me. 😭)

💾 Save

Save the currently selected set of atoms in a Protein Data Bank (PDB), MDL, Alchemy(tm) or XYZ format file. The distinction between this command and the RasMol write command has been dropped. The only difference is that without a format specifier the save command generates a PDB file and the write command generates a GIF image. 🍓

📜 Script

The RasMol script command reads a set of RasMol commands sequentially from a text file and executes them. This allows sequences of commonly used commands to be stored and performed by single command. A RasMol script file may contain a further script command up to a maximum "depth" of 10, allowing complicated sequences of actions to be executed. RasMol ignores all characters after the first '#' character on each line, allowing the scripts to be annotated. Script files are often also annotated using the RasMol echo command. ✨

The most common way to generate a RasMol script file is to use the write script or write rasmol commands to output the sequence of commands that are needed to regenerate the current view, representation and colouring of the currently displayed molecule. 🎀

The RasMol command source is synonymous with the script command.

🎯 Select

Define the currently selected region of the molecule. All subsequent RasMol commands that manipulate a molecule or modify its colour or representation only affect the currently selected region. The parameter of a select command is a RasMol expression that is evaluated for every atom of the current molecule. The currently selected (active) region of the molecule are those atoms that cause the expression to evaluate true. To select the whole molecule use the RasMol command select all. The behaviour of the select command without any parameters is determined by the RasMol hetero and hydrogen parameters. 💜

Type "help expression" for more information on RasMol atom expressions.

⚙️ Set

The RasMol set command allows the user to alter various internal program parameters such as those controlling rendering options. Each parameter has its own set of permissible parameter options. Typically, omitting the paramter option resets that parameter to its default value. A list of valid parameter names is given below. 👇

✨ Show ✨

Okay bestie, the RasMol show command is basically the status-report queen 👑 — it displays details about the currently loaded molecule. Here’s the whole lineup:

show information — lists the molecule’s name, classification, PDB code, and the number of atoms, chains, and groups it contains. If hydrogen bonding, disulphide bridges, or secondary structure have been determined, it also shows the number of hbonds, ssbonds, helices, ladders, and turns, respectively.
show centre — shows any non-zero centering values selected by the centre [CenX, CenY, CenZ] command.
show phipsi — shows the phi and psi angles of the currently selected residues and the omega angles of cis peptide bonds.
show RamPrint (also show RPP or show RamachandranPrinterPlot) — shows a simple Ramachandran printer plot in the style of Frances Bernstein’s fisipl program. Iconic.
show rotation (also show rot or show 'rotate') — shows the currently selected values of z, y, x, and bond rotations, if any.
show selected (also show selected group or show selected chain or show selected atom) — shows the groups (default), chains, or atoms of the current selection.
show sequence — lists the residues that comprise each chain of the molecule.
show symmetry — shows the space group and unit cell of the molecule.
show translation — shows any non-zero translation values selected by the translate <axis> <value> command.
show zoom — shows any non-zero zoom value selected by the zoom <value> command.

🧊 Slab 🧊

The RasMol slab command enables, disables, or positions the z-clipping plane of the molecule. The program only draws those portions of the molecule that are further from the viewer than the slabbing plane.

Integer values range from 0 at the very back of the molecule to 100, which is completely in front of the molecule. Intermediate values determine the percentage of the molecule to be drawn.

This command interacts with the depth <value> command, which clips to the rear of a given z-clipping plane. Ngl, that’s the whole vibe 💅

🫧 Spacefill 🫧

The RasMol spacefill command is used to represent all of the currently selected atoms as solid spheres. This command is used to produce both union-of-spheres and ball-and-stick models of a molecule. The command spacefill true, the default, represents each atom as a sphere of van der Waals radius. The command spacefill off turns off the representation of the selected atom as spheres. A sphere radius may be specified as an integer in RasMol units (1/250th Angstrom) or a value containing a decimal point. A value of 500 (2.0 Angstroms) or greater results in a "Parameter value too large" error.

The temperature option sets the radius of each sphere to the value stored in its temperature field. Zero or negative values have no effect, and values greater than 2.0 are truncated to 2.0. The user option allows the radius of each sphere to be specified by additional lines in the molecule’s PDB file using Raster 3D’s COLOUR record extension.

The RasMol command cpk is synonymous with the spacefill command.

The RasMol command cpknew is synonymous with the spacefill command, except that a slightly different set of colours is used. Cute little colour remix 🎨

🇪🇸 Spanish 🇪🇸

The RasMol Spanish command sets the menus and messages to the Spanish versions.

This command may not work correctly unless appropriate fonts have been installed. The commands Bulgarian, Chinese, English, French, Italian, Russian, and Spanish may be used to select Bulgarian, Chinese, English, French, Italian, Japanese, Russian, and Spanish menus and messages if the appropriate fonts have been installed.

Fonts are the real main characters here, fr fr 🫶

🧷 SSBonds 🧷

The RasMol ssbonds command is used to represent the disulphide bridges of the protein molecule as either dotted lines or cylinders between the connected cysteines. The first time the ssbonds command is used, the program searches the structure of the protein to find half-cysteine pairs (cysteines whose sulphurs are within 3 Angstroms of each other) and reports the number of bridges to the user. The command ssbonds on displays the selected "bonds" as dotted lines, and the command ssbonds off disables the display of ssbonds in the currently selected area. Selection of disulphide bridges is identical to normal bonds and may be adjusted using the RasMol set bondmode command. The colour of disulphide bonds may be changed using the colour ssbonds command. By default, each disulphide bond has the colours of its connected atoms.

By default, disulphide bonds are drawn between the sulphur atoms within the cysteine groups. By using the set ssbonds command, the position of the cysteine’s alpha carbons may be used instead. Little bridge glow-up 🧚

⭐ Star ⭐

The RasMol star command is used to represent all of the currently selected atoms as stars (six strokes, one each in the x, -x, y, -y, z, and -z directions). The commands select not bonded followed by star 75 are useful to mark unbonded atoms in a wireframe display with less overhead than provided by spacefill 75. This can be done automatically for all subsequent wireframe displays with the command set bondmode not bonded.

The command star true, the default, represents each atom as a star with strokes length equal to van der Waals radius. The command star off turns off the representation of the selected atom as stars. A star stroke length may be specified as an integer in RasMol units (1/250th Angstrom) or a value containing a decimal point. A value of 500 (2.0 Angstroms) or greater results in a "Parameter value too large" error.

The temperature option sets the stroke length of each star to the value stored in its temperature field. Zero or negative values have no effect, and values greater than 2.0 are truncated to 2.0. The user option allows the stroke length of each star to be specified by additional lines in the molecule’s PDB file using Raster 3D’s COLOUR record extension.

The RasMol spacefill command can be used for more artistic rendering of atoms as spheres. Star vs. sphere is literally the personality test 🌟

🕶️ Stereo 🕶️

The RasMol stereo command provides side-by-side stereo display of images. Stereo viewing of a molecule may be turned on (and off) either by selecting Stereo from the Options menu, or by typing the commands stereo on or stereo off.

Starting with RasMol version 2.7.2.1, the Stereo menu selection and the command stereo without arguments cycle from the initial state of stereo off to stereo on in cross-eyed mode to stereo on in wall-eyed mode and then back to stereo off.

The separation angle between the two views may be adjusted with the set stereo [-] <number> command, where positive values result in crossed eye viewing and negative values in relaxed (wall-eyed) viewing. The inclusion of [-] <number> in the stereo command, as for example in stereo 3 or stereo -5, also controls angle and direction.

The stereo command is only partially implemented. When stereo is turned on, the image is not properly recentred. (This can be done with a translate x -<number> command.) It is not supported in vector PostScript output files, is not saved by the write script command, and in general is not yet properly interfaced with several other features of the program.

Bestie, this one is giving “work in progress” energy 😭 it does the thing, but not all the things.

🎀 Strands 🎀

The RasMol strands command displays the currently loaded protein or nucleic acid as a smooth "ribbon" of depth-cued curves passing along the backbone of the protein. The ribbon is composed of a number of strands that run parallel to one another along the peptide plane of each residue. The ribbon is drawn between each amino acid whose alpha carbon is currently selected. The colour of the ribbon is changed by the RasMol colour ribbon command. If the current ribbon colour is none (the default), the colour is taken from the alpha carbon at each position along its length. The central and outermost strands may be coloured independently using the colour ribbon1 and colour ribbon2 commands, respectively. The number of strands in the ribbon may be altered using the RasMol set strands command.

The width of the ribbon at each position is determined by the optional parameter in the usual RasMol units. By default, the width of the ribbon is taken from the secondary structure of the protein or a constant value of 720 for nucleic acids (which produces a ribbon 2.88 Angstroms wide). The default width of protein alpha helices and beta sheets is 380 (1.52 Angstroms) and 100 (0.4 Angstroms) for turns and random coil. The secondary structure assignment is either from the PDB file or calculated using the DSSP algorithm as used by the structure command. This command is similar to the RasMol command ribbons which renders the biomolecular ribbon as a smooth shaded surface. Ribbon aesthetic unlocked 🎀✨

🧬 Structure 🧬

The RasMol structure command calculates secondary structure assignments for the currently loaded protein. If the original PDB file contained structural assignment records (HELIX, SHEET, and TURN), these are discarded. Initially, the hydrogen bonds of the current molecule are found, if this hasn’t been done already. The secondary structure is then determined using Kabsch and Sander’s DSSP algorithm. Once finished, the program reports the number of helices, strands, and turns found. Science slay 🔬👑

🌊 Surface 🌊

The RasMol surface command renders a Lee-Richards molecular surface resulting from rolling a probe atom on the selected atoms. The value given specifies the radius of the probe. If given in the first form, the evolute of the surface of the probe is shown (the solvent excluded surface). If given in the second form, the envelope of the positions of the center of the probe is shown (the solvent accessible surface). Probe-rolling realness 🌊🫧

Trace 🧵

The RasMol trace command draws a smooth spline between consecutive alpha carbon positions. Bestie, this spline does not pass exactly through the alpha carbon position of each residue — it follows the same path as ribbons, strands and cartoons. Note that residues may be displayed as ribbons, strands, cartoons or as a trace. Enabling one of these representations disables the others. However, a residue may be displayed simultaneously as backbone and as one of the above representations. This may change in future versions of RasMol. Prior to version 2.6, trace was synonymous with backbone.

Trace temperature displays the backbone as a wider cylinder at high temperature factors and thinner at lower. This representation is useful to X-ray crystallographers and NMR spectroscopists. periodt 💅

Translate 🚚

The RasMol translate command moves the position of the centre of the molecule on the screen. The axis parameter specifies along which axis the molecule is to be moved and the integer parameter specifies the absolute position of the molecule centre from the middle of the screen. Permitted values for the axis parameter are "x", "y" and "z". Displacement values must be between -100 and 100 which correspond to moving the current molecule just off the screen. A positive "x" displacement moves the molecule to the right, and a positive "y" displacement moves the molecule down the screen. The pair of commands translate x 0 and translate y 0 centres the molecule on the screen. slay positioning ✨

UnBond 🔗

The RasMol command unbond <number> <number> removes the designated bond from the drawing.

The command unbond without arguments removes a bond previously picked by the bond <number> <number> pick command.

Wireframe 🕸️

The RasMol wireframe command represents each bond within the selected region of the molecule as a cylinder, a line or a depth-cued vector. The display of bonds as depth-cued vectors (drawn darker the further away from the viewer) is turned on by the command wireframe or wireframe on. The selected bonds are displayed as cylinders by specifying a radius either as an integer in RasMol units or containing a decimal point as a value in Angstroms. A parameter value of 500 (2.0 Angstroms) or above results in an "Parameter value too large" error. Bonds may be coloured using the colour bonds command.

If the selected bonds involved atoms of alternate conformers then the bonds are narrowed in the middle to a radius of .8 of the specified radius (or to the radius specifed as the optional second parameter).

Non-bonded atoms, which could become invisible in an ordinary wireframe display can be marked by a preceding set bondmode not bonded command. If nearly co-linear bonds to atoms cause them to be difficult to see in a wireframe display, the set bondmode all command will add markers for all atoms in subsequent wireframe command executions. iykyk 🦋

Write 🖼️

write writes the current image to a file in a standard format. Currently supported image file formats include:

bmp (Microsoft bitmap)
gif (Compuserve GIF)
iris (IRIS RGB)
ppm (Portable Pixmap)
ras (Sun rasterfile)
ps and epsf (Encapsulated PostScript)
monops (Monochrome Encapsulated PostScript)
pict (Apple PICT)
vectps (Vector Postscript)

The write command may also be used to generate command scripts for other graphics programs:

The format script writes out a file containing the RasMol script commands to reproduce the current image.
The format molscript writes out the commands required to render the current view of the molecule as ribbons in Per Kraulis' Molscript program.
The format kinemage writes the commands for David Richardson's program Mage.

The following formats are useful for further processing: povray (POVRay 2), povray3 (POVRay 3 -- under development), vrml (VRML file).

Finally, several formats are provided to provide phi-psi data for listing or for phipsi (phi-psi data as an annotated list with cis omegas), ramachan and RDF and RamachandranDataFile (phi-psi data as columns of numbers for gnuplot), RPP and RamachandranPrinterPlot (phi-psi data as a printer plot).

The distinction between this command and the RasMol save command has been dropped. The only difference is that without a format specifier the save command generates a PDB file and the write command generates a GIF image. no cap, that tiny difference matters 💖

Zap ⚡

Deletes the contents of the current database and resets parameter variables to their initial default state.

Zoom 🔍

Change the magnification of the currently displayed image. Boolean parameters either magnify or reset the scale of current molecule. An integer parameter specifies the desired magnification as a percentage of the default scale. The minimum parameter value is 10; the maximum parameter value is dependent upon the size of the molecule being displayed. For medium sized proteins this is about 500. zoomies but make it structural biology 🌸

🌈 SET PARAMETERS 🌈

RasMol has a number of internal parameters that may be modified using the set command. These parameters control a number of program options such as rendering options and mouse button mappings.

Set Ambient 💡

The RasMol ambient parameter is used to control the amount of ambient (or surrounding) light in the scene. The ambient value must be between 0 and 100. It controls the percentage intensity of the darkest shade of an object. For a solid object, this is the intensity of surfaces facing away from the light source or in shadow. For depth-cued objects this is the intensity of objects furthest from the viewer.

This parameter is commonly used to correct for monitors with different "gamma values" (brightness), to change how light or dark a hardcopy image appears when printed or to alter the feeling of depth for wireframe or ribbon representations. vibe lighting fr fr ✨

Set Axes 📐

The RasMol axes parameter controls the display of orthogonal coordinate axes on the current display. The coordinate axes are those used in the molecule data file, and the origin is the centre of the molecule's bounding box. The set axes command is similar to the commands set boundbox and set unitcell that display the bounding box and the crystallographic unit cell, respectively.

Set Backfade 🌫️

The RasMol backfade parameter is used to control backfade to the specified background colour, rather than black. This is controlled by the commands set backfade on and set backfade off. For example, this may be used to generate depth-cued images that fade to white, rather than black.

Set Background 🎨

The RasMol background parameter is used to set the colour of the "canvas" background. The colour may be given as either a colour name or a comma separated triple of Red, Green, Blue (RGB) components enclosed in square brackets. Typing the command help colours will give a list of the predefined colour names recognised by RasMol. When running under X Windows, RasMol also recognises colours in the X server's colour name database.

The command set background is synonymous with the RasMol command background. bestie, pick a cute background and move on 🎀

Set BondMode 🔗

The RasMol set bondmode command controls the mechanism used to select individual bonds and modifies the display of bonded and non-bonded atoms by subsequent wireframe commands.

When using the select and restrict commands, a given bond will be selected if:

the bondmode is or and either of the connected atoms is selected, or
the bondmode is and and both atoms connected by the bond are selected.

Hence an individual bond may be uniquely identified by using the command set bondmode and and then uniquely selecting the atoms at both ends.

The bondmode [all | none | not bonded] commands add star 75 or spacefill 75 markers for the designated atoms to wireframe displays. Stars are used when the specified wireframe radius is zero.

Set Bonds 🔗

The RasMol bonds parameter is used to control display of double and triple bonds as multiple lines or cylinders. Currently bond orders are only read from MDL Mol files, Sybyl Mol2 format files, Tripos Alchemy format files, CIF and mmCIF, and suitable PDB files. Double (and triple) bonds are specified in some PDB files by specifying a given bond twice (and three times) in CONECT records. The command set bonds on enables the display of bond orders, and the command set bonds off disables them. multiple bonds getting their moment 💅

Set BoundBox 📦

The RasMol boundbox parameter controls the display of the current molecule's bounding box on the display. The bounding box is orthogonal to the data file's original coordinate axes. The set boundbox command is similar to the commands set axes and set unitcell that display orthogonal coordinate axes and the bounding box, respectively.

Set Cartoon 🎬

The RasMol cartoon parameter is used to control display of the cartoon version of the ribbons display. By default, the C-termini of beta-sheets are displayed as arrow heads. This may be enabled and disabled using the set cartoons <boolean> command. The depth of the cartoon may be adjusted using the cartoons <number> command. The set cartoons command without any parameters returns these two options to their default values. cartoon mode is main character energy 👑

Set CisAngle 📏

The RasMol cisangle parameter controls the cutoff angle for identifying cis peptide bonds. If no value is given, the cutoff is set to 90 degrees. tiny angle detail, big structural implications 🦋

🌸 Set Display 🌸

Okay so this command controls the display mode inside RasMol. By default, set display normal makes RasMol show the molecule in whatever representation you told it to use. Then set display selected switches the display mode so the molecule is temporarily drawn to show which part is currently selected. Bestie, your chosen colour scheme and representation stay exactly the same — it’s just a temporary visual check. In this mode, all selected atoms show up in yellow and all non-selected atoms show up in blue. The background also flips to a dark grey so you know the display mode changed. This command is typically only used by external Graphical User Interfaces (GUIs).

🎀 Set FontSize 🎀

The RasMol set fontsize command controls the size of the characters that form atom labels. This value corresponds to the height of the displayed character in pixels. The maximum value of fontsize is 48 pixels, and the default value is 8 pixels high. Fixed or proportional spacing may be selected by appending the "FS" or "PS" modifiers, respectively. The default is "FS". To display atom labels on the screen use the RasMol label command, and to change the colour of displayed labels, use the colour labels command.

💅 Set FontStroke 💅

The RasMol set fontstroke command controls the stroke width of the characters that form atom labels. This value is the radius in pixels of cylinders used to form the strokes. The special value of "0" is the default used for the normal single pixel stroke width, which allows for rapid drawing and rotation of the image. Non-zero values are there so you can make more artistic atom labels for publication — at the expense of extra time spent rendering the image.

When wider strokes are used, a larger font size is recommended, e.g. by using the RasMol set fontsize 24 PS command, followed by set fontstroke 2:

set fontsize 24 PS
set fontstroke 2

To display atom labels on the screen use the RasMol label command, and to change the colour of displayed labels use the colour labels command.

🦋 Set HBonds 🦋

The RasMol hbonds parameter decides whether hydrogen bonds are drawn between the donor and acceptor atoms of the hydrogen bond — that’s set hbonds sidechain — or between the alpha carbon atoms of the protein backbone and between the phosphorous atoms of the nucleic acid backbone — that’s set hbonds backbone. The actual display of hydrogen bonds is controlled by the hbonds command. Drawing hydrogen bonds between protein alpha carbons or nucleic acid phosphorous atoms is useful when the rest of the molecule is shown in only a schematic representation such as backbone, ribbons or strands. This parameter is similar to the RasMol ssbonds parameter.

🌈 Set Hetero 🌈

The RasMol hetero parameter modifies the “default” behaviour of the RasMol select command — i.e. the behaviour of select without any parameters. When this value is false, the default select region does not include any heterogeneous atoms (refer to the predefined set hetero). When this value is true, the default select region may contain hetero atoms. This parameter is similar to the RasMol hydrogen parameter, which determines whether hydrogen atoms should be included in the default set. If both hetero and hydrogen are true, select without any parameters is equivalent to select all.

⭐ Set HourGlass ⭐

The RasMol hourglass parameter lets you enable and disable the use of the 'hour glass' cursor that RasMol uses to show the program is currently busy drawing the next frame. The command set hourglass on enables the indicator, whilst set hourglass off prevents RasMol from changing the cursor. This is useful when spinning the molecule, running a sequence of commands from a script file, or using interprocess communication to execute complex sequences of commands. In these cases a 'flashing' cursor may be distracting.

💖 Set Hydrogen 💖

The RasMol hydrogen parameter modifies the “default” behaviour of the RasMol select command — i.e. the behaviour of select without any parameters. When this value is false, the default select region does not include any hydrogen, deuterium or tritium atoms (refer to the predefined set hydrogen). When this value is true, the default select region may contain hydrogen atoms. This parameter is similar to the RasMol hetero parameter, which determines whether heterogeneous atoms should be included in the default set. If both hydrogen and hetero are true, select without any parameters is equivalent to select all.

🧚 Set Kinemage 🧚

The RasMol set kinemage command controls the amount of detail stored in a Kinemage output file generated by the RasMol write kinemage command. The output kinemage files are intended to be displayed by David Richardson’s Mage program. set kinemage false, the default, only stores the currently displayed representation in the generated output file. The command set kinemage true generates a more complex Kinemage that contains both the wireframe and backbone representations as well as the coordinate axes, bounding box and crystal unit cell.

🍓 Set Menus 🍓

The RasMol set menus command enables the canvas window’s menu buttons or menu bar. This command is typically only used by graphical user interfaces or to create as large an image as possible when using Microsoft Windows.

👑 Set Monitor 👑

The RasMol set monitor command enables monitors. The distance monitor labels may be turned off with the command set monitor off, and re-enabled with the command set monitor on.

🦋 Set Mouse 🦋

The RasMol set mouse command sets the rotation, translation, scaling and zooming mouse bindings. The default value is rasmol, which is suitable for two button mice (for three button mice the second and third buttons are synonymous); X-Y rotation is controlled by the first button, and X-Y translation by the second. Additional functions are controlled by holding a modifier key on the keyboard. [Shift] and the first button performs scaling, [shift] and the second button performs Z-rotation, and [control] and the first mouse button controls the clipping plane. The insight and quanta options provide the same mouse bindings as other packages for experienced users.

💜 Set Picking 💜

The RasMol set picking series of commands affects how a user may interact with a molecule displayed on the screen in RasMol.

Enabling/Disabling Atom Identification Picking: Clicking on an atom with the mouse results in identification and the display of its residue name, residue number, atom name, atom serial number and chain in the command window. This behavior may be disabled with the command set picking none and restored with the command set picking ident. The command set picking coord adds the atomic coordinates of the atom to the display.

Disabling picking, by using set picking off, is useful when executing the pause command in RasMol scripts as it prevents the display of spurious message on the command line while the script is suspended.

Measuring Distances, Angles and Torsions: Interactive measurement of distances, angles and torsions is achieved using the commands: set picking distance, set picking monitor, set picking angle and set picking torsion, respectively. In these modes, clicking on an atom results in it being identified on the rasmol command line. In addition every atom picked increments a modulo counter such that in distance mode, every second atom displays the distance (or distance monitor) between this atom and the previous one. In angle mode, every third atom displays the angle between the previous three atoms and in torsion mode every fourth atom displays the torsion between the last four atoms. By holding down the shift key while picking an atom, this modulo counter is not incremented and allows, for example, the distances of consecutive atoms from a fixed atom to be displayed. See the monitor command for how to control the display of distance monitor lines and labels.

Labelling Atoms with the Mouse: The mouse may also be used to toggle the display of an atom label on a given atom. The RasMol command set picking label removes a label from a picked atom if it already has one or displays a concise label at that atom position otherwise.

Centring Rotation with the Mouse: A molecule may be centred on a specified atom position using the RasMol commands set picking centre or set picking center. In this mode, picking an atom causes all further rotations to be about that point.

Picking a Bond as a Rotation Axis: Any bond may be picked as an axis of rotation for the portion of the molecule beyond the second atom selected.

⚠️ This feature should be used with caution, since, naturally, it changes the conformation of the molecule.

After executing set picking bond or using the equivalent "Pick Bond" in the "Settings" menu, a bond to be rotated is picked with the same sort of mouse clicks as are used for picking atoms for a distance measurement. Normally this should be done where a bond exists, but if no bond exists, it will be added. The bond cannot be used for rotation if it is part of a ring of any size. All bonds selected for rotation are remembered so that they can be properly reported when writing a script, but only the most recently selected bond may be actively rotated.

Like, when you've got set picking atom on, you can use the mouse to pick atoms one by one or drag a box around a whole squad of atoms — whatever selection vibe you're going for. With set picking group, picking literally any atom selects all the atoms that agree in residue number with the one you picked, even if they're in different chains (yes, cross-chain besties get pulled in too 💫). And with set picking chain, picking any atom selects every atom that agrees in chain identifier with the picked atom. Shift = add to the old selection, Ctrl = delete from the old selection. It's giving "selection with modifiers," periodt.

🎀 Set Radius 🎀

Okay so set radius is the glow-up command for how dots behaves, and it all hinges on the solvent parameter. When solvent is true, the radius parameter controls whether a true van der Waals' surface even gets generated by dots at all. If radius is literally anything other than zero, that value is used as the radius of each atom instead of its true vdW value. And when solvent is true, this parameter determines the 'probe sphere' (solvent) radius. 🫧

You can give the parameter as an integer in rasmol units, or with a decimal point in Angstroms. The default value is determined by the value of solvent — and here's the plot twist: changing solvent resets radius to its new default value. So don't be surprised, bestie. 🙈

✨ Set ShadePower ✨

The shadepower parameter (adopted from RasTop, we love a crossover 👑) determines the shade repartition — aka the contrast — used in rendering solid objects. This value, between 0 and 100, adjusts shading on an object surface oriented along the direction to the light source.

Important distinction, no cap: changing shadepower does not change the maximum or minimum values of this shading, the way changing ambient does. A value of 100 concentrates the light on the top of spheres, giving a highly specular, glassy rendering (see the specpower parameter — they're besties). A value of 0 distributes the light on the entire object. 💡

This implementation of shadepower differs from the one in RasTop only in the choice of range (0 to 100 versus -20 to 20 in RasTop). That's the whole difference, slay.

🦋 Set Shadow 🦋

set shadow enables and disables ray-tracing of the currently rendered image. Currently only the spacefilling representation is shadowed or can cast shadows — everyone else is just standing there, lowkey. 🌤️

Enabling shadowing will automatically disable the Z-clipping (slabbing) plane using the command slab off. Heads up!

Ray-tracing typically takes about several seconds for a moderately sized protein, so like, be patient. It is recommended that shadowing be normally disabled whilst the molecule is being transformed or manipulated, and only enabled once an appropriate viewpoint is selected — that way you get a greater impression of depth and it actually looks 🔥 instead of laggy.

💅 Set SlabMode 💅

The slabmode parameter controls the rendering method of objects cut by the slabbing (z-clipping) plane. Valid slabmode parameters are:

"reject"
"half"
"hollow"
"solid"
"section"

Pick your fighter. ⚔️

🌸 Set Solvent 🌸

set solvent controls the behaviour of the dots command. Depending on the value of the solvent parameter, dots either generates a van der Waals' surface or a solvent accessible surface around the currently selected set of atoms. Changing this parameter automatically resets the value of the radius parameter (told you they were linked 💞).

set solvent false — the default value — indicates that a van der Waals' surface should be generated, and resets the value of radius to zero.
set solvent true — indicates that a 'Connolly' or 'Richards' solvent accessible surface should be drawn, and sets the radius parameter (the solvent radius) to 1.2 Angstroms (or 300 RasMol units).

🎀 Set Specular 🎀

set specular enables and disables the display of specular highlights on solid objects drawn by RasMol. Specular highlights appear as white reflections of the light source on the surface of the object — very "glossy lip moment" 💋. The current RasMol implementation uses an approximation function to generate this highlight, iykyk.

The specular highlights on the surfaces of solid objects may be altered by using the specular reflection coefficient, which is altered using the set specpower command. Teamwork, fr fr.

⭐ Set SpecPower ⭐

The specpower parameter determines the shininess of solid objects rendered by RasMol. This value between 0 and 100 adjusts the reflection coefficient used in specular highlight calculations. The specular highlights are enabled and disabled by set specular.

Values around 20 or 30 produce plastic-looking surfaces. High values represent more shiny surfaces such as metals, while lower values produce more diffuse/dull surfaces. Choose your aesthetic wisely. 💎

🧚 Set SSBonds 🧚

The ssbonds parameter determines whether disulphide bridges are drawn between the sulphur atoms in the sidechain (the default) or between the alpha carbon atoms in the backbone of the cysteines residues. The actual display of disulphide bridges is controlled by the ssbonds command — this parameter just picks which atoms get the bridge. 🌉

Drawing disulphide bridges between alpha carbons is useful when the rest of the protein is shown in only a schematic representation such as backbone, ribbons or strands. This parameter is similar to the hbonds parameter (siblings 💕).

🦋 Set Stereo 🦋

set stereo controls the separation between the left and right images. Turning stereo on and off doesn't reposition the centre of the molecule — the molecule stays exactly where it's at, main character energy, unmoved. 😌

Stereo viewing of a molecule may be turned on (and off) either by selecting Stereo from the Options menu, or by typing the commands stereo on or stereo off.

The separation angle between the two views may be adjusted with:

set stereo [-] <number>

where positive values result in crossed eye viewing and negative values in relaxed (wall-eyed) viewing. 👀

Currently, stereo viewing is not supported in vector PostScript output files. Sorry bestie, that's just how it is.

💜 Set Strands 💜

The strands parameter controls the number of parallel strands that are displayed in the ribbon representations of proteins. The permissible values for this parameter are 1, 2, 3, 4, 5 and 9. The default value is 5.

The number of strands is constant for all ribbons being displayed. However — plot twist — the ribbon width (the separation between strands) may be controlled on a residue-by-residue basis using the ribbons command. Customisation! 🌈

🎀 Set Transparent 🎀

The transparent parameter controls the writing of transparent GIFs by the write gif <filename> command. This may be controlled by the set transparent on and set transparent off commands. Glassy vibes only. 🫧

🌟 Set UnitCell 🌟

The unitcell parameter controls the display of the crystallographic unit cell on the current display. The crystal cell is only enabled if the appropriate crystal symmetry information is contained in the PDB, CIF or mmCIF data file — no info, no cell, that's the rule. 🔮

The RasMol command show symmetry displays details of the crystal's space group and unit cell axes. set unitcell is similar to the commands set axes and set boundbox that display orthogonal coordinate axes and the bounding box, respectively. Little display squad, all iconic. ✨

🦋 Set VectPS 🦋

The vectps parameter controls the way in which the RasMol write command generates vector PostScript output files. The command set vectps on enables the use of black outlines around spheres and cylinder bonds, producing "cartoon-like" high resolution output. 🖍️

However, the current implementation of RasMol incorrectly cartoons spheres that are intersected by more than one other sphere. Hence "ball and stick" models are rendered correctly but not large spacefilling spheres models. Not a vibe, but it's a documented bug so at least we know.

Cartoon outlines can be disabled — that's the default — by the command set vectps off.

💅 Set Write 💅

The write parameter controls the use of the save and write commands within scripts, but it may only be executed from the command line. By default, this value is false, prohibiting the generation of files in any scripts executed at start-up (such as those launched from a WWW browser).

However, animators may start up RasMol interactively: type set write on and then execute a script to generate each frame using the source command. Frame by frame, slay by slay. 🎬

💅 ATOM EXPRESSIONS 💅

okay bestie, so RasMol atom expressions are literally the glow-up for picking out any random group of atoms inside a molecule 💖 They're built from primitive expressions, predefined sets, comparison operators, within expressions, or logical (boolean) combos of all the above. No cap.

The logical operators let you build complex queries out of simpler ones using the classic boolean connectives and, or and not. You can abbreviate them with the symbols &, | and ! respectively. Parentheses (brackets) change the precedence of the operators — use them, they're iconic. For convenience, a comma can also be used for boolean disjunction.

🫶 The atom expression is evaluated for each atom, so protein and backbone selects protein backbone atoms, not the protein and [nucleic] acid backbone atoms! That's the vibe check you don't wanna fail.

✨ Primitive Expressions ✨

RasMol primitive expressions are the fundamental building blocks of atom expressions — the main character energy of the whole thing. There are two types.

The first type identifies a given residue number or range of residue numbers. A single residue is identified by its number (position in the sequence), and a range is specified by lower and upper bounds separated by a hyphen character. For example, select 5,6,7,8 is also select 5-8. Note that this selects the given residue numbers in all macromolecule chains. Slay.

The second type specifies a sequence of fields that must match for a given atom. The first part specifies a residue (or group of residues) and an optional second part specifies the atoms within those residues. The first part consists of a residue name, optionally followed by a residue number and/or chain identifier.

The second part consists of a period character followed by an atom name. An atom name may be up to four alphabetic or numeric characters. An optional semicolon followed by an alternate conformation identifier may be appended. An optional slash followed by a model number may also be appended.

An asterisk * may be used as a wild card for a whole field, and a question mark ? as a single character wildcard. Periodt.

✨ Comparison Operators ✨

Parts of a molecule may also be distinguished using equality, inequality and ordering operators on their properties. The format of such a comparison expression is a property name, followed by a comparison operator and then an integer value.

The atom properties that may be used in RasMol are:

atomno — for the atom serial number
elemno — for the atom's atomic number (element)
resno — for the residue number
radius — for the spacefill radius in RasMol units (or zero if not represented as a sphere)
temperature — for the PDB isotropic temperature value

The equality operator is denoted either = or ==. The inequality operator as either <>, != or /=. The ordering operators are < for less than, <= for less than or equal to, > for greater than, and > for greater than or equal to. (Yes, the original says > again for greater than or equal to — iconic typo energy, we're keeping it exactly as it is 💀)

✨ Within Expressions ✨

A RasMol within expression allows atoms to be selected based on their proximity to another set of atoms. A within expression takes two parameters separated by a comma and surrounded by parentheses. The first argument is an integer value called the "cut-off" distance of the within expression, and the second argument is any valid atom expression. The cut-off distance is expressed in either integer RasMol units or Angstroms containing a decimal point. An atom is selected if it is within the cut-off distance of any of the atoms defined by the second argument. This allows complex expressions to be constructed containing nested within expressions.

For example, the command select within(3.2,backbone) selects any atom within a 3.2 Angstrom radius of any atom in a protein or nucleic acid backbone. Within expressions are particularly useful for selecting the atoms around an active site. Obsessed with the precision 🎀

✨ Predefined Sets ✨

RasMol atom expressions may contain predefined sets. These sets are single keywords that represent portions of a molecule of interest. Predefined sets are often abbreviations of primitive atom expressions. In some cases the use of predefined sets allows selection of areas of a molecule that could not otherwise be distinguished. A list of the currently predefined sets is given below.

🌈 In addition to the sets listed here, RasMol also treats element names (and their plurals) as predefined sets containing all atoms of that element type, i.e. the command select oxygen is equivalent to the command select elemno=8.

🌸 Predefined Sets 🌸

AT Set — This set contains the atoms in the complementary nucleotides adenosine and thymidine (A and T, respectively). All nucleotides are classified as either the set at or the set cg. This set is equivalent to the RasMol atom expressions a,t, and nucleic and not cg.
Acidic Set — The set of acidic amino acids. These are the residue types Asp and Glu. All amino acids are classified as either acidic, basic or neutral. This set is equivalent to the RasMol atom expressions asp, glu and amino and not (basic or neutral).
Acyclic Set — The set of atoms in amino acids not containing a cycle or ring. All amino acids are classified as either cyclic or acyclic. This set is equivalent to the RasMol atom expression amino and not cyclic.
Aliphatic Set — This set contains the aliphatic amino acids. These are the amino acids Ala, Gly, Ile, Leu and Val. This set is equivalent to the RasMol atom expression ala, gly, ile, leu, val.
Alpha Set — The set of alpha carbons in the protein molecule. This set is approximately equivalent to the RasMol atom expression *.CA. This command should not be confused with the predefined set helix which contains the atoms in the amino acids of the protein's alpha helices.
Amino Set — This set contains all the atoms contained in amino acid residues. This is useful for distinguishing the protein from the nucleic acid and heterogeneous atoms in the current molecule database.
Aromatic Set — The set of atoms in amino acids containing aromatic rings. These are the amino acids His, Phe, Trp and Tyr. Because they contain aromatic rings all members of this set are members of the predefined set cyclic. This set is equivalent to the RasMol atom expressions his, phe, trp, tyr and cyclic and not pro.
Backbone Set — This set contains the four atoms of each amino acid that form the polypeptide N-C-C-O backbone of proteins, and the atoms of the sugar phosphate backbone of nucleic acids. Use the RasMol predefined sets protein and nucleic to distinguish between the two forms of backbone. Atoms in nucleic acids and proteins are either backbone or sidechain. This set is equivalent to the RasMol expression (protein or nucleic) and not sidechain.

💖 The predefined set mainchain is synonymous with the set backbone.

Basic Set — The set of basic amino acids. These are the residue types Arg, His and Lys. All amino acids are classified as either acidic, basic or neutral. This set is equivalent to the RasMol atom expressions arg, his, lys and amino and not (acidic or neutral).
Bonded Set — This set contains all the atoms in the current molecule database that are bonded to at least one other atom.
Buried Set — This set contains the atoms in those amino acids that tend (prefer) to be buried inside protein, away from contact with solvent molecules. This set refers to the amino acids preference and not the actual solvent accessibility for the current protein. All amino acids are classified as either surface or buried. This set is equivalent to the RasMol atom expression amino and not surface.
CG Set — This set contains the atoms in the complementary nucleotides cytidine and guanosine (C and G, respectively). All nucleotides are classified as either the set at or the set cg. This set is equivalent to the RasMol atom expressions c,g and nucleic and not at.
Charged Set — This set contains the charged amino acids. These are the amino acids that are either acidic or basic. Amino acids are classified as being either charged or neutral. This set is equivalent to the RasMol atom expressions acidic or basic and amino and not neutral.
Cyclic Set — The set of atoms in amino acids containing a cycle or rings. All amino acids are classified as either cyclic or acyclic. This set consists of the amino acids His, Phe, Pro, Trp and Tyr. The members of the predefined set aromatic are members of this set. The only cyclic but non-aromatic amino acid is proline. This set is equivalent to the RasMol atom expressions his, phe, pro, trp, tyr and aromatic or pro and amino and not acyclic.
Cystine Set — This set contains the atoms of cysteine residues that form part of a disulphide bridge, i.e. half cystines. RasMol automatically determines disulphide bridges, if neither the predefined set cystine nor the RasMol ssbonds command have been used since the molecule was loaded. The set of free cysteines may be determined using the RasMol atom expression cys and not cystine.
Helix Set — This set contains all atoms that form part of a protein alpha helix as determined by either the PDB file author or Kabsch and Sander's DSSP algorithm. By default, RasMol uses the secondary structure determination given in the PDB file if it exists. Otherwise, it uses the DSSP algorithm as used by the RasMol structure command.

🌟 This predefined set should not be confused with the predefined set alpha which contains the alpha carbon atoms of a protein.

Hetero Set — This set contains all the heterogeneous atoms in the molecule. These are the atoms described by HETATM entries in the PDB file. These typically contain water, cofactors and other solvents and ligands. All hetero atoms are classified as either ligand or solvent atoms. These heterogeneous solvent atoms are further classified as either water or ions.

Hydrogen Set ✨

okay so this predefined set is literally every hydrogen, deuterium and tritium atom in the current molecule. that's it, that's the set, tiny icons only 💖. it's exactly equivalent to the RasMol atom expression elemno=1.

Hydrophobic Set 🌊

this one's got all the hydrophobic amino acids, no cap. that's Ala, Leu, Val, Ile, Pro, Phe, Met and Trp — the whole "i don't wanna talk to water" squad 🫧. every single amino acid is classified as either hydrophobic or polar, no in-between situationships. this set is equivalent to the RasMol atom expressions ala, leu, val, ile, pro, phe, met, trp and amino and not polar.

Ions Set ⚡

all the heterogeneous phosphate and sulphate ions in your current molecule data file, bestie. a large number of these ions are sometimes associated with protein and nucleic acid structures determined by X-ray crystallography — and honestly they tend to clutter an image so bad 😭. all hetero atoms are classified as either ligand or solvent atoms, and all solvent atoms are classified as either water or ions. iykyk.

Large Set 🐘

so every amino acid gets classified as either small, medium or large, and this is the big-girl set. it's equivalent to the RasMol atom expression amino and not (small or medium).

Ligand Set 🔗

this set contains all the heterogeneous cofactor and ligand moieties chilling in the current molecule data file. it's defined as all hetero atoms that are not solvent atoms, which means it's equivalent to the RasMol atom expression hetero and not solvent.

Medium Set 🧸

the middle child of the small/medium/large classification (all amino acids are classified as either small, medium or large, remember 💅). equivalent to the RasMol atom expression amino and not (large or small).

Neutral Set ⚖️

the set of neutral amino acids. all amino acids are classified as either acidic, basic or neutral, and this is the "no strong opinions" vibes set. equivalent to the RasMol atom expression amino and not (acidic or basic).

Nucleic Set 🧬

the set of all atoms in nucleic acids — which consists of the four nucleotide bases adenosine, cytidine, guanosine and thymidine (A, C, G and T, respectively). all nucleotides are classified as either purine or pyrimidine. this set is equivalent to the RasMol atom expressions a,c,g,t and purine or pyrimidine. ✨ bonus: the symbols for RNA nucleotides (U, +U, I, 1MA, 5MC, OMC, 1MG, 2MG, M2G, 7MG, OMG, YG, H2U, 5MU, and PSU) are also recognized as members of this set. iconic, honestly.

Polar Set 💧

the polar amino acids live here. all amino acids are classified as either hydrophobic or polar, and this is the chatty-with-water half. equivalent to the RasMol atom expression amino and not hydrophobic.

Protein Set 🥚

the set of all atoms in proteins. this consists of the RasMol predefined set amino plus common post-translation modifications. main character energy fr fr 👑.

Purine Set 🅰️

the set of purine nucleotides — bases adenosine and guanosine (A and G, respectively). all nucleotides are either purines or pyrimidines, no third option. equivalent to the RasMol atom expressions a,g and nucleic and not pyrimidine.

Pyrimidine Set 🅲

the set of pyrimidine nucleotides — bases cytidine and thymidine (C and T, respectively). again, all nucleotides are either purines or pyrimidines. equivalent to the RasMol atom expressions c,t and nucleic and not purine.

Selected Set 🎯

this set contains the atoms in the currently selected region. and here's the important little detail bestie 👀: the currently selected region is defined by the preceding select or restrict command — not by the atom expression containing the selected keyword. don't get it twisted.

Sheet Set 📄

all atoms that form part of a protein beta sheet, as determined by either the PDB file author or Kabsch and Sander's DSSP algorithm. by default, RasMol uses the secondary structure determination given in the PDB file if it exists. otherwise, it uses the DSSP algorithm as used by the RasMol structure command. slay 🔥.

Sidechain Set 🌿

this set has the functional sidechains of any amino acids plus the base of each nucleotide. these are the atoms not part of the polypeptide N-C-C-O backbone of proteins or the sugar phosphate backbone of nucleic acids. use the RasMol predefined sets protein and nucleic to distinguish between the two flavors of sidechain 🍓. atoms in nucleic acids and proteins are either backbone or sidechain, and this set is equivalent to the RasMol expression (protein or nucleic) and not backbone.

Small Set 🐣

the smol set. all amino acids are classified as either small, medium or large. equivalent to the RasMol atom expression amino and not (medium or large).

Solvent Set 🌊

this set contains the solvent atoms in the molecule coordinate file — the heterogeneous water molecules, phosphate and sulphate ions. all hetero atoms are classified as either ligand or solvent atoms, and all solvent atoms are classified as either water or ions. this set is equivalent to the RasMol atom expressions hetero and not ligand and water or ions.

Surface Set ☀️

atoms in those amino acids that tend (prefer) to be on the surface of proteins, in contact with solvent molecules. and a lil heads up 🫶: this set refers to the amino acids' preference, not the actual solvent accessibility for the current protein. all amino acids are classified as either surface or buried, and this set is equivalent to the RasMol atom expression amino and not buried.

Turn Set 🔄

all atoms that form part of a protein turns, as determined by either the PDB file author or Kabsch and Sander's DSSP algorithm. by default RasMol uses the secondary structure determination given in the PDB file if it exists — otherwise it falls back to the DSSP algorithm as used by the RasMol structure command. same deal as Sheet, different vibe check 💫.

Water Set 💦

all the heterogeneous water molecules in the current database. a large number of water molecules are sometimes associated with protein and nucleic acid structures determined by X-ray crystallography, and ngl these atoms tend to clutter an image 😭. reminder that all hetero atoms are classified as either ligand or solvent atoms, and the solvent atoms are further classified as either water or ions.

Set Summary 🌈

the table below summarises RasMol's classification of the common amino acids:

🎨 COLOUR SCHEMES 🎨

The colour command is literally the glow-up button for different objects — atoms, bonds, ribbon segments, the whole crew — and it gives them a specified colour. Usually that colour is either a RasMol predefined colour name or an RGB triple. RasMol also supports alt, amino, chain, charge, cpk, group, model, shapely, structure, temperature or user colour schemes for atoms, plus the hbond type colour scheme for hydrogen bonds and the electrostatic potential colour scheme for dot surfaces.

The 24 currently predefined colour names are: Black, Blue, BlueTint, Brown, Cyan, Gold, Grey, Green, GreenBlue, GreenTint, HotPink, Magenta, Orange, Pink, PinkTint, Purple, Red, RedOrange, SeaGreen, SkyBlue, Violet, White, Yellow and YellowTint.

If you frequently wish to use a colour that isn't predefined, bestie, you can write a one-line script. For example, if you make the file grey.col containing the line:

colour [180,180,180] #grey

then the command script grey.col colours the currently selected atom set grey. Iconic, lowkey.

🦋 Alt Colours 🦋

The RasMol alt (Alternate Conformer) colour scheme codes the base structure with one colour and applies a limited number of colours to each alternate conformer. In a RasMol built for 8-bit colour systems, 4 colours are allowed for alternate conformers. Otherwise, 8 colours are available. No cap.

🌸 Amino Colours 🌸

The RasMol amino colour scheme colours amino acids according to traditional amino acid properties. The purpose of colouring is to identify amino acids in an unusual or surprising environment. The outer parts of a protein that are polar are visible (bright) colours, and non-polar residues are darker. Most colours are hallowed by tradition. This colour scheme is similar to the shapely scheme.

🎀 Chain Colours 🎀

The RasMol chain colour scheme assigns each macromolecular chain a unique colour. This colour scheme is particularly useful for distinguishing the parts of a multimeric structure or the individual 'strands' of a DNA chain. Chain can be selected from the RasMol Colours menu.

⚡ Charge Colours ⚡

The RasMol charge colour scheme colour codes each atom according to the charge value stored in the input file (or the beta factor field of PDB files). High values are coloured in blue (positive) and lower values are coloured in red (negative). Rather than use a fixed scale, this scheme determines the maximum and minimum values of the charge/temperature field and interpolates from red to blue appropriately. Hence, green cannot be assumed to be 'no net charge' charge. 💀

The difference between the charge and temperature colour schemes is that increasing temperature values proceed from blue to red, whereas increasing charge values go from red to blue.

If the charge/temperature field stores reasonable values, it is possible to use the RasMol colour dots potential command to colour code a dot surface (generated by the dots command) by electrostatic potential.

🧪 CPK Colours 🧪

The RasMol cpk colour scheme is based upon the colours of the popular plastic spacefilling models which were developed by Corey, Pauling and later improved by Kultun. This colour scheme colours 'atom' objects by the atom (element) type. This is the scheme conventionally used by chemists. The assignment of the most commonly used element types to colours is given below.

🌈 Group Colours 🌈

The RasMol group colour scheme colour codes residues by their position in a macromolecular chain. Each chain is drawn as a smooth spectrum from blue through green, yellow and orange to red. Hence, the N terminus of proteins and 5' terminus of nucleic acids are coloured red, and the C terminus of proteins and 3' terminus of nucleic acids are drawn in blue. If a chain has a large number of heterogeneous molecules associated with it, the macromolecule may not be drawn in the full 'range' of the spectrum. Group can be selected from the RasMol Colours menu.

Okay, same tea again because it matters: if a chain has a large number of heterogeneous molecules associated with it, the macromolecule may not be drawn in the full range of the spectrum. When RasMol performs group colouring, it decides the range of colours it uses from the residue numbering given in the PDB file. Hence the lowest residue number is displayed in blue and the highest residue number is displayed as red. Unfortunately, if a PDB file contains a large number of heteroatoms, such as water molecules, that occupy the high residue numbers, the protein is displayed in the blue-green end of the spectrum and the waters in the yellow-red end of the spectrum. This is aggravated by there typically being many more water molecules than amino acid residues. The solution to this problem is to use the command set hetero off before applying the group colour scheme. This can also be achieved by toggling Hetero Atoms on the Options menu before selecting Group on the Colour menu. This command instructs RasMol to only use non-hetero residues in the group colour scaling.

💜 NMR Model Colours 💜

The RasMol model colour scheme codes each NMR model with a distinct colour. The NMR model number is taken as a numeric value. High values are coloured in blue and lower values are coloured in red. Rather than use a fixed scale, this scheme determines the maximum value of the NMR model number and interpolates from red to blue appropriately.

🦋 Shapely Colours 🦋

The RasMol shapely colour scheme colour codes residues by amino acid property. This scheme is based upon Bob Fletterick's "Shapely Models". Each amino acid and nucleic acid residue is given a unique colour. The shapely colour scheme is used by David Bacon's Raster3D program. This colour scheme is similar to the amino colour scheme.

🏗️ Structure Colours 🏗️

The RasMol structure colour scheme colours the molecule by protein secondary structure. Alpha helices are coloured magenta, [240,0,128], beta sheets are coloured yellow, [255,255,0], turns are coloured pale blue, [96,128,255] and all other residues are coloured white. The secondary structure is either read from the PDB file (HELIX, SHEET and TURN records), if available, or determined using Kabsch and Sander's DSSP algorithm. The RasMol structure command may be used to force DSSP's structure assignment to be used.

🔥 Temperature Colours 🔥

The RasMol temperature colour scheme colour codes each atom according to the anisotropic temperature (beta) value stored in the PDB file. Typically this gives a measure of the mobility/uncertainty of a given atom's position. High values are coloured in warmer (red) colours and lower values in colder (blue) colours. This feature is often used to associate a "scale" value [such as amino acid variability in viral mutants] with each atom in a PDB file, and colour the molecule appropriately.

The difference between the temperature and charge colour schemes is that increasing temperature values proceed from blue to red, whereas increasing charge values go from red to blue.

🎨 User Colours 🎨

The RasMol user colour scheme allows RasMol to use the colour scheme stored in the PDB file. The colours for each atom are stored in COLO records placed in the PDB data file. This convention was introduced by David Bacon's Raster3D program.

💅 HBond Type Colours 💅

The RasMol type colour scheme applies only to hydrogen bonds, hence is used in the command colour hbonds type. This scheme colour codes each hydrogen bond according to the distance along a protein chain between hydrogen bond donor and acceptor. This schematic representation was introduced by Belhadj-Mostefa and Milner-White. This representation gives a good insight into protein secondary structure (hbonds forming alpha helices appear red, those forming sheets appear yellow and those forming turns appear magenta).

✨ Potential Colours ✨

The RasMol potential colour scheme applies only to dot surfaces, hence is used in the command colour dots potential. This scheme colours each currently displayed dot by the electrostatic potential at that point in space. This potential is calculated using Coulomb's law, taking the temperature/charge field of the input file to be the charge associated with that atom. This is the same interpretation used by the colour charge command. Like the charge colour scheme, low values are blue/white and high values are red.

🧬 Amino Acid Codes 🧬

The following table lists the names, single letter and three letter codes of each of the amino acids.

🔘 Booleans 🔘

A boolean parameter is a truth value. Valid boolean values are 'true' and used by RasMol to either enable or disable a representation or option.

📁 FILE FORMATS 📁

🧬 Protein Data Bank Files 🧬

Okay bestie, if you don’t have the PDB docs handy, this little summary of the PDB file format is gonna be your bestie. The Protein Data Bank is a computer-based archival database for macromolecular structures. It was established in 1971 by Brookhaven National Laboratory, Upton, New York, as a public domain repository for resolved crystallographic structures. The Bank uses a uniform format to store atomic coordinates and partial bond connectivities as derived from crystallographic studies. In 1999 the Protein Data Bank moved to the Research Collaboratory for Structural Biology. ✨

PDB file entries consist of records of 80 characters each. Using the punched card analogy, columns 1 to 6 contain a record-type identifier, and columns 7 to 70 contain data. In older entries, columns 71 to 80 are normally blank, but may contain sequence information added by library management programs. In new entries conforming to the 1996 PDB format, there is other information in those columns. The first four characters of the record identifier are sufficient to identify the type of record uniquely, and the syntax of each record is independent of the order of records within any entry for a particular macromolecule. 🫶

The only record types that are of major interest to the RasMol program are the ATOM and HETATM records, which describe the position of each atom. ATOM/HETATM records contain standard atom names and residue abbreviations, along with sequence identifiers, coordinates in Angstrom units, occupancies and thermal motion factors. The exact details are given below as a FORTRAN format statement. The fmt column indicates use of the field in all PDB formats, in the 1992 and earlier formats or in the 1996 and later formats. 💅

Residues occur in order starting from the N-terminal residue for proteins and 5'-terminus for nucleic acids. If the residue sequence is known, certain atom serial numbers may be omitted to allow for future insertion of any missing atoms. Within each residue, atoms are ordered in a standard manner, starting with the backbone (N-C-C-O for proteins) and proceeding in increasing remoteness from the alpha carbon, along the side chain. 🧚

HETATM records are used to define post-translational modifications and cofactors associated with the main molecule. TER records are interpreted as breaks in the main molecule's backbone. 🦋

If present, RasMol also inspects HEADER, COMPND, HELIX, SHEET, TURN, CONECT, CRYST1, SCALE, MODEL, ENDMDL, EXPDTA and END records. Information such as the name, database code, revision date and classification of the molecule are extracted from HEADER and COMPND records, initial secondary structure assignments are taken from HELIX, SHEET and TURN records, and the end of the file may be indicated by an END record. 👑

🔍 RasMol Interpretation of PDB fields 🔍

Atoms located at 9999.000, 9999.000, 9999.000 are assumed to be Insight pseudo atoms and are ignored by RasMol. Atom names beginning ' Q' are also assumed to be pseudo atoms or position markers. 🙈
When a data file contains an NMR structure, multiple conformations may be placed in a single PDB file delimited by pairs of MODEL and ENDMDL records. RasMol displays all the NMR models contained in the file. 🌀
Residue names CSH, CYH and CSM are considered pseudonyms for cysteine CYS. Residue names WAT, H20, SOL and TIP are considered pseudonyms for water HOH. The residue name D20 is consider heavy water DOD. The residue name SUL is considered a sulphate ion SO4. The residue name CPR is considered to be cis-proline and is translated as PRO. The residue name TRY is considered a pseudonym for tryptophan TRP. 💖
RasMol uses the HETATM fields to define the sets hetero, water, solvent and ligand. Any group with the name HOH, DOD, SO4 or PO4 (or aliased to one of these names by the preceding rules) is considered a solvent and is considered to be defined by a HETATM field. 🌸
RasMol only respects CONECT connectivity records in PDB files containing fewer than 256 atoms. This is explained in more detail in the section on determining molecule connectivity. CONECT records that define a bond more than once are interpreted as specifying the bond order of that bond, i.e. a bond specified twice is a double bond and a bond specified three (or more) times is a triple bond. This is not a standard PDB feature. 💀

🎨 PDB Colour Scheme Specification 🎨

RasMol also accepts the supplementary COLO record type in PDB files. This record format was introduced by David Bacon's Raster3D program for specifying the colour scheme to be used when rendering the molecule. This extension is not currently supported by the PDB. The COLO record has the same basic record type as the ATOM and HETATM records described above. 🌈

Colours are assigned to atoms using a matching process. The Mask field is used in the matching process as follows. First RasMol reads in and remembers all the ATOM, HETATM and COLO records in input order. When the user-defined ('User') colour scheme is selected, RasMol goes through each remembered ATOM/HETATM record in turn, and searches for a COLO record that matches in all of columns 7 through 30. The first such COLO record to be found determines the colour and radius of the atom. ⭐

Note that the Red, Green and Blue components are in the same positions as the X, Y, and Z components of an ATOM or HETA record, and the van der Waals radius goes in the place of the Occupancy. The Red, Green and Blue components must all be in the range 0 to 1. 🎀

In order that one COLO record can provide colour and radius specifications for more than one atom (e.g. based on residue, atom type, or any other criterion for which labels can be given somewhere in columns 7 through 30), a 'don't-care' character, the hash mark # (number or sharp sign) is used. This character, when found in a COLO record, matches any character in the corresponding column in a ATOM/HETATM record. All other characters must match identically to count as a match. As an extension to the specification, any atom that fails to match a COLO record is displayed in white. 💜

🌀 Multiple NMR Models 🌀

RasMol loads all of the NMR models from a PDB file no matter which command is used:

load pdb <filename>
load nmrpdb <filename>

Once multiple NMR conformations have been loaded they may be manipulated with the atom expression extensions described in Primitive Expressions. In particular, the command restrict */1 will restrict the display to the first model only. ✨

📚 CIF and mmCIF Format Files 📚

CIF is the IUCr standard for presentation of small molecules and mmCIF is intended as the replacement for the fixed-field PDB format for presentation of macromolecular structures. RasMol can accept data sets in either format. 🧬

There are many useful sites on the World Wide Web where information tools and software related to CIF, mmCIF and the PDB can be found. The following are good starting points for exploration:

The International Union of Crystallography (IUCr) provides access to software, dictionaries, policy statements and documentation relating to CIF and mmCIF at: IUCr, Chester, England (www.iucr.org/iucr-top/cif/) with many mirror sites. 🌍
The Nucleic Acid Database Project provides access to its entries, software and documentation, with an mmCIF page giving access to the dictionary and mmCIF software tools at Rutgers University, New Jersey, USA (http://ndbserver.rutgers.edu/NDB/mmcif) with many mirror sites. 🗂️

This version of RasMol restricts CIF or mmCIF tag values to essentially the same conventions as are used for the fixed-field PDB format. Thus chain identifiers and alternate conformation identifiers are limited to a single character, atom names are limited to 4 characters, etc. RasMol interprets the following CIF and mmCIF tags: A search is made through multiple data blocks for the desired tags, so a single dataset may be composed from multiple data blocks, but multiple data sets may not be stacked in the same file. 💖

🛠️ MACHINE-SPECIFIC SUPPORT 🛠️

Okay bestie, this is the special-cases-and-platform-lore corner. The following sections describe support for Monochrome X-Windows, Tcl/Tk IPC, UNIX sockets based IPC, and compiling RasWin with Borland and MetroWerks. Buckle up 💅

🖤 Monochrome X-Windows Support 🖤

RasMol supports the many monochrome UNIX workstations typically found in academia, such as low-end SUN workstations and NCD X-terminals. Iconic legacy-machine energy.

The X11 version of RasMol (when compiled in 8 bit mode) now detects black and white X-Windows displays and enables dithering automatically. Because it uses run-time error diffusion dithering, all display modes of RasMol are available when in monochrome mode. For best results, users should experiment with the set ambient command to ensure the maximum contrast in resulting images. No cap ✨

🦋 Tcl/Tk IPC support 🦋

Version 4 of Tk graphics library changed the protocol used to communicate between Tk applications. RasMol version 2.6 was modified such that it could communicate with both this new protocol and the previous version 3 protocol supported by RasMol v2.5.

So even though Tcl/Tk 3.x applications may only communicate with other 3.x applications and Tcl/Tk 4.x applications with other 4.x applications, these changes allow RasMol to communicate between processes with both protocols (potentially concurrently). Both-protocol main character energy. 🫶

🔌 UNIX sockets based IPC 🔌

The UNIX implementation of RasMol supports BSD-style socket communication. An identical socket mechanism is also being developed for VMS, Apple Macintosh and Microsoft Windows systems. This should allow RasMol to interactively display results of a computation on a remote host.

The current protocol acts as a TCP/IP server on port 21069 that executes command lines until either the command exit or the command quit is typed. From the RasMol server, the command exit and the command quit both disconnect the current session and terminate RasMol.

This functionality may be tested using the UNIX command telnet <hostname> 21069. iykyk, remote-display bestie. 💻

🛠️ Compiling RasWin with Borland and MetroWerks 🛠️

A number of changes were made to the source code in the transition from version 2.5 to 2.6 to allow the Microsoft Windows version of RasMol to compile using the Borland C/C++ compiler. These fixes include name changes for the standard library and special code to avoid a bug in _fmemset.

Additional changes were made in the transition from 2.6 to 2.7 to allow compilation with the MetroWerks compilers. Compiler-era glow-up, fr fr. 🔥

📚 BIBLIOGRAPHY 📚

Molecular Graphics

[1] Nelson Max, "Computer Representation of Molecular Surfaces", IEEE Computer Graphics and Applications, pp.21-29, August 1983.
[2] Arthur M. Lesk, "Protein Architecture: A Practical Approach", IRL Press Publishers, 1991.

Molecular Graphics Programs

[3] Per J. Kraulis, "MOLSCRIPT: A Program to Produce both Detailed and Schematic Plots of Protein Structures", Journal of Applied Crystallography, Vol.24, pp.946-950, 1991.
[4] David Bacon and Wayne F. Anderson, "A Fast Algorithm for Rendering Space-Filling Molecule Pictures", Journal of Molecular Graphics, Vol.6, No.4, pp.219-220, December 1988.
[5] David C. Richardson and Jane S. Richardson, "The Kinemage: A tool for Scientific Communication", Protein Science, Vol.1, No.1,pp.3-9, January 1992.
[6] Mike Carson, "RIBBONS 2.0", Journal of Applied Crystallography, Vol.24, pp.958-961, 1991.
[7] Conrad C. Huang, Eric F. Pettersen, Teri E. Klein, Thomas E. Ferrin and Robert Langridge, "Conic: A Fast Renderer for Space-Filling Molecules with Shadows", Journal of Molecular Graphics, Vol.9, No.4, pp.230-236, December 1991.

Molecular Biology Algorithms

[8] Wolfgang Kabsch and Christian Sander, "Dictionary of Protein Secondary Structure: Pattern Recognition of Hydrogen-Bonded and Geometrical Features", Biopolymers, Vol.22, pp.2577-2637, 1983.
[9] Michael L. Connolly, "Solvent-Accessible Surfaces of Proteins and Nucleic Acids", Science, Vol.221, No.4612, pp.709-713, August 1983.
[10] Khaled Belhadj-Mostefa, Ron Poet and E. James Milner-White, "Displaying Inter-Main Chain Hydrogen Bond Patterns in Proteins", Journal of Molecular Graphics, Vol.9, No.3, pp.194-197, September 1991.
[11] Mike Carson, "Ribbon Models of Macromolecules", Journal of Molecular Graphics, Vol.5, No.2, pp.103-106, June 1987.
[12] Mike Carson and Charles E. Bugg, "Algorithm for Ribbon Models of Proteins", Journal of Molecular Graphics, Vol.4, No.2, pp.121-122, June 1986.
[13] H. Iijima, J. B. Dunbar Jr. and G. Marshall, "Calibration of Effective van der Waals Atomic Contact Radii for Proteins and Peptides", Proteins: Structure, Functions and Genetics, Vol.2, pp.330-339,1987.

Graphics Algorithms

[14] J. Foley, A. van Dam, S. Feiner and J. Hughes, "Computer Graphics: Principles and Practice", 2nd Edition, Addison Wesley Publishers, 1990.
[15] J. Cleary and G. Wyvill, "Analysis of an Algorithm for Fast Ray Tracing using Uniform Space Subdivision", The Visual Computer, Vol.4, pp.65-83, 1988.
[16] Thomas Porter,"Spherical Shading", Computer Graphics Vol.12, ACM SIGGRAPH, pp.282-285, 1978.
[17] Jean-Michel Cense, "Exact Visibility Calculation for Space-Filling Molecular Models", Journal of Molecular Graphics, Vol.9, No.3, pp.191-193, September 1991.
[18] Chris Schafmeister, "Fast Algorithm for Generating CPK Images on Graphics Workstations", Journal of Molecular Graphics, Vol.8, No.4, pp.201-206, December 1990.
[19] Bruce A. Johnson, "MSURF: A Rapid and General Program for the Representation of Molecular Surfaces", Journal of Molecular Graphics, Vol.5, No.3, pp.167-169, September 1987.

File Formats

[20] Frances C. Bernstein et al., "The Protein Data Bank: A Computer-Based Archival File for Macromolecular Structures", Journal of Molecular Biology, Vol.112, pp.535-542, 1977.
[21] Arthur Dalby, James G. Nourse, W. Douglas Hounshell, Ann K. I. Gushurst, David L. Grier, Burton A. Leland and John Laufer, "Description of Several Chemical File Formats Used by Computer Programs Developed at Molecular Design Limited", Journal of Chemical Information and Computer Sciences, Vol.32, No.3, pp.244-255, 1992.
[22] Adobe Systems Inc., "PostScript Language Reference Manual", Addison-Wesley Publishers, Reading, Mass., 1985.
[23] Philip E. Bourne et al., "The Macromolecular Crystallographic Information File (mmCIF)", Meth. Enzymol. (1997) 277, 571-590.
[24] Sydney R. Hall, "The STAR File: a New Format for Electronic Data Transfer and Archiving", Journal of Chemical Information and Computer Sciences, Vol. 31, 326-333, 1991.

👀 SEE ALSO 👀

The RasMol User Manual! Literally go read it, bestie. 📖💖

💖 AUTHOR 💖

1992-1998 by Roger Sayle (rasmol@ggr.co.uk) 👑

Byeee bestie 💅 — source/version: RASMOL(1), date: February 2005. Mwah 🎀✨

📦 where this page comes from

opensuse-leap 16.0: rasmol 2.7.4.2-bp160.1.12 · SUSE-Public-Domain
opensuse-leap 16.0: rasmol 2.7.4.2-bp160.1.12 · SUSE-Public-Domain
opensuse-leap 16.0: rasmol 2.7.4.2-bp160.1.12 · SUSE-Public-Domain
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms