Editing Pml


== PyMOL Script ==

PyMOL scripts are plain text files containing PyMOL commands, one per line, appearing as they would be entered at the PyMOL command prompt.  The standard extension for a PyMOL script is <tt>.pml</tt>.


=== Basic usage ===

Save your commands in a plain text file (using e.g. Notepad, TextEdit, or a text editor of your choice) with a <tt>.pml</tt> extension, e.g. <tt>script.pml</tt>.

Run the script by either '''File > Run script...''' in the GUI menu bar, or via the command

 @/path/to/my/script.pml

Relative paths are fine, so if PyMOL has been launched in the same directory as your script, you can simplify this to <code>@script.pml</code>

=== Command syntax ===

PyMOL commands are typically in the form:

 command arg1[, arg2[, ...]]

For example:

 color green, chain A

which will, as you might expect, color all the atoms of chain A green.  There is no comma between the command and the first argument, and in general, no quotation marks are necessary around the arguments.  (Exceptions to this rule include situations where you are passing a text string as an argument which contains a comma; in this case the entire string should be quoted.)

For commands that take keyword arguments, the syntax is similar to passing keyword arguments to a Python function:

 fetch 1nmr, async=0

will use the asynchronous version of <code>fetch</code>, waiting to execute any following commands until the <code>fetch</code> command finishes.


==== Python code ====

''PyMOL'' scripts can also contain ''Python'' code.  Single-line Python statements can be written normally and will be handled as expected;

<source lang="python">
# imports
import this
from glob import glob

# variable assignments
prefix = "structure_"

# complex single-line statements like list comprehensions
[cmd.load(x) for x in glob(f'{prefix}*.pdb')]

# any other arbitrary Python code
print(2 + 2)
</source>

Python code that spans more than one line can be enclosed in a <code>python/python end</code> code block, like this:

<source lang="python">
python
def hello(name="World"):
    print("Hello,", name)
python end
</source>

=== Handy commands to include in your scripts ===

* <code>reinitialize</code> - issue this command at the start of your script to allow it to be run multiple times in the same PyMOL session.
* <code>log_open log.pml</code> - create a log file to record actions taken in the GUI.  Examine this log file to learn new commands, although keep in mind that these are typically formatted as Python function calls.
* <code>deselect</code> - place this at the very end of the script to ensure no atoms are selected after the script completes, for a cleaner GUI appearance.