The Coot User Manual

Table of Contents

Next: , Up: (dir)   [Contents][Index]

Coot User Manual


Next: , Previous: Top, Up: Top   [Contents][Index]

1 Introduction

This document is the Coot User Manual, giving an overview of the interactive features. Other documentation includes the Coot Reference Manual and the Coot Tutorial. These documents should be distributed with the source code.


Next: , Up: Introduction   [Contents][Index]

1.1 Citing Coot and Friends

If have found this software to be useful, you are requested (if appropriate) to cite:

"Features and Development of Coot" P Emsley, B Lohkamp, W Scott, and K Cowtan Acta Cryst. (2010). D66, 486-501 Acta Crystallographica Section D-Biological Crystallography 66: 486-501

The reference for the REFMAC5 Dictionary is:

REFMAC5 dictionary: "Organization of Prior Chemical Knowledge and Guidelines for its Use" Vagin AA, Steiner RA, Lebedev AA, Potterton L, McNicholas S Long F, Murshudov GN Acta Crystallographica Section D-Biological Crystallography 60: 2184-2195 Part 12 Sp. Iss. 1 DEC 2004"

If using "SSM Superposition", please cite:

"Secondary-structure matching (SSM), a new tool for fast protein structure alignment in three dimensions" Krissinel E, Henrick K Acta Crystallographica Section D-Biological Crystallography 60: 2256-2268 Part 12 Sp. Iss. 1 DEC 2004

The reference for the the Electron Density Server is:

GJ Kleywegt, MR Harris, JY Zou, TC Taylor, A Wählby, TA Jones (2004), "The Uppsala Electron-Density Server", Acta Crystallographica Section D-Biological Crystallography 60, 2240-2249.

Please also cite the primary literature for the received structures.


Next: , Previous: Citing Coot, Up: Introduction   [Contents][Index]

1.2 What is Coot?

Coot is a molecular graphics application. Its primary focus is crystallographic macromolecular model-building and manipulation rather than representation i.e. more like Frodo than Rasmol. Having said that, Coot can work with small molecule (SHELXL) and electron microscopy data, be used for homology modelling, make passably pretty pictures and display NMR structures.

Coot is Free Software. You can give it away. If you don’t like the way it behaves, you can fix it yourself.


Next: , Previous: What is Coot?, Up: Introduction   [Contents][Index]

1.3 What Coot is Not

Coot is not:


Next: , Previous: What Coot is Not, Up: Introduction   [Contents][Index]

1.4 Hardware Requirements

The code is designed to be portable to any Unix-like operating system. Coot certainly runs on RedHat Linux of various sorts, Fedora, Ubuntu, Debian, SuSe Linux and MacOS X. There is also a Window port (called WinCoot).

If you want to port to some other operating system, you are welcome 4. Note that your task will be eased by using GNU GCC to compile the programs components.

1.4.1 Mouse

Coot works best with a 3-button mouse and works better if it has a scroll-wheel too (see Chapter 2 for more details) 5.


Next: , Previous: Hardware Requirements, Up: Introduction   [Contents][Index]

1.5 Environment Variables

Coot responds to several environment variables that modify its behaviour.

And of course extension language environment variables are used too:

Normally, these environment variables will be set correctly in the coot shell script.


Next: , Previous: Environment Variables, Up: Introduction   [Contents][Index]

1.6 Command Line Arguments

Rather that using the GUI to read in information, you can use the following command line arguments:

So, for example, one might use:


Next: , Previous: Command Line Arguments, Up: Introduction   [Contents][Index]

1.7 Web Page

Coot has a web page:

There you can read more about the CCP4 molecular graphics project in general and other projects which are important for Coot 7.


Previous: Web Page, Up: Introduction   [Contents][Index]

1.8 Crash

Coot might crash on you - it shouldn’t.

Whenever Coot manipulates the model, it saves a backup pdb file. There are backup files in the directory coot-backup 8. You can recover the session (until the last edit) by reading in the pdb file that you started with last time and then use File -> Recover Session….

I would like to know about coot crashing 9 so that I can fix it as soon as possible. If you want your problem fixed, this involves some work on your part sadly.

First please make sure that you are using the most recent version of coot. I will often need to know as much as possible about what you did to cause the bug. If you can reproduce the bug and send me the files that are needed to cause it, I can almost certainly fix it 10 - especially if you use the debugger (gdb) and send a backtrace too11. Note that you may have to source the contents of bin/coot so that the libraries are can be found when the executable dynamically links.


Next: , Previous: Introduction, Up: Top   [Contents][Index]

2 Mousing and Keyboarding

How do we move around and select things?

Left-mouse Drag

Rotate view

Ctrl Left-Mouse Drag

Translates view

Shift Left-Mouse

Label Atom

Right-Mouse Drag

Zoom in and out

Ctrl Shift Right-Mouse Drag

Rotate View around Screen Z axis

Middle-mouse

Centre on atom

Scroll-wheel Forward

Increase map contour level

Scroll-wheel Backward

Decrease map contour level

See also Chapter Hints and Usage Tips for more help.


Next: , Up: Mousing and Keyboarding   [Contents][Index]

2.1 Next Residue

``Space''

Next Residue

``Shift'' ``Space''

Previous Residue

See also “Recentring View” (Section Recentring View).


Next: , Previous: Next Residue, Up: Mousing and Keyboarding   [Contents][Index]

2.2 Keyboard Contouring

Use + or - on the keyboard if you don’t have a scroll-wheel.


Next: , Previous: Keyboard Contouring, Up: Mousing and Keyboarding   [Contents][Index]

2.3 Mouse Z Translation and Clipping

Here we can change the clipping and Translate in Screen Z

Ctrl Right-Mouse Drag Up/Down

changes the slab (clipping planes)

Ctrl Right-Mouse Drag Left/Right

translates the view in screen Z


Next: , Previous: Mouse Z Translation, Up: Mousing and Keyboarding   [Contents][Index]

2.4 Keyboard Translation

Keypad 3

Push View (+Z translation)

Keypad .

Pull View (-Z translation)


Next: , Previous: Keyboard Z Translation, Up: Mousing and Keyboarding   [Contents][Index]

2.5 Keyboard Zoom and Clip

N

Zoom out

M

Zoom in

D

Slim clip

F

Fatten clip


Next: , Previous: Keyboard Zoom and Clip, Up: Mousing and Keyboarding   [Contents][Index]

2.6 Scrollwheel

When there is no map, using the scroll-wheel has no effect. If there is exactly one map displayed, the scroll-wheel will change the contour level of that map. If there are two or more maps, the map for which the contour level is changed can be set using either HID -> Scrollwheel -> Attach scroll-wheel to which map? and selecting a map number or clicking the "Scroll" radio button for the map in the Display Manager.

You can turn off the map contour level changing by the scroll wheel using:

(set-scroll-by-wheel-mouse 0)

(the default is 1 [on]).


Next: , Previous: Scrollwheel, Up: Mousing and Keyboarding   [Contents][Index]

2.7 Selecting Atoms

Several Coot functions require the selecting of atoms to specify a residue range (for example: Regularize, Refine (Section Regularization and Real Space Refinement) or Rigid Body Fit Zone (Section Rigid Body Refinement)). Select atoms with the Left-mouse. See also Picking (Section sec_picking).

Use the scripting function (quanta-buttons) to make the mouse functions more like other molecular graphics programs to which you may be more accustomed 12.


Next: , Previous: Selecting Atoms, Up: Mousing and Keyboarding   [Contents][Index]

2.8 Virtual Trackball

You may not completely like the way the molecule is moved by the mouse movement 13. To change this, try: HID -> Virtual Trackball -> Flat. To do this from the scripting interface: (vt-surface 1) 14.

If you do want screen-z rotation screen-z rotation, you can either use Shift Right-Mouse Drag or set the Virtual Trackball to Spherical Surface mode and move the mouse along the bottom edge of the screen.


Previous: Virtual Trackball, Up: Mousing and Keyboarding   [Contents][Index]

2.9 More on Zooming

The function (quanta-like-zoom) adds the ability to zoom the view using just Shift + Mouse movement 15.

There is also a Zoom slider (Draw -> Zoom) for those without a right-mouse button.


Next: , Previous: Mousing and Keyboarding, Up: Top   [Contents][Index]

3 General Features

The map-fitting and model-building tools can be accessed by using Calculate -> Model/Fit/Refine…. Many functions have tooltips 16 describing the particular features and are documented in Chapter Modelling and Building.

F5:

posts the Model/Fit/Refine dialog

F6:

posts the Go To Atom Window

F7:

posts the Display Control Window


Next: , Up: General Features   [Contents][Index]

3.1 Version number

The version number of Coot can be found at the top of the “About” window (Help -> About).

This will return the version of coot:

$ coot --version

There is also a script function to return the version of coot:

(coot-version)


Next: , Previous: Version number, Up: General Features   [Contents][Index]

3.2 Antialiasing

The built-in antialiasing (for what it’s worth) can be enabled using:

(set-do-anti-aliasing 1)

The default is 0 (off).

This can also be activated using Edit Preferences -> Others -> Antialiasing -> Yes.

If you have an nVidia graphics card, external antialiasing can be actived setting the environment variable __GL_FSAA_MODE. For me a setting of 5 works nicely and gives a better image than using Coot’s built-in antialiasing.

Also for nVidia graphics card users, there is the application nvidia-settings:

Antialiasing Setting -> Override Application Settings and slide the slider to the right. On restarting Coot, it should be in antialias mode 17.


Next: , Previous: Antialiasing, Up: General Features   [Contents][Index]

3.3 Molecule Number

Coot is based on the concept of molecules. Maps and coordinates are different representations of molecules. The access to the molecule is via the molecule number. It is often important therefore to know the molecule number of a particular molecule.

The Molecule Number of a molecule can be found by clicking on an atom of that molecule (if it has coordinates of course). The first number in brackets in the resulting text in the status bar and console is the Molecule Number. The Molecule Number can also be found in Display Control window (Section Display Manager). It is also displayed on the left-hand side of the molecule name in the option menus of the “Save Coordinates” and “Go To Atom” windows.


Next: , Previous: Molecule Number, Up: General Features   [Contents][Index]

3.4 Display Issues

The “graphics” window is drawn using OpenGL. It is considerably smoother (i.e. more frames/sec) when using a 3D accelerated X server.

The view is orthographic (i.e. the back is the same size as the front). The default clipping is about right for viewing coordinate data, but is often a little too “thick” for viewing electron density. It is easily changed (see Section Clipping Manipulation).

Depth-cueing is linear and fixed on.

The graphics window can be resized, but it has a minimum size of 400x400 pixels.

3.4.1 Stereo

Hardware Stereo is an option for Coot (Draw -> Stereo… -> Hardware Stereo -> OK), side-by-side stereo is not an option.

The angle between the stereo pairs (the stereo separation) can be changed to suit your personal tastes using:

(set-hardware-stereo-angle-factor angle-factor)

where angle-factor would typically be between 1.0 and 2.0

3.4.2 Pick Cursor

When asked to pick a residue or atom, the cursor changes from the normal arrow shape to a "pick" cursor. Sometimes it is difficult to see the default pick cursor, so you can change it using the function

(set-pick-cursor-index i)

where i is an integer less than 256. The cursors can be viewed using an external X program:

xfd -fn cursor

3.4.3 Origin Marker

A yellow box called the “origin marker” marks the origin. It can be removed using:

(set-show-origin-marker 0)

Its state can be queried like this:

(show-origin-marker-state)

which returns an number (0 if it is not displayed, 1 if it is).


Next: , Previous: Display Issues, Up: General Features   [Contents][Index]

3.5 Screenshot

A simple screenshot (image dump) can be made using Draw -> Screenshot -> Simple…. Note that in side by side stereo mode you only get the left-hand image.


Next: , Previous: Screenshot, Up: General Features   [Contents][Index]

3.6 Raster3D output

Output suitable for use by Raster3D’s “render” can be generated using the scripting function

(raster3d file-name)

where file-name is such as "test.r3d" 18.

There is a keyboard key to generate this file, run “render” and display the image: Function key F8.

You can also use the function

(render-image)

which will create a file coot.r3d, from which “render” produces coot.png. This png file is displayed using ImageMagick’s display program (by default). Use something like:

(set! coot-png-display-program "gqview")

to change that to different display program ("gqview" in this case).

(set! coot-png-display-program "open")

would use Preview (by default) on Macintosh.

To change the widths of the bonds and density “lines” use (for example):

(set-raster3d-bond-thickness 0.1)

and

(set-raster3d-density-thickness 0.01)

Similarly for bones:

(set-raster3d-bone-thickness 0.05)

To turn off the representations of the atoms (spheres):

(set-renderer-show-atoms 0)


Next: , Previous: Raster3D, Up: General Features   [Contents][Index]

3.7 Display Manager

This is also known as “Map and molecule (coordinates) display control”. Here you can select which maps and molecules you can see and how they are drawn 19. The “Display” and “Active” are toggle buttons, either depressed (active) or undepressed (inactive). The “Display” buttons control whether a molecule (or map) is drawn and the “Active” button controls if the molecule is clickable 20 (i.e. if the molecule’s atoms can be labeled).

The "Scroll" radio buttons sets which map is has its contour level changed by scrolling the mouse scroll wheel.

By default, the path names of the files are not displayed in the Display Manager. To turn them on:

(set-show-paths-in-display-manager 1)

If you pull across the horizontal scrollbar in a Molecule view, you will see the “Render as” menu. You can use this to change between normal “Bonds (Colour by Atom)”,“Bonds (Colour by Chain)” and “C\alpha” representation There is also available “No Waters” and “C\alpha + ligands” representations.


Next: , Previous: Display Manager, Up: General Features   [Contents][Index]

3.8 The Modelling Toolbar

You might not want to have the right-hand-side vertical toolbar that contains icons for some modelling operations 21 displayed:

(hide-modelling-toolbar)

to bring it back again:

(show-modelling-toolbar)


Next: , Previous: The Modelling Toolbar, Up: General Features   [Contents][Index]

3.9 The file selector

3.9.1 File-name Filtering

The “Filter” button in the fileselection filters the filenames according to extension. For coordinates files the extensions are “.pdb” “.brk” “.mmcif” and others. For data: “.mtz”, “.hkl”, “.phs”, “.cif” and for (CCP4) maps “.ext”, “.msk” and “.map”. If you want to add to the extensions, the following functions are available:

where extension is something like: ".mycif".

If you want the fileselection to be filtered without having to use the "Filter" button, use the scripting function

(set-filter-fileselection-filenames 1)

3.9.2 Filename Sorting

If you like your files initially sorted by date (rather than lexicographically, which is the default) use:

(set-sticky-sort-by-date)

3.9.3 Save Coordinates Directory

Some people prefer that the fileselection for saving coordinates starts in the original directory (rather than the directory from which they last imported coordinates). This option is for them:

(set-save-coordinates-in-original-directory 1)


Next: , Previous: The file selector, Up: General Features   [Contents][Index]

3.10 Scripting

There is an compile-time option of adding a script interpreter. Currently the options are python and guile. It seems possible that in future you will be able to use both in the same executable. The binary distribution of Coot are linked with guile, others with python.

Hundreds of commands are made available for use in scripting by using SWIG, some of which are documented here. Other functions documented less well, but descriptions for them can be found at the end of this manual.

Commands described throughout this manual (such as (vt-surface 1)) can be evaluated directly by Coot by using the “Scripting Window” (Calculate -> Scripting…). Note that you type the commands in the upper entry widget and the command gets echoed (in red) and the return value and any output is displayed in the text widget lower (green). The typed command should be terminated with a carriage return 22. Files 23 can be evaluated (executed) using Calculate -> Run Script….

Note that in scheme (the usual scripting language of Coot), the parentheses are important.

To execute a script file from the command line use the --script filename arguments (except when also using the command line argument --no-graphics, in which case you should use -s filename).

After you have used the scripting window, you may have noticed that you can no longer kill Coot by using Ctrl-C in the console. To recover this ability:

(exit)

in the scripting window.


Next: , Up: Scripting   [Contents][Index]

3.10.1 Python

Coot has an (optional) embedded python interpreter. Thus the full power of python is available to you. Coot will look for an initialization script ($HOME/.coot.py) and will execute it if found. This file should contain python commands that set your personal preferences.

3.10.1.1 Python Commands

The scripting functions described in this manual are formatted suitable for use with guile, i.e.:

(function arg1 arg2…)

If you are using Python instead: the format needs to be changed to:

function(arg1,arg2…)

Note that dashes in guile function names become underscores for python, so that (for example) (raster-screen-shot) becomes raster_screen_shot().


Next: , Previous: Python, Up: Scripting   [Contents][Index]

3.10.2 Scheme

The scheme interpreter is made available by embedding guile. The initialization script used by this interpreter is $HOME/.coot. This file should contain scheme commands that set your personal preferences.


Next: , Previous: Scheme, Up: Scripting   [Contents][Index]

3.10.3 Coot State

The “state” of Coot is saved on Exit and written to a file called 0-coot.state.scm (scheme) 0-coot.state.py (python). This state file contains information about the screen centre, the clipping, colour map rotation size, the symmetry radius, and other molecule related parameters such as filename, column labels, coordinate filename etc..

Use Calculate -> Run Script… to use this file to re-create the loaded maps and models that you had when you finished using Coot 24 last time. A state file can be saved at any time using (save-state) which saves to file 0-coot.state.scm or (save-state-filename "thing.scm") which saves to file thing.scm.

When Coot starts it can optionally run the commands in 0-coot.state.scm.

Use (set-run-state-file-status i) to change the behaviour: i is 0 to never run this state file at startup, i is 1 to get a dialog option (this is the default) and i is 2 to run the commands without question.


Next: , Previous: Coot State, Up: Scripting   [Contents][Index]

3.10.4 Key Binding

“Power users” of Coot might like to write their own functions and bind that function to a keyboard key. How do they do that?

By using the add-key-binding function:

(add-key-binding function-name key function)

where key is a quoted string (note that upper case and lower case keys are distinguished - activate get upper case key binding you need to chord the shift key 25).

for example:

(add-key-binding "Refine Active Residue with Auto-accept" "x" refine-active-residue)

Have a look at the key bindings section on the Coot wiki for several more examples.


Previous: Key Binding, Up: Scripting   [Contents][Index]

3.10.5 User-Defined Functions

“Power users” of Coot might also like to write their own functions that occur after picking an atom (or a number of atoms)

(user-defined-click n_clicks udfunc)

define a function func which runs after the user has made n_clicked atom picks. func is called with a list of atom specifiers - the first member of which is the molecule number.


Next: , Previous: Scripting, Up: General Features   [Contents][Index]

3.11 Backups and Undo

By default, each time a modification is made to a model, the old coordinates are written out 26. The backups are kept in a backup directory and are tagged with the date and the history number (lower numbers are more ancient 27). The “Undo” function discards the current molecule and loads itself from the most recent backup coordinates. Thus you do not have to remember to “Save Changes” - coot will do it for you 28.

If you have made changes to more than one molecule, Coot will pop-up a dialog box in which you should set the “Undo Molecule” i.e. the molecule to which the Undo operations will apply. Further Undo operations will continue to apply to this molecule until there are none left. If another Undo is requested Coot checks to see if there are other molecules that can be undone, if there is exactly one, then that molecule becomes the “Undo Molecule”, if there are more than one, then another Undo selection dialog will be displayed.

You can set the undo molecule using the scripting function:

(set-undo-molecule imol)

If for reasons of strange system29 requirements you want to remove the path components of the backup file name you can do so using:

(set-unpathed-backup-file-names 1)

3.11.1 Redo

The “undone” modifications can be re-done using this button. This is not available immediately after a modification 30.

3.11.2 Restoring from Backup

There may be certain circumstances 31 in which you wish to restore from a backup but can’t get it by the “Undo” mechanism described above. In that case, start coot as normal and then open the (typically most recent) coordinates file in the directory coot-backup (or the directory pointed to the environment variable COOT_BACKUP_DIR if it was set) . This file should contain your most recent edits. In such a case, it is sensible for neatness purposes to immediately save the coordinates (probably to the current directory) so that you are not modifying a file in the backup directory.

See also Section Crash.


Next: , Previous: Backups and Undo, Up: General Features   [Contents][Index]

3.12 View Matrix

It is sometimes useful to use this to orient the view and export this orientation to other programs. The orientation matrix of the view can be displayed (in the console) using:

(view-matrix)

Also, the internal representation of the view can be returned and set using:

(view-quaternion) to return a 4-element list

(set-view-quaternion i j k l) which sets the view quaternion.

So the usage of these functions would be something like:

(let ((v (view-quaternion)))
   ;; manipulate v here, maybe
   (apply set-view-quaternion v))

Next: , Previous: View Matrix, Up: General Features   [Contents][Index]

3.13 Space Group and Symmetry

Occasionally you may want to know the space group of a particular molecule. Interactively (for maps) you can see it using the Map Properties button in the Molecule Display Control dialog.

There is a scripting interface function that returns the space group for a given molecule 32:

(show-spacegroup imol)

You can force a space group onto a molecule using the following:

(set-space-group imol space-group)

where space-group is one of the standard CCP4 space group names (e.g. "P 21 21 21").

To show the symmetry operators of a particular molecule use: (get-symmetry imol) which will return a list of strings.

Sometimes molecular replacement solutions (for example) create models with chains non-optimally placed relative to each other - a symmetry-related copy would be more apealling (but would be equivalent, crystalographically). For example, to move the B chain to a symmetry-related position:

Centre on an atom in the symmetry-related B chain (where you want the B chain to be)

Extensions -> Modelling -> Symm Shift Reference Chain Here.


Next: , Previous: Space Group and Symmetry, Up: General Features   [Contents][Index]

3.14 Recentring View

If you don’t want smooth recentring (sliding) Edit -> Preferences -> Smooth Recentring -> Off. You can also use this dialog to speed it up a bit (by decreasing the number of steps instead of turning it off).


Next: , Previous: Recentring View, Up: General Features   [Contents][Index]

3.15 Views

Coot has a views interface (you might call them ”scenes“) that define a particular orientation, zoom and view centre. Coot and linearly interpolate between the views. The animation play back speed can be set with the ”Views Play Speed“ menu item - default is a speed of 10.

The views interface can be found under the Extensions menu item.


Next: , Previous: Views, Up: General Features   [Contents][Index]

3.16 Clipping Manipulation

The clipping planes (a.k.a. “slab” ) can be adjusted using Edit -> Clipping and adjusting the slider. There is only one parameter to change and it affects both the front and the back clipping planes 33. The clipping can also be changed using keyboard “D” and “F”.

It can also be changed with Ctrl + Right-mouse drag up and down. Likewise the screen-Z can be changed with Ctrl + Right-mouse left and right 34.

One can “push” and “pull” the view in the screen-Z direction using keypad 3 and keypad “.” (see Section Keyboard Z Translation).


Next: , Previous: Clipping Manipulation, Up: General Features   [Contents][Index]

3.17 Background colour

The background colour can be set either using a GUI dialog (Edit$ -> Background Colour) or the function (set-background-colour 0.00 0.00 0.00), where the arguments are 3 numbers between 0.0 and 1.0, which respectively represent the red, green and blue components of the background colour. The default is (0.0, 0.0, 0.0) (black).


Next: , Previous: Background colour, Up: General Features   [Contents][Index]

3.18 Unit Cell

If coordinates have symmetry available then unit cells can be drawn for molecules (Draw -> Cell & Symmetry -> Show Unit Cell?).


Next: , Previous: Unit Cell, Up: General Features   [Contents][Index]

3.19 Rotation Centre Pointer

There is a pink pointer at the centre of the screen that marks the rotation centre. The size of the pointer can be changed using Edit -> Pink Pointer Size… or using scripting commands: (set-rotation-centre-size 0.3).


Next: , Previous: Rotation Centre Pointer, Up: General Features   [Contents][Index]

3.20 Orientation Axes

The green axes showing the orientation of the molecule are displayed by default. To remove them use the scripting function;

(set-draw-axes 0)


Next: , Previous: Orientation Axes, Up: General Features   [Contents][Index]

3.21 Pointer Distances

The Rotation Centre Pointer is sometimes called simply “Pointer”. One can find distances to the pointer from any active set of atoms using “Pointer Distances” (under Measures). If you move the Pointer (e.g. by centering on an atom) and want to update the distances to it, you have to toggle off and on the “Show Pointer Distances” on the Pointer Distances dialog.


Next: , Previous: Pointer Distances, Up: General Features   [Contents][Index]

3.22 Crosshairs

Crosshairs can be drawn at the centre of the screen, using either the C key35 in graphics window or Draw -> Crosshairs…. The ticks are at 1.54Å, 2.7Å and 3.8Å.


Next: , Previous: Crosshairs, Up: General Features   [Contents][Index]

3.23 3D Annotations

Positions in 3D space can be annotated with 3D text. The mechanism to do this can be found under Extensions -> Representations -> 3D Annotations. 3D Annotations can be saved to and loaded from a file.


Next: , Previous: 3D Annotations, Up: General Features   [Contents][Index]

3.24 Frame Rate

Sometimes, you might as yourself “how fast is the computer?” 36. Using Calculate -> Frames/Sec you can see how fast the molecule is rotating, giving an indication of graphics performance. It is often better to use a map that is more realistic and stop the picture whizzing round. The output is written to the status bar and the console, you need to give it a few seconds to “settle down”. It is best not to have other widgets overlaying the GL canvas as you do this.

The contouring elapsed time 37 gives an indication of CPU performance.


Previous: Frame Rate, Up: General Features   [Contents][Index]

3.25 Program Output

Due to its “in development” nature (at the moment), Coot produces a lot of “console” 38 output - much of it debugging or “informational”. This will go away in due course. You are advised to run Coot so that you can see the console and the graphics window at the same time, since feedback from atom clicking (for example) is often written there rather than displayed in the graphics window.


Next: , Previous: General Features, Up: Top   [Contents][Index]

4 Coordinate-Related Features


Next: , Up: Coordinate-Related Features   [Contents][Index]

4.1 Reading coordinates

The format of coordinates that can be read by coot is either PDB or mmCIF. To read coordinates, choose File -> Read Coordinates from the menu-bar. Immediately after the coordinates have been read, the view is (by default) recentred to the centre of this new molecule and the molecule is displayed. The recentring of the view after the coordinates have been read can be turned off by unclicking the "Recentre?" radio-button.

To disable the recentring of the view on reading a coordinates file via scripting, use: (set-recentre-on-read-pdb 0). However, when reading a coordinates file from a script it is just as good (if not better) to use (handle-read-draw-molecule-with-recentre filename 0) - the additional 0 means “don’t recentre”. And that affects just the reading of filename and not subsequent files.

By default coot does not allow reading coordinates with duplicated sequence numbers. To enable the reading of files with duplicated sequence numbers use the function:

(allow-duplicate-sequence-numbers)

Coot can read MDL mol files.

4.1.1 A Note on Space Groups Names

Coot uses the space group on the “CRYST1” line of the pdb file. The space group should be one of the xHM symbols listed (for example) in the CCP4 dictionary file syminfo.lib. So, for example, "R 3 2 :H" should be used in preference to "H32".

4.1.2 Read multiple coordinate files

The reading multiple files using the GUI is not available (at the moment). However the following scripting functions are available:

(read-pdb-all)

which reads all the “*.pdb” files in the current directory

(multi-read-pdb glob-pattern dir)

which reads all the files matching glob-pattern in directory dir. Typical usage of this might be:

(multi-read-pdb "a*.pdb" ".")

Alternatively you can specify the files to be opened on the command line when you start coot (see Section Command Line Arguments).

4.1.3 SHELX .ins/.res files

SHELX ".res" (and ".ins" of course) files can be read into Coot, either using the GUI File -> Open Coordinates… or by the scripting function:

(read-shelx-ins-file file-name)

where file-name is quoted, such as "thox.ins".

Although Coot should be able to read any SHELX ".res" file, it may currently have trouble displaying the bonds for centro-symmetric structures.

ShelxL atoms with negative PART numbers are given alternative configuration identifiers in lower case.

To write a SHELX ".ins" file:

(write-shelx-ins-file imol file-name)

where imol is the number of the molecule you wish to export.

This will be a rudimentary file if the coordinates were initially from a "PDB" file, but will contain substantial SHELX commands if the coordinates were initially generated from a SHELX ins file.


Next: , Previous: Reading coordinates, Up: Coordinate-Related Features   [Contents][Index]

4.2 Atom Info

Information about about a particular atom is displayed in the text console when you click using middle-mouse. Information for all the atoms in a residue is available using Info -> Residue Info….

The temperature factors and occupancy of the atoms in a residue can be set by using Edit -> Residue Info….


Next: , Previous: Atom Info, Up: Coordinate-Related Features   [Contents][Index]

4.3 Atom Labeling

Use Shift + left-mouse to label atom. Do the same to toggle off the label. The font size is changeable using Edit -> Font Size…. The newly centred atom is labelled by default. To turn this off use:

(set-label-on-recentre-flag 0)

Some people prefer to have atom labels that are shorter, without the slashes and residue name:

(set-brief-atom-labels 1)

To change the atom label colour, use:

(set-font-colour 0.9 0.9 0.9)


Next: , Previous: Atom Labeling, Up: Coordinate-Related Features   [Contents][Index]

4.4 Atom Colouring

The atom colouring system in coot is unsophisticated. Typically, atoms are coloured by element: carbons are yellow, oxygens red, nitrogens blue, hydrogens white and everything else green (see Section Display Manager for colour by chain). However, it is useful to be able to distinguish different molecules by colour, so by default coot rotates the colour map of the atoms (i.e. changes the H value in the HSV 39 colour system). The amount of the rotation depends on the molecule number and a user-settable parameter:

The default value is 31^\circ.

Also one is able to select only the Carbon atoms to change colour in this manner: (set-colour-map-rotation-on-read-pdb-c-only-flag 1).

The colour map rotation can be set individually for each molecule by using the GUI: Edit -> Bond Colours....


Next: , Previous: Atom Colouring, Up: Coordinate-Related Features   [Contents][Index]

4.5 Bond Parameters

The various bond parameters can be set using the GUI dialog Draw -> Bond Parameters or via scripting functions.

The represention style of the molecule that has the active residue (if any) can be changed using the scroll wheel with Ctrl and Shift.

4.5.1 Bond Thickness

The thickness (width) of bonds of individual molecules can be changed. This can be done via the Bond Parameters dialog or the scripting interface:

(set-bond-thickness thickness imol)

where imol is the molecule number.

The default thickness is 3 pixels. The bond thickness also applies to the symmetry atoms of the molecule. The default bond thickness for new molecules can be set using:

(set-default-bond-thickness thick)

where thick is an integer.

There is no means to change the bond thickness of a residue selection within a molecule.

4.5.2 Display Hydrogens

Initially, hydrogens are displayed. They can be undisplayed using

(set-draw-hydrogens mol-no 0) 40

where mol-no is the molecule number.

There is a GUI to control this too, under “Edit -> Bond Parameters”.

4.5.3 NCS Ghosts Coordinates

It is occasionally useful when analysing non-crystallographically related molecules to have “images” of the other related molecules appear matched onto the current coordinates. It is important to understand that these ghosts are for displaying differences of NCS-related molecules by structure superposition, not displaying neighbouring NCS related molecules. As you read in coordinates in Coot, they are checked for NCS relationships and clicking on “Edit -> Bond Parameters -> Show NCS Ghosts” -> “Yes” -> “Apply” will create “ghost” copies of them over the reference chain 41.

Sometimes SSM does not provide a good (or even useful) matrix. In that case, we can specify the residue range ourselves and let the LSQ algorithm provide the matrix. A gui dialog for this operation can be found under Extensions -> NCS -> NCS Ghosts by Residue Range….

The scripting function is used like this:

(manual-ncs-ghosts imol resno-start resno-end ncs-chain-ids)

Typical usage: (manual-ncs-ghosts 0 1 10 (list "A" "B" "C"))

note that in ncs-chain-ids, the NCS master/reference chain-id goes first.

4.5.4 NCS Maps

Coot can use the relative transformations of the NCS-related molecules in a coordinates molecule to transform maps. Use Calculate -> NCS Maps… to do this (note the NCS maps only make sense in the region of the reference chain (see above).

Note also that the internal representation of the map is not transformed. If you try to export a NCS overlay map you will get an untransformed map. A transformed map only makes sense around a given point (and when using transformed maps in Coot, this reference point is changed on the fly, thus allowing map transformations on the fly). [This applies to NCS overlap maps, NCS averaged maps are transformed].

This will also create an NCS averaged map 42.

4.5.5 Using Strict NCS

Coot can use a set of strict NCS matrices to specify NCS which means that NCS-related molecules can appear like convention symmetry-related molecules.

(add-strict-ncs-matrix imol ncs-chain-id ncs-target-chain-id m11 m12 m13 m21 m22 m23 m31 m32 m33 t1 t2 t3)

where ncs-chain-id might be "B", "C" "D" (etc.) and ncs-target-chain-id is "A", i.e. the B, C, D molecules are NCS copies of the A chain.

for icosahedral symmetry the translation components t1, t2, t3 will be 0.

You need to turn on symmetry for molecule imol and set the displayed symmetry object type to "Display Near Chains".


Next: , Previous: Bond Parameters, Up: Coordinate-Related Features   [Contents][Index]

4.6 Download coordinates

Coot provides the possibility to download coordinates from an OCA 43. (e.g. EBI) server 44 (File -> Get PDB Using Code…). A pop-up entry box is displayed into which you can type a PDB accession code. Coot will then connect to the web server and transfer the file. Coot blocks as it does this (which is not ideal) but on a semi-decent internet connection, it’s not too bad. The downloaded coordinates are saved into a directory called coot-download.

It is also possible to download mmCIF data and generate a map. This currently requires a properly formatted database structure factors mmCIF file 45.


Next: , Previous: Download coordinates, Up: Coordinate-Related Features   [Contents][Index]

4.7 Get Coordinates and Map from EDS

Using this function we have the ability to download coordinates and view the map from structures in the Electron Density Server (EDS) at Uppsala University. This is a much more robust and faster way to see maps from deposited structures. This function can be found under the File menu item.

This feature was added with the assistance of Gerard Kleywegt. If you use the EDS, please cite GJ Kleywegt, MR Harris, JY Zou, TC Taylor, A Wählby & TA Jones (2004), "The Uppsala Electron-Density Server", Acta Cryst. D60, 2240-2249.


Next: , Previous: Get Coordinates and Map from EDS, Up: Coordinate-Related Features   [Contents][Index]

4.8 Save Coordinates

On selecting from the menus File -> Save Coordinates… you are first presented with a list of molecules which have coordinates. As well as the molecule number, there is the molecule name - very frequently the name of the file that was read in to generate the coordinates in coot initially. However, this is only a molecule name and should not be confused with the filename to which the coordinates are saved. The coordinates filename can be selected using the Select Filename… button.

If your filename ends in .cif, .mmcif or .mmCIF then an mmCIF file will be written (not a “PDB” file).


Next: , Previous: Save coordinates, Up: Coordinate-Related Features   [Contents][Index]

4.9 Setting the Space Group

If for some reason, the pdb file that you read does not have a space group, or has the wrong space group, then you can set it using the following function:

(set-space-group imol symbol)

e.g.:

(set-space-group 0 "P 41 21 2")


Next: , Previous: Setting the Space Group, Up: Coordinate-Related Features   [Contents][Index]

4.10 Anisotropic Atoms

By default anisotropic atom information is not represented 46. To turn them on, use Draw -> Anisotropic Atoms -> Show Anisotropic Atoms? -> Yes, or the command: (set-show-aniso 1).

You cannot currently display thermal ellipsoids 47 for isotropic atoms.


Next: , Previous: Anisotropic Atoms, Up: Coordinate-Related Features   [Contents][Index]

4.11 Symmetry

Coordinates symmetry is “dynamic”. Symmetry atoms can be labeled 48.

Every time you recentre, the symmetry coordinates are updated. The information shown contains the atom information and the symmetry operation number and translations needed to generate the atom in that position. To show the symmetry operator as a string (rather than a (1-based) index into the list of symmetry operators (as is the default)) Use Draw -> Show Symmetry> -> Expanded Symmetry Atom Labels. Coot generates symmetry related atoms by moving the current set close to the origin by a translation, performing the symmetry expansion around the origin and moving the the symmetry coordinates back by applying the inverse of the origin translation. The origin translation is also displayed in curly braces, e.g. “{1 -1 0}”.

By default symmetry atoms are not displayed.

If you want coot to display symmetry coordinates without having to use the gui, add to your ~/.coot the following:

(set-show-symmetry-master 1)

The symmetry can be represented as C\alphas. This along with representation of the molecule as C\alphas (Section Display Manager) allow the production of a packing diagram.

4.11.1 Missing symmetry

Sometimes (rarely) coot misses symmetry-related molecules that should be displayed. In that case you need to expand the shift search (the default is 1):

(set-symmetry-shift-search-size 2)

This is a hack, until the symmetry search algorithm is improved.


Next: , Previous: Symmetry, Up: Coordinate-Related Features   [Contents][Index]

4.12 Sequence View

The protein is represented by one letter codes and coloured according to secondary structure. These one letter codes are active - if you click on them, they will change the centre of the graphics window - in much the same way as clicking on a residue in the Ramachandran plot.


Next: , Previous: Sequence View, Up: Coordinate-Related Features   [Contents][Index]

4.13 Print Sequence

The single letter code (of the imolth molecule) is written out to the console in FASTA format. Use can use this to cut and paste into other applications:

(print-sequence imol)


Next: , Previous: Print Sequence, Up: Coordinate-Related Features   [Contents][Index]

4.14 Environment Distances

Environment distances are turned on using Info -> Environment Distances…. Contacts to other residues are shown and to symmetry-related atoms if symmetry is being displayed. The contacts are coloured by atom type 49.


Next: , Previous: Environment Distances, Up: Coordinate-Related Features   [Contents][Index]

4.15 Distances and Angles

The distance between atoms can be found using Info -> Distance 50. The result is displayed graphically, and written to the console.


Next: , Previous: Distances and Angles, Up: Coordinate-Related Features   [Contents][Index]

4.16 Zero Occupancy Marker

Atoms of zero occupancy are marked with a grey spot. To turn off these markers, use:

(set-draw-zero-occ-markers 0)

Use an argument of 1 to turn them on.


Next: , Previous: Zero Occupancy Marker, Up: Coordinate-Related Features   [Contents][Index]

4.17 Atomic Dots

You can draw dots round arbitrary atom selections

(dots imol atom-selection dot-density radius) The function returns a handle.

e.g. put a sphere of dots around all atoms of the 0th molecule (it might be a set of heavy atom coordinates) at the default dot density and radius:

(dots 0 "/1" "heavy-atom-sites" 1 1)

You can’t change the colour of the dots.

There is no internal mechanism to change the radius according to atom type. With some cleverness you might be able to call this function several times and change the radius according to the atom selection.

There is a function to clear up the dots for a particular molecule imol and dots set identifier dots-handle

(clear-dots imol dots-handle)

There is a function to return how many dots sets there are for a particular molecule imol:

(n-dots-set imol)


Next: , Previous: Atomic Dots, Up: Coordinate-Related Features   [Contents][Index]

4.18 Ball and Stick Representation

Fragments of the molecule can be rendered as a “ball and stick” molecule:

(make-ball-and-stick imol atom-selection bond-thickness sphere-size draw-spheres-flag)

e.g. (make-ball-and-stick 0 "/1/A/10-20" 0.3 0.4 1)

The ball-and-stick representation can be cleared using:

(clear-ball-and-stick imol)


Next: , Previous: Ball and Stick Representation, Up: Coordinate-Related Features   [Contents][Index]

4.19 Mean, Median Temperature Factors

Coot can be used to calculate the mean (average) and median temperatures factors:

(average-temperature-factor imol)

(median-temperature-factor imol)

-1 is returned if there was a problem 51.


Next: , Previous: Mean and Median Temperature Factors, Up: Coordinate-Related Features   [Contents][Index]

4.20 Secondary Structure Matching (SSM)

The excellent SSM alogrithm52 of Eugene Krissinel is available in Coot. The GUI interface is straight-forward and can be found under Calculate -> SSM Superpose. You can specify the specific chains that you wish to match using the "Use Specific Chain" check-button.

There is a scripting level function which gives even finer control:

(superpose-with-atom-selection imol1 imol2 mmdb-atom-selection-string-1 mmdb-atom-selection-string-2 move-copy-flag )

the move-copy-flag should be 1 if you want to apply the transformation to a copy of imol2 (rather than imol2 itself). Otherwise, move-copy-flag should be 0.

mmdb atom selection strings (Coordinate-IDs) are explained in detail in the mmdb manual.

Briefly, the string should be formed in this manner:

/mdl/chn/seq(res).ic/atm[elm]:aloc

e.g. "/1/A/12-130/CA"

<p><a href="http://www.ebi.ac.uk/~keb/cldoc/object/cl_obj_surf.html#CoordinateID">The mmdb manual CoordinateID description</a>.</p>


Next: , Previous: Secondary Structure Matching (SSM), Up: Coordinate-Related Features   [Contents][Index]

4.21 Least-Squares Fitting

There is a simple GUI for this Calculate -> LSQ Superpose…

The scripting interface to LSQ fitting is as follows:

(simple-lsq-match ref-start-resno ref-end-resno ref-chain-id imol-ref mov-start-resno mov-end-resno mov-chain-id imol-mov match-type)

where:

e.g.: (simple-lsq-match 940 950 "A" 0 940 950 "A" 1 'main)

More sophisticated (match molecule number 1 chain “B” on to molecule number 0 chain “A”):

(define match1 (list 840 850 "A" 440 450 "B" 'all))

(define match2 (list 940 950 "A" 540 550 "B" 'main))

(clear-lsq-matches)

(set-match-element match1)

(set-match-element match2)

(apply-lsq-matches 0 1) ; match molecule number 1 onto molecule number 0.


Next: , Previous: Least-Squares Fitting, Up: Coordinate-Related Features   [Contents][Index]

4.22 Ligand Overlaying

The scripting function

(overlap-ligands imol-ligand imol-ref chain-id-ref resno-ref)

returns a rotation+translation operator which can be applied to other molecules (and maps). Here, imol-ligand is the molecule number of the ligand (which is presumed to be a a molecule on its own - Coot simply takes the first residue that it finds). imol-ref chain-id-ref resno-ref collectively describe the target position for the moving imol-ligand molecule.

The convenience function

(overlay-my-ligands imol-mov chain-id-mov resno-mov imol-ref chain-id-ref resno-ref)

wraps overlap-ligands.

The GUI for the function can be found under

Extensions -> Modelling -> Supperpose Ligands…


Previous: Ligand Overlaying, Up: Coordinate-Related Features   [Contents][Index]

4.23 Writing PDB files

As well as the GUI option File -> Save Coordinates… there is a scripting options available:

(write-pdb-file imol pdb-file-name)

which writes the imolth coordinates molecule to filename.

To write a specific residue range:

(write-residue-range-to-pdb-file imol chain-id start-resno endresno pdb-file-name)


Next: , Previous: Coordinate-Related Features, Up: Top   [Contents][Index]

5 Modelling and Building

The functions described in this chapter manipulate, extend or build molecules and can be found under Calculate -> Model/Fit/Refine…. When activated, the dialog "stays on top" of the main graphics window 53. Some people think that this is not always desirable, so this behaviour can be undone using:

(set-model-fit-refine-dialog-stays-on-top 0)


Next: , Up: Modelling and Building   [Contents][Index]

5.1 Regularization and Real Space Refinement

Coot will read the geometry restraints for refmac and use them in fragment (zone) idealization - this is called “Regularization”. The geometrical restraints are, by default, bonds, angles, planes and non-bonded contacts. You can additionally use torsion restraints by Calculate -> Model/Fit/Refine… -> Refine/Regularize Control -> Use Torsion Restraints. Truth to tell, this has not been successful in my hands (sadly).

“RS (Real Space) Refinement” (after Diamond, 1971 54) in Coot is the use of the map in addition to geometry terms to improve the positions of the atoms. Select “Regularize” from the “Model/Fit/Refine” dialog and click on 2 atoms to define the zone (you can of course click on the same atom twice if you only want to regularize one residue). Coot then regularizes the residue range. At the end Coot, displays the intermediate atoms in white and also displays a dialog, in which you can accept or reject this regularization. In the console are displayed the \chi^2 values of the various geometrical restraints for the zone before and after the regularization. Usually the \chi^2 values are considerably decreased - structure idealization such as this should drive the \chi^2 values toward zero.

The use of “Refinement” is similar - with the addition of using a map. The map used to refine the structure is set by using the “Refine/Regularize Control” dialog. If you have read/created only one map into Coot, then that map will be used (there is no need to set it explicitly).

Use, for example, (set-matrix 20.0)

to change the weight of the map gradients to geometric gradients. The higher the number the more weight that is given to the map terms 55. The default is 60.0. This will be needed for maps generated from data not on (or close to) the absolute scale or maps that have been scaled (for example so that the sigma level has been scaled to 1.0).

For both “Regularize Zone” and “Refine Zone” one is able to use a single click to refine a residue range. Pressing A on the keyboard while selecting an atom in a residue will automatically create a residue range with that residue in the middle. By default the zone is extended one residue either size of the central residue. This can be changed to 2 either side using (set-refine-auto-range-step 2).

Intermediate (white) atoms can be moved around with the mouse (click and drag with left-mouse, by default). Refinement will proceed from the new atom positions when the mouse button is released. It is possible to create incorrect atom nomenclature and/or chiral volumes in this manner - so some care must be taken. Press the A key as you left-mouse click to move atoms more “locally” (rather than a linear shear) and Ctrl key as you left-mouse click to move just one atom.

In more up to date versions, Coot will display colour patches (something like a traffic light system) representing the chi squared values of each of types of geometric feature refined. Typically “5 greens” is the thing to aim for, the colour changes occurring at chi squared values 2, 5 and 8 (8 being the most red).

To prevent the unintentional refinement of a large number of residues, there is a “heuristic fencepost” of 20 residues. A selection of than 20 residues will not be regularized or refined. The limit can be changed using the scripting function: e.g. (set-refine-max-residues 30).


Next: , Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.1 Dictionary

The geometry description for residues, monomers and links used by Coot are in the standard mmCIF format. Because this format alows multiple comp_ids (residue types) to be described within a cif loop, it is hard to tell when a dictionary entry needs to be overwritten when reading a new file. Therefore Coot makes this extra constraint: that the “chem_comp” loop should appear first in the comp list data item - if this is the case, then Coot can overwrite an old restraint table for a particular comp_id/residue-type when a new one is read.

By default, the geometry dictionary entries for only the standard residues are read in at the start 56. It may be that your particular ligand is not amongst these. To interactively add a dictionary entry use File -> Import CIF Dictionary.

There is a selector in the cif dictionary file chooser that allow you to select the molecule to which molecule refers. Each of the indididual molecules can be specifically selected. “All“ means that the dictionary refers to all loaded molecules and “Auto“ means that the dictionary will be applied to all model molecules if the comp_id/residue name is not on the non-auto-load list and will choose the latest model molecule if the comp_id/residue name is on the non-auto-load list. By default the non-auto-load list consists of INH, LIG, DRG, XXX, and the series LG0-9.

Alternatively, you can use the function:

(read-cif-dictionary filename)

and add this to your .coot file (this may be the preferred method if you want to read the file on more than one occasion).

Note: the dictionary also provides the description of the ligand’s torsions.


Next: , Previous: Dictionary, Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.2 Sphere Refinement

Sphere refinement selects residues within a certain distance of the residue at the centre of the screen and includes them for real space refinement. In this way, one can select residues that are not in a linear range. This technique is useful for refining disulfide bonds and glycosidic linkages.

To enable sphere refinement, Right-mouse click in the right hand side of the horizontal toolbutton menu, Manage buttons -> [Tick] Sphere Refine -> Apply. You will need a python-enabled Coot to do this.

The following adds a key binding (Shift-R) that refines resides that are within 3.5Å of the residue at the centre of the screen:

        
(define *sphere-refine-radius* 3.5)

(add-key-binding "Refine residues in a sphere" "R"
    (lambda ()
     (using-active-atom
      
      (let* ((rc-spec (list aa-chain-id aa-res-no aa-ins-code))
	     (ls (residues-near-residue aa-imol rc-spec *sphere-refine-radius*)))
	(refine-residues aa-imol (cons rc-spec ls))))))



Next: , Previous: Sphere Refinement, Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.3 Refining Specific Residues

You can specify the residues that you want to refine without using a linear or sphere selection usine refine-residues. For example:

(refine-residues 0 '(("L" 501 "") ("L" 503 "")))

will refine residues A501 and A503 (and residue A502 (if it exists) will be an anchoring residue - used in optimizing the link geometry of the atoms in A501 and A503).


Next: , Previous: Refining Specific Residues, Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.4 Refining Carbohydrates

Refining carbohydrates monomers should be as straightforward as refining a protein residue. Coot will look in the dictionary for the 3-letter code for the particular residue type, if it does not find it, Coot will try to search for dictionary files using “-b-D” or “-a-L” extensions.

When refining a group of carbohydrates, the situation needs a bit more explanation. For each residue pair with tandem residue numbers specified in the refinement range selection, Coot checks if these residue types are are furanose or pyranose in the dictionary, and if the are both one or the other, then it tries to see if there are any of the 11 link types (BETA1-4, BETA2-3, ALPHA1-2 and so on) specified in the dictionary. It does this by a distance check of the potentially bonding atoms. If the distance is less than 3.0Å, then a glycosidic bond is made and used in the refinement.

Bonds between protein and carbohydrate and branched carbohydrates can be refined using “Sphere Refinement”.

Instead of using a sphere to make a residue selection, you can specify the residues directly using refine-residues, for example:

(refine-residues 0 '(("L" 501 "") ("L" 503 "")))

LINK and LINKR cards are not yet used to determine the geometry of the restraints.


Next: , Previous: Refining Carbohydrates, Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.5 Planar Peptide Restraints

By default, Coot uses a 5 atom (CA-1, C-1, O-1, N-2, CA-2) planar peptide restraints. These restraints should help in low resolution fitting (the main-chains becomes less distorted), reduce accidental cis-peptides and may help “clean up” Ramachandran plots.

(add-planar-peptide-restraints)

And similarly they can be removed:

(remove-planar-peptide-restraints)

There is also a GUI to add and remove these restraints in Extensions -> Refine… -> Peptide Restraints…


Next: , Previous: Planar Peptide Restraints, Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.6 The UNK residue type

The UNK residue type is a special residue type to Coot. It has been added for use with Buccaneer. Don’t give you ligand (or anything else) the 3-letter-code UNK or confusion will result 57.


Previous: The UNK residue type, Up: Regularization and Real Space Refinement   [Contents][Index]

5.1.7 Moving Zero Occupancy Atoms

By default, atoms with zero occupancy are moved when refining and regularizing. This can sometimes be inconvenient. To turn of the movement of atoms with zero occupancy when refining and regularizing:

(set-refinement-move-atoms-with-zero-occupancy 0)


Next: , Previous: Regularization and Real Space Refinement, Up: Modelling and Building   [Contents][Index]

5.2 Changing the Map for Building/Refinement

You can change the map that is used for the fitting and refinement tools using the Select Map... button on the Model/Fit/Refine dialog.


Next: , Previous: Changing the Map for Building/Refinement, Up: Modelling and Building   [Contents][Index]

5.3 Rotate/Translate Zone

“Rotate/Translate Zone” from the “Model/Fit/Refine” menu allows manual movement of a zone. After pressing the “Rotate/Translate Zone” button, select two atoms in the graphics canvas to define a residue range 58, the second atom that you click will be the local rotation centre for the zone. The atoms selected in the moving fragment have the same alternate conformation code as the first atom you click. To actuate a transformation, click and drag horizontally across the relevant button in the newly-created “Rotation & Translation” dialog. The axis system of the rotations and translations are the screen coordinates. Alternatively 59, you can click using left-mouse on an atom in the fragment and drag the fragment around. Use Control Left-mouse to move just one atom, rather than the whole fragment. If you click Control Left-mouse whilst not over an atom then you can rotate the fragment using mouse drag. Click “OK” (or press Return) when the transformation is complete.

To change the rotation point to the centre of the intermediate atoms (rather than the second clicked atom), use the setting:

(set-rotate-translate-zone-rotates-about-zone-centre 1)


Next: , Previous: Rotate/Translate Zone, Up: Modelling and Building   [Contents][Index]

5.4 Rigid Body Refinement

“Rigid Body Fit Zone” from the “Model/Fit/Refine” dialog provides rigid body refinement. The selection is zone-based 60. So to refine just one residue, click on one atom twice.

Sometimes no results are displayed after Rigid Body Fit Zone. This is because the final model positions had too many final atom positions in negative density. If you want to over-rule the default fraction of atoms in the zone that have an acceptable fit (0.75), to be (say) 0.25:

(set-rigid-body-fit-acceptable-fit-fraction 0.25)


Next: , Previous: Rigid Body Refinement, Up: Modelling and Building   [Contents][Index]

5.5 Simplex Refinement

Rigid body refinement via Nelder-Mead Simplex minimization is available in Coot. Simplex refinement has a larger radius of convergence and thus is useful in a position where simple rigid body refinement finds the wrong minimum. However the Simplex algorithm is much slower. Simplex refinement for a residue range start-resno to end-resno (inclusive) in chain chain-id can be accessed as follows:

(fit-residue-range-to-map-by-simplex start-resno end-resno alt-loc chain-id imol imol-for-map)

There is currently no GUI interface to Simplex refinement.


Next: , Previous: Simplex Refinement, Up: Modelling and Building   [Contents][Index]

5.6 Post-manipulation-hook

If you wanted automatically run a function after a model has been manipulated then you can do so using by creating a function that takes 2 arguments, such as:

(post-manipulation-hook imol manipulation-mode)

manipulation-mode is one of (DELETED), (MUTATED) or (MOVINGATOMS).

And of course imol is the model number of the maniplated molecule.

(It would of course be far more useful if this function was also passed a list of residues - that is something for the future).


Next: , Previous: Post-manipulation-hook, Up: Modelling and Building   [Contents][Index]

5.7 Baton Building

Baton build is most useful if a skeleton is already calculated and displayed (see Section Skeletonization). When three or more atoms have been built in a chain, Coot will use a prior probability distribution for the next position based on the position of the previous three. The analysis is similar to that of Oldfield & Hubbard (1994) 61, however it is based on a more recent and considerably larger database.

Little crosses are drawn representing directions in which is is possible that the chain goes, and a baton is drawn from the current point to one of these new positions. If you don’t like this particular direction 62, use Try Another. The list of directions is scored according to the above criterion and sorted so that the most likely is at the top of the list and displayed first as the baton direction.

When starting baton building, be sure to be about 3.8Å from the position of the first-placed C\alpha, this is because the next C\alpha is placed at the end of the baton, the baton root being at the centre of the screen. So, when trying to baton-build a chain starting at residue 1, centre the screen at about the position of residue 2.

It seems like a good idea to increase the map sampling to 2 or even 2.5 (before reading in your mtz file) [a grid sampling of about 0.5Å seems reasonable] when trying to baton-build a low resolution map. You can set the map sampling using Edit -> Map Parameters -> Map Sampling.

Occasionally, every point is not where you want to position the next atom. In that case you can either shorten or lengthen the baton, or position it yourself using the mouse. Use “b” on the keyboard to swap to baton mode for the mouse 63.

Baton-built atoms are placed into a molecule called “Baton Atom” and it is often sensible to save the coordinates of this molecule before quitting coot.

If you try to trace a high resolution map (1.5Å or better) you will need to increase the skeleton search depth from the default (10), for example:

(set-max-skeleton-search-depth 20)

Alternatively, you could generate a new map using data to a more moderate resolution (2Å), the map may be easier to interpret at that resolution anyhow 64.

The guide positions are updated every time the “Accept” button is clicked. The molecule name for these atoms is “Baton Build Guide Points” and is is not usually necessary to keep them.

5.7.1 Undo

There is also an “Undo” button for baton-building. Pressing this will delete the most recently placed C\alpha and the guide points will be recalculated for the previous position. The number of “Undo”s is unlimited. Note that you should use the “Undo” button in the Baton Build dialog, not the one in the “Model/Fit/Refine” dialog (Section Backups and Undo).

5.7.2 Missing Skeleton

Sometimes (especially at loops) you can see the direction in which the chain should go, but there is no skeleton (see Section Skeletonization) is displayed (and consequently no guide points) in that direction. In that case, “Undo” the previous atom and decrease the skeletonization level (Edit -> Skeleton Parameters -> Skeletonization Level). Accept the atom (in the same place as last time) and now when the new guide points are displayed, there should be an option to build in a new direction.

5.7.3 Building Backwards

The following scenario is not uncommon: you find a nice stretch of density and start baton building in it. After a while you come to a point where you stop (dismissing the baton build dialog). You want to go back to where you started and build the other way. How do you do that?


Next: , Previous: Baton Building, Up: Modelling and Building   [Contents][Index]

5.8 Reversing Direction of Fragment

After you’ve build a fragment, sometimes you might want to change the direction of that fragment (this function changes an already existing fragment, as opposed to Backwards Building which sets up Baton Building to place new points in reverse order).

The fragment is defined as a contiguous set of residues numbers. So that you should be sure that other partial fragments which have the same chain id and that are not connected to this fragment have residue numbers that are not contiguous with the fragment you are trying to reverse.


Next: , Previous: Reversing Direction of Fragment, Up: Modelling and Building   [Contents][Index]

5.9 C\alpha -> Mainchain

Mainchain can be generated using a set of C\alphas as guide-points (such as those from Baton-building) along the line of Esnouf 66 or Jones and coworkers 67. Briefly, 6-residue fragments of are generated from a list of high-quality 68 structures. The C\alpha atoms of these fragments are matched against overlapping sets of the guide-point C\alphas. The resulting matches are merged to provide positions for the mainchain (and C\beta) atoms. This procedure works well for helices and strands, but less well 69 for less common structural features.

This function is also available from the scripting interface:

(db-mainchain imol chain-id resno-start resno-end direction)

where direction is either "backwards" or "forwards".

Recall that the chain-id needs to be quoted, i.e. use "A" not A. Note that chain-id is "" when the C\alphas have been built with Baton Mode in Coot.


Next: , Previous: C-alpha -> Mainchain, Up: Modelling and Building   [Contents][Index]

5.10 Backbone Torsion Angles

It is possible to edit the backbone \phi and \psi angles indirectly using an option in the Model/Fit/Refine’s dialog: “Edit Backbone Torsions..”. When clicked and an atom of a peptide is selected, this produces a new dialog that offers “Rotate Peptide” which changes this residues \psi and “Rotate Carbonyl” which changes \phi. Click and drag across the button 70 to rotate the moving atoms in the graphics window. You should know, of course, that making these modifications alter the \phi/\psi angles of more than one residue.


Next: , Previous: Backbone Torsion Angles, Up: Modelling and Building   [Contents][Index]

5.11 Docking Sidechains

Docking sidechains means adding sidechains to a model or fragment that has currently only poly-Ala, where the sequence assignment is unknown. The algorithm is basically the same as in Cowtan’s Buccaneer, but with some corners cut to make things (more or less) interactive. The algorithm uses the shape of the density around the C-beta position to estimate the probability of each sidechain type at that position.

The function is accessed via the Extensions -> Dock Sequence menu item. First, a sequence should be assigned from a PIR file to a particular chain-id and model number. Secondly Extensions -> Dock Sequence -> Dock Sequence on this fragment…. Choose the model to build on and then Dock Sequence! If all goes well, the model will be updated with mutated residues and undergo rotamer seach for each of the new residues. If the sequence alignment is not sufficiently clear, then you will get a dialog suggesting that you extend or improve the fragment.


Next: , Previous: Docking Sidechains, Up: Modelling and Building   [Contents][Index]

5.12 Rotamers

The rotamers are generated 71 from the backbone independent sidechain library of the Richardsons group 72.

The m, t and p stand for “minus (-60)”, “trans (180)” and “plus (+60)”. There is one letter per \chi angle.

Use keyboard . and , to cycle round the rotamers.

5.12.1 Auto Fit Rotamer

“Auto Fit Rotamer” will try to fit the rotamer to the electron density. Each rotamer is generated, rigid body refined and scored according to the fit to the map. Fitting the second conformation of a dual conformation in this way will often fail - the algorithm will pick the best fit to the density - ignoring the position of the other atoms.

The algorithm doesn’t know if the other atoms in the structure are in sensible positions. If they are, then it is sensible not to put this residue too close to them, if they are not then there should be no restriction from the other atoms as to the position of this residue - the default is “are sensible”, which means that the algorithm is prevented from finding solutions that are too close to the atoms of other residues. (set-rotamer-check-clashes 0) will stop this.

There is a scripting interface to auto-fitting rotamers:

(auto-fit-best-rotamer resno alt-loc ins-code chain-id imol-coords imol-map clash-flag lowest-rotamer-probability)

where:

resno is the residue number

alt-loc is the alternate/alternative location symbol (e.g. "A" or "B", but most often "")

ins-code is the insertion code (usually "")

imol-coords is the molecule number of the coordinates molecule

imol-map is the molecule number of the map to which you wish to fit the side chains

clash-flag should the positions of other residues be included in the scoring of the rotamers (i.e. clashing with other other atoms gets marked as bad/unlikely)

lowest-rotamer-probability: some rotamers of some side chains are so unlikely that they shouldn’t be considered - typically 0.01 (1%).

You can change the auto-fit rotamer fitting algorithms using

(set-rotamer-search-mode mode)

where mode is one of (ROTAMERSEARCHAUTOMATIC), (ROTAMERSEARCHLOWRES) (i.e. "Backrub Rotamers" (vide infra)) or (ROTAMERSEARCHHIGHRES) (the conventional/high-resolution method using rigid-body fitting).

By default, the auto-fit rotamer method is (ROTAMERSEARCHAUTOMATIC).

5.12.1.1 Backrub Rotamers

By default, Auto Fit Rotamer will switch to “Backrub Rotamer” 73 mode when fitting against a map of worse than 2.7Å. This search mode moves the some atoms of the mainchain of the neighbouring residues. After rotation of the central residue and neighbouring atoms around the “backrub vector”, the individual peptides are back-rotated (along the peptide axis) so that the carbonyl oxygen are placed as near as possible to their original position. The Ramachandran plot is not used in this fitting algorithm.

5.12.2 De-clashing residues

Sometimes you don’t have a map 74 but nevertheless there are clashing residues 75 (for example after mutation of a residue range) and you need to rotate side-chains to a non-clashing rotamer. There is a scripting interface:

(de-clash imol chain-id start-resno end-resno)

start-resno is the residue number of the first residue you wish to de-clash

end-resno is the residue number of the last residue you wish to de-clash

imol is the molecule number of the coordinates molecule

This interface will not change residues with insertion codes or alternate conformation. The lowest-rotamer-probability is set to 0.01.


Next: , Previous: Rotamers, Up: Modelling and Building   [Contents][Index]

5.13 Editing chi Angles

Instead of using Rotamers, one can instead change the \chi angles (often called “torsions”) “by hand” (using “Edit Chi Angles” from the “Model/Fit/Refine” dialog). To edit a residue’s \chi_1 press “1”: to edit \chi_2, “2”: \chi_3 “3” and \chi_4 “4”. Use left-mouse click and drag to change the \chi value. Use keyboard “0” 76 to go back to ordinary view mode at any time during the editing. Alternatively, one can use the “View Rotation Mode” or use the Ctrl key when moving the mouse in the graphics window. Use the Accept/Reject dialog when you have finished editing the \chi angles.

For non-standard residues, the clicked atom defines the base of the atom tree, which defines the “head” of the molecule (it’s the “tail” (twigs/leaves) that wags). To emphasise, then: it matters on which atom you click!

By default torsions for hydrogen atoms are turned off. To turn them on:

(set-find-hydrogen-torsions 1)

To edit the rotatable bonds of a ligand using this tool, you will need to have read in the mmCIF dictionary beforehand.


Next: , Previous: Editing Chi Angles, Up: Modelling and Building   [Contents][Index]

5.14 Torsion General

You need to click on the torsion-general button, then click 4 atoms that describe the torsion - the first atom will be the base (non moving) part of the atom tree, on clicking the 4th atom a dialog will pop up with a "Reverse" button. Move this dialog out of the way and then left mouse click and drag in the main window will rotate the "top" part of the residue round the clicked atoms 2 and 3. When you are happy, click "Accept".

If you are torsion generaling a residue that has an alt conf, then the atoms of residue that are moved are those that have the same alt conf as the 4th clicked atom (or have an blank alt conf).

5.14.1 Ligand Torsion angles

For ligands, you will need to read the mmCIF file that contains a description of the ligand’s geometry (see Section Regularization and Real Space Refinement). By default, torsions that move hydrogens are not included. Only 9 torsion angles are available from the keyboard torsion angle selection.


Next: , Previous: Torsion General, Up: Modelling and Building   [Contents][Index]

5.15 Pep-flip

Coot uses the same pepflip scheme as is used in O (i.e. the C, N and O atoms are rotated 180^o round a line joining the C\alpha atoms of the residues involved in the peptide). Flip the peptide again to return the atoms to their previous position.


Next: , Previous: Pep-flip, Up: Modelling and Building   [Contents][Index]

5.16 Add Alternate Conformation

The allows the addition alternate (dual, triple etc.) conformations to the picked residue. By default, this provides a choice of rotamer (Section Rotamers). If there are not the correct main chain atoms a rotamer choice cannot be provided, and Coot falls back to providing intermediate atoms.

The default occupancy for new atoms is 0.5. This can be changed by using use slider on the rotamer selection window or by using the scripting function:

(set-add-alt-conf-new-atoms-occupancy 0.4)

The remaining occupancy of the atoms (after the new occupancy has been added) is split amongst the atoms that existed in the residue before the split. It is important therefore that the residues atoms have sane occupancies before adding an alternative conformation.

The default Split Type is to split the whole residue. If you want the default to be to split a residue after (and including) the CA, then add to your .coot file:

(set-add-alt-conf-split-type-number 0)


Next: , Previous: Adding Alternative Conformations, Up: Modelling and Building   [Contents][Index]

5.17 Mutation

Mutations are available on a 1-by-1 basis using the graphics. After selecting “Mutate…” from the “Model/Fit/Refine” dialog, click on an atom in the graphics. A “Residue Type” window will now appear. Select the new residue type you wish and the residue in the graphics is updated to the new residue type 77. The initial position of the new rotamer is the a priori most likely rotamer. Note that in interactive mode, such as this, a residue type match 78 will not stop the mutation action occurring.

5.17.1 Mutating DNA/RNA

Mutation of DNA or RNA can be performed using “Simple Mutate” from the Model/Fit/Refine dialog. Residues need to be named "Ad", "Gr", "Ur" etc.

5.17.2 Multiple mutations

This dialog can be found under Calculate -> Mutate Residue Range. A residue range can be assigned a sequence and optionally fitted to the map. This is useful converting a poly-ALA model to the correct sequence 79.

Multiple mutations are also supported via the scripting interface. Unlike the single residue mutation function, a residue type match will prevent a modification of the residue 80. Two functions are provided: To mutate a whole chain, use (mutate-chain imol chain-id sequence) where:

chain-id is the chain identifier of the chain that you wish to mutate (e.g. "A") and

imol is molecule number.

sequence is a list of single-letter residue codes, such as "GYRESDF" (this should be a straight string with no additional spaces or carriage returns).

Note that the number of residues in the sequence chain and those in the chain of the protein must match exactly (i.e. the whole of the chain is mutated (except residues that have a matching residue type).)

To mutate a residue range, use

where

start-res-no is the starting residue for mutation

stop-res-no is the last residue for mutation, i.e. using values of 2 and 3 for start-res-no and stop-res-no respectively will mutate 2 residues.

Again, the length of the sequence must correspond to the residue range length. Note also that this is a protein sequence - not nucleic acid.

For mutation of nucleic acids, use:

(mutate-nucleotide-range imol chain-id resno-start resno-end sequence)

5.17.3 Mutating to a Non-Standard Residue

Sometimes one might like to model post-translational or other such modifications. How is that done, if the new residue type is not one of the standard residue types?

There is a scripting function:

(mutate-by-overlap imol chain-id resno new-three-letter-code)

This imports a model residue for the new residue type and overlays it on to the given residue by using graph-matching to determine the equivalent atoms.

The GUI for this can be found under Extensions -> Modelling -> Replace Residue... (for this to work, you need to be centred on the residue you wish to replace).

Note that if you are replacing are conventional protein residue with a modified form (e.g. replacing a TYR with a phoso-tyrosine or a LYS with an acetyl-lysine) you will need to make sure that the group of the resulting restraints is an L-peptide (use Edit -> Restraints to check and modify the restraints group. Likewise for modified RNA/DNA nucleotides, you need to specify the group as RNA or DNA as appropriate.

5.17.4 Mutate and Autofit

The function combines Mutation and Auto Fit Rotamer and is the easiest way to make a mutation and then fit to the map. You can currently only “Mutate and Autofit” protein residues (i.e. things with a rotamer dictionary.

5.17.5 Renumbering

Renumbering is straightforward using the renumber dialog available under Calculate -> Renumber Residue Range…. There is also a scripting interface:

(renumber-residue-range imol chain-id start-res-no last-resno offset)


Next: , Previous: Mutation, Up: Modelling and Building   [Contents][Index]

5.18 Importing Lignds/Monomers

You can import monomers (often ligands) using File -> Get Monomer…81 by providing the 3-letter code of your monomer/ligand. The resulting molecule will be moved so that it placed at the current screen centre.

Typically, when you are happy about the placement of the ligand, you’d then use Merge Molecules to add the ligand/monomer to the main set of coordinates.

This procedure creates a pdb file monomer-XXX.pdb and a dictionary file libcheck_XXX.cif in the directory in which Coot was started.

A future invocation of Get Monomer uses these file so that the monomer appears quickly 82.


Next: , Previous: Importing Ligands/Monomers, Up: Modelling and Building   [Contents][Index]

5.19 Ligand from SMILES strings

Similarly, you can generate ligands using File -> SMILES... and providing a SMILES string and a code for the residue name (this is your name for the residue type and a dictionary will be generated for the monomer of this type). This function is also a wrapper to LIBCHECK.


Next: , Previous: Ligand from SMILES strings, Up: Modelling and Building   [Contents][Index]

5.20 Find Ligands

You are offered a selection of maps to search (you can only choose one at a time) and a selection of molecules that act as a mask to this map. Finally you must choose which ligand types you are going to search for in this map 83. Only molecules with less than 400 atoms are suggested as potential ligands.

If you do not have any molecules with less that 400 atoms loaded in Coot, you will get the message:

"Error: you must have at least one ligand to search for!"

New ligands are placed where the map density is and protein (mask) atoms are not). The masked map is searched for clusters using a default cut-off of 1.0\sigma. In weak density this cut-off may be too high and in such a case the cut-off value can be changed using something such as:

(set-ligand-cluster-sigma-level 0.8)

However, if the map to be searched for ligands is a difference map, a cluster level of 2.0 or 3.0 would probably be more appropriate (less likely to generate spurious sites).

Each ligand is fitted with rigid body refinement to each potential ligand site in the map and the best one for each site selected and written out as a pdb file. The clusters are sorted by size, the biggest one first (with an index of 0). The output placed ligands files have a prefix “best-overall” and are tagged by the cluster index and residue type of the best fit ligand in that site.

By default, the top 10 sites are tested for ligands - to increase this use:

(set-ligand-n-top-ligands 20)

5.20.1 Flexible Ligands

If the “Flexible?” checkbutton is activated, coot will generate a number of variable conformations (default 100) by rotating around the rotatable bonds (torsions). Each of these conformations will be fitted to each of the potential ligand sites in the map and the best one will be selected (again, if it passes the fitting criteria above).

Before you search for flexible ligands you must have read the mmCIF dictionary for that particular ligand residue type (File -> Import CIF dictionary).

Use:

(set-ligand-flexible-ligand-n-samples n-samples)

where n-samples is the number of samples of flexibility made for each ligand. Generally speaking, The more the number of rotatable bonds, the bigger this number should be.

By default the options to change these values are not in the GUI. To enable these GUI options, use the scripting function:

(ligand-expert)

5.20.2 Adding Ligands to Model

After successful ligand searching, one may well want to add that displayed ligand to the current model (the coordinates set that provided the map mask). To do so, use Merge Molecules (Section Merge Molecules).


Next: , Previous: Find Ligands, Up: Modelling and Building   [Contents][Index]

5.21 Flip Ligand

Sometimes a ligand is placed more or less in the correct position, but the orientation is wrong - or at least you might want to explore other possible orientation. To do that easily a function has been provided:

(flip-ligand imol chain-id residue-number)

This will flip the orientation of the residue around the Eigen vector corresponding to the largest Eigen value, exploring 4 possible orientations.

This function has been further wrapped to provide flipping for the active residue:

(flip-active-ligand)

This function can easily be bound to a key.


Next: , Previous: Flip Ligand, Up: Modelling and Building   [Contents][Index]

5.22 Find Waters

As with finding ligands, you are given a choice of maps, protein (masking) atoms. A final selection has to be made for the cut-off level, note that this value is the number of standard deviation of the density of the map before the map has been masked. The default sigma level (water positions must have density above this level) is set for a “2Fo-Fc”-style map. If you want to use a difference map, you must change the sigma level (typically to 3 sigma) otherwise you run the risk of fitting waters to difference map noise peaks.

Then the map is masked by the masking atoms and a search is made of features in the map about the electron density cut-off value. Waters are added if the feature is approximately water-sized and can make sensible hydrogen bonds to the protein atoms. The new waters are optionally created in a new molecule called “Waters”.

You have control over several parameters used in the water finding:

(set-write-peaksearched-waters)

which writes ligand-waters-peaksearch-results.pdb, which contains the water peaks (from the clusters) without any filtering and ligand-waters.pdb which are a disk copy filtered waters that have been either added to the molecule or from which a new molecule has been created.

(set-ligand-water-to-protein-distance-limits min-d max-d) sets the minimum and maximum allowable distances between new waters and the masking molecule (usually the protein). Defaults are 2.4 and 3.2Å.

(set-ligand-water-spherical-variance-limit varlim) sets the upper limit for the density variance around water atoms. The default is 0.12.

The map that is marked by the protein and is searched to find the waters is written out in CCP4 format as "masked-for-waters.map".

5.22.1 Refinement Failure

Sometimes as a result of water fitting, you may see something like:

 WARNING:: refinement failure
           start pos: xyz = (      17.1,     34.76,     60.42)
           final pos: xyz = (     17.19,     34.61,     60.59)

When Coot finds a blob, it does a crude positioning of an atom at the centre of the grid points. It then proceeds to move to the peak of the blob by a series of translations. There are a certain number of cycles, and if it doesn’t reach convergence by the end of those cycles then you get the error message.

Often when you go to the position indicated, you can see why Coot had a problem in the refinement.

5.22.2 Blobs

After a water search, Coot will create a blobs dialog (see Section sec_blobs).


Next: , Previous: Find Waters, Up: Modelling and Building   [Contents][Index]

5.23 Add Terminal Residue

This creates a new residue at the C or N terminal extension of the residue clicked by fitting to the map. \phi,\psi angle pairs are selected at random based on the Ramachandran plot probability (for a generic residue) and fitted to the density. By default there are 100 trials. It is possible that a wrong position will be selected for the terminal residue and if so, you can reject this fit and try again with Fit Terminal Residue 84. Each of the trial positions are scored according to their fit to the map 85 and the best one selected. It is probably a good idea to run “Refine Zone” on these new residues.

If you use the Extensions (Dock Sequence... -> Associate Sequence with Model) to apply a PIR sequence file to a model then Add Terminal Residue will use the sequence alignment to determine the residue type of the added residue.

Sometimes, particularly with low resolution maps, the added terminal residue will wander off to somewhere inappropriate. This can be addressed in a number of ways:

  1. (set-terminal-residue-do-rigid-body-refine 0) will disable rigid body fitting of the terminal residue fragment for each trial residue position (the default is 1 (on)) - this may help if the search does not provide good results.
  2. to anneal the newly added residue back to the clicked residue (no matter where it ended up being positioned): (set-add-terminal-residue-do-post-refine 1)
  3. (set-add-terminal-residue-n-phi-psi-trials 200) will change the number of trials (default is 100). This is useful if you think that Coot needs to search harder to find a good solution to the positioning of the next residue.

Next: , Previous: Add Terminal Residue, Up: Modelling and Building   [Contents][Index]

5.24 Add OXT Atom to Residue

At the C-terminus of a chain of amino-acid residues, there is a “modification” so that the C-O becomes a carbonyl, i.e. an extra (terminal) oxygen (OXT) needs to be added. This atom is added so that it is in the plane of the C\alpha, C and O atoms of the residue.

Scripting usage:

(add-OXT-to-residue imol residue-number insertion-code chain-id) 86,

where insertion-code is typically "".

Note, in order to place OXT, the N, CA, C and O atoms must be present in the residue - if (for example) the existing carbonyl oxygen atom is called “OE1” then this function will not work.


Next: , Previous: Add OXT Atom to Residue, Up: Modelling and Building   [Contents][Index]

5.25 Add Atom at Pointer

By default, “Add Atom At Pointer” will pop-up a dialog from which you can choose the atom type you wish to insert 87. Using (set-pointer-atom-is-dummy 1) you can by-pass this dialog and immediately create a dummy atom at the pointer position. Use an argument of 0 to revert to using the atom type selection pop-up on a button press.

The atoms are added to a new molecule called “Pointer Atoms”. They should be saved and merged with your coordinates outside of Coot.


Next: , Previous: Add Atom at Pointer, Up: Modelling and Building   [Contents][Index]

5.26 Place Helix

The idea is to place a helix more or less “here” (the screen centre) by fitting to the electron density map. The algorithm is straightforward. First we move to the local centre of density, then examine the density for characteristic directions and fit ideal helices (of length 20 residues) to these directions. The helix is then extended if possible (by checking the fit to the map of residues added in ideal helix conformation) and chopped back if not. If the fit is successful, the helix is created in a new molecule called “Helix”. If the fit is not successful, there is instead a message added to the status bar. You can build the majority of a helical protein in a few minutes using this method (you will of course have to assemble the helices and assign residue numbers and sequence later).

This is available as a scripting function (place-helix-here) and in the GUI (in the “Other Modelling Tools” dialog).


Next: , Previous: Place Helix, Up: Modelling and Building   [Contents][Index]

5.27 Building Ideal DNA and RNA

The interface to building ideal polynucleotides can be found by pressing the “Ideal RNA/DNA…” button on the “Other Modelling Tools” dialog.

For a given sequence, a choice of DNA or RNA, A or B form, single or double stranded is presented.

The interface may not gracefully handle uracils in DNA, thymines in RNA or B form RNA.

The ideal B-form DNA is somewhat under-wound, needing 11 base-pairs to repeat (instead of the expected 10.5). There is no easy fix for this currently.


Next: , Previous: Building Ideal DNA and RNA, Up: Modelling and Building   [Contents][Index]

5.28 Merge Molecules

The dialog for this opperation can be found under “Calculate” in the main menubar. This is typically used to add molecule fragments or residues that are in one molecule to the “working” coordinates 88.

The scripting interface is used like this

(merge-molecules molecule-list target-molecule)

e.g.

(merge-molecules (list 1 2 ) 0)

merges molecules 1 and 2 into molecule 0.


Next: , Previous: Merge Molecules, Up: Modelling and Building   [Contents][Index]

5.29 Temperature Factor for New Atoms

The default temperature factor for new atoms is 30.0. This can be changed by the following

(set-default-temperature-factor-for-new-atoms 50.0)


Next: , Previous: Temperature Factor for New Atoms, Up: Modelling and Building   [Contents][Index]

5.30 Applying NCS Edits

Let’s imagine that you have 3-fold NCS. You have molecule “A” as your master molecule and you make edits to that molecule. Now you want to apply the edits that you made to “A” (the NCS master chain ID) to the “B” and “C” molecules (i.e. you want the “B” and “C” molecules to be rotated/translated versions of the “A” molecule). How is that done?

There are now guis to NCS command to help you out (under Extensions). However, for completeness here are the scripting versions:

(copy-from-ncs-master-to-others imol master-chain-id)

If you have only a range of residues, rather than a whole chain to replace:

(copy-residue-range-from-ncs-master-to-others imol master-chain-id start-resno end-resno)

e.g.

(copy-residue-range-from-ncs-master-to-others 0 "A" 1 5)

If you want to copy a residue range to a specific chain, or specific list of chains (rather than all NCS peer chains) then make a list of the chain-ids that you wish replaced:

(copy-residue-range-from-ncs-master-to-chains 0 "A" 1 5 (list "C"))

in this case, just the residues in the "C" chain is replaced.


Next: , Previous: Applying NCS Edits, Up: Modelling and Building   [Contents][Index]

5.31 Running Refmac

Use the “Run Refmac...” button to select the dataset and the coordinates on which you would like to run Refmac. Note that here Coot only allows the use of datasets which has Refmac parameters set as the MTZ file was read. By default, Coot displays the new coordinates and the new map generated from refmac’s output MTZ file. Optionally, you can also display the difference map.

You can add extra parameters (data lines) to refmac’s input by storing them in a file called refmac-extra-params in the directory in which you started coot.

You can also provide extra/replacement parameters for refmac by setting the variable refmac-extra-params to a list of strings, for example:

(set! refmac-extra-params (list "REFINE MATRIX 0.1" "MAKE HYDROGENS NO"))

Coot “blocks” 89 until Refmac has terminated 90.

The default refmac executable is refmac5 it is presumed to be in the path. If you don’t want this, it can be overridden using a re-definition either at the scripting interface or in one’s ~/.coot file e.g.:

After running refmac several times, you may find that you prefer if the new map that refmac creates (after refmac refinement) is the same colour as the previous one (from before this refmac refinement). If so, use:

(set-keep-map-colour-after-refmac 1)

which will swap the colours of then new and old refmac map so that the post-refmac map has the same colour as the pre-refmac map and the pre-refmac map is coloured with a different colour.


Next: , Previous: Running Refmac, Up: Modelling and Building   [Contents][Index]

5.32 Running SHELXL

Coot can read shelx .res files and write .ins files, and thus one can refine using SHELXL in a convenient manner using the function

(shelxl-refine imol . hkl-file-name)

(the hkl-file-name is an optional argument)

e.g.

(shelxl-refine 0)

or

(shelxl-refine 0 "insulin.hkl")

In the former case, coot will presume that there is a SHELX hkl file corresponding to the res file that you read in; if there is not coot will print a warning and not try to run shelxl. In the latter case, you can specify the location of the hkl file.

After shelxl has finished, coot will automatically read in the resulting res coordinates, the fcf file, convert the data to mmCIF format and read that, which generates a \sigma_A map and a difference map.

Coot creates a time stamped ins file and a time-stamped sym-link to the hkl file in the coot-shelxl directory.

Please note that the output ins file will not be particularly useful (and thus shelxl will fail) if the input file was not in SHELX ins format.

There is a GUI for this operation under the “Extensions” menu item.


Next: , Previous: Running SHELXL, Up: Modelling and Building   [Contents][Index]

5.33 Clear Pending Picks

Sometimes one can click on a button 91 unintentionally. This button is there for such a case. It clears the expectation of an atom pick. This works not only for modelling functions, but also geometry functions (such as Distance and Angle).


Next: , Previous: Clear Pending Picks, Up: Modelling and Building   [Contents][Index]

5.34 Delete

Single atoms or residues can be deleted from the molecule using “Delete…” from the “Model/Fit/Refine”dialog. Pressing this button results in a new dialog, with the options of “Residue” (the default), “Atom” and “Hydrogen Atoms”. Now click on an atom in the graphics - the deleted object will be the whole residue of the atom if “Residue” was selected and just that atom if “Atom” was selected. Note that if a residue has an alternative conformation, then “Delete Residue” will delete only the conformation that matches that alternative conformation specifier of the clicked atom.

Only waters are deletable if the "Water" check button is active and waters are not deletable if the "Residue/Monomer" check button is active. This is to reduce mis-clicking.

To rotate the view when in “Delete Mode”, use Ctrl left-mouse.

If you want to delete multiple items you can use check the “Keep Delete Active” check-button on this dialog This will will keep the dialog open, ready for deletion of next item.

An atom can be delete using the scripting

(delete-atom imol chain-id residue-no ins-code atom-name alt-conf)

Residues can be deleted using the scripting

(delete-residue imol chain-id residue-no ins-code)

Residue ranges can be deleted using the scripting

(delete-residue-range imol chain-id residue-no-start residue-no-end)

Chains can be deleted using the scripting

(delete-chain imol chain-id)

Sidechains can be deleted from a region:

(delete-side-chain-range imol chain-id residue-no-start residue-no-end)

or for a chain

(delete-sidechains-for-chain imol chain-id)


Next: , Previous: Delete, Up: Modelling and Building   [Contents][Index]

5.35 Sequence Assignment

You can assign a (FASTA format) sequence to a molecule using:

(assign-fasta-sequence imol chain-id fasta-seq)

This function has been provided as a precursor to functions that will (as automatically as possible) mutate your current coordinates to one that has the desired sequence. It will be used in automatic side-chain assignment (at some stage in the future).


Next: , Previous: Sequence Assignment, Up: Modelling and Building   [Contents][Index]

5.36 Building Links and Loops

Coot can build missing linking regions or loops 92. The function can be found under Calculate -> Fit Loop -> Fit Loop by Rama Search or the scripting function:

(fit-gap imol chain-id start-resno stop-resno)

and

(fit-gap imol chain-id start-resno stop-resno sequence)

the second form will also mutate and try to rotamer fit the provided sequence.

Example usage: let’s say for molecule number 0 in chain "A" we have residues up to 56 and then a gap after which we have residues 62 and beyond:

(fit-gap 0 "A" 57 61 "TYPWS")


Next: , Previous: Building Links and Loops, Up: Modelling and Building   [Contents][Index]

5.37 Fill Partial Residues

After molecular replacement, the residues of your protein could well have the correct sequence but be chopped back to CG or CB atoms. There is a function to fill such partially-filled residues:

(fill-partial-residues imol)

This identifies residues with missing atoms, then fills them and does a rotamer fit and real-space refinement.

If you want to fill the side chain of just one residue

(fill-partial-residue imol chain-id res-no ins-code)

this does a auto-fit-best-rotamer and a refinement on the resulting side-chain position.


Next: , Previous: Fill Partial Residues, Up: Modelling and Building   [Contents][Index]

5.38 Changing Chain IDs

You can change the chain ids of chains using Calculate -> Change Chain IDs…. Coot will block an attempt to change the whole of a chain and the target chain id already exists in the molecule.

If you use the "Residue Range" option then you can insert residues with non-conflicting residue number into pre-existing chains.


Next: , Previous: Changing Chain IDs, Up: Modelling and Building   [Contents][Index]

5.39 Setting Occupancies

As well as the editing “Residue Info” to change occupancies of individual atoms, one can use a scripting function to change occupancies of a whole residue range:

example usage:

(zero-occupancy-residue-range 0 "A" 23 28)

This is often useful to zero out a questionable loop before submitting for refinement. After refinement (with refmac) there should be relatively unbiased density in the resulting 2Fo-Fc-style and difference maps.

Similarly there is a function to reverse this operation:


Next: , Previous: Setting Occupancies, Up: Modelling and Building   [Contents][Index]

5.40 Fix Nomenclature Errors

Currently this is available only in scripting form:

(fix-nomenclature-errors imol)

This will fix atoms nomenclature problems in molecule number imol according to the same criteria as WATCHECK 93 e.g. Chi-2 for Phe, Tyr, Asp, and Glu should be between -90 and 90 degrees. Note that Val and Leu nomenclature errors are also corrected.


Next: , Previous: Fix Nomenclature Errors, Up: Modelling and Building   [Contents][Index]

5.41 Rotamer Fix Whole Protein

There is an experimental scripting function

(fit-protein imol)

which does a auto-fit rotamer and Real Space Refinement for each residue. The graphics follow the refinement.


Next: , Previous: Rotamer Fix Whole Protein, Up: Modelling and Building   [Contents][Index]

5.42 Refine All Waters

All the waters in a model can be refined (that is, moved to the local density peak) using

(fit-waters imol)

This is a non-interactive function (the waters are moved without user intervention).


Next: , Previous: Refine All Waters, Up: Modelling and Building   [Contents][Index]

5.43 Moving Molecules/Ligands

Often you want to move a ligand (or some such) from wherever it was read in to the position of interest in your molecule (i.e. the current view centre). There is a GUI to do this: Calculate -> Move Molecule Here.

There are scripting functions available for this sort of thing:

(molecule-centre imol)

will tell you the molecule centre of the imolth molecule.

(translate-molecule-by imol x-shift y-shift z-shift)

will translate all the atoms in molecule imol by the given amount (in Ångströms).

(move-molecule-to-screen-centre imol)

will move the imolth molecule to the current centre of the screen (sometimes useful for imported ligands). Note that this moves the atoms of the molecule - not just the view of the molecule.


Previous: Moving Molecules/Ligands, Up: Modelling and Building   [Contents][Index]

5.44 Modifying the Labels on the Model/Fit/Refine dialog

If you don’t like the labels "Rotate/Translate Zone" or "Place Atom at Pointer" and rather they said something else, you can change the button names using:

(set-model-fit-refine-rotate-translate-zone-label "Move Zone")

and

(set-model-fit-refine-place-atom-at-pointer "Add Atom")


Next: , Previous: Modelling and Building, Up: Top   [Contents][Index]

6 Map-Related Features


Next: , Up: Map-Related Features   [Contents][Index]

6.1 Maps in General

Maps are “infinite,” not limited to pre-calculated volume (the “Everywhere You Click - There Is Electron Density” (EYC-TIED) paradigm) symmetry-related electron density is generated automatically. Maps are easily re-contoured. Simply use the scroll wheel on you mouse to alter the contour level (or -/+ on the keyboard).

Maps follow the molecule. As you recentre or move about the crystal, the map quickly follows. If your computer is not up to re-contouring all the maps for every frame, then use Draw -> Dragged Map… to turn off this feature.

6.1.1 Map Reading Bug

Unfortunately, there is a bug in map-reading. If the map is not a bona-fide CCP4 map 94, then coot will crash. Sorry. A fix is in the works but “it’s complicated”. That’s why maps are limited to the extension ".ext" and ".map", to make it less likely a non-CCP4 map is read.


Next: , Previous: Maps in General, Up: Map-Related Features   [Contents][Index]

6.2 Create a Map

From MTZ, mmCIF and .phs data use File -> Open MTZ, CIF or phs…. You can then choose the MTZ columns for the Fourier synthesis. The button “Expert mode” also adds to the options any anomalous columns you may have in the MTZ file (a -90 degree phase shift will be applied). It also provides the option to apply resolution limits.

From a CCP4 map use File -> Read Map. After being generated/read, the map is immediately contoured and centred on the current rotation centre.

6.2.1 Auto-read MTZ file

This function allows Coot to read an MTZ file and make a map directly (without going through the column selection procedure). The default column labels for auto-reading are "FWT" and "PHWT" for the 2Fo-Fc-style map, "DELFWT" and "PHDELWT" for the difference map. You can change the column labels that Coot uses for auto-reading - here is an example of how to do that:

(set-auto-read-column-labels "2FOFCWT" "PHIWT" 0) (set-auto-read-column-labels "FOFCWT" "DELPHIWT" 1)

By default the difference map is created in auto-reading the MTZ file. If you don’t want a difference map, you can use the function:

(set-auto-read-do-difference-map-too 0)

6.2.2 Reading CIF data

There are several maps that can be generated from CIF files that contain observed Fs, calculated Fs and calculated phases:

6.2.3 Reading PHS data

There are 2 ways to read data by scripting:

(read-phs-and-make-map-using-cell-symm phs-file-name space-group-name a b c alpha beta gamma)

(read-pdb-and-make-map-with-reso-limits imol-previous phs-file-name reso-limit-low reso-limit-high)

The first specifies the cell explicitly, and alpha, beta and gamma are specified in degrees.

The second form allows the specification of resolution limits and takes the cell and symmetry from a previous molecule (typically a pdb file).


Next: , Previous: Create a Map, Up: Map-Related Features   [Contents][Index]

6.3 Map Contouring

Maps can be re-contoured using the middle-mouse scroll-wheel (buttons 4 and 5 in X Window System(TM) terminology). Scrolling the mouse wheel will change the map contour level and the map it redrawn. If you have several maps displayed then the map that has its contour level changed can be set using HID -> Scrollwheel -> Attach scroll-wheel to which map?. If there is only one map displayed, then that is the map that has its contour level changed (no matter what the scroll-wheel is attached to in the menu). The level of the electron density is displayed in the top right hand corner of the OpenGL canvas.

Use keyboard + or - to change the contour level if you don’t have a scroll-wheel 95.

If you are creating your map from an MTZ file, you can choose to click on the “is difference map” button on the Column Label selection widget (after a data set filename has been selected) then this map will be displayed in 2 colours corresponding to + and - the map contour level.

If you read in a map and it is a difference map then there is a checkbutton to tell Coot that.

If you want to tell Coot that a map is a difference map after it has been read, use:

(set-map-is-difference-map imol)

where imol is the molecule number.

By default the change of the contour level is determined from the sigma of the map. You can change this in the map properties dialog or by using the scripting function:

(set-contour-by-sigma-step-by-mol step on/off? imol)

where

step is the difference in sigma from one level to the next (typically 0.2)

on/off? is either 0 (sigma stepping off) or 1 (sigma stepping on)

By default the map radius 96 is 10Å. The default increment to the electron density depends on whether or not this is a difference map (0.05 e^-/\AA^3 for a “2Fo-Fc” style map and 0.005 e^-/\AA^3 for a difference map). You can change these using Edit -> Map Parameters or by using the “Properties” button of a particular map in the Display Control (Display Manager) window.


Next: , Previous: Map Contouring, Up: Map-Related Features   [Contents][Index]

6.4 Map Extent

The extent of the map can be set using the GUI (Edit -> Map Parameters -> Map Radius) or by using the scripting function, e.g.:

(set-map-radius 13.2)


Next: , Previous: Map Extent, Up: Map-Related Features   [Contents][Index]

6.5 Map Contour “Scrolling” Limits

Usually one doesn’t want to look at negative contour levels of a map97, so Coot has by default a limit that stops the contour level going beyond (less than) 0. To remove the limit:

(set-stop-scroll-iso-map 0) for a 2Fo-Fc style map

(set-stop-scroll-diff-map 0) for a difference map

To set the limits to negative (e.g. -0.6) levels:

(set-stop-scroll-iso-map-level -0.6)

and similarly:

(set-stop-scroll-diff-map-level -0.6)

where the level is specified in e^-/\AA^3.


Next: , Previous: Map Contour ``Scrolling'' Limits, Up: Map-Related Features   [Contents][Index]

6.6 Map Line Width

The width of the lines that describe the density can be changed like this:

(set-map-line-width 2)

The default line width is 1.


Next: , Previous: Map Line Width, Up: Map-Related Features   [Contents][Index]

6.7 “Dynamic” Map colouring

By default, maps get coloured according to their molecule number. The starting colour (i.e. for molecule 0) is blue. The colour of a map can be changed by Edit -> Map Colour... The map colour gets updated as you change the value in the colour selector 98. Use “OK” to fix that colour.

As subsequent maps are read, they are coloured by rotation round a colour wheel. The default colour map step is 31 degrees. You can change this using:

(set-colour-map-rotation-for-map step)


Next: , Previous: Map colouring, Up: Map-Related Features   [Contents][Index]

6.8 Difference Map Colouring

For some strange reason, some crystallographers 99 like to have their difference maps coloured with red as positive and green as negative, this option is for them:

(set-swap-difference-map-colours 1)

This option will allow the “blue is positive, red is negative” colour scheme on “Edit -> Map Colour”.


Next: , Previous: Difference Map Colouring, Up: Map-Related Features   [Contents][Index]

6.9 Make a Difference Map

Using the “Make a Difference Map” function in the Extensions menu, one can make a difference from two arbitrary maps. The maps need not be on the same griding, or in the same space group even. The resulting map will be on the same griding and space group as the “Reference” map.


Next: , Previous: Make a Difference Map, Up: Map-Related Features   [Contents][Index]

6.10 Make an Averaged Map

There is a scripting interface to the generation of map averages. As above, the maps need not be on the same grid or in the same space group. The resulting map will have the same gridding and space group as the first map in the list. Typical usage:

(average-map '((1 1.0) (2 1.0))))

The argument to (average-map is a list of lists, each list element is a list of the map number and a weighting factor (1.0 in this case).


Next: , Previous: Make an Averaged Map, Up: Map-Related Features   [Contents][Index]

6.11 Map Sampling

By default, the Shannon sampling factor is the conventional 1.5. Use larger values (Edit -> Map Parameters -> Sampling Rate) for smoother maps 100.

This value can be set by the scripting command

(set-map-sampling-rate 2.5)


Next: , Previous: Map Sampling, Up: Map-Related Features   [Contents][Index]

6.12 Dragged Map

By default, the map is re-contoured at every frame during a drag (Ctrl Left-mouse). Sometimes this can be annoyingly slow and jerky so it is possible to turn it off: Draw -> Dragged Map -> No.

To change this by scripting:

(set-active-map-drag-flag 0)


Next: , Previous: Dragged Map, Up: Map-Related Features   [Contents][Index]

6.13 Dynamic Map Sampling and Display Size

If activated (Edit -> Map Parameters -> Dynamic Map Sampling) the map will be re-sampled on a more coarse grid when the view is zoomed out. If “Display Size” is also activated, the box of electron density will be increased in size also. In this way, you can see electron density for big maps (many unit cells) and the graphics still remain rotatable.

If you want to have these functions active for all maps, add the following to your initialization file Scheme:

(set-dynamic-map-sampling-on) (set-dynamic-map-size-display-on)


Next: , Previous: Dynamic Map Sampling and Display Size, Up: Map-Related Features   [Contents][Index]

6.14 Skeletonization

The skeleton (also known as “Bones” 101) can be displayed for any map. A map can be skeletonized using Calculate -> Map Skeleton…. Use the option menu to choose the map and click “On” then “OK” to the generate the map (the skeleton is off by default).

The level of the skeleton can be changed by using Edit -> Skeleton Parameters… -> Skeletonization Level… and corresponds to the electron density level in the map. By default this value is 1.2 map standard deviations. The amount of map can be changed using Edit -> Skeleton Parameters… -> Skeleton Box Radius…102. The units are in Ångströms, with 40 as the default value.

The skeleton is often recalculated as the screen centre changes - but not always since it can be an irritatingly slow calculation. If you want to force a regeneration of the displayed skeleton, simply centre on an atom (using the middle mouse button) or press the S key.


Next: , Previous: Skeletonization, Up: Map-Related Features   [Contents][Index]

6.15 Map Sharpening

It can be educational (even useful at lower resolutions) to sharpen or blur a map. This can be achieved with the sharpening tool Calculate -> Map Sharpening…. By default, the maximum and minimum sharpness is +/- 200Å^2, this can be changed (in this case to 300) using:

(set-map-sharpening-scale-limit 300)

This currently only works on maps created by reading an MTZ (or other) reflection data file.


Next: , Previous: Map Sharpening, Up: Map-Related Features   [Contents][Index]

6.16 Pattersons

Pattersons can be generated using the make-and-draw-patterson function. Example usage:

(make-and-draw-patterson mtz-file-name f-col sig-f-col)

where use-weights-flag is either 0 or 1.

e.g.

(make-and-draw-patterson "native.mtz" "FP_nat" "SIGFP_nat")


Next: , Previous: Pattersons, Up: Map-Related Features   [Contents][Index]

6.17 Map Re-Interpolation

Maps can be re-interpolated to match a reference map.

(reinterp-map map-no reference-map-no)

will create a copy of map-no in the same cell, spacegroup and grid spacing as the reference-map-no map.


Next: , Previous: Map Re-Interpolation, Up: Map-Related Features   [Contents][Index]

6.18 Masks

A map can be masked by a set of coordinates. Use the scripting function:

(mask-map-by-molecule imol-map imol-model invert-mask?)

If invert-mask? is 0, this will create a new map that has density only where there are no (close) coordinates. If invert-mask? is 1 then the map density values will be set to zero everywhere except close to the atoms of molecule number imol-model.

The radius of the mask around each atom is 2.0Å by default. You can change this using:

(set-map-mask-atom-radius radius)

There is a GUI interface to Map Masking under the Extensions menu.

6.18.1 Example

If one wanted to show just the density around a ligand:

  1. Make a pdb file the contains just the ligand and read it in to Coot - let’s say it is molecule 1 and the ligand is residue 3 of chain “L”.
  2. Get a map that covers the ligand (e.g. from refmac). Let’s say this map is molecule number 2.
  3. Mask the map:

    (mask-map-by-molecule 2 1 1)

    This creates a new map. Turn the other maps off, leaving only the masked map.

To get a nice rendered image, press F8 (see Section Raster3D).


Next: , Previous: masks, Up: Map-Related Features   [Contents][Index]

6.19 Trimming

If you want to remove all the atoms 103 that lie “outside the map” (i.e. in low density) you can use

(trim-molecule-by-map imol-coords imol-map density-level delete/zero-occ?)

where delete/zero-occ? is 0 to remove the atoms and 1 to set their occupancy to zero.

There is a GUI interface for this feature under the “Extensions” menu item.


Next: , Previous: Trimming Atoms, Up: Map-Related Features   [Contents][Index]

6.20 Map Transformation

If you want to transform a map, you can do it thusly:

(transform-map imol rotation-matrix trans point radius)

where:

rotation-matrix is a 9-membered list of numbers for an orthogonal rotation matrix.

trans is a 3-membered list of numbers (distances in Ångstöms).

point is a 3-membered list of numbers (centre point in Ångstöms).

radius is a single number (also in Ångstöms).

This applies the rotation rotation-matrix and a translation trans to a map fragment, so that when the transformation is applied the centre of the new map is at point.

Example usage:

(transform-map 2 '(1 0 0 0 1 0 0 0 1) '(0 0 1) (rotation-centre) 10)

which transforms map number 2 by a translation of 1Å along the Z axis, centred at the screen centre for 10Å around that centre.

Here’s a more real-world example:

Let’s say we want to tranform the density over the “B” molecule to a position over the “A” molecule. First we do a LSQ transformation to get the rotation and translation that moves the “B” coordinates over the “A” coordinates:

In the terminal output we get:

|    0.9707,    0.2351,   0.05033|
|  -0.04676,      0.39,   -0.9196|
|   -0.2358,    0.8903,    0.3896|
(    -33.34,     21.14,     18.82)

The centre of the “A” molecule is at (58.456, 5.65, 11.108). So we do:

(transform-map 3 (list 0.9707 0.2351 0.05033 -0.04676 0.39 -0.9196 -0.2358 0.8903 0.3896) (list -33.34 21.14 18.82) (list 58.456 5.65 11.108) 8)

Which creates a map over the middle of the “A” molecule. Note that using a too high radius can cause overlap problems, so try with a small radius (e.g. 5.0) if the resulting map looks problematic.

Alternatively, instead of typing the whole matrix, you can use a coordinates least-squares fit to generate the matrix for you. (transform-map-using-lsq-matrix) does just that.

Heres how to use it:

(transform-map-using-lsq-matrix imol-ref ref-chain ref-resno-start ref-resno-end imol-mov mov-chain mov-resno-start mov-resno-end imol-map about-pt radius)

Hopefully the arguments are self explanatory (ref refers to the reference molecule, of course and about-pt is a 3-number list such as is returned by (rotation-centre)).

We can now export that map, if we want.


Previous: Map Transformation, Up: Map-Related Features   [Contents][Index]

6.21 Export Map

You can write out a map from Coot (e.g. one from NCS averaging, or masking or general transformation) using the export map function:

(export-map imol filename)

e.g.

(export-map 4 "ncs-averaged.map")


Next: , Previous: Map-Related Features, Up: Top   [Contents][Index]

7 Validation

The validation functions are still being added to from time to time. In future there will be more functions, particularly those that will interface to other programs.


Next: , Up: Validation   [Contents][Index]

7.1 Ramachandran Plots

Ramachandran plots are “dynamic”. When you edit the molecule (i.e. move the coordinates of some of atoms) the Ramachandran plot gets updated to reflect those changes. Also the underlying \phi/\psi probability density changes according to the selected residue type (i.e. the residue under the mouse in the plot). There are 3 different residue types: GLY, PRO, and not-GLY-or-PRO 104.

When you mouse over a representation of a residue (a little square or triangle 105) the residue label pops up. The residue is “active” i.e. it can be clicked. The “graphics” view changes so that the C\alpha of the selected residue is centred. In the Ramachandran plot window, the current residue is highlighted by a green square.

The underlying distributions are taken from the Richardson’s Top500 structures http://kinemage.biochem.duke.edu/databases/top500.php.

The probability levels for acceptable (yellow) and preferred (red) are 0.2% and 2% respectively.

You can change the contour levels:

(set-ramachandran-plot-contour-levels 0.025 0.003)

You can change the “blocksize” (the default is 10 degrees) of the contours using

(set-ramachandran-plot-background-block-size 5)

These comes into effect when a new plot is created (it doesn’t change plots currently displayed).


Next: , Previous: Ramachandran Plots, Up: Validation   [Contents][Index]

7.2 Geometry Analysis

A restraints-based geometry analysis of the molecule. The distortion is weighted by atom occupancy. The distortion of the geometry due to links is shared between the contributing residues.

Note that only the first model of a multi-model molecule is analysed.


Next: , Previous: Geometry Analysis, Up: Validation   [Contents][Index]

7.3 Chiral Volumes

The dictionary is used to identify the chiral atoms of each of the model’s residues. A clickable list is created of atoms whose chiral volume in the model is of a different sign to that in the dictionary.

During refinement and regularization, Coot will pop-up dialogs warning about chiral volume errors - if you have them. This can be annoying 106. You can inhibit this dialog like this:

(set-show-chiral-volume-errors-dialog 0)

7.3.1 Fixing Chiral Volume Errors

There are two obvious ways:

1) mutate and auto-fit rotamer (mutate it to the residue type that it is)

2) RS Refine the residue and invert the chiral centre by pulling an atom. Usually you can pull the CA to the other side of the plane made by the chiral neighbouring atoms (using ctrl left-click). Sometimes giving the CB a good old tweak is the easier way.

Inverting the CB of THR is easier, just move the OG so that the plane of the neighbours is on the other side of the CB (again with ctrl left-click).


Next: , Previous: Chiral Volumes, Up: Validation   [Contents][Index]

7.4 Blobs: a.k.a. Unmodelled density

This is an interface to the Blobs dialog. A map and a set of coordinates that model the protein are required.

A blob is region of relatively high residual election density that cannot be explained by a simple water. So, for example, sulfates, ligands, mis-placed sidechains or unbuilt terminal residues might appear as blobs. The blobs are in order, the biggest 107 at the top.


Next: , Previous: sec_blobs, Up: Validation   [Contents][Index]

7.5 Difference Map Peaks

This is one of the fastest ways to validate a model and its data (presuming that the difference map comes from a post-refinement mFo-DFc map). It highlights regions where the model and the data do not agree.

Lesser peaks within a certain distance (by default, 2.0Å) of a large peak are not shown. This cuts down on the number of times one is navigated to a particular region because of ripple or other noise peaks around a central peak.

This value can be queried:

(difference-map-peaks-max-closeness)

and adjusted:

(set-difference-map-peaks-max-closeness 0.1)


Next: , Previous: Difference Map Peaks, Up: Validation   [Contents][Index]

7.6 Check Waters by Difference Map

Sometimes waters can be misplaced - taking the place of sidechains or ligands or crystallization agents such as phosphate for example 108. In such cases the variance of the difference map can be used to identify these problems.

This function is also useful to check anomalous maps. Often waters are placed in density that is really a something else, perhaps a cation, anion, sulphate or a ligand. If such an atom diffracts anomalously this can be identified and corrected.

By default the waters with a map variance greater than 3.5\sigma are listed. One can be more rigorous by using a lower cut-off:

(set-check-waters-by-difference-map-sigma-level 3.0)

The scripting interface is:

(check-waters-by-difference-map imol-coords imol-diff-map)

where imol-coords is the molecule number of the coordinates that contain the waters to be checked

imol-diff-map is the molecule number of the difference map (it must be a difference map, not an “ordinary” map). This difference map must have been calculated using the waters. So there is no point in doing this check immediately after “Find Waters”. You will need to run Refmac or some other refinement first first 109.


Next: , Previous: Check Waters by Difference Map, Up: Validation   [Contents][Index]

7.7 Molprobity Tools Interface

The molprobity tools probe and reduce have been interfaced into Coot (currently, the interface is not as slick as it might be). However, the tools are useful and can be used in the following way:

first we need to tell Coot where to find the relevant executables (typically you would add the following lines to you ~/.coot file):

(define *probe-command* "/path/to/probe/executable")

(define *reduce-command* "/path/to/reduce/executable")

now the probe hydrogens and probe dots can be generated using Validate -> Probe Clashes (or in the Scripting Window):

(probe imol)

where imol is the molecule number of coordinates to be probed. A new molecule with Hydrogens is created (by reduce) and read in.

By default Coot creates a new molecule for the molecule that now has hydrogens. To change this:

(set! reduce-molecule-updates-current #t)

and that, as you can guess, replaces, rather than adds to the “probed” molecule.

This gives a "static" view of the molecule’s interactions.

To get a dynamic view (which is currently only enabled on rotating chi angles) add these to your ~/.coot file:

(set-do-probe-dots-on-rotamers-and-chis 1)

To get a semi-static view (dots are regenerated in the region of zone after a "Real Space Refinement"):

(set-do-probe-dots-post-refine 1)


Next: , Previous: Molprobity Tools Interface, Up: Validation   [Contents][Index]

7.8 GLN and ASN B-factor Outliers

It is often difficult to detect by eye the correct orientation of the amino-carbonylo group of GLN and ASNs. However, we can use (properly refined) temperature factors to detect outliers. We take the Z value as half the difference between the B-factor of the NE2 and OE1 divided by the standard deviation of the B-factors of the rest of the residue. An analysis of GLNs and ASNs of high resolutions structures indicates that a Z value of greater than 2.25 indicates a potential (if not probable) flip. A “Fix” button is provided in the resultant dialog make this easy to do.

This analysis was added after discussions with Atsushi Nakagawa and so is called “Nakagawa’s Bees”.

The analysis does not check residues with multiple conformations.


Previous: GLN and ASN B-factor Outliers, Up: Validation   [Contents][Index]

7.9 Validation Graphs

Coot provides several graphs that are useful for model validation (on a residue by residue basis): residue density fit, geometry distortion, temperature factor variance, peptide distortion and rotamer analysis.

7.9.1 Residue Density Fit

The density fit graph shows the density fit for residues. The score is the average electron density level at the atom centres of the atoms in the residue. The height of the blocks is inversely proportional to the density average.

The residue density fit is by default scaled to a map that is calculated on the absolute scale. Sometimes you might be using a map with density levels considerably different to this, which makes the residue density fit graph less useful. To correct for this you can use the scripting function:

(set-residue-density-fit-scale-factor factor)

where factor would be 1/(4* rmd_{map}) (as a rule of thumb).

(residue-density-fit-scale-factor) returns the current scale factor (default 1.0).

There is also a GUI to this:

Extensions -> Refine… -> Set Density Fit Graph Weight…

7.9.2 Rotamer Analysis

Residue rotamers are scored according to the prior likelihood. Note that when CD1 and CD2 of a PHE residue are exchanged (simply a nomenclature error) this can lead to large red blocks in the graph (apparently due to very unlikely rotamers). There are several other residues that can have nomenclature errors like this. To fix these problems use

(fix-nomenclature-errors imol)

7.9.3 Temperature Factor Variance

This idea is from Eleanor Dodson, who liked to use the standard deviation of a residue’s temperature factors to highlight regions of questionable structure.

Note that Hydrogens are ignored in this analysis.

7.9.4 Peptide Omega Angle Distortion

Some variability of the \omega is to be expected in the peptide bond. But not too much. Anything more than 13 degrees is suspicicous. Unexpected peptide bonds show up red by default. If cis peptides are to be expected, and should not marked as bad, then you can tell this to Coot using:

Edit -> Preferences -> Geometry -> Cis-Peptides -> No


Next: , Previous: Validation, Up: Top   [Contents][Index]

8 Representation


Up: Representation   [Contents][Index]

8.1 Surfaces

Coot uses the surface code from Gruber and Noble (2004).

Coot uses the partial charges of the atoms (the partial_charge field in the _chem_comp_atom block) from the charge dictionary item in the refmac (or other) cif dictionary. However, partial charges are only used under certain conditions

1) the molecule consists of less than 100 atoms

or

2) the number of atoms in the molecule that are hydrogens is at least 15% of the total number of atoms in the molecule

If partial charges are not used, then the fall-back is to use charges from side-chains charged at physiological pH (Arg, Lys, Asp, Glu).


Next: , Previous: Representation, Up: Top   [Contents][Index]

9 Hints and Usage Tips


Next: , Up: Hints and Usage Tips   [Contents][Index]

9.1 Documentation

This manual is on the web where it can be searched:

In the Menu item “About”, under “Online Docs URL...” there is a entry bar that can be used to search the Coot documentation via Google. The results are returned as a web page in web browser. The browser type can be specified as in this example:

(set-browser-interface "firefox")

Example usage can be found in xxx/share/coot/scheme/group-settings.scm


Next: , Previous: Documentation, Up: Hints and Usage Tips   [Contents][Index]

9.2 Low Resolution

Building structures using low resolution data is a pain. We hope to make it less of a pain in future, but there are some things that you can do now.


Next: , Previous: Low Resolution, Up: Hints and Usage Tips   [Contents][Index]

9.3 Coot Droppings

This describes the files and directory that coot leaves behind after it has been fed (sorry, I mean “used”). Everything except the 0-coot.state.scm state file can comfortably be deleted if needed after coot has finished.

You can stop the state and history files being written if you start coot with the --no-guano option.


Next: , Previous: Coot Droppings, Up: Hints and Usage Tips   [Contents][Index]

9.4 Clearing Backups

Coot will occasionally ask you to clear up the coot-backup directory. You can adjust the behaviour in a number of ways:

So, if you wanted to clear out everything more than 1 day old, every time, without Coot asking you about it:

(define *clear-out-backup-run-n-days* 0)
(define *clear-out-backup-old-days* 1)
(define (clear-backups-maybe) 
  (delete-coot-backup-files 'delete)
  (coot-real-exit 0))

Next: , Previous: Clearing Backups, Up: Hints and Usage Tips   [Contents][Index]

9.5 Getting out of “Translate” Mode

If you get stuck in "translate" mode in the GL canvas (i.e. mouse does not rotate the view as you would expect) simply press and release the Ctrl key to return to "rotate" mode.


Next: , Previous: Getting out of ``Translate'' Mode, Up: Hints and Usage Tips   [Contents][Index]

9.6 Getting out of “Continuous Rotation” Mode

The keyboard I key toggles the “continuous rotation” mode. The menu item Draw -> Spin View On/Off does the same thing.


Next: , Previous: Getting out of ``Continuous Rotation'' Mode, Up: Hints and Usage Tips   [Contents][Index]

9.7 Getting out of “Label Atom Only” Mode

Similarly, if you are stuck in a mode where the “Model/Fit/Refine” buttons don’t work (the atoms are not selected, only the atom gets labelled), press and release the Shift key.


Next: , Previous: Label Atom Only Mode, Up: Hints and Usage Tips   [Contents][Index]

9.8 Button Labels

Button labels ending in “…” mean that a new dialog will pop-up when this button is pressed.


Next: , Previous: Button Labels, Up: Hints and Usage Tips   [Contents][Index]

9.9 Picking

Note that left-mouse in the graphics window is used for both atom picking and rotating the view, so try not to click over an atom when trying to rotate the view when in atom selection mode.


Next: , Previous: sec_picking, Up: Hints and Usage Tips   [Contents][Index]

9.10 Resizing View

Click and drag using right-mouse (up and down or left and right) to zoom in and out.


Next: , Previous: Resizing View, Up: Hints and Usage Tips   [Contents][Index]

9.11 Scroll-wheel

To change the map to which the scroll-wheel is attached, use the scroll check button in the Display Manager or use HID -> Scrollwheel -> Attach Scrollwheel to which map?


Previous: Scroll-wheel, Up: Hints and Usage Tips   [Contents][Index]

9.12 Slow Computer Configuration

Several of the parameters of Coot are chosen because they are reasonable on my “middle-ground” development machine. However, these parameters can be tweaked so that slower computers perform better:


Next: , Previous: Hints and Usage Tips, Up: Top   [Contents][Index]

10 Other Programs


Up: Other Programs   [Contents][Index]

10.1 findligand

findligand is a stand-alone command-line program that uses the libraries of Coot.

findligand provides a number of command line arguments for increased flexibility:

One uses findligand like this:

$ findligand various-args ligand-pdb-file-name(s)

i.e. the example ligand pdb files that you wish to search for are given at the end of the command line.


Next: , Previous: Other Programs, Up: Top   [Contents][Index]

11 Scripting Functions


Next: , Up: Scripting Functions   [Contents][Index]

11.1 Startup Functions


Next: , Up: Startup Functions   [Contents][Index]

11.1.1 set-prefer-python

function: set-prefer-python

tell coot that you prefer to run python scripts if/when there is an option to do so.


Previous: set-prefer-python, Up: Startup Functions   [Contents][Index]

11.1.2 prefer-python

function: prefer-python

the python-prefered mode.

This is available so that the scripting functions know whether on not to put themselves onto in as menu items.

If you consider using this, consider in preference use_gui_qm == 2, which is used elsewhere to stop python functions adding to the gui, when guile-gtk functions have alread done so. We should clean up this (rather obscure) interface at some stage.

return 1 for python is prefered, 0 for not.


Next: , Previous: Startup Functions, Up: Scripting Functions   [Contents][Index]

11.2 File System Functions


Next: , Up: File System Functions   [Contents][Index]

11.2.1 make-directory-maybe

function: make-directory-maybe dir

Where dir is a string

make a directory dir (if it doesn’t exist) and return error code

If it can be created, create the directory dir, return the success status like mkdir: mkdir

Returns: zero on success, or -1 if an error occurred. If dir already exists as a directory, return 0 of course.


Next: , Previous: make-directory-maybe, Up: File System Functions   [Contents][Index]

11.2.2 set-show-paths-in-display-manager

function: set-show-paths-in-display-manager i

Where i is an integer number

Show Paths in Display Manager?

Some people don’t like to see the full path names in the display manager here is the way to turn them off, with an argument of 1.


Next: , Previous: set-show-paths-in-display-manager, Up: File System Functions   [Contents][Index]

11.2.3 show-paths-in-display-manager-state

function: show-paths-in-display-manager-state

return the internal state

What is the internal flag?

Returns: 1 for "yes, display paths" , 0 for not


Next: , Previous: show-paths-in-display-manager-state, Up: File System Functions   [Contents][Index]

11.2.4 add-coordinates-glob-extension

function: add-coordinates-glob-extension ext

Where ext is a string

add an extension to be treated as coordinate files


Next: , Previous: add-coordinates-glob-extension, Up: File System Functions   [Contents][Index]

11.2.5 add-data-glob-extension

function: add-data-glob-extension ext

Where ext is a string

add an extension to be treated as data (reflection) files


Next: , Previous: add-data-glob-extension, Up: File System Functions   [Contents][Index]

11.2.6 add-dictionary-glob-extension

function: add-dictionary-glob-extension ext

Where ext is a string

add an extension to be treated as geometry dictionary files


Next: , Previous: add-dictionary-glob-extension, Up: File System Functions   [Contents][Index]

11.2.7 add-map-glob-extension

function: add-map-glob-extension ext

Where ext is a string

add an extension to be treated as geometry map files


Next: , Previous: add-map-glob-extension, Up: File System Functions   [Contents][Index]

11.2.8 remove-coordinates-glob-extension

function: remove-coordinates-glob-extension ext

Where ext is a string

remove an extension to be treated as coordinate files


Next: , Previous: remove-coordinates-glob-extension, Up: File System Functions   [Contents][Index]

11.2.9 remove-data-glob-extension

function: remove-data-glob-extension ext

Where ext is a string

remove an extension to be treated as data (reflection) files


Next: , Previous: remove-data-glob-extension, Up: File System Functions   [Contents][Index]

11.2.10 remove-dictionary-glob-extension

function: remove-dictionary-glob-extension ext

Where ext is a string

remove an extension to be treated as geometry dictionary files


Next: , Previous: remove-dictionary-glob-extension, Up: File System Functions   [Contents][Index]

11.2.11 remove-map-glob-extension

function: remove-map-glob-extension ext

Where ext is a string

remove an extension to be treated as geometry map files


Next: , Previous: remove-map-glob-extension, Up: File System Functions   [Contents][Index]

11.2.12 set-sticky-sort-by-date

function: set-sticky-sort-by-date

sort files in the file selection by date?

some people like to have their files sorted by date by default


Next: , Previous: set-sticky-sort-by-date, Up: File System Functions   [Contents][Index]

11.2.13 unset-sticky-sort-by-date

function: unset-sticky-sort-by-date

do not sort files in the file selection by date?

removes the sorting of files by date


Next: , Previous: unset-sticky-sort-by-date, Up: File System Functions   [Contents][Index]

11.2.14 set-filter-fileselection-filenames

function: set-filter-fileselection-filenames istate

Where istate is an integer number

on opening a file selection dialog, pre-filter the files.

set to 1 to pre-filter, [0 (off, non-pre-filtering) is the default


Next: , Previous: set-filter-fileselection-filenames, Up: File System Functions   [Contents][Index]

11.2.15 filter-fileselection-filenames-state

function: filter-fileselection-filenames-state

, return the state of the above variable


Next: , Previous: filter-fileselection-filenames-state, Up: File System Functions   [Contents][Index]

11.2.16 file-type-coords

function: file-type-coords file_name

Where file_name is a string

is the given file name suitable to be read as coordinates?


Next: , Previous: file-type-coords, Up: File System Functions   [Contents][Index]

11.2.17 open-coords-dialog

function: open-coords-dialog

display the open coordinates dialog


Previous: open-coords-dialog, Up: File System Functions   [Contents][Index]

11.2.18 set-file-chooser-selector

function: set-file-chooser-selector istate

Where istate is an integer number

this flag set chooser as default for windows, otherwise use selector 0 is selector 1 is chooser


Next: , Previous: File System Functions, Up: Scripting Functions   [Contents][Index]

11.3 Widget Utilities


Up: Widget Utilities   [Contents][Index]

11.3.1 set-main-window-title

function: set-main-window-title s

Where s is a string

set the main window title.

function added for Lothar Esser


Next: , Previous: Widget Utilities, Up: Scripting Functions   [Contents][Index]

11.4 MTZ and data handling utilities


Up: MTZ and data handling utilities   [Contents][Index]

11.4.1 manage-column-selector

function: manage-column-selector filename

Where filename is a string

given a filename, try to read it as a data file

We try as .phs and .cif files first


Next: , Previous: MTZ and data handling utilities, Up: Scripting Functions   [Contents][Index]

11.5 Molecule Info Functions


Next: , Up: Molecule Info Functions   [Contents][Index]

11.5.1 chain-n-residues

function: chain-n-residues chain_id imol

Where:

the number of residues in chain chain_id and molecule number imol

Returns: the number of residues


Next: , Previous: chain-n-residues, Up: Molecule Info Functions   [Contents][Index]

11.5.2 molecule-centre-internal

function: molecule-centre-internal imol iaxis

Where:

internal function for molecule centre

Returns: status, less than -9999 is for failure (eg. bad imol);


Next: , Previous: molecule-centre-internal, Up: Molecule Info Functions   [Contents][Index]

11.5.3 seqnum-from-serial-number

function: seqnum-from-serial-number imol chain_id serial_num

Where:

a residue seqnum (normal residue number) from a residue serial number

Returns: < -9999 on failure


Next: , Previous: seqnum-from-serial-number, Up: Molecule Info Functions   [Contents][Index]

11.5.4 insertion-code-from-serial-number

function: insertion-code-from-serial-number imol chain_id serial_num

Where:

the insertion code of the residue.

Returns: NULL (scheme False) on failure.


Next: , Previous: insertion-code-from-serial-number, Up: Molecule Info Functions   [Contents][Index]

11.5.5 chain-id-scm

function: chain-id-scm imol ichain

Where:

the chain_id (string) of the ichain-th chain molecule number imol

Returns: the chain-id


Next: , Previous: chain-id-scm, Up: Molecule Info Functions   [Contents][Index]

11.5.6 n-models

function: n-models imol

Where imol is an integer number

return the number of models in molecule number imol

useful for NMR or other such multi-model molecules.

return the number of models or -1 if there was a problem with the given molecule.


Next: , Previous: n-models, Up: Molecule Info Functions   [Contents][Index]

11.5.7 n-chains

function: n-chains imol

Where imol is an integer number

number of chains in molecule number imol

Returns: the number of chains


Next: , Previous: n-chains, Up: Molecule Info Functions   [Contents][Index]

11.5.8 is-solvent-chain-p

function: is-solvent-chain-p imol chain_id

Where:

is this a solvent chain? [Raw function]

This is a raw interface function, you should generally not use this, but instead use (is-solvent-chain? imol chain-id)

This wraps the mmdb function isSolventChain().

Returns: -1 on error, 0 for no, 1 for is "a solvent chain". We wouldn’t want to be doing rotamer searches and the like on such a chain.


Next: , Previous: is-solvent-chain-p, Up: Molecule Info Functions   [Contents][Index]

11.5.9 is-protein-chain-p

function: is-protein-chain-p imol chain_id

Where:

is this a protein chain? [Raw function]

This is a raw interface function, you should generally not use this, but instead use (is-protein-chain? imol chain-id)

This wraps the mmdb function isAminoacidChain().

Returns: -1 on error, 0 for no, 1 for is "a protein chain". We wouldn’t want to be doing rotamer searches and the like on such a chain.


Next: , Previous: is-protein-chain-p, Up: Molecule Info Functions   [Contents][Index]

11.5.10 is-nucleotide-chain-p

function: is-nucleotide-chain-p imol chain_id

Where:

is this a nucleic acid chain? [Raw function]

This is a raw interface function, you should generally not use this, but instead use (is-nucleicacid-chain? imol chain-id)

This wraps the mmdb function isNucleotideChain(). For completeness.

Returns: -1 on error, 0 for no, 1 for is "a nucleicacid chain". We wouldn’t want to be doing rotamer searches and the like on such a chain.


Next: , Previous: is-nucleotide-chain-p, Up: Molecule Info Functions   [Contents][Index]

11.5.11 n-residues

function: n-residues imol

Where imol is an integer number

return the number of residues in the molecule,

return -1 if this is a map or closed.


Next: , Previous: n-residues, Up: Molecule Info Functions   [Contents][Index]

11.5.12 n-atoms

function: n-atoms imol

Where imol is an integer number

return the atoms of residues in the molecule,

return -1 if this is a map or closed.


Next: , Previous: n-atoms, Up: Molecule Info Functions   [Contents][Index]

11.5.13 remarks-scm

function: remarks-scm imol

Where imol is an integer number

return a list of the remarks of hte molecule number imol


Next: , Previous: remarks-scm, Up: Molecule Info Functions   [Contents][Index]

11.5.14 sort-chains

function: sort-chains imol

Where imol is an integer number

sort the chain ids of the imol-th molecule in lexographical order


Next: , Previous: sort-chains, Up: Molecule Info Functions   [Contents][Index]

11.5.15 sort-residues

function: sort-residues imol

Where imol is an integer number

sort the residues of the imol-th molecule


Next: , Previous: sort-residues, Up: Molecule Info Functions   [Contents][Index]

11.5.16 remarks-dialog

function: remarks-dialog imol

Where imol is an integer number

a gui dialog showing remarks header info (for a model molecule).


Next: , Previous: remarks-dialog, Up: Molecule Info Functions   [Contents][Index]

11.5.17 print-header-secondary-structure-info

function: print-header-secondary-structure-info imol

Where imol is an integer number

simply print secondary structure info to the terminal/console. In future, this could/should return the info.


Next: , Previous: print-header-secondary-structure-info, Up: Molecule Info Functions   [Contents][Index]

11.5.18 add-header-secondary-structure-info

function: add-header-secondary-structure-info imol

Where imol is an integer number

add secondary structure info to the internal representation of the model


Next: , Previous: add-header-secondary-structure-info, Up: Molecule Info Functions   [Contents][Index]

11.5.19 copy-molecule

function: copy-molecule imol

Where imol is an integer number

copy molecule imol

Returns: the new molecule number. Return -1 on failure to copy molecule (out of range, or molecule is closed)


Next: , Previous: copy-molecule, Up: Molecule Info Functions   [Contents][Index]

11.5.20 add-ligand-delete-residue-copy-molecule

function: add-ligand-delete-residue-copy-molecule imol_ligand_new chain_id_ligand_new resno_ligand_new imol_current chain_id_ligand_current resno_ligand_current

Where:

Copy a molecule with addition of a ligand and a deletion of current ligand.

This function is used when adding a new (modified) ligand to a structure. It creates a new molecule that is a copy of the current molecule except that the new ligand is added and the current ligand/residue is deleted.


Next: , Previous: add-ligand-delete-residue-copy-molecule, Up: Molecule Info Functions   [Contents][Index]

11.5.21 exchange-chain-ids-for-seg-ids

function: exchange-chain-ids-for-seg-ids imol

Where imol is an integer number

Experimental interface for Ribosome People.

Ribosome People have many chains in their pdb file, they prefer segids to chainids (chainids are only 1 character). But coot uses the concept of chain ids and not seg-ids. mmdb allow us to use more than one char in the chainid, so after we read in a pdb, let’s replace the chain ids with the segids. Will that help?


Previous: exchange-chain-ids-for-seg-ids, Up: Molecule Info Functions   [Contents][Index]

11.5.22 show-remarks-browswer

function: show-remarks-browswer

show the remarks browser


Next: , Previous: Molecule Info Functions, Up: Scripting Functions   [Contents][Index]

11.6 Library and Utility Functions


Next: , Up: Library and Utility Functions   [Contents][Index]

11.6.1 git-revision-count

function: git-revision-count

return the git revision count for for this build.


Next: , Previous: git-revision-count, Up: Library and Utility Functions   [Contents][Index]

11.6.2 svn-revision

function: svn-revision

an alias to git_revision_count() for backwards compatibility


Next: , Previous: svn-revision, Up: Library and Utility Functions   [Contents][Index]

11.6.3 molecule-name

function: molecule-name imol

Where imol is an integer number

return the name of molecule number imol

Returns: 0 if not a valid name ( -> False in scheme) e.g. "/a/b/c.pdb" for "d/e/f.mtz FWT PHWT"


Next: , Previous: molecule-name, Up: Library and Utility Functions   [Contents][Index]

11.6.4 molecule-name-stub-scm

function: molecule-name-stub-scm imol include_path_flag

Where:

return the molecule name without file extension


Next: , Previous: molecule-name-stub-scm, Up: Library and Utility Functions   [Contents][Index]

11.6.5 molecule-name-stub-py

function: molecule-name-stub-py imol include_path_flag

Where:

return the molecule name without file extension


Next: , Previous: molecule-name-stub-py, Up: Library and Utility Functions   [Contents][Index]

11.6.6 set-molecule-name

function: set-molecule-name imol new_name

Where:

set the molecule name of the imol-th molecule


Next: , Previous: set-molecule-name, Up: Library and Utility Functions   [Contents][Index]

11.6.7 coot-real-exit

function: coot-real-exit retval

Where retval is an integer number

exit from coot, give return value retval back to invoking process.


Next: , Previous: coot-real-exit, Up: Library and Utility Functions   [Contents][Index]

11.6.8 coot-no-state-real-exit

function: coot-no-state-real-exit retval

Where retval is an integer number

exit without writing a state file


Next: , Previous: coot-no-state-real-exit, Up: Library and Utility Functions   [Contents][Index]

11.6.9 coot-clear-backup-or-real-exit

function: coot-clear-backup-or-real-exit retval

Where retval is an integer number

exit coot doing clear-backup maybe


Next: , Previous: coot-clear-backup-or-real-exit, Up: Library and Utility Functions   [Contents][Index]

11.6.10 coot-save-state-and-exit

function: coot-save-state-and-exit retval save_state_flag

Where:

exit coot, write a state file


Next: , Previous: coot-save-state-and-exit, Up: Library and Utility Functions   [Contents][Index]

11.6.11 run-clear-backups

function: run-clear-backups retval

Where retval is an integer number

run clear-backups


Next: , Previous: run-clear-backups, Up: Library and Utility Functions   [Contents][Index]

11.6.12 first-coords-imol

function: first-coords-imol

What is the molecule number of first coordinates molecule?

return -1 when there is none.


Next: , Previous: first-coords-imol, Up: Library and Utility Functions   [Contents][Index]

11.6.13 first-small-coords-imol

function: first-small-coords-imol

molecule number of first small (<400 atoms) molecule.

return -1 on no such molecule


Next: , Previous: first-small-coords-imol, Up: Library and Utility Functions   [Contents][Index]

11.6.14 first-unsaved-coords-imol

function: first-unsaved-coords-imol

What is the molecule number of first unsaved coordinates molecule?

return -1 when there is none.


Previous: first-unsaved-coords-imol, Up: Library and Utility Functions   [Contents][Index]

11.6.15 mmcif-sfs-to-mtz

function: mmcif-sfs-to-mtz cif_file_name mtz_file_name

Where:

convert the structure factors in cif_file_name to an mtz file.

Return 1 on success. Return 0 on a file without Rfree, return -1 on complete failure to write a file.


Next: , Previous: Library and Utility Functions, Up: Scripting Functions   [Contents][Index]

11.7 Graphics Utility Functions


Next: , Up: Graphics Utility Functions   [Contents][Index]

11.7.1 set-do-anti-aliasing

function: set-do-anti-aliasing state

Where state is an integer number

set the bond lines to be antialiased


Next: , Previous: set-do-anti-aliasing, Up: Graphics Utility Functions   [Contents][Index]

11.7.2 do-anti-aliasing-state

function: do-anti-aliasing-state

return the flag for antialiasing the bond lines


Next: , Previous: do-anti-aliasing-state, Up: Graphics Utility Functions   [Contents][Index]

11.7.3 set-do-GL-lighting

function: set-do-GL-lighting state

Where state is an integer number

turn the GL lighting on (state = 1) or off (state = 0)

slows down the display of simple lines


Next: , Previous: set-do-GL-lighting, Up: Graphics Utility Functions   [Contents][Index]

11.7.4 do-GL-lighting-state

function: do-GL-lighting-state

return the flag for GL lighting


Next: , Previous: do-GL-lighting-state, Up: Graphics Utility Functions   [Contents][Index]

11.7.5 use-graphics-interface-state

function: use-graphics-interface-state

shall we start up the Gtk and the graphics window?

if passed the command line argument

no-graphics, coot will not start up gtk itself.

An interface function for Ralf.


Next: , Previous: use-graphics-interface-state, Up: Graphics Utility Functions   [Contents][Index]

11.7.6 python-at-prompt-at-startup-state

function: python-at-prompt-at-startup-state

is the python interpreter at the prompt?

Returns: 1 for yes, 0 for no.


Next: , Previous: python-at-prompt-at-startup-state, Up: Graphics Utility Functions   [Contents][Index]

11.7.7 start-graphics-interface

function: start-graphics-interface

start Gtk (and graphics)

This function is useful if it was not started already (which can be achieved by using the command line argument

no-graphics).

An interface for Ralf


Next: , Previous: start-graphics-interface, Up: Graphics Utility Functions   [Contents][Index]

11.7.8 reset-view

function: reset-view

"Reset" the view

return 1 if we moved, else return 0.

centre on last-read molecule with zoom 100. If we are there, then go to the previous molecule, if we are there, then go to the origin.


Next: , Previous: reset-view, Up: Graphics Utility Functions   [Contents][Index]

11.7.9 graphics-n-molecules

function: graphics-n-molecules

return the number of molecules (coordinates molecules and map molecules combined) that are currently in coot

Returns: the number of molecules (closed molecules are not counted)


Next: , Previous: graphics-n-molecules, Up: Graphics Utility Functions   [Contents][Index]

11.7.10 toggle-idle-spin-function

function: toggle-idle-spin-function

Spin spin spin (or not)


Next: , Previous: toggle-idle-spin-function, Up: Graphics Utility Functions   [Contents][Index]

11.7.11 toggle-idle-rock-function

function: toggle-idle-rock-function

Rock (not roll) (self-timed)


Next: , Previous: toggle-idle-rock-function, Up: Graphics Utility Functions   [Contents][Index]

11.7.12 set-rocking-factors

function: set-rocking-factors width_scale frequency_scale

Where:

Settings for the inevitable discontents who dislike the default rocking rates (defaults 1 and 1)


Next: , Previous: set-rocking-factors, Up: Graphics Utility Functions   [Contents][Index]

11.7.13 set-idle-function-rotate-angle

function: set-idle-function-rotate-angle f

Where f is a number

how far should we rotate when (auto) spinning? Fast computer? set this to 0.1


Next: , Previous: set-idle-function-rotate-angle, Up: Graphics Utility Functions   [Contents][Index]

11.7.14 idle-function-rotate-angle

function: idle-function-rotate-angle

what is the idle function rotation angle?


Next: , Previous: idle-function-rotate-angle, Up: Graphics Utility Functions   [Contents][Index]

11.7.15 handle-read-draw-molecule

function: handle-read-draw-molecule filename

Where filename is a string

a synonym for read-pdb. Read the coordinates from filename (can be pdb, cif or shelx format)


Next: , Previous: handle-read-draw-molecule, Up: Graphics Utility Functions   [Contents][Index]

11.7.16 make-updating-model-molecule

function: make-updating-model-molecule filename

Where filename is a string

make a model molecule from the give file name.

If the file updates, then the model will be updated.


Next: , Previous: make-updating-model-molecule, Up: Graphics Utility Functions   [Contents][Index]

11.7.17 allow-duplicate-sequence-numbers

function: allow-duplicate-sequence-numbers

enable reading PDB/pdbx files with duplicate sequence numbers


Next: , Previous: allow-duplicate-sequence-numbers, Up: Graphics Utility Functions   [Contents][Index]

11.7.18 set-convert-to-v2-atom-names

function: set-convert-to-v2-atom-names state

Where state is an integer number

shall we convert nucleotides to match the old dictionary names?

Usually (after 2006 or so) we do not want to do this (given current Coot architecture). Coot should handle the residue synonyms transparently.

default off (0).


Next: , Previous: set-convert-to-v2-atom-names, Up: Graphics Utility Functions   [Contents][Index]

11.7.19 handle-read-draw-molecule-with-recentre

function: handle-read-draw-molecule-with-recentre filename recentre_on_read_pdb_flag

Where:

read coordinates from filename with option to not recentre.

set recentre_on_read_pdb_flag to 0 if you don’t want the view to recentre on the new coordinates.


Next: , Previous: handle-read-draw-molecule-with-recentre, Up: Graphics Utility Functions   [Contents][Index]

11.7.20 handle-read-draw-molecule-and-move-molecule-here

function: handle-read-draw-molecule-and-move-molecule-here filename

Where filename is a string

read coordinates from filename and recentre the new molecule at the screen rotation centre.


Next: , Previous: handle-read-draw-molecule-and-move-molecule-here, Up: Graphics Utility Functions   [Contents][Index]

11.7.21 read-pdb

function: read-pdb filename

Where filename is a string

read coordinates from filename


Next: , Previous: read-pdb, Up: Graphics Utility Functions   [Contents][Index]

11.7.22 assign-hetatms

function: assign-hetatms imol

Where imol is an integer number

some programs produce PDB files with ATOMs where there should be HETATMs. This is a function to assign HETATMs as per the PDB definition.


Next: , Previous: assign-hetatms, Up: Graphics Utility Functions   [Contents][Index]

11.7.23 hetify-residue

function: hetify-residue imol chain_id resno ins_code

Where:

if this is not a standard group, then turn the atoms to HETATMs.

Return 1 on atoms changes, 0 on not. Return -1 if residue not found.


Next: , Previous: hetify-residue, Up: Graphics Utility Functions   [Contents][Index]

11.7.24 residue-has-hetatms

function: residue-has-hetatms imol chain_id resno ins_code

Where:

residue has HETATMs?

return 1 if all atoms of the specified residue are HETATMs, else, return 0. If residue not found, return -1.


Next: , Previous: residue-has-hetatms, Up: Graphics Utility Functions   [Contents][Index]

11.7.25 het-group-residues-scm

function: het-group-residues-scm imol

Where imol is an integer number

get the specs for hetgroups - waters are not counted as het-groups.


Next: , Previous: het-group-residues-scm, Up: Graphics Utility Functions   [Contents][Index]

11.7.26 het-group-residues-py

function: het-group-residues-py imol

Where imol is an integer number

get the specs for hetgroups - waters are not counted as het-groups.


Next: , Previous: het-group-residues-py, Up: Graphics Utility Functions   [Contents][Index]

11.7.27 het-group-n-atoms

function: het-group-n-atoms comp_id

Where comp_id is a string

return the number of non-hydrogen atoms in the given het-group (comp-id).

Return -1 on comp-id not found in dictionary.


Next: , Previous: het-group-n-atoms, Up: Graphics Utility Functions   [Contents][Index]

11.7.28 replace-fragment

function: replace-fragment imol_target imol_fragment atom_selection

Where:

replace the parts of molecule number imol that are duplicated in molecule number imol_frag


Next: , Previous: replace-fragment, Up: Graphics Utility Functions   [Contents][Index]

11.7.29 copy-residue-range

function: copy-residue-range imol_target chain_id_target imol_reference chain_id_reference resno_range_start resno_range_end

Where:

copy the given residue range from the reference chain to the target chain

resno_range_start and resno_range_end are inclusive.


Next: , Previous: copy-residue-range, Up: Graphics Utility Functions   [Contents][Index]

11.7.30 replace-residues-from-mol-scm

function: replace-residues-from-mol-scm imol_target imol_ref residue_specs_list_ref_scm

Where:

replace the given residues from the reference molecule to the target molecule


Next: , Previous: replace-residues-from-mol-scm, Up: Graphics Utility Functions   [Contents][Index]

11.7.31 clear-and-update-model-molecule-from-file

function: clear-and-update-model-molecule-from-file molecule_number file_name

Where:

replace pdb. Fail if molecule_number is not a valid model molecule. Return -1 on failure. Else return molecule_number


Next: , Previous: clear-and-update-model-molecule-from-file, Up: Graphics Utility Functions   [Contents][Index]

11.7.32 screendump-image

function: screendump-image filename

Where filename is a string

dump the current screen image to a file. Format ppm

You can use this, in conjunction with spinning and view moving functions to make movies


Next: , Previous: screendump-image, Up: Graphics Utility Functions   [Contents][Index]

11.7.33 check-for-dark-blue-density

function: check-for-dark-blue-density

give a warning dialog if density it too dark (blue)


Next: , Previous: check-for-dark-blue-density, Up: Graphics Utility Functions   [Contents][Index]

11.7.34 set-draw-solid-density-surface

function: set-draw-solid-density-surface imol state

Where:

sets the density map of the given molecule to be drawn as a (transparent) solid surface.


Next: , Previous: set-draw-solid-density-surface, Up: Graphics Utility Functions   [Contents][Index]

11.7.35 set-draw-map-standard-lines

function: set-draw-map-standard-lines imol state

Where:

toggle for standard lines representation of map.

This turns off/on standard lines representation of map. transparent surface is another representation type.

If you want to just turn off a map, don’t use this, use

.


Next: , Previous: set-draw-map-standard-lines, Up: Graphics Utility Functions   [Contents][Index]

11.7.36 set-solid-density-surface-opacity

function: set-solid-density-surface-opacity imol opacity

Where:

set the opacity of density surface representation of the given map.

0.0 is totally transparent, 1.0 is completely opaque and (because the objects are no longer depth sorted) considerably faster to render. 0.3 is a reasonable number.


Previous: set-solid-density-surface-opacity, Up: Graphics Utility Functions   [Contents][Index]

11.7.37 set-flat-shading-for-solid-density-surface

function: set-flat-shading-for-solid-density-surface state

Where state is an integer number

set the flag to do flat shading rather than smooth shading for solid density surface.

Default is 1 (on.


Next: , Previous: Graphics Utility Functions, Up: Scripting Functions   [Contents][Index]

11.8 Interface Preferences


Next: , Up: Interface Preferences   [Contents][Index]

11.8.1 set-scroll-by-wheel-mouse

function: set-scroll-by-wheel-mouse istate

Where istate is an integer number

Some people (like Phil Evans) don’t want to scroll their map with the mouse-wheel.

To turn off mouse wheel recontouring call this with istate value of 0


Next: , Previous: set-scroll-by-wheel-mouse, Up: Interface Preferences   [Contents][Index]

11.8.2 scroll-by-wheel-mouse-state

function: scroll-by-wheel-mouse-state

return the internal state of the scroll-wheel map contouring


Next: , Previous: scroll-by-wheel-mouse-state, Up: Interface Preferences   [Contents][Index]

11.8.3 set-auto-recontour-map

function: set-auto-recontour-map state

Where state is an integer number

turn off (0) or on (1) auto recontouring (on screen centre change) (default it on)


Next: , Previous: set-auto-recontour-map, Up: Interface Preferences   [Contents][Index]

11.8.4 get-auto-recontour-map

function: get-auto-recontour-map

return the auto-recontour state


Next: , Previous: get-auto-recontour-map, Up: Interface Preferences   [Contents][Index]

11.8.5 set-default-initial-contour-level-for-map

function: set-default-initial-contour-level-for-map n_sigma

Where n_sigma is a number

set the default inital contour for 2FoFc-style map

in sigma


Next: , Previous: set-default-initial-contour-level-for-map, Up: Interface Preferences   [Contents][Index]

11.8.6 set-default-initial-contour-level-for-difference-map

function: set-default-initial-contour-level-for-difference-map n_sigma

Where n_sigma is a number

set the default inital contour for FoFc-style map

in sigma


Next: , Previous: set-default-initial-contour-level-for-difference-map, Up: Interface Preferences   [Contents][Index]

11.8.7 print-view-matrix

function: print-view-matrix

print the view matrix to the console, useful for molscript, perhaps


Next: , Previous: print-view-matrix, Up: Interface Preferences   [Contents][Index]

11.8.8 get-view-quaternion-internal

function: get-view-quaternion-internal element

Where element is an integer number

internal function to get an element of the view quaternion. The whole quaternion is returned by the scheme function view-quaternion


Next: , Previous: get-view-quaternion-internal, Up: Interface Preferences   [Contents][Index]

11.8.9 set-view-quaternion

function: set-view-quaternion i j k l

Where:

Set the view quaternion.


Next: , Previous: set-view-quaternion, Up: Interface Preferences   [Contents][Index]

11.8.10 apply-ncs-to-view-orientation

function: apply-ncs-to-view-orientation imol current_chain next_ncs_chain

Where:

Given that we are in chain current_chain, apply the NCS operator that maps current_chain on to next_ncs_chain, so that the relative view is preserved. For NCS skipping.


Next: , Previous: apply-ncs-to-view-orientation, Up: Interface Preferences   [Contents][Index]

11.8.11 apply-ncs-to-view-orientation-and-screen-centre

function: apply-ncs-to-view-orientation-and-screen-centre imol current_chain next_ncs_chain forward_flag

Where:

as above, but shift the screen centre also.


Next: , Previous: apply-ncs-to-view-orientation-and-screen-centre, Up: Interface Preferences   [Contents][Index]

11.8.12 set-fps-flag

function: set-fps-flag t

Where t is an integer number

set show frame-per-second flag


Next: , Previous: set-fps-flag, Up: Interface Preferences   [Contents][Index]

11.8.13 get-fps-flag

function: get-fps-flag

set the state of show frames-per-second flag


Next: , Previous: get-fps-flag, Up: Interface Preferences   [Contents][Index]

11.8.14 set-show-origin-marker

function: set-show-origin-marker istate

Where istate is an integer number

set a flag: is the origin marker to be shown? 1 for yes, 0 for no.


Next: , Previous: set-show-origin-marker, Up: Interface Preferences   [Contents][Index]

11.8.15 show-origin-marker-state

function: show-origin-marker-state

return the origin marker shown? state


Next: , Previous: show-origin-marker-state, Up: Interface Preferences   [Contents][Index]

11.8.16 hide-modelling-toolbar

function: hide-modelling-toolbar

hide the vertical modelling toolbar in the GTK2 version


Next: , Previous: hide-modelling-toolbar, Up: Interface Preferences   [Contents][Index]

11.8.17 show-modelling-toolbar

function: show-modelling-toolbar

show the vertical modelling toolbar in the GTK2 version (the toolbar is shown by default)


Next: , Previous: show-modelling-toolbar, Up: Interface Preferences   [Contents][Index]

11.8.18 hide-main-toolbar

function: hide-main-toolbar

hide the horizontal main toolbar in the GTK2 version


Next: , Previous: hide-main-toolbar, Up: Interface Preferences   [Contents][Index]

11.8.19 show-main-toolbar

function: show-main-toolbar

show the horizontal main toolbar in the GTK2 version (the toolbar is shown by default)


Next: , Previous: show-main-toolbar, Up: Interface Preferences   [Contents][Index]

11.8.20 show-model-toolbar-all-icons

function: show-model-toolbar-all-icons

show all available icons in the modelling toolbar (same as MFR dialog)


Next: , Previous: show-model-toolbar-all-icons, Up: Interface Preferences   [Contents][Index]

11.8.21 show-model-toolbar-main-icons

function: show-model-toolbar-main-icons

show only a selection of icons in the modelling toolbar


Next: , Previous: show-model-toolbar-main-icons, Up: Interface Preferences   [Contents][Index]

11.8.22 reattach-modelling-toolbar

function: reattach-modelling-toolbar

reattach the modelling toolbar to the last attached position


Next: , Previous: reattach-modelling-toolbar, Up: Interface Preferences   [Contents][Index]

11.8.23 set-model-toolbar-docked-position

function: set-model-toolbar-docked-position state

Where state is an integer number

to swap sides of the Model/Fit/Refine toolbar 0 (default) is right, 1 is left, 2 is top, 3 is bottom


Next: , Previous: set-model-toolbar-docked-position, Up: Interface Preferences   [Contents][Index]

11.8.24 suck-model-fit-dialog

function: suck-model-fit-dialog

reparent the Model/Fit/Refine dialog so that it becomes part of the main window, next to the GL graphics context


Next: , Previous: suck-model-fit-dialog, Up: Interface Preferences   [Contents][Index]

11.8.25 add-status-bar-text

function: add-status-bar-text s

Where s is a string

Put text s into the status bar.

use this to put info for the user in the statusbar (less intrusive than popup).


Next: , Previous: add-status-bar-text, Up: Interface Preferences   [Contents][Index]

11.8.26 set-model-fit-refine-dialog-stays-on-top

function: set-model-fit-refine-dialog-stays-on-top istate

Where istate is an integer number

model-fit-refine dialog stays on top


Next: , Previous: set-model-fit-refine-dialog-stays-on-top, Up: Interface Preferences   [Contents][Index]

11.8.27 model-fit-refine-dialog-stays-on-top-state

function: model-fit-refine-dialog-stays-on-top-state

return the state model-fit-refine dialog stays on top


Next: , Previous: model-fit-refine-dialog-stays-on-top-state, Up: Interface Preferences   [Contents][Index]

11.8.28 accept-reject-dialog-docked-state

function: accept-reject-dialog-docked-state

the accept/reject dialog docked state


Next: , Previous: accept-reject-dialog-docked-state, Up: Interface Preferences   [Contents][Index]

11.8.29 set-accept-reject-dialog-docked-show

function: set-accept-reject-dialog-docked-show state

Where state is an integer number

set the accept/reject dialog docked show state


Previous: set-accept-reject-dialog-docked-show, Up: Interface Preferences   [Contents][Index]

11.8.30 accept-reject-dialog-docked-show-state

function: accept-reject-dialog-docked-show-state

what is the accept/reject dialog docked show state?


Next: , Previous: Interface Preferences, Up: Scripting Functions   [Contents][Index]

11.9 Mouse Buttons


Next: , Up: Mouse Buttons   [Contents][Index]

11.9.1 quanta-buttons

function: quanta-buttons

quanta-like buttons

Note, when you have set these, there is no way to turn them of again (other than restarting).


Next: , Previous: quanta-buttons, Up: Mouse Buttons   [Contents][Index]

11.9.2 quanta-like-zoom

function: quanta-like-zoom

quanta-like zoom buttons

Note, when you have set these, there is no way to turn them of again (other than restarting).


Next: , Previous: quanta-like-zoom, Up: Mouse Buttons   [Contents][Index]

11.9.3 set-control-key-for-rotate

function: set-control-key-for-rotate state

Where state is an integer number

Alternate mode for rotation.

Prefered by some, including Dirk Kostrewa. I don’t think this mode works properly yet


Next: , Previous: set-control-key-for-rotate, Up: Mouse Buttons   [Contents][Index]

11.9.4 control-key-for-rotate-state

function: control-key-for-rotate-state

return the control key rotate state


Next: , Previous: control-key-for-rotate-state, Up: Mouse Buttons   [Contents][Index]

11.9.5 blob-under-pointer-to-screen-centre

function: blob-under-pointer-to-screen-centre

Put the blob under the cursor to the screen centre. Check only positive blobs. Useful function if bound to a key.

The refinement map must be set. (We can’t check all maps because they are not (or may not be) on the same scale).

Returns: 1 if successfully found a blob and moved there. return 0 if no move.


Next: , Previous: blob-under-pointer-to-screen-centre, Up: Mouse Buttons   [Contents][Index]

11.9.6 select-atom-under-pointer-scm

function: select-atom-under-pointer-scm

return scheme false or a list of molecule number and an atom spec


Previous: select-atom-under-pointer-scm, Up: Mouse Buttons   [Contents][Index]

11.9.7 select-atom-under-pointer-py

function: select-atom-under-pointer-py

return Python false or a list of molecule number and an atom spec


Next: , Previous: Mouse Buttons, Up: Scripting Functions   [Contents][Index]

11.10 Cursor Function


Next: , Up: Cursor Function   [Contents][Index]

11.10.1 normal-cursor

function: normal-cursor

normal cursor


Next: , Previous: normal-cursor, Up: Cursor Function   [Contents][Index]

11.10.2 fleur-cursor

function: fleur-cursor

fleur cursor


Next: , Previous: fleur-cursor, Up: Cursor Function   [Contents][Index]

11.10.3 pick-cursor-maybe

function: pick-cursor-maybe

pick cursor maybe


Next: , Previous: pick-cursor-maybe, Up: Cursor Function   [Contents][Index]

11.10.4 rotate-cursor

function: rotate-cursor

rotate cursor


Previous: rotate-cursor, Up: Cursor Function   [Contents][Index]

11.10.5 set-pick-cursor-index

function: set-pick-cursor-index icursor_index

Where icursor_index is an integer number

let the user have a different pick cursor

sometimes (the default) GDK_CROSSHAIR is hard to see, let the user set their own


Next: , Previous: Cursor Function, Up: Scripting Functions   [Contents][Index]

11.11 Model/Fit/Refine Functions


Next: , Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.1 post-model-fit-refine-dialog

function: post-model-fit-refine-dialog

display the Model/Fit/Refine dialog


Next: , Previous: post-model-fit-refine-dialog, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.2 unset-model-fit-refine-dialog

function: unset-model-fit-refine-dialog

unset model/fit/refine dialog


Next: , Previous: unset-model-fit-refine-dialog, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.3 unset-refine-params-dialog

function: unset-refine-params-dialog

unset refine params dialog


Next: , Previous: unset-refine-params-dialog, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.4 show-select-map-dialog

function: show-select-map-dialog

display the Display Manager dialog


Next: , Previous: show-select-map-dialog, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.5 set-model-fit-refine-rotate-translate-zone-label

function: set-model-fit-refine-rotate-translate-zone-label txt

Where txt is a string

Allow the changing of Model/Fit/Refine button label from "Rotate/Translate Zone".


Next: , Previous: set-model-fit-refine-rotate-translate-zone-label, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.6 set-model-fit-refine-place-atom-at-pointer-label

function: set-model-fit-refine-place-atom-at-pointer-label txt

Where txt is a string

Allow the changing of Model/Fit/Refine button label from "Place Atom at Pointer".


Next: , Previous: set-model-fit-refine-place-atom-at-pointer-label, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.7 post-other-modelling-tools-dialog

function: post-other-modelling-tools-dialog

display the Other Modelling Tools dialog


Next: , Previous: post-other-modelling-tools-dialog, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.8 set-refinement-move-atoms-with-zero-occupancy

function: set-refinement-move-atoms-with-zero-occupancy state

Where state is an integer number

shall atoms with zero occupancy be moved when refining? (default 1, yes)


Previous: set-refinement-move-atoms-with-zero-occupancy, Up: Model/Fit/Refine Functions   [Contents][Index]

11.11.9 refinement-move-atoms-with-zero-occupancy-state

function: refinement-move-atoms-with-zero-occupancy-state

return the state of "shall atoms with zero occupancy be moved when refining?"


Next: , Previous: Model/Fit/Refine Functions, Up: Scripting Functions   [Contents][Index]

11.12 Backup Functions


Next: , Up: Backup Functions   [Contents][Index]

11.12.1 make-backup

function: make-backup imol

Where imol is an integer number

make backup for molecule number imol


Next: , Previous: make-backup, Up: Backup Functions   [Contents][Index]

11.12.2 turn-off-backup

function: turn-off-backup imol

Where imol is an integer number

turn off backups for molecule number imol


Next: , Previous: turn-off-backup, Up: Backup Functions   [Contents][Index]

11.12.3 turn-on-backup

function: turn-on-backup imol

Where imol is an integer number

turn on backups for molecule number imol


Next: , Previous: turn-on-backup, Up: Backup Functions   [Contents][Index]

11.12.4 backup-state

function: backup-state imol

Where imol is an integer number

return the backup state for molecule number imol

return 0 for backups off, 1 for backups on, -1 for unknown


Next: , Previous: backup-state, Up: Backup Functions   [Contents][Index]

11.12.5 apply-undo

function: apply-undo

apply undo - the "Undo" button callback


Next: , Previous: apply-undo, Up: Backup Functions   [Contents][Index]

11.12.6 apply-redo

function: apply-redo

apply redo - the "Redo" button callback


Next: , Previous: apply-redo, Up: Backup Functions   [Contents][Index]

11.12.7 set-have-unsaved-changes

function: set-have-unsaved-changes imol

Where imol is an integer number

set the molecule number imol to be marked as having unsaved changes


Next: , Previous: set-have-unsaved-changes, Up: Backup Functions   [Contents][Index]

11.12.8 have-unsaved-changes-p

function: have-unsaved-changes-p imol

Where imol is an integer number

does molecule number imol have unsaved changes?

Returns: -1 on bad imol, 0 on no unsaved changes, 1 on has unsaved changes


Next: , Previous: have-unsaved-changes-p, Up: Backup Functions   [Contents][Index]

11.12.9 set-undo-molecule

function: set-undo-molecule imol

Where imol is an integer number

set the molecule to which undo operations are done to molecule number imol


Next: , Previous: set-undo-molecule, Up: Backup Functions   [Contents][Index]

11.12.10 show-set-undo-molecule-chooser

function: show-set-undo-molecule-chooser

show the Undo Molecule chooser - i.e. choose the molecule to which the "Undo" button applies.


Next: , Previous: show-set-undo-molecule-chooser, Up: Backup Functions   [Contents][Index]

11.12.11 set-unpathed-backup-file-names

function: set-unpathed-backup-file-names state

Where state is an integer number

set the state for adding paths to backup file names

by default directories names are added into the filename for backup (with / to _ mapping). call this with state=1 to turn off directory names


Next: , Previous: set-unpathed-backup-file-names, Up: Backup Functions   [Contents][Index]

11.12.12 unpathed-backup-file-names-state

function: unpathed-backup-file-names-state

return the state for adding paths to backup file names


Next: , Previous: unpathed-backup-file-names-state, Up: Backup Functions   [Contents][Index]

11.12.13 set-decoloned-backup-file-names

function: set-decoloned-backup-file-names state

Where state is an integer number

set the state for adding paths to backup file names

by default directories names are added into the filename for backup (with / to _ mapping). call this with state=1 to turn off directory names


Next: , Previous: set-decoloned-backup-file-names, Up: Backup Functions   [Contents][Index]

11.12.14 decoloned-backup-file-names-state

function: decoloned-backup-file-names-state

return the state for adding paths to backup file names


Next: , Previous: decoloned-backup-file-names-state, Up: Backup Functions   [Contents][Index]

11.12.15 backup-compress-files-state

function: backup-compress-files-state

return the state for compression of backup files


Previous: backup-compress-files-state, Up: Backup Functions   [Contents][Index]

11.12.16 set-backup-compress-files

function: set-backup-compress-files state

Where state is an integer number

set if backup files will be compressed or not using gzip


Next: , Previous: Backup Functions, Up: Scripting Functions   [Contents][Index]

11.13 Recover Session Function


Up: Recover Session Function   [Contents][Index]

11.13.1 recover-session

function: recover-session

recover session

After a crash, we provide this convenient interface to restore the session. It runs through all the molecules with models and looks at the coot backup directory looking for related backup files that are more recent that the read file. (Not very good, because you need to remember which files you read in before the crash - should be improved.)


Next: , Previous: Recover Session Function, Up: Scripting Functions   [Contents][Index]

11.14 Map Functions


Next: , Up: Map Functions   [Contents][Index]

11.14.1 calc-phases-generic

function: calc-phases-generic mtz_file_name

Where mtz_file_name is a string

fire up a GUI, which asks us which model molecule we want to calc phases from. On "OK" button there, we call map_from_mtz_by_refmac_calc_phases()


Next: , Previous: calc-phases-generic, Up: Map Functions   [Contents][Index]

11.14.2 map-from-mtz-by-refmac-calc-phases

function: map-from-mtz-by-refmac-calc-phases mtz_file_name f_col sigf_col imol_coords

Where:

Calculate SFs (using refmac optionally) from an MTZ file and generate a map. Get F and SIGF automatically (first of their type) from the mtz file.

Returns: the new molecule number, -1 on a problem.


Next: , Previous: map-from-mtz-by-refmac-calc-phases, Up: Map Functions   [Contents][Index]

11.14.3 map-from-mtz-by-calc-phases

function: map-from-mtz-by-calc-phases mtz_file_name f_col sigf_col imol_coords

Where:

Calculate SFs from an MTZ file and generate a map.

Returns: the new molecule number.


Next: , Previous: map-from-mtz-by-calc-phases, Up: Map Functions   [Contents][Index]

11.14.4 sfcalc-genmap

function: sfcalc-genmap imol_model imol_map_with_data_attached imol_updating_difference_map

Where:

Calculate structure factors from the model and update the given difference map accordingly.


Next: , Previous: sfcalc-genmap, Up: Map Functions   [Contents][Index]

11.14.5 set-auto-updating-sfcalc-genmap

function: set-auto-updating-sfcalc-genmap imol_model imol_map_with_data_attached imol_updating_difference_map

Where:

As above, calculate structure factors from the model and update the given difference map accordingly - but difference map gets updated automatically on modification of the imol_model molecule.


Next: , Previous: set-auto-updating-sfcalc-genmap, Up: Map Functions   [Contents][Index]

11.14.6 set-scroll-wheel-map

function: set-scroll-wheel-map imap

Where imap is an integer number

set the map that is moved by changing the scroll wheel and change_contour_level().


Next: , Previous: set-scroll-wheel-map, Up: Map Functions   [Contents][Index]

11.14.7 set-scrollable-map

function: set-scrollable-map imol

Where imol is an integer number

return the molecule number to which the mouse scroll wheel is attached

set the map that has its contour level changed by the scrolling the mouse wheel to molecule number imol (same as

).


Next: , Previous: set-scrollable-map, Up: Map Functions   [Contents][Index]

11.14.8 scroll-wheel-map

function: scroll-wheel-map

the contouring of which map is altered when the scroll wheel changes?


Next: , Previous: scroll-wheel-map, Up: Map Functions   [Contents][Index]

11.14.9 save-previous-map-colour

function: save-previous-map-colour imol

Where imol is an integer number

save previous colour map for molecule number imol


Next: , Previous: save-previous-map-colour, Up: Map Functions   [Contents][Index]

11.14.10 restore-previous-map-colour

function: restore-previous-map-colour imol

Where imol is an integer number

restore previous colour map for molecule number imol


Next: , Previous: restore-previous-map-colour, Up: Map Functions   [Contents][Index]

11.14.11 set-active-map-drag-flag

function: set-active-map-drag-flag t

Where t is an integer number

set the state of immediate map upate on map drag.

By default, it is on (t=1). On slower computers it might be better to set t=0.


Next: , Previous: set-active-map-drag-flag, Up: Map Functions   [Contents][Index]

11.14.12 get-active-map-drag-flag

function: get-active-map-drag-flag

return the state of the dragged map flag


Next: , Previous: get-active-map-drag-flag, Up: Map Functions   [Contents][Index]

11.14.13 set-last-map-colour

function: set-last-map-colour f1 f2 f3

Where:

set the colour of the last (highest molecule number) map


Next: , Previous: set-last-map-colour, Up: Map Functions   [Contents][Index]

11.14.14 set-map-colour

function: set-map-colour imol red green blue

Where:

set the colour of the imolth map


Next: , Previous: set-map-colour, Up: Map Functions   [Contents][Index]

11.14.15 set-contour-level-absolute

function: set-contour-level-absolute imol_map level

Where:

set the contour level, direct control


Next: , Previous: set-contour-level-absolute, Up: Map Functions   [Contents][Index]

11.14.16 set-contour-level-in-sigma

function: set-contour-level-in-sigma imol_map level

Where:

set the contour level, direct control in r.m.s.d. (if you like that sort of thing)


Next: , Previous: set-contour-level-in-sigma, Up: Map Functions   [Contents][Index]

11.14.17 get-contour-level-absolute

function: get-contour-level-absolute imol

Where imol is an integer number

get the contour level


Next: , Previous: get-contour-level-absolute, Up: Map Functions   [Contents][Index]

11.14.18 get-contour-level-in-sigma

function: get-contour-level-in-sigma imol

Where imol is an integer number

get the contour level in rmd above 0.


Next: , Previous: get-contour-level-in-sigma, Up: Map Functions   [Contents][Index]

11.14.19 set-last-map-sigma-step

function: set-last-map-sigma-step f

Where f is a number

set the sigma step of the last map to f sigma


Next: , Previous: set-last-map-sigma-step, Up: Map Functions   [Contents][Index]

11.14.20 set-contour-by-sigma-step-by-mol

function: set-contour-by-sigma-step-by-mol f state imol

Where:

set the contour level step

set the contour level step of molecule number imol to f and variable state (setting state to 0 turns off contouring by sigma level)


Next: , Previous: set-contour-by-sigma-step-by-mol, Up: Map Functions   [Contents][Index]

11.14.21 data-resolution

function: data-resolution imol

Where imol is an integer number

return the resolution of the data for molecule number imol. Return negative number on error, otherwise resolution in A (eg. 2.0)


Next: , Previous: data-resolution, Up: Map Functions   [Contents][Index]

11.14.22 model-resolution

function: model-resolution imol

Where imol is an integer number

return the resolution set in the header of the model/coordinates file. If this number is not available, return a number less than 0.


Next: , Previous: model-resolution, Up: Map Functions   [Contents][Index]

11.14.23 export-map

function: export-map imol filename

Where:

export (write to disk) the map of molecule number imol to filename.

Return 0 on failure, 1 on success.


Next: , Previous: export-map, Up: Map Functions   [Contents][Index]

11.14.24 export-map-fragment

function: export-map-fragment imol x y z radius filename

Where:

export a fragment of the map about (x,y,z)


Next: , Previous: export-map-fragment, Up: Map Functions   [Contents][Index]

11.14.25 export-map-fragment-with-origin-shift

function: export-map-fragment-with-origin-shift imol x y z radius filename

Where:

export a fragment of the map about (x,y,z)


Next: , Previous: export-map-fragment-with-origin-shift, Up: Map Functions   [Contents][Index]

11.14.26 export-map-fragment-to-plain-file

function: export-map-fragment-to-plain-file imol x y z radius filename

Where:

tmp interface for Hamish


Next: , Previous: export-map-fragment-to-plain-file, Up: Map Functions   [Contents][Index]

11.14.27 difference-map

function: difference-map imol1 imol2 map_scale

Where:

make a difference map, taking map_scale * imap2 from imap1, on the grid of imap1. Return the new molecule number. Return -1 on failure.


Next: , Previous: difference-map, Up: Map Functions   [Contents][Index]

11.14.28 reinterp-map

function: reinterp-map map_no reference_map_no

Where:

make a new map (a copy of map_no) that is in the cell, spacegroup and gridding of the map in reference_map_no.

Return the new map molecule number - return -1 on failure


Next: , Previous: reinterp-map, Up: Map Functions   [Contents][Index]

11.14.29 smooth-map

function: smooth-map map_no sampling_multiplier

Where:

make a new map (a copy of map_no) that is in the cell, spacegroup and a multiple of the sampling of the input map (a sampling factor of more than 1 makes the output maps smoother)


Next: , Previous: smooth-map, Up: Map Functions   [Contents][Index]

11.14.30 average-map-scm

function: average-map-scm map_number_and_scales

Where map_number_and_scales is a SCM

make an average map from the map_number_and_scales (which is a list of pairs (list map-number scale-factor)) (the scale factors are typically 1.0 of course). The output map is in the same grid as the first (valid) map. Return -1 on failure to make an averaged map, otherwise return the new map molecule number.


Previous: average-map-scm, Up: Map Functions   [Contents][Index]

11.14.31 average-map-py

function: average-map-py map_number_and_scales

Where map_number_and_scales is a PyObject

make an average map from the map_number_and_scales (which is a list of pairs map_number, scale_factor. The output map is in the same grid as the first (valid) map. Return -1 on failure to make an averaged map, otherwise return the new map molecule number.


Next: , Previous: Map Functions, Up: Scripting Functions   [Contents][Index]

11.15 Density Increment


Next: , Up: Density Increment   [Contents][Index]

11.15.1 set-iso-level-increment

function: set-iso-level-increment val

Where val is a number

set the contour scroll step (in absolute e/A3) for 2Fo-Fc-style maps to val

The is only activated when scrolling by sigma is turned off


Next: , Previous: set-iso-level-increment, Up: Density Increment   [Contents][Index]

11.15.2 set-diff-map-iso-level-increment

function: set-diff-map-iso-level-increment val

Where val is a number

set the contour scroll step for difference map (in absolute e/A3) to val

The is only activated when scrolling by sigma is turned off


Next: , Previous: set-diff-map-iso-level-increment, Up: Density Increment   [Contents][Index]

11.15.3 get-diff-map-iso-level-increment

function: get-diff-map-iso-level-increment

return difference maps iso-map level increment


Next: , Previous: get-diff-map-iso-level-increment, Up: Density Increment   [Contents][Index]

11.15.4 set-diff-map-iso-level-increment-from-text

function: set-diff-map-iso-level-increment-from-text text imol

Where:

set the difference maps iso-map level increment


Next: , Previous: set-diff-map-iso-level-increment-from-text, Up: Density Increment   [Contents][Index]

11.15.5 set-map-sampling-rate-text

function: set-map-sampling-rate-text text

Where text is a string

sampling rate

find the molecule for which the single map dialog applies and set the contour level and redraw


Next: , Previous: set-map-sampling-rate-text, Up: Density Increment   [Contents][Index]

11.15.6 set-map-sampling-rate

function: set-map-sampling-rate r

Where r is a number

set the map sampling rate (default 1.5)

Set to something like 2.0 or 2.5 for more finely sampled maps. Useful for baton-building low resolution maps.


Next: , Previous: set-map-sampling-rate, Up: Density Increment   [Contents][Index]

11.15.7 get-map-sampling-rate

function: get-map-sampling-rate

return the map sampling rate


Next: , Previous: get-map-sampling-rate, Up: Density Increment   [Contents][Index]

11.15.8 change-contour-level

function: change-contour-level is_increment

Where is_increment is an integer number

change the contour level of the current map by a step

if is_increment=1 the contour level is increased. If is_increment=0 the map contour level is decreased.


Next: , Previous: change-contour-level, Up: Density Increment   [Contents][Index]

11.15.9 set-last-map-contour-level

function: set-last-map-contour-level level

Where level is a number

set the contour level of the map with the highest molecule number to level


Next: , Previous: set-last-map-contour-level, Up: Density Increment   [Contents][Index]

11.15.10 set-last-map-contour-level-by-sigma

function: set-last-map-contour-level-by-sigma n_sigma

Where n_sigma is a number

set the contour level of the map with the highest molecule number to n_sigma sigma


Next: , Previous: set-last-map-contour-level-by-sigma, Up: Density Increment   [Contents][Index]

11.15.11 set-stop-scroll-diff-map

function: set-stop-scroll-diff-map i

Where i is an integer number

create a lower limit to the "Fo-Fc-style" map contour level changing

(default 1 on)


Next: , Previous: set-stop-scroll-diff-map, Up: Density Increment   [Contents][Index]

11.15.12 set-stop-scroll-iso-map

function: set-stop-scroll-iso-map i

Where i is an integer number

create a lower limit to the "2Fo-Fc-style" map contour level changing

(default 1 on)


Next: , Previous: set-stop-scroll-iso-map, Up: Density Increment   [Contents][Index]

11.15.13 set-stop-scroll-iso-map-level

function: set-stop-scroll-iso-map-level f

Where f is a number

set the actual map level changing limit

(default 0.0)


Next: , Previous: set-stop-scroll-iso-map-level, Up: Density Increment   [Contents][Index]

11.15.14 set-stop-scroll-diff-map-level

function: set-stop-scroll-diff-map-level f

Where f is a number

set the actual difference map level changing limit

(default 0.0)


Previous: set-stop-scroll-diff-map-level, Up: Density Increment   [Contents][Index]

11.15.15 set-residue-density-fit-scale-factor

function: set-residue-density-fit-scale-factor f

Where f is a number

set the scale factor for the Residue Density fit analysis


Next: , Previous: Density Increment, Up: Scripting Functions   [Contents][Index]

11.16 Density Functions


Next: , Up: Density Functions   [Contents][Index]

11.16.1 set-map-line-width

function: set-map-line-width w

Where w is an integer number

draw the lines of the chickenwire density in width w


Next: , Previous: set-map-line-width, Up: Density Functions   [Contents][Index]

11.16.2 map-line-width-state

function: map-line-width-state

return the width in which density contours are drawn


Next: , Previous: map-line-width-state, Up: Density Functions   [Contents][Index]

11.16.3 make-and-draw-map

function: make-and-draw-map mtz_file_name f_col phi_col weight use_weights is_diff_map

Where:

make a map from an mtz file (simple interface)

given mtz file mtz_file_name and F column f_col and phases column phi_col and optional weight column weight_col (pass use_weights=0 if weights are not to be used). Also mark the map as a difference map (is_diff_map=1) or not (is_diff_map=0) because they are handled differently inside coot.

Returns: -1 on error, else return the new molecule number


Next: , Previous: make-and-draw-map, Up: Density Functions   [Contents][Index]

11.16.4 make-and-draw-map-with-refmac-params

function: make-and-draw-map-with-refmac-params mtz_file_name a b weight use_weights is_diff_map have_refmac_params fobs_col sigfobs_col r_free_col sensible_f_free_col

Where:

as the above function, execpt set refmac parameters too

pass along the refmac column labels for storage (not used in the creation of the map)

Returns: -1 on error, else return imol


Next: , Previous: make-and-draw-map-with-refmac-params, Up: Density Functions   [Contents][Index]

11.16.5 make-and-draw-map-with-reso-with-refmac-params

function: make-and-draw-map-with-reso-with-refmac-params mtz_file_name a b weight use_weights is_diff_map have_refmac_params fobs_col sigfobs_col r_free_col sensible_f_free_col is_anomalous use_reso_limits low_reso_limit high_reso_lim

Where:

as the above function, except set expert options too.


Next: , Previous: make-and-draw-map-with-reso-with-refmac-params, Up: Density Functions   [Contents][Index]

11.16.6 make-updating-map

function: make-updating-map mtz_file_name f_col phi_col weight use_weights is_diff_map

Where:

make a map molecule from the give file name.

If the file updates, then the map will be updated.


Next: , Previous: make-updating-map, Up: Density Functions   [Contents][Index]

11.16.7 valid-labels

function: valid-labels mtz_file_name f_col phi_col weight_col use_weights

Where:

does the mtz file have the columms that we want it to have?


Next: , Previous: valid-labels, Up: Density Functions   [Contents][Index]

11.16.8 mtz-file-has-phases-p

function: mtz-file-has-phases-p mtz_file_name

Where mtz_file_name is a string

does the mtz file have phases?


Next: , Previous: mtz-file-has-phases-p, Up: Density Functions   [Contents][Index]

11.16.9 is-mtz-file-p

function: is-mtz-file-p filename

Where filename is a string

is the given filename an mtz file?


Next: , Previous: is-mtz-file-p, Up: Density Functions   [Contents][Index]

11.16.10 cns-file-has-phases-p

function: cns-file-has-phases-p cns_file_name

Where cns_file_name is a string

does the given file have cns phases?


Next: , Previous: cns-file-has-phases-p, Up: Density Functions   [Contents][Index]

11.16.11 auto-read-do-difference-map-too-state

function: auto-read-do-difference-map-too-state

return the flag to do a difference map (too) on auto-read MTZ

Returns: 0 means no, 1 means yes.


Next: , Previous: auto-read-do-difference-map-too-state, Up: Density Functions   [Contents][Index]

11.16.12 set-auto-read-column-labels

function: set-auto-read-column-labels fwt phwt is_for_diff_map_flag

Where:

set the expected MTZ columns for Auto-reading MTZ file.

Not every program uses the default refmac labels ("FWT"/"PHWT") for its MTZ file. Here we can tell coot to expect other labels so that coot can "Auto-open" such MTZ files.

e.g. (set-auto-read-column-labels "2FOFCWT" "PH2FOFCWT" 0)


Next: , Previous: set-auto-read-column-labels, Up: Density Functions   [Contents][Index]

11.16.13 set-map-radius

function: set-map-radius f

Where f is a number

set the extent of the box/radius of electron density contours for x-ray maps


Next: , Previous: set-map-radius, Up: Density Functions   [Contents][Index]

11.16.14 set-map-radius-em

function: set-map-radius-em radius

Where radius is a number

set the extent of the box/radius of electron density contours for EM map


Next: , Previous: set-map-radius-em, Up: Density Functions   [Contents][Index]

11.16.15 set-density-size

function: set-density-size f

Where f is a number

another (old) way of setting the radius of the map


Next: , Previous: set-density-size, Up: Density Functions   [Contents][Index]

11.16.16 set-display-intro-string

function: set-display-intro-string str

Where str is a string

Give me this nice message str when I start coot.


Next: , Previous: set-display-intro-string, Up: Density Functions   [Contents][Index]

11.16.17 get-map-radius

function: get-map-radius

return the extent of the box/radius of electron density contours


Next: , Previous: get-map-radius, Up: Density Functions   [Contents][Index]

11.16.18 set-esoteric-depth-cue

function: set-esoteric-depth-cue istate

Where istate is an integer number

not everone likes coot’s esoteric depth cueing system

Pass an argument istate=1 to turn it off

(this function is currently disabled).


Next: , Previous: set-esoteric-depth-cue, Up: Density Functions   [Contents][Index]

11.16.19 esoteric-depth-cue-state

function: esoteric-depth-cue-state

native depth cueing system

return the state of the esoteric depth cueing flag


Next: , Previous: esoteric-depth-cue-state, Up: Density Functions   [Contents][Index]

11.16.20 set-swap-difference-map-colours

function: set-swap-difference-map-colours i

Where i is an integer number

not everone likes coot’s default difference map colouring.

Pass an argument i=1 to swap the difference map colouring so that red is positive and green is negative.


Next: , Previous: set-swap-difference-map-colours, Up: Density Functions   [Contents][Index]

11.16.21 set-map-is-difference-map

function: set-map-is-difference-map imol bool_flag

Where:

post-hoc set the map of molecule number imol to be a difference map

Returns: success status, 0 -> failure (imol does not have a map)


Next: , Previous: set-map-is-difference-map, Up: Density Functions   [Contents][Index]

11.16.22 map-is-difference-map

function: map-is-difference-map imol

Where imol is an integer number

map is difference map?


Next: , Previous: map-is-difference-map, Up: Density Functions   [Contents][Index]

11.16.23 another-level

function: another-level

Add another contour level for the last added map.

Currently, the map must have been generated from an MTZ file.

Returns: the molecule number of the new molecule or -1 on failure


Next: , Previous: another-level, Up: Density Functions   [Contents][Index]

11.16.24 another-level-from-map-molecule-number

function: another-level-from-map-molecule-number imap

Where imap is an integer number

Add another contour level for the given map.

Currently, the map must have been generated from an MTZ file.

Returns: the molecule number of the new molecule or -1 on failure


Next: , Previous: another-level-from-map-molecule-number, Up: Density Functions   [Contents][Index]

11.16.25 residue-density-fit-scale-factor

function: residue-density-fit-scale-factor

return the scale factor for the Residue Density fit analysis


Previous: residue-density-fit-scale-factor, Up: Density Functions   [Contents][Index]

11.16.26 density-at-point

function: density-at-point imol_map x y z

Where:

return the density at the given point for the given map. Return 0 for bad imol


Next: , Previous: Density Functions, Up: Scripting Functions   [Contents][Index]

11.17 Parameters from map


Next: , Up: Parameters from map   [Contents][Index]

11.17.1 mtz-hklin-for-map

function: mtz-hklin-for-map imol_map

Where imol_map is an integer number

return the mtz file that was use to generate the map

return 0 when there is no mtz file associated with that map (it was generated from a CCP4 map file say).


Next: , Previous: mtz-hklin-for-map, Up: Parameters from map   [Contents][Index]

11.17.2 mtz-fp-for-map

function: mtz-fp-for-map imol_map

Where imol_map is an integer number

return the FP column in the file that was use to generate the map

return 0 when there is no mtz file associated with that map (it was generated from a CCP4 map file say).

Caller should dispose of returned pointer.


Next: , Previous: mtz-fp-for-map, Up: Parameters from map   [Contents][Index]

11.17.3 mtz-phi-for-map

function: mtz-phi-for-map imol_map

Where imol_map is an integer number

return the phases column in mtz file that was use to generate the map

return 0 when there is no mtz file associated with that map (it was generated from a CCP4 map file say). Caller should dispose of returned pointer.


Next: , Previous: mtz-phi-for-map, Up: Parameters from map   [Contents][Index]

11.17.4 mtz-weight-for-map

function: mtz-weight-for-map imol_map

Where imol_map is an integer number

return the weight column in the mtz file that was use to generate the map

return 0 when there is no mtz file associated with that map (it was generated from a CCP4 map file say) or no weights were used. Caller should dispose of returned pointer.


Next: , Previous: mtz-weight-for-map, Up: Parameters from map   [Contents][Index]

11.17.5 mtz-use-weight-for-map

function: mtz-use-weight-for-map imol_map

Where imol_map is an integer number

return flag for whether weights were used that was use to generate the map

return 0 when no weights were used or there is no mtz file associated with that map.


Next: , Previous: mtz-use-weight-for-map, Up: Parameters from map   [Contents][Index]

11.17.6 map-parameters-scm

function: map-parameters-scm imol

Where imol is an integer number

return the parameter that made the map,

Returns: false or a string like ("xxx.mtz" "FPH" "PHWT" "" False)


Next: , Previous: map-parameters-scm, Up: Parameters from map   [Contents][Index]

11.17.7 cell-scm

function: cell-scm imol

Where imol is an integer number

return the parameter that made the map,

Returns: false or a list like (45 46 47 90 90 120), angles in degress


Next: , Previous: cell-scm, Up: Parameters from map   [Contents][Index]

11.17.8 map-parameters-py

function: map-parameters-py imol

Where imol is an integer number

return the parameter of the molecule, something like (45 46 47 90 90 120), angles in degress

return the parameter that made the map,

Returns: False or something like ["xxx.mtz", "FPH", "PHWT", "", False]


Previous: map-parameters-py, Up: Parameters from map   [Contents][Index]

11.17.9 cell-py

function: cell-py imol

Where imol is an integer number

return the parameter that made the map,

Returns: False or something like [45, 46, 47, 90, 90, 120], angles in degress


Next: , Previous: Parameters from map, Up: Scripting Functions   [Contents][Index]

11.18 PDB Functions


Next: , Up: PDB Functions   [Contents][Index]

11.18.1 write-pdb-file

function: write-pdb-file imol file_name

Where:

write molecule number imol as a PDB to file file_name


Next: , Previous: write-pdb-file, Up: PDB Functions   [Contents][Index]

11.18.2 write-cif-file

function: write-cif-file imol file_name

Where:

write molecule number imol as a mmCIF to file file_name


Next: , Previous: write-cif-file, Up: PDB Functions   [Contents][Index]

11.18.3 write-residue-range-to-pdb-file

function: write-residue-range-to-pdb-file imol chainid resno_start resno_end filename

Where:

write molecule number imol’s residue range as a PDB to file file_name


Previous: write-residue-range-to-pdb-file, Up: PDB Functions   [Contents][Index]

11.18.4 quick-save

function: quick-save

save all modified coordinates molecules to the default names and save the state too.


Next: , Previous: PDB Functions, Up: Scripting Functions   [Contents][Index]

11.19 Info Dialog


Next: , Up: Info Dialog   [Contents][Index]

11.19.1 info-dialog

function: info-dialog txt

Where txt is a string

create a dialog with information

create a dialog with information string txt. User has to click to dismiss it, but it is not modal (nothing in coot is modal).


Next: , Previous: info-dialog, Up: Info Dialog   [Contents][Index]

11.19.2 info-dialog-and-text

function: info-dialog-and-text txt

Where txt is a string

create a dialog with information and print to console

as info_dialog but print to console as well.


Previous: info-dialog-and-text, Up: Info Dialog   [Contents][Index]

11.19.3 info-dialog-with-markup

function: info-dialog-with-markup txt

Where txt is a string

as above, create a dialog with information

This dialog is left-justified and can use markup such as angled bracketted tt or i


Next: , Previous: Info Dialog, Up: Scripting Functions   [Contents][Index]

11.20 Refmac Functions


Next: , Up: Refmac Functions   [Contents][Index]

11.20.1 set-refmac-counter

function: set-refmac-counter imol refmac_count

Where:

set counter for runs of refmac so that this can be used to construct a unique filename for new output


Next: , Previous: set-refmac-counter, Up: Refmac Functions   [Contents][Index]

11.20.2 swap-map-colours

function: swap-map-colours imol1 imol2

Where:

swap the colours of maps

swap the colour of maps imol1 and imol2. Useful to some after running refmac, so that the map to be build into is always the same colour


Next: , Previous: swap-map-colours, Up: Refmac Functions   [Contents][Index]

11.20.3 set-keep-map-colour-after-refmac

function: set-keep-map-colour-after-refmac istate

Where istate is an integer number

flag to enable above

call this with istate=1


Previous: set-keep-map-colour-after-refmac, Up: Refmac Functions   [Contents][Index]

11.20.4 keep-map-colour-after-refmac-state

function: keep-map-colour-after-refmac-state

the keep-map-colour-after-refmac internal state

Returns: 1 for "yes", 0 for "no"


Next: , Previous: Refmac Functions, Up: Scripting Functions   [Contents][Index]

11.21 Symmetry Functions


Next: , Up: Symmetry Functions   [Contents][Index]

11.21.1 set-symmetry-size

function: set-symmetry-size f

Where f is a number

set the size of the displayed symmetry


Next: , Previous: set-symmetry-size, Up: Symmetry Functions   [Contents][Index]

11.21.2 get-show-symmetry

function: get-show-symmetry

is symmetry master display control on?


Next: , Previous: get-show-symmetry, Up: Symmetry Functions   [Contents][Index]

11.21.3 set-show-symmetry-master

function: set-show-symmetry-master state

Where state is an integer number

set display symmetry, master controller


Next: , Previous: set-show-symmetry-master, Up: Symmetry Functions   [Contents][Index]

11.21.4 set-show-symmetry-molecule

function: set-show-symmetry-molecule mol_no state

Where:

set display symmetry for molecule number mol_no

pass with state=0 for off, state=1 for on


Next: , Previous: set-show-symmetry-molecule, Up: Symmetry Functions   [Contents][Index]

11.21.5 symmetry-as-calphas

function: symmetry-as-calphas mol_no state

Where:

display symmetry as CAs?

pass with state=0 for off, state=1 for on


Next: , Previous: symmetry-as-calphas, Up: Symmetry Functions   [Contents][Index]

11.21.6 get-symmetry-as-calphas-state

function: get-symmetry-as-calphas-state imol

Where imol is an integer number

what is state of display CAs for molecule number mol_no?

return state=0 for off, state=1 for on


Next: , Previous: get-symmetry-as-calphas-state, Up: Symmetry Functions   [Contents][Index]

11.21.7 set-symmetry-molecule-rotate-colour-map

function: set-symmetry-molecule-rotate-colour-map imol state

Where:

set the colour map rotation (i.e. the hue) for the symmetry atoms of molecule number imol


Next: , Previous: set-symmetry-molecule-rotate-colour-map, Up: Symmetry Functions   [Contents][Index]

11.21.8 symmetry-molecule-rotate-colour-map-state

function: symmetry-molecule-rotate-colour-map-state imol

Where imol is an integer number

should there be colour map rotation (i.e. the hue) change for the symmetry atoms of molecule number imol?

return state=0 for off, state=1 for on


Next: , Previous: symmetry-molecule-rotate-colour-map-state, Up: Symmetry Functions   [Contents][Index]

11.21.9 set-symmetry-colour-by-symop

function: set-symmetry-colour-by-symop imol state

Where:

set symmetry colour by symop mode


Next: , Previous: set-symmetry-colour-by-symop, Up: Symmetry Functions   [Contents][Index]

11.21.10 set-symmetry-whole-chain

function: set-symmetry-whole-chain imol state

Where:

set symmetry colour for the chain


Next: , Previous: set-symmetry-whole-chain, Up: Symmetry Functions   [Contents][Index]

11.21.11 set-symmetry-atom-labels-expanded

function: set-symmetry-atom-labels-expanded state

Where state is an integer number

set use expanded symmetry atom labels


Next: , Previous: set-symmetry-atom-labels-expanded, Up: Symmetry Functions   [Contents][Index]

11.21.12 has-unit-cell-state

function: has-unit-cell-state imol

Where imol is an integer number

molecule number imol has a unit cell?

Returns: 1 on "yes, it has a cell", 0 for "no"


Next: , Previous: has-unit-cell-state, Up: Symmetry Functions   [Contents][Index]

11.21.13 undo-symmetry-view

function: undo-symmetry-view

Undo symmetry view. Translate back to main molecule from this symmetry position.


Next: , Previous: undo-symmetry-view, Up: Symmetry Functions   [Contents][Index]

11.21.14 first-molecule-with-symmetry-displayed

function: first-molecule-with-symmetry-displayed

return the molecule number.

Returns: -1 if there is no molecule with symmetry displayed.


Next: , Previous: first-molecule-with-symmetry-displayed, Up: Symmetry Functions   [Contents][Index]

11.21.15 save-symmetry-coords

function: save-symmetry-coords imol filename symop_no shift_a shift_b shift_c pre_shift_to_origin_na pre_shift_to_origin_nb pre_shift_to_origin_nc

Where:

save the symmetry coordinates of molecule number imol to filename

Allow a shift of the coordinates to the origin before symmetry expansion is apllied (this is how symmetry works in Coot internals).


Next: , Previous: save-symmetry-coords, Up: Symmetry Functions   [Contents][Index]

11.21.16 new-molecule-by-symmetry

function: new-molecule-by-symmetry imol name m11 m12 m13 m21 m22 m23 m31 m32 m33 tx ty tz pre_shift_to_origin_na pre_shift_to_origin_nb pre_shift_to_origin_nc

Where:

create a new molecule (molecule number is the return value) from imol.

The rotation/translation matrix components are given in

coordinates.

Allow a shift of the coordinates to the origin before symmetry expansion is aplied.

Pass "" as the name-in and a name will be constructed for you.

Return -1 on failure.


Next: , Previous: new-molecule-by-symmetry, Up: Symmetry Functions   [Contents][Index]

11.21.17 new-molecule-by-symmetry-with-atom-selection

function: new-molecule-by-symmetry-with-atom-selection imol name mmdb_atom_selection_string m11 m12 m13 m21 m22 m23 m31 m32 m33 tx ty tz pre_shift_to_origin_na pre_shift_to_origin_nb pre_shift_to_origin_nc

Where:

create a new molecule (molecule number is the return value) from imol, but only for atom that match the mmdb_atom_selection_string.

The rotation/translation matrix components are given in

coordinates.

Allow a shift of the coordinates to the origin before symmetry expansion is aplied.

Pass "" as the name-in and a name will be constructed for you.

Return -1 on failure.


Next: , Previous: new-molecule-by-symmetry-with-atom-selection, Up: Symmetry Functions   [Contents][Index]

11.21.18 new-molecule-by-symop

function: new-molecule-by-symop imol symop_string pre_shift_to_origin_na pre_shift_to_origin_nb pre_shift_to_origin_nc

Where:

create a new molecule (molecule number is the return value) from imol.


Next: , Previous: new-molecule-by-symop, Up: Symmetry Functions   [Contents][Index]

11.21.19 n-symops

function: n-symops imol

Where imol is an integer number

return the number of symmetry operators for the given molecule

return -1 on no-symmetry for molecule or inappropriate imol number


Next: , Previous: n-symops, Up: Symmetry Functions   [Contents][Index]

11.21.20 origin-pre-shift-scm

function: origin-pre-shift-scm imol

Where imol is an integer number

return the pre-shift (the shift that translates the centre of the molecule as close as possible to the origin) as a list of ints or scheme false on failure


Next: , Previous: origin-pre-shift-scm, Up: Symmetry Functions   [Contents][Index]

11.21.21 origin-pre-shift-py

function: origin-pre-shift-py imol

Where imol is an integer number

return the pre-shift (the shift that translates the centre of the molecule as close as possible to the origin) as a list of ints or Python false on failure


Next: , Previous: origin-pre-shift-py, Up: Symmetry Functions   [Contents][Index]

11.21.22 set-space-group

function: set-space-group imol spg

Where:

set the space group for a coordinates molecule

for shelx FA pdb files, there is no space group. So allow the user to set it. This can be initted with a HM symbol or a symm list for clipper.

This will only work on model molecules.

Returns: the success status of the setting (1 good, 0 fail).


Next: , Previous: set-space-group, Up: Symmetry Functions   [Contents][Index]

11.21.23 set-unit-cell-and-space-group

function: set-unit-cell-and-space-group imol a b c alpha beta gamma space_group

Where:

set the unit cell for a given model molecule

Angles in degress, cell lengths in Angstroms.

Returns: the success status of the setting (1 good, 0 fail).


Next: , Previous: set-unit-cell-and-space-group, Up: Symmetry Functions   [Contents][Index]

11.21.24 set-unit-cell-and-space-group-using-molecule

function: set-unit-cell-and-space-group-using-molecule imol imol_from

Where:

set the unit cell for a given model molecule using the cell of moecule imol_from

This will only work on model molecules.

Returns: the success status of the setting (1 good, 0 fail).


Previous: set-unit-cell-and-space-group-using-molecule, Up: Symmetry Functions   [Contents][Index]

11.21.25 set-symmetry-shift-search-size

function: set-symmetry-shift-search-size shift

Where shift is an integer number

set the cell shift search size for symmetry searching.

When the coordinates for one (or some) symmetry operator are missing (which happens sometimes, but rarely), try changing setting this to 2 (default is 1). It slows symmetry searching, which is why it is not set to 2 by default.


Next: , Previous: Symmetry Functions, Up: Scripting Functions   [Contents][Index]

11.22 History Functions


Next: , Up: History Functions   [Contents][Index]

11.22.1 print-all-history-in-scheme

function: print-all-history-in-scheme

print the history in scheme format


Next: , Previous: print-all-history-in-scheme, Up: History Functions   [Contents][Index]

11.22.2 print-all-history-in-python

function: print-all-history-in-python

print the history in python format


Next: , Previous: print-all-history-in-python, Up: History Functions   [Contents][Index]

11.22.3 set-console-display-commands-state

function: set-console-display-commands-state istate

Where istate is an integer number

set a flag to show the text command equivalent of gui commands in the console as they happen.

1 for on, 0 for off.


Previous: set-console-display-commands-state, Up: History Functions   [Contents][Index]

11.22.4 set-console-display-commands-hilights

function: set-console-display-commands-hilights bold_flag colour_flag colour_index

Where:

set a flag to show the text command equivalent of gui commands in the console as they happen in bold and colours.

colour_flag: pass 1 for on, 0 for off.

colour_index 0 to 7 inclusive for various different colourings.


Next: , Previous: History Functions, Up: Scripting Functions   [Contents][Index]

11.23 State Functions


Next: , Up: State Functions   [Contents][Index]

11.23.1 save-state

function: save-state

save the current state to the default filename


Next: , Previous: save-state, Up: State Functions   [Contents][Index]

11.23.2 save-state-file

function: save-state-file filename

Where filename is a string

save the current state to file filename


Next: , Previous: save-state-file, Up: State Functions   [Contents][Index]

11.23.3 save-state-file-py

function: save-state-file-py filename

Where filename is a string

save the current state to file filename


Next: , Previous: save-state-file-py, Up: State Functions   [Contents][Index]

11.23.4 set-save-state-file-name

function: set-save-state-file-name filename

Where filename is a string

set the default state file name (default 0-coot.state.scm)


Next: , Previous: set-save-state-file-name, Up: State Functions   [Contents][Index]

11.23.5 save-state-file-name-scm

function: save-state-file-name-scm

the save state file name

Returns: the save state file name


Next: , Previous: save-state-file-name-scm, Up: State Functions   [Contents][Index]

11.23.6 save-state-file-name-py

function: save-state-file-name-py

the save state file name

Returns: the save state file name


Next: , Previous: save-state-file-name-py, Up: State Functions   [Contents][Index]

11.23.7 set-run-state-file-status

function: set-run-state-file-status istat

Where istat is an integer number

set run state file status

0: never run it 1: ask to run it 2: run it, no questions


Next: , Previous: set-run-state-file-status, Up: State Functions   [Contents][Index]

11.23.8 run-state-file

function: run-state-file

run the state file (reading from default filenname)


Previous: run-state-file, Up: State Functions   [Contents][Index]

11.23.9 run-state-file-maybe

function: run-state-file-maybe

run the state file depending on the state variables


Next: , Previous: State Functions, Up: Scripting Functions   [Contents][Index]

11.24 The Virtual Trackball


Next: , Up: The Virtual Trackball   [Contents][Index]

11.24.1 vt-surface

function: vt-surface mode

Where mode is an integer number

How should the mouse move the view?

mode=1 for "Flat", mode=2 for "Spherical Surface"


Previous: vt-surface, Up: The Virtual Trackball   [Contents][Index]

11.24.2 vt-surface-status

function: vt-surface-status

return the mouse view status mode

mode=1 for "Flat", mode=2 for "Spherical Surface"


Next: , Previous: The Virtual Trackball, Up: Scripting Functions   [Contents][Index]

11.25 Clipping Functions


Next: , Up: Clipping Functions   [Contents][Index]

11.25.1 set-clipping-back

function: set-clipping-back v

Where v is a number

set clipping plane back


Previous: set-clipping-back, Up: Clipping Functions   [Contents][Index]

11.25.2 set-clipping-front

function: set-clipping-front v

Where v is a number

set clipping plane front


Next: , Previous: Clipping Functions, Up: Scripting Functions   [Contents][Index]

11.26 Unit Cell interface


Next: , Up: Unit Cell interface   [Contents][Index]

11.26.1 get-show-unit-cell

function: get-show-unit-cell imol

Where imol is an integer number

return the stage of show unit cell for molecule number imol


Next: , Previous: get-show-unit-cell, Up: Unit Cell interface   [Contents][Index]

11.26.2 set-show-unit-cells-all

function: set-show-unit-cells-all istate

Where istate is an integer number

set the state of show unit cell for all molecules

1 for displayed 0 for undisplayed


Previous: set-show-unit-cells-all, Up: Unit Cell interface   [Contents][Index]

11.26.3 set-show-unit-cell

function: set-show-unit-cell imol istate

Where:

set the state of show unit cell for the particular molecule number imol

1 for displayed 0 for undisplayed


Next: , Previous: Unit Cell interface, Up: Scripting Functions   [Contents][Index]

11.27 Colour


Next: , Up: Colour   [Contents][Index]

11.27.1 set-colour-map-rotation-on-read-pdb

function: set-colour-map-rotation-on-read-pdb f

Where f is a number

set the hue change step on reading a new molecule


Next: , Previous: set-colour-map-rotation-on-read-pdb, Up: Colour   [Contents][Index]

11.27.2 set-colour-map-rotation-on-read-pdb-flag

function: set-colour-map-rotation-on-read-pdb-flag i

Where i is an integer number

shall the hue change step be used?


Next: , Previous: set-colour-map-rotation-on-read-pdb-flag, Up: Colour   [Contents][Index]

11.27.3 set-colour-map-rotation-on-read-pdb-c-only-flag

function: set-colour-map-rotation-on-read-pdb-c-only-flag i

Where i is an integer number

shall the colour map rotation apply only to C atoms?


Next: , Previous: set-colour-map-rotation-on-read-pdb-c-only-flag, Up: Colour   [Contents][Index]

11.27.4 set-colour-by-chain

function: set-colour-by-chain imol

Where imol is an integer number

colour molecule number imol by chain type


Next: , Previous: set-colour-by-chain, Up: Colour   [Contents][Index]

11.27.5 set-colour-by-chain-goodsell-mode

function: set-colour-by-chain-goodsell-mode imol

Where imol is an integer number

colour molecule number imol by chain type, goodsell-like colour scheme


Next: , Previous: set-colour-by-chain-goodsell-mode, Up: Colour   [Contents][Index]

11.27.6 set-colour-by-molecule

function: set-colour-by-molecule imol

Where imol is an integer number

colour molecule number imol by molecule


Previous: set-colour-by-molecule, Up: Colour   [Contents][Index]

11.27.7 set-symmetry-colour

function: set-symmetry-colour r g b

Where:

set the symmetry colour base


Next: , Previous: Colour, Up: Scripting Functions   [Contents][Index]

11.28 Map colour


Next: , Up: Map colour   [Contents][Index]

11.28.1 set-colour-map-rotation-for-map

function: set-colour-map-rotation-for-map f

Where f is a number

set the colour map rotation (hue change) for maps

default: for maps is 14 degrees.


Next: , Previous: set-colour-map-rotation-for-map, Up: Map colour   [Contents][Index]

11.28.2 set-molecule-bonds-colour-map-rotation

function: set-molecule-bonds-colour-map-rotation imol theta

Where:

set the colour map rotation for molecule number imol

theta is in degrees


Previous: set-molecule-bonds-colour-map-rotation, Up: Map colour   [Contents][Index]

11.28.3 get-molecule-bonds-colour-map-rotation

function: get-molecule-bonds-colour-map-rotation imol

Where imol is an integer number

Get the colour map rotation for molecule number imol.


Next: , Previous: Map colour, Up: Scripting Functions   [Contents][Index]

11.29 Anisotropic Atoms Interface


Next: , Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.1 get-limit-aniso

function: get-limit-aniso

get the aniso radius limit


Next: , Previous: get-limit-aniso, Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.2 get-show-limit-aniso

function: get-show-limit-aniso

get show the aniso limit


Next: , Previous: get-show-limit-aniso, Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.3 get-show-aniso

function: get-show-aniso

return show-aniso-atoms state


Next: , Previous: get-show-aniso, Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.4 set-limit-aniso

function: set-limit-aniso state

Where state is an integer number

set the aniso atom limit


Next: , Previous: set-limit-aniso, Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.5 set-show-aniso

function: set-show-aniso state

Where state is an integer number

set show aniso atoms


Next: , Previous: set-show-aniso, Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.6 set-aniso-probability

function: set-aniso-probability f

Where f is a number

set aniso probability


Previous: set-aniso-probability, Up: Anisotropic Atoms Interface   [Contents][Index]

11.29.7 get-aniso-probability

function: get-aniso-probability

get aniso probability


Next: , Previous: Anisotropic Atoms Interface, Up: Scripting Functions   [Contents][Index]

11.30 Display Functions


Next: , Up: Display Functions   [Contents][Index]

11.30.1 set-graphics-window-size

function: set-graphics-window-size x_size y_size

Where:

set the window size


Next: , Previous: set-graphics-window-size, Up: Display Functions   [Contents][Index]

11.30.2 set-graphics-window-position

function: set-graphics-window-position x_pos y_pos

Where:

set the graphics window position


Next: , Previous: set-graphics-window-position, Up: Display Functions   [Contents][Index]

11.30.3 store-graphics-window-position

function: store-graphics-window-position x_pos y_pos

Where:

store the graphics window position


Next: , Previous: store-graphics-window-position, Up: Display Functions   [Contents][Index]

11.30.4 graphics-window-size-and-position-to-preferences

function: graphics-window-size-and-position-to-preferences

store the graphics window position and size to zenops-graphics-window-size-and-postion.scm in the preferences directory.


Next: , Previous: graphics-window-size-and-position-to-preferences, Up: Display Functions   [Contents][Index]

11.30.5 graphics-draw

function: graphics-draw

draw a frame


Next: , Previous: graphics-draw, Up: Display Functions   [Contents][Index]

11.30.6 zalman-stereo-mode

function: zalman-stereo-mode

try to turn on Zalman stereo mode


Next: , Previous: zalman-stereo-mode, Up: Display Functions   [Contents][Index]

11.30.7 hardware-stereo-mode

function: hardware-stereo-mode

try to turn on stereo mode


Next: , Previous: hardware-stereo-mode, Up: Display Functions   [Contents][Index]

11.30.8 stereo-mode-state

function: stereo-mode-state

what is the stero state?

Returns: 1 for in hardware stereo, 2 for side by side stereo, else return 0.


Next: , Previous: stereo-mode-state, Up: Display Functions   [Contents][Index]

11.30.9 mono-mode

function: mono-mode

try to turn on mono mode


Next: , Previous: mono-mode, Up: Display Functions   [Contents][Index]

11.30.10 side-by-side-stereo-mode

function: side-by-side-stereo-mode use_wall_eye_mode

Where use_wall_eye_mode is an integer number

turn on side bye side stereo mode


Next: , Previous: side-by-side-stereo-mode, Up: Display Functions   [Contents][Index]

11.30.11 set-hardware-stereo-angle-factor

function: set-hardware-stereo-angle-factor f

Where f is a number

how much should the eyes be separated in stereo mode?


Next: , Previous: set-hardware-stereo-angle-factor, Up: Display Functions   [Contents][Index]

11.30.12 hardware-stereo-angle-factor-state

function: hardware-stereo-angle-factor-state

return the hardware stereo angle factor


Next: , Previous: hardware-stereo-angle-factor-state, Up: Display Functions   [Contents][Index]

11.30.13 set-model-fit-refine-dialog-position

function: set-model-fit-refine-dialog-position x_pos y_pos

Where:

set position of Model/Fit/Refine dialog


Next: , Previous: set-model-fit-refine-dialog-position, Up: Display Functions   [Contents][Index]

11.30.14 set-display-control-dialog-position

function: set-display-control-dialog-position x_pos y_pos

Where:

set position of Display Control dialog


Next: , Previous: set-display-control-dialog-position, Up: Display Functions   [Contents][Index]

11.30.15 set-go-to-atom-window-position

function: set-go-to-atom-window-position x_pos y_pos

Where:

set position of Go To Atom dialog


Next: , Previous: set-go-to-atom-window-position, Up: Display Functions   [Contents][Index]

11.30.16 set-delete-dialog-position

function: set-delete-dialog-position x_pos y_pos

Where:

set position of Delete dialog


Next: , Previous: set-delete-dialog-position, Up: Display Functions   [Contents][Index]

11.30.17 set-rotate-translate-dialog-position

function: set-rotate-translate-dialog-position x_pos y_pos

Where:

set position of the Rotate/Translate Residue Range dialog


Next: , Previous: set-rotate-translate-dialog-position, Up: Display Functions   [Contents][Index]

11.30.18 set-accept-reject-dialog-position

function: set-accept-reject-dialog-position x_pos y_pos

Where:

set position of the Accept/Reject dialog


Next: , Previous: set-accept-reject-dialog-position, Up: Display Functions   [Contents][Index]

11.30.19 set-ramachandran-plot-dialog-position

function: set-ramachandran-plot-dialog-position x_pos y_pos

Where:

set position of the Ramachadran Plot dialog


Next: , Previous: set-ramachandran-plot-dialog-position, Up: Display Functions   [Contents][Index]

11.30.20 set-edit-chi-angles-dialog-position

function: set-edit-chi-angles-dialog-position x_pos y_pos

Where:

set edit chi angles dialog position


Previous: set-edit-chi-angles-dialog-position, Up: Display Functions   [Contents][Index]

11.30.21 set-rotamer-selection-dialog-position

function: set-rotamer-selection-dialog-position x_pos y_pos

Where:

set rotamer selection dialog position


Next: , Previous: Display Functions, Up: Scripting Functions   [Contents][Index]

11.31 Smooth Scrolling


Next: , Up: Smooth Scrolling   [Contents][Index]

11.31.1 set-smooth-scroll-flag

function: set-smooth-scroll-flag v

Where v is an integer number

set smooth scrolling


Next: , Previous: set-smooth-scroll-flag, Up: Smooth Scrolling   [Contents][Index]

11.31.2 get-smooth-scroll

function: get-smooth-scroll

return the smooth scrolling state


Next: , Previous: get-smooth-scroll, Up: Smooth Scrolling   [Contents][Index]

11.31.3 set-smooth-scroll-steps

function: set-smooth-scroll-steps i

Where i is an integer number

set the number of steps in the smooth scroll

Set more steps (e.g. 50) for more smoothness (default 10).


Previous: set-smooth-scroll-steps, Up: Smooth Scrolling   [Contents][Index]

11.31.4 set-smooth-scroll-limit

function: set-smooth-scroll-limit lim

Where lim is a number

do not scroll for distances greater this limit


Next: , Previous: Smooth Scrolling, Up: Scripting Functions   [Contents][Index]

11.32 Font Parameters


Next: , Up: Font Parameters   [Contents][Index]

11.32.1 set-font-size

function: set-font-size i

Where i is an integer number

set the font size


Next: , Previous: set-font-size, Up: Font Parameters   [Contents][Index]

11.32.2 get-font-size

function: get-font-size

return the font size

Returns: 1 (small) 2 (medium, default) 3 (large)


Next: , Previous: get-font-size, Up: Font Parameters   [Contents][Index]

11.32.3 set-font-colour

function: set-font-colour red green blue

Where:

set the colour of the atom label font - the arguments are in the range 0->1


Previous: set-font-colour, Up: Font Parameters   [Contents][Index]

11.32.4 set-use-stroke-characters

function: set-use-stroke-characters state

Where state is an integer number

set use stroke characters


Next: , Previous: Font Parameters, Up: Scripting Functions   [Contents][Index]

11.33 Rotation Centre


Next: , Up: Rotation Centre   [Contents][Index]

11.33.1 set-rotation-centre-size

function: set-rotation-centre-size f

Where f is a number

set rotoation centre marker size


Next: , Previous: set-rotation-centre-size, Up: Rotation Centre   [Contents][Index]

11.33.2 recentre-on-read-pdb

function: recentre-on-read-pdb

return the recentre-on-pdb state


Next: , Previous: recentre-on-read-pdb, Up: Rotation Centre   [Contents][Index]

11.33.3 set-recentre-on-read-pdb

function: set-recentre-on-read-pdb int

Where int is a short

set the recentre-on-pdb state


Next: , Previous: set-recentre-on-read-pdb, Up: Rotation Centre   [Contents][Index]

11.33.4 set-rotation-centre

function: set-rotation-centre x y z

Where:

set the rotation centre


Next: , Previous: set-rotation-centre, Up: Rotation Centre   [Contents][Index]

11.33.5 go-to-ligand

function: go-to-ligand

centre on the ligand of the "active molecule", if we are already there, centre on the next hetgroup (etc)


Next: , Previous: go-to-ligand, Up: Rotation Centre   [Contents][Index]

11.33.6 set-go-to-ligand-n-atoms-limit

function: set-go-to-ligand-n-atoms-limit n_atom_min

Where n_atom_min is an integer number

go to the ligand that has more than n_atom_min atoms


Previous: set-go-to-ligand-n-atoms-limit, Up: Rotation Centre   [Contents][Index]

11.33.7 set-reorienting-next-residue-mode

function: set-reorienting-next-residue-mode state

Where state is an integer number

rotate the view so that the next main-chain atoms are oriented in the same direction as the previous - hence side-chain always seems to be "up" - set this mode to 1 for reorientation-mode - and 0 for off (standard translation)


Next: , Previous: Rotation Centre, Up: Scripting Functions   [Contents][Index]

11.34 Atom Selection Utilities


Next: , Up: Atom Selection Utilities   [Contents][Index]

11.34.1 median-temperature-factor

function: median-temperature-factor imol

Where imol is an integer number

return the median temperature factor for imol


Next: , Previous: median-temperature-factor, Up: Atom Selection Utilities   [Contents][Index]

11.34.2 average-temperature-factor

function: average-temperature-factor imol

Where imol is an integer number

return the average temperature factor for the atoms in imol


Next: , Previous: average-temperature-factor, Up: Atom Selection Utilities   [Contents][Index]

11.34.3 standard-deviation-temperature-factor

function: standard-deviation-temperature-factor imol

Where imol is an integer number

return the standard deviation of the atom temperature factors for imol


Next: , Previous: standard-deviation-temperature-factor, Up: Atom Selection Utilities   [Contents][Index]

11.34.4 clear-pending-picks

function: clear-pending-picks

clear pending picks (stop coot thinking that the user is about to pick an atom).


Next: , Previous: clear-pending-picks, Up: Atom Selection Utilities   [Contents][Index]

11.34.5 set-default-temperature-factor-for-new-atoms

function: set-default-temperature-factor-for-new-atoms new_b

Where new_b is a number

set the default temperature factor for newly created atoms (initial default 20)


Next: , Previous: set-default-temperature-factor-for-new-atoms, Up: Atom Selection Utilities   [Contents][Index]

11.34.6 default-new-atoms-b-factor

function: default-new-atoms-b-factor

return the default temperature factor for newly created atoms


Next: , Previous: default-new-atoms-b-factor, Up: Atom Selection Utilities   [Contents][Index]

11.34.7 set-reset-b-factor-moved-atoms

function: set-reset-b-factor-moved-atoms state

Where state is an integer number

reset temperature factor for all moved atoms to the default for new atoms (usually 30)


Next: , Previous: set-reset-b-factor-moved-atoms, Up: Atom Selection Utilities   [Contents][Index]

11.34.8 get-reset-b-factor-moved-atoms-state

function: get-reset-b-factor-moved-atoms-state

return the state if temperature factors shoudl be reset for moved atoms


Next: , Previous: get-reset-b-factor-moved-atoms-state, Up: Atom Selection Utilities   [Contents][Index]

11.34.9 set-atom-attribute

function: set-atom-attribute imol chain_id resno ins_code atom_name alt_conf attribute_name val

Where:

set a numberical attibute to the atom with the given specifier.

Attributes can be "x", "y","z", "B", "occ" and the attribute val is a floating point number


Next: , Previous: set-atom-attribute, Up: Atom Selection Utilities   [Contents][Index]

11.34.10 set-atom-string-attribute

function: set-atom-string-attribute imol chain_id resno ins_code atom_name alt_conf attribute_name attribute_value

Where:

set a string attibute to the atom with the given specifier.

Attributes can be "atom-name", "alt-conf", "element" or "segid".


Next: , Previous: set-atom-string-attribute, Up: Atom Selection Utilities   [Contents][Index]

11.34.11 set-atom-attributes

function: set-atom-attributes attribute_expression_list

Where attribute_expression_list is a SCM

set lots of atom attributes at once by-passing the rebonding and redrawing of the above 2 functions


Previous: set-atom-attributes, Up: Atom Selection Utilities   [Contents][Index]

11.34.12 set-residue-name

function: set-residue-name imol chain_id res_no ins_code new_residue_name

Where:

set the residue name of the specified residue


Next: , Previous: Atom Selection Utilities, Up: Scripting Functions   [Contents][Index]

11.35 Skeletonization Interface


Next: , Up: Skeletonization Interface   [Contents][Index]

11.35.1 skeletonize-map

function: skeletonize-map imol prune_flag

Where:

skeletonize molecule number imol

the prune_flag should almost always be 0.

NOTE:: The arguments to have been reversed for coot 0.8.3 and later (now the molecule number comes first).


Next: , Previous: skeletonize-map, Up: Skeletonization Interface   [Contents][Index]

11.35.2 unskeletonize-map

function: unskeletonize-map imol

Where imol is an integer number

undisplay the skeleton on molecule number imol


Next: , Previous: unskeletonize-map, Up: Skeletonization Interface   [Contents][Index]

11.35.3 set-max-skeleton-search-depth

function: set-max-skeleton-search-depth v

Where v is an integer number

set the skeleton search depth, used in baton building

For high resolution maps, you need to search deeper down the skeleton tree. This limit needs to be increased to 20 or so for high res maps (it is 10 by default)


Previous: set-max-skeleton-search-depth, Up: Skeletonization Interface   [Contents][Index]

11.35.4 set-skeleton-box-size

function: set-skeleton-box-size f

Where f is a number

the box size (in Angstroms) for which the skeleton is displayed


Next: , Previous: Skeletonization Interface, Up: Scripting Functions   [Contents][Index]

11.36 Save Coordinates


Next: , Up: Save Coordinates   [Contents][Index]

11.36.1 save-coordinates

function: save-coordinates imol filename

Where:

save coordinates of molecule number imol in filename

Returns: status 1 is good (success), 0 is fail.


Previous: save-coordinates, Up: Save Coordinates   [Contents][Index]

11.36.2 set-save-coordinates-in-original-directory

function: set-save-coordinates-in-original-directory i

Where i is an integer number

set save coordinates in the starting directory


Next: , Previous: Save Coordinates, Up: Scripting Functions   [Contents][Index]

11.37 Read Phases File Functions


Next: , Up: Read Phases File Functions   [Contents][Index]

11.37.1 read-phs-and-coords-and-make-map

function: read-phs-and-coords-and-make-map pdb_filename

Where pdb_filename is a string

read phs file use coords to get cell and symm to make map

uses pending data to make the map.


Next: , Previous: read-phs-and-coords-and-make-map, Up: Read Phases File Functions   [Contents][Index]

11.37.2 read-phs-and-make-map-using-cell-symm-from-previous-mol

function: read-phs-and-make-map-using-cell-symm-from-previous-mol phs_filename

Where phs_filename is a string

read a phs file, the cell and symm information is from previously read (most recently read) coordinates file

For use with phs data filename provided on the command line


Next: , Previous: read-phs-and-make-map-using-cell-symm-from-previous-mol, Up: Read Phases File Functions   [Contents][Index]

11.37.3 read-phs-and-make-map-using-cell-symm-from-mol

function: read-phs-and-make-map-using-cell-symm-from-mol phs_filename imol

Where:

read phs file and use a previously read molecule to provide the cell and symmetry information

Returns: the new molecule number, return -1 if problem creating the map (e.g. not phs data, file not found etc).


Next: , Previous: read-phs-and-make-map-using-cell-symm-from-mol, Up: Read Phases File Functions   [Contents][Index]

11.37.4 read-phs-and-make-map-using-cell-symm

function: read-phs-and-make-map-using-cell-symm phs_file_name hm_spacegroup a b c alpha beta gamma

Where:

read phs file use coords to use cell and symm to make map

in degrees


Previous: read-phs-and-make-map-using-cell-symm, Up: Read Phases File Functions   [Contents][Index]

11.37.5 read-phs-and-make-map-with-reso-limits

function: read-phs-and-make-map-with-reso-limits imol phs_file_name reso_lim_low reso_lim_high

Where:

read a phs file and use the cell and symm in molecule number imol and use the resolution limits reso_lim_high (in Angstroems).


Next: , Previous: Read Phases File Functions, Up: Scripting Functions   [Contents][Index]

11.38 Graphics Move


Next: , Up: Graphics Move   [Contents][Index]

11.38.1 undo-last-move

function: undo-last-move

undo last move


Next: , Previous: undo-last-move, Up: Graphics Move   [Contents][Index]

11.38.2 translate-molecule-by

function: translate-molecule-by imol x y z

Where:

translate molecule number imol by (x,y,z) in Angstroms


Next: , Previous: translate-molecule-by, Up: Graphics Move   [Contents][Index]

11.38.3 transform-molecule-by

function: transform-molecule-by imol m11 m12 m13 m21 m22 m23 m31 m32 m33 x y z

Where:

transform molecule number imol by the given rotation matrix, then translate by (x,y,z) in Angstroms


Previous: transform-molecule-by, Up: Graphics Move   [Contents][Index]

11.38.4 transform-zone

function: transform-zone imol chain_id resno_start resno_end ins_code m11 m12 m13 m21 m22 m23 m31 m32 m33 x y z

Where:

transform fragment of molecule number imol by the given rotation matrix, then translate by (x,y,z) in Angstroms


Next: , Previous: Graphics Move, Up: Scripting Functions   [Contents][Index]

11.39 Go To Atom Widget Functions


Next: , Up: Go To Atom Widget Functions   [Contents][Index]

11.39.1 post-go-to-atom-window

function: post-go-to-atom-window

Post the Go To Atom Window.


Next: , Previous: post-go-to-atom-window, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.2 go-to-atom-molecule-number

function: go-to-atom-molecule-number

the go-to-atom molecule number


Next: , Previous: go-to-atom-molecule-number, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.3 go-to-atom-chain-id

function: go-to-atom-chain-id

the go-to-atom chain-id


Next: , Previous: go-to-atom-chain-id, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.4 go-to-atom-atom-name

function: go-to-atom-atom-name

the go-to-atom atom name


Next: , Previous: go-to-atom-atom-name, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.5 go-to-atom-residue-number

function: go-to-atom-residue-number

the go-to-atom residue number


Next: , Previous: go-to-atom-residue-number, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.6 go-to-atom-ins-code

function: go-to-atom-ins-code

the go-to-atom insertion code


Next: , Previous: go-to-atom-ins-code, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.7 go-to-atom-alt-conf

function: go-to-atom-alt-conf

the go-to-atom alt conf


Next: , Previous: go-to-atom-alt-conf, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.8 set-go-to-atom-chain-residue-atom-name

function: set-go-to-atom-chain-residue-atom-name t1_chain_id iresno t3_atom_name

Where:

set the go to atom specification

It seems important for swig that the char * arguments are const char *, not const gchar * (or else we get wrong type of argument error on (say) "A"

Returns: the success status of the go to. 0 for fail, 1 for success.


Next: , Previous: set-go-to-atom-chain-residue-atom-name, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.9 set-go-to-atom-chain-residue-atom-name-full

function: set-go-to-atom-chain-residue-atom-name-full chain_id resno ins_code atom_name alt_conf

Where:

set the go to (full) atom specification

It seems important for swig that the char * arguments are const char *, not const gchar * (or else we get wrong type of argument error on (say) "A"

Returns: the success status of the go to. 0 for fail, 1 for success.


Next: , Previous: set-go-to-atom-chain-residue-atom-name-full, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.10 set-go-to-atom-chain-residue-atom-name-no-redraw

function: set-go-to-atom-chain-residue-atom-name-no-redraw t1 iresno t3 make_the_move_flag

Where:

set go to atom but don’t redraw


Next: , Previous: set-go-to-atom-chain-residue-atom-name-no-redraw, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.11 update-go-to-atom-from-current-position

function: update-go-to-atom-from-current-position

update the Go To Atom widget entries to atom closest to screen centre.


Next: , Previous: update-go-to-atom-from-current-position, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.12 atom-spec-to-atom-index

function: atom-spec-to-atom-index mol chain resno atom_name

Where:

what is the atom index of the given atom?


Next: , Previous: atom-spec-to-atom-index, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.13 full-atom-spec-to-atom-index

function: full-atom-spec-to-atom-index imol chain resno inscode atom_name altloc

Where:

what is the atom index of the given atom?


Next: , Previous: full-atom-spec-to-atom-index, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.14 update-go-to-atom-window-on-changed-mol

function: update-go-to-atom-window-on-changed-mol imol

Where imol is an integer number

update the Go To Atom window


Next: , Previous: update-go-to-atom-window-on-changed-mol, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.15 update-go-to-atom-window-on-new-mol

function: update-go-to-atom-window-on-new-mol

update the Go To Atom window. This updates the option menu for the molecules.


Previous: update-go-to-atom-window-on-new-mol, Up: Go To Atom Widget Functions   [Contents][Index]

11.39.16 set-go-to-atom-molecule

function: set-go-to-atom-molecule imol

Where imol is an integer number

set the molecule for the Go To Atom

For dynarama callback sake. The widget/class knows which molecule that it was generated from, so in order to go to the molecule from dynarama, we first need to the the molecule - because

does not mention the molecule (see "Next/Previous Residue" for reasons for that). This function simply calls the graphics_info_t function of the same name.

Also used in scripting, where go-to-atom-chain-residue-atom-name does not mention the molecule number.

20090914-PE set-go-to-atom-molecule can be used in a script and it should change the go-to-atom-molecule in the Go To Atom dialog (if it is being displayed). This does mean, of course that using the ramachandran plot to centre on atoms will change the Go To Atom dialog. Maybe that is surprising (maybe not).


Next: , Previous: Go To Atom Widget Functions, Up: Scripting Functions   [Contents][Index]

11.40 Map and Molecule Control


Next: , Up: Map and Molecule Control   [Contents][Index]

11.40.1 post-display-control-window

function: post-display-control-window

display the Display Constrol window


Next: , Previous: post-display-control-window, Up: Map and Molecule Control   [Contents][Index]

11.40.2 set-map-displayed

function: set-map-displayed imol state

Where:

make the map displayed/undisplayed, 0 for off, 1 for on


Next: , Previous: set-map-displayed, Up: Map and Molecule Control   [Contents][Index]

11.40.3 set-mol-displayed

function: set-mol-displayed imol state

Where:

make the coordinates molecule displayed/undisplayed, 0 for off, 1 for on


Next: , Previous: set-mol-displayed, Up: Map and Molecule Control   [Contents][Index]

11.40.4 set-display-only-model-mol

function: set-display-only-model-mol imol

Where imol is an integer number

from all the model molecules, display only imol

This stops flashing/delayed animations with many molecules


Next: , Previous: set-display-only-model-mol, Up: Map and Molecule Control   [Contents][Index]

11.40.5 set-mol-active

function: set-mol-active imol state

Where:

make the coordinates molecule active/inactve (clickable), 0 for off, 1 for on


Next: , Previous: set-mol-active, Up: Map and Molecule Control   [Contents][Index]

11.40.6 display-maps-scm

function: display-maps-scm maps_list

Where maps_list is a SCM

maps_list is a list of integers (map molecule numbers).

This interface is uses so that we don’t get flashing when a map is turned off (using set_mol_displayed).


Next: , Previous: display-maps-scm, Up: Map and Molecule Control   [Contents][Index]

11.40.7 mol-is-displayed

function: mol-is-displayed imol

Where imol is an integer number

return the display state of molecule number imol

Returns: 1 for on, 0 for off


Next: , Previous: mol-is-displayed, Up: Map and Molecule Control   [Contents][Index]

11.40.8 mol-is-active

function: mol-is-active imol

Where imol is an integer number

return the active state of molecule number imol

Returns: 1 for on, 0 for off


Next: , Previous: mol-is-active, Up: Map and Molecule Control   [Contents][Index]

11.40.9 map-is-displayed

function: map-is-displayed imol

Where imol is an integer number

return the display state of molecule number imol

Returns: 1 for on, 0 for off


Next: , Previous: map-is-displayed, Up: Map and Molecule Control   [Contents][Index]

11.40.10 set-all-maps-displayed

function: set-all-maps-displayed on_or_off

Where on_or_off is an integer number

if on_or_off is 0 turn off all maps displayed, for other values of on_or_off turn on all maps


Next: , Previous: set-all-maps-displayed, Up: Map and Molecule Control   [Contents][Index]

11.40.11 set-all-models-displayed-and-active

function: set-all-models-displayed-and-active on_or_off

Where on_or_off is an integer number

if on_or_off is 0 turn off all models displayed and active, for other values of on_or_off turn on all models.


Next: , Previous: set-all-models-displayed-and-active, Up: Map and Molecule Control   [Contents][Index]

11.40.12 set-only-last-model-molecule-displayed

function: set-only-last-model-molecule-displayed

only display the last model molecule


Next: , Previous: set-only-last-model-molecule-displayed, Up: Map and Molecule Control   [Contents][Index]

11.40.13 display-only-active

function: display-only-active

display only the active mol and the refinement map


Next: , Previous: display-only-active, Up: Map and Molecule Control   [Contents][Index]

11.40.14 space-group-scm

function: space-group-scm imol

Where imol is an integer number

return the spacegroup as a string, return scheme false if unable to do so.


Next: , Previous: space-group-scm, Up: Map and Molecule Control   [Contents][Index]

11.40.15 show-spacegroup

function: show-spacegroup imol

Where imol is an integer number

return the spacegroup of molecule number imol . Deprecated.

Returns: "No Spacegroup" when the spacegroup of a molecule has not been set.


Next: , Previous: show-spacegroup, Up: Map and Molecule Control   [Contents][Index]

11.40.16 symmetry-operators-scm

function: symmetry-operators-scm imol

Where imol is an integer number

return a list of symmetry operators as strings - or scheme false if that is not possible.


Previous: symmetry-operators-scm, Up: Map and Molecule Control   [Contents][Index]

11.40.17 symmetry-operators-py

function: symmetry-operators-py imol

Where imol is an integer number

return a list of symmetry operators as strings - or Python False if that is not possible.


Next: , Previous: Map and Molecule Control, Up: Scripting Functions   [Contents][Index]

11.41 Align and Mutate


Next: , Up: Align and Mutate   [Contents][Index]

11.41.1 align-and-mutate

function: align-and-mutate imol chain_id fasta_maybe renumber_residues_flag

Where:

align and mutate the given chain to the given sequence


Next: , Previous: align-and-mutate, Up: Align and Mutate   [Contents][Index]

11.41.2 set-alignment-gap-and-space-penalty

function: set-alignment-gap-and-space-penalty wgap wspace

Where:

set the penalty for affine gap and space when aligning, defaults -3.0 and -0.4


Next: , Previous: set-alignment-gap-and-space-penalty, Up: Align and Mutate   [Contents][Index]

11.41.3 nearest-residue-by-sequence-scm

function: nearest-residue-by-sequence-scm imol chain_id resno ins_code

Where:

return the residue spec of the nearest residue by sequence numbering.

Returns: scheme false if not possible


Previous: nearest-residue-by-sequence-scm, Up: Align and Mutate   [Contents][Index]

11.41.4 nearest-residue-by-sequence-py

function: nearest-residue-by-sequence-py imol chain_id resno ins_code

Where:

return the residue spec of the nearest residue by sequence numbering. Return Python False if not possible


Next: , Previous: Align and Mutate, Up: Scripting Functions   [Contents][Index]

11.42 Renumber Residue Range


Next: , Up: Renumber Residue Range   [Contents][Index]

11.42.1 renumber-residue-range

function: renumber-residue-range imol chain_id start_res last_res offset

Where:

renumber the given residue range by offset residues


Previous: renumber-residue-range, Up: Renumber Residue Range   [Contents][Index]

11.42.2 change-residue-number

function: change-residue-number imol chain_id current_resno current_inscode new_resno new_inscode

Where:

change chain id, residue number or insertion code for given residue


Next: , Previous: Renumber Residue Range, Up: Scripting Functions   [Contents][Index]

11.43 Scripting Interface


Next: , Up: Scripting Interface   [Contents][Index]

11.43.1 probe-available-p

function: probe-available-p

Can we run probe (was the executable variable set properly?) (predicate).

Returns: 1 for yes, 2 for no


Next: , Previous: probe-available-p, Up: Scripting Interface   [Contents][Index]

11.43.2 post-scripting-window

function: post-scripting-window

do nothing - compatibility function


Next: , Previous: post-scripting-window, Up: Scripting Interface   [Contents][Index]

11.43.3 post-scheme-scripting-window

function: post-scheme-scripting-window

pop-up a scripting window for scheming


Previous: post-scheme-scripting-window, Up: Scripting Interface   [Contents][Index]

11.43.4 post-python-scripting-window

function: post-python-scripting-window

pop-up a scripting window for pythoning


Next: , Previous: Scripting Interface, Up: Scripting Functions   [Contents][Index]

11.44 Monomer


Next: , Up: Monomer   [Contents][Index]

11.44.1 run-script

function: run-script filename

Where filename is a string

run script file


Next: , Previous: run-script, Up: Monomer   [Contents][Index]

11.44.2 run-guile-script

function: run-guile-script filename

Where filename is a string

guile run script file


Next: , Previous: run-guile-script, Up: Monomer   [Contents][Index]

11.44.3 run-python-script

function: run-python-script filename

Where filename is a string

run python script file


Next: , Previous: run-python-script, Up: Monomer   [Contents][Index]

11.44.4 import-python-module

function: import-python-module module_name use_namespace

Where:

import python module


Next: , Previous: import-python-module, Up: Monomer   [Contents][Index]

11.44.5 matching-compound-names-from-dictionary-scm

function: matching-compound-names-from-dictionary-scm compound_name_fragment allow_minimal_descriptions_flag

Where:

return a list of compoundIDs in the dictionary of which the given string is a substring of the compound name


Next: , Previous: matching-compound-names-from-dictionary-scm, Up: Monomer   [Contents][Index]

11.44.6 comp-id-to-name-scm

function: comp-id-to-name-scm comp_id

Where comp_id is a string

return the monomer name

return scheme false if not found


Next: , Previous: comp-id-to-name-scm, Up: Monomer   [Contents][Index]

11.44.7 auto-load-dictionary

function: auto-load-dictionary comp_id

Where comp_id is a string

try to auto-load the dictionary for comp_id from the refmac monomer library.

return 0 on failure. return 1 on successful auto-load. return 2 on already-read.


Next: , Previous: auto-load-dictionary, Up: Monomer   [Contents][Index]

11.44.8 reload-dictionary

function: reload-dictionary comp_id

Where comp_id is a string

as above, but dictionary is cleared and re-read if it already exists


Next: , Previous: reload-dictionary, Up: Monomer   [Contents][Index]

11.44.9 add-non-auto-load-residue-name

function: add-non-auto-load-residue-name s

Where s is a string

add residue name to the list of residue names that don’t get auto-loaded from the Refmac dictionary.


Next: , Previous: add-non-auto-load-residue-name, Up: Monomer   [Contents][Index]

11.44.10 remove-non-auto-load-residue-name

function: remove-non-auto-load-residue-name s

Where s is a string

remove residue name from the list of residue names that don’t get auto-loaded from the Refmac dictionary.


Next: , Previous: remove-non-auto-load-residue-name, Up: Monomer   [Contents][Index]

11.44.11 matching-compound-names-from-dictionary-py

function: matching-compound-names-from-dictionary-py compound_name_fragment allow_minimal_descriptions_flag

Where:

return a list of compoundIDs in the dictionary which the given string is a substring of the compound name


Previous: matching-compound-names-from-dictionary-py, Up: Monomer   [Contents][Index]

11.44.12 comp-id-to-name-py

function: comp-id-to-name-py comp_id

Where comp_id is a string

return the monomer name

return python false if not found


Next: , Previous: Monomer, Up: Scripting Functions   [Contents][Index]

11.45 Regularization and Refinement


Next: , Up: Regularization and Refinement   [Contents][Index]

11.45.1 add-planar-peptide-restraints

function: add-planar-peptide-restraints

add a restraint on peptides to make them planar

This adds a 5 atom restraint that includes both CA atoms of the peptide. Use this rather than editting the mon_lib_list.cif file.


Next: , Previous: add-planar-peptide-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.2 remove-planar-peptide-restraints

function: remove-planar-peptide-restraints

remove restraints on peptides to make them planar.


Next: , Previous: remove-planar-peptide-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.3 make-tight-planar-peptide-restraints

function: make-tight-planar-peptide-restraints

make the planar peptide restraints tight

Useful when refining models with cryo-EM maps


Next: , Previous: make-tight-planar-peptide-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.4 set-use-trans-peptide-restraints

function: set-use-trans-peptide-restraints on_off_state

Where on_off_state is an integer number

add a restraint on peptides to keep trans peptides trans

i.e. omega in trans-peptides is restraints to 180 degrees.


Next: , Previous: set-use-trans-peptide-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.5 add-omega-torsion-restriants

function: add-omega-torsion-restriants

add restraints on the omega angle of the peptides

(that is the torsion round the peptide bond). Omega angles that are closer to 0 than to 180 will be refined as cis peptides (and of course if omega is greater than 90 then the peptide will be refined as a trans peptide (this is the normal case).


Next: , Previous: add-omega-torsion-restriants, Up: Regularization and Refinement   [Contents][Index]

11.45.6 remove-omega-torsion-restriants

function: remove-omega-torsion-restriants

remove omega restraints on CIS and TRANS linked residues.


Next: , Previous: remove-omega-torsion-restriants, Up: Regularization and Refinement   [Contents][Index]

11.45.7 set-auto-h-bond-restraints

function: set-auto-h-bond-restraints state

Where state is an integer number

add or remove auto H-bond restraints


Next: , Previous: set-auto-h-bond-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.8 set-refinement-immediate-replacement

function: set-refinement-immediate-replacement istate

Where istate is an integer number

set immediate replacement mode for refinement and regularization. You need this (call with istate=1) if you are scripting refinement/regularization


Next: , Previous: set-refinement-immediate-replacement, Up: Regularization and Refinement   [Contents][Index]

11.45.9 refinement-immediate-replacement-state

function: refinement-immediate-replacement-state

query the state of the immediate replacement mode


Next: , Previous: refinement-immediate-replacement-state, Up: Regularization and Refinement   [Contents][Index]

11.45.10 set-residue-selection-flash-frames-number

function: set-residue-selection-flash-frames-number i

Where i is an integer number

set the number of frames for which the selected residue range flashes

On fast computers, this can be set to higher than the default for more aesthetic appeal.


Next: , Previous: set-residue-selection-flash-frames-number, Up: Regularization and Refinement   [Contents][Index]

11.45.11 accept-moving-atoms

function: accept-moving-atoms

accept the new positions of the regularized or refined residues

If you are scripting refinement and/or regularization, this is the function that you need to call after refine-zone or regularize-zone.


Next: , Previous: accept-moving-atoms, Up: Regularization and Refinement   [Contents][Index]

11.45.12 accept-regularizement

function: accept-regularizement

a hideous alias for the above


Next: , Previous: accept-regularizement, Up: Regularization and Refinement   [Contents][Index]

11.45.13 refinement-already-ongoing-p

function: refinement-already-ongoing-p

If there is a refinement on-going already, we don’t want to start a new one.

The is the means to ask if that is the case. This needs a scheme wrapper to provide refinement-already-ongoing? The question is translated to "are the intermediate atoms being displayed?" so that might be a more accurate function name than the current one.

Returns: 1 for yes, 0 for no.


Next: , Previous: refinement-already-ongoing-p, Up: Regularization and Refinement   [Contents][Index]

11.45.14 refine-residues-scm

function: refine-residues-scm imol r

Where:

refine residues, r is a list of residue specs.

1 - an information string (in case of error)

2 - the progress variable (from GSL)

3 - refinement results for each particular geometry type (bonds, angles etc.)

Returns: refinement results, which consists of


Next: , Previous: refine-residues-scm, Up: Regularization and Refinement   [Contents][Index]

11.45.15 refine-residues-py

function: refine-residues-py imol r

Where:

refine the residues in the given residue spec list

Returns: the refinement summary statistics


Next: , Previous: refine-residues-py, Up: Regularization and Refinement   [Contents][Index]

11.45.16 shiftfield-b-factor-refinement

function: shiftfield-b-factor-refinement imol

Where imol is an integer number

shiftfield B-factor refinement


Next: , Previous: shiftfield-b-factor-refinement, Up: Regularization and Refinement   [Contents][Index]

11.45.17 shiftfield-xyz-factor-refinement

function: shiftfield-xyz-factor-refinement imol

Where imol is an integer number

shiftfield xyz refinement


Next: , Previous: shiftfield-xyz-factor-refinement, Up: Regularization and Refinement   [Contents][Index]

11.45.18 set-refine-with-torsion-restraints

function: set-refine-with-torsion-restraints istate

Where istate is an integer number

turn on (or off) torsion restraints

Pass with istate=1 for on, istate=0 for off.


Next: , Previous: set-refine-with-torsion-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.19 refine-with-torsion-restraints-state

function: refine-with-torsion-restraints-state

return the state of above


Next: , Previous: refine-with-torsion-restraints-state, Up: Regularization and Refinement   [Contents][Index]

11.45.20 set-matrix

function: set-matrix f

Where f is a number

set the relative weight of the geometric terms to the map terms

The default is 60.

The higher the number the more weight that is given to the map terms but the resulting chi squared values are higher). This will be needed for maps generated from data not on (or close to) the absolute scale or maps that have been scaled (for example so that the sigma level has been scaled to 1.0).


Next: , Previous: set-matrix, Up: Regularization and Refinement   [Contents][Index]

11.45.21 matrix-state

function: matrix-state

return the relative weight of the geometric terms to the map terms.


Next: , Previous: matrix-state, Up: Regularization and Refinement   [Contents][Index]

11.45.22 get-map-weight

function: get-map-weight

return the relative weight of the geometric terms to the map terms.

A more sensible name for the

function)


Next: , Previous: get-map-weight, Up: Regularization and Refinement   [Contents][Index]

11.45.23 set-refine-auto-range-step

function: set-refine-auto-range-step i

Where i is an integer number

change the +/- step for autoranging (default is 1)

Auto-ranging alow you to select a range from one button press, this allows you to set the number of residues either side of the clicked residue that becomes the selected zone


Next: , Previous: set-refine-auto-range-step, Up: Regularization and Refinement   [Contents][Index]

11.45.24 set-refine-max-residues

function: set-refine-max-residues n

Where n is an integer number

set the heuristic fencepost for the maximum number of residues in the refinement/regularization residue range

Default is 20


Next: , Previous: set-refine-max-residues, Up: Regularization and Refinement   [Contents][Index]

11.45.25 refine-zone-atom-index-define

function: refine-zone-atom-index-define imol ind1 ind2

Where:

refine a zone based on atom indexing


Next: , Previous: refine-zone-atom-index-define, Up: Regularization and Refinement   [Contents][Index]

11.45.26 refine-zone

function: refine-zone imol chain_id resno1 resno2 altconf

Where:

refine a zone

presumes that imol_Refinement_Map has been set


Next: , Previous: refine-zone, Up: Regularization and Refinement   [Contents][Index]

11.45.27 repeat-refine-zone

function: repeat-refine-zone

repeat the previous (user-selected) refine zone


Next: , Previous: repeat-refine-zone, Up: Regularization and Refinement   [Contents][Index]

11.45.28 refine-auto-range

function: refine-auto-range imol chain_id resno1 altconf

Where:

refine a zone using auto-range

presumes that imol_Refinement_Map has been set


Next: , Previous: refine-auto-range, Up: Regularization and Refinement   [Contents][Index]

11.45.29 regularize-zone

function: regularize-zone imol chain_id resno1 resno2 altconf

Where:

regularize a zone

Returns: a status, whether the regularisation was done or not. 0 for no, 1 for yes.


Next: , Previous: regularize-zone, Up: Regularization and Refinement   [Contents][Index]

11.45.30 set-dragged-refinement-steps-per-frame

function: set-dragged-refinement-steps-per-frame v

Where v is an integer number

set the number of refinement steps applied to the intermediate atoms each frame of graphics.

smaller numbers make the movement of the intermediate atoms slower, smoother, more elegant.

Default: 80.


Next: , Previous: set-dragged-refinement-steps-per-frame, Up: Regularization and Refinement   [Contents][Index]

11.45.31 dragged-refinement-steps-per-frame

function: dragged-refinement-steps-per-frame

return the number of steps per frame in dragged refinement


Next: , Previous: dragged-refinement-steps-per-frame, Up: Regularization and Refinement   [Contents][Index]

11.45.32 set-refinement-refine-per-frame

function: set-refinement-refine-per-frame istate

Where istate is an integer number

allow refinement of intermediate atoms after dragging, before displaying (default: 0, off).

An attempt to do something like xfit does, at the request of Frank von Delft.

Pass with istate=1 to enable this option.


Next: , Previous: set-refinement-refine-per-frame, Up: Regularization and Refinement   [Contents][Index]

11.45.33 refinement-refine-per-frame-state

function: refinement-refine-per-frame-state

query the state of the above option


Next: , Previous: refinement-refine-per-frame-state, Up: Regularization and Refinement   [Contents][Index]

11.45.34 set-refinement-drag-elasticity

function: set-refinement-drag-elasticity e

Where e is a number

the elasticity of the dragged atom in refinement mode.

Default 0.33

Bigger numbers mean bigger movement of the other atoms.


Next: , Previous: set-refinement-drag-elasticity, Up: Regularization and Refinement   [Contents][Index]

11.45.35 set-refine-ramachandran-angles

function: set-refine-ramachandran-angles state

Where state is an integer number

turn on Ramachandran angles refinement in refinement and regularization

name consistent with

!?


Next: , Previous: set-refine-ramachandran-angles, Up: Regularization and Refinement   [Contents][Index]

11.45.36 set-refine-ramachandran-restraints-type

function: set-refine-ramachandran-restraints-type type

Where type is an integer number

change the target function type


Next: , Previous: set-refine-ramachandran-restraints-type, Up: Regularization and Refinement   [Contents][Index]

11.45.37 set-refine-ramachandran-restraints-weight

function: set-refine-ramachandran-restraints-weight w

Where w is a number

change the target function weight

a big number means bad things


Next: , Previous: set-refine-ramachandran-restraints-weight, Up: Regularization and Refinement   [Contents][Index]

11.45.38 set-fix-chiral-volumes-before-refinement

function: set-fix-chiral-volumes-before-refinement istate

Where istate is an integer number

correct the sign of chiral volumes before commencing refinement?

Do we want to fix chiral volumes (by moving the chiral atom to the other side of the chiral plane if necessary). Default yes (1). Note: doesn’t work currently.


Next: , Previous: set-fix-chiral-volumes-before-refinement, Up: Regularization and Refinement   [Contents][Index]

11.45.39 check-chiral-volumes

function: check-chiral-volumes imol

Where imol is an integer number

query the state of the above option


Next: , Previous: check-chiral-volumes, Up: Regularization and Refinement   [Contents][Index]

11.45.40 set-show-chiral-volume-errors-dialog

function: set-show-chiral-volume-errors-dialog istate

Where istate is an integer number

For experienced Cooters who don’t like Coot nannying about chiral volumes during refinement.


Next: , Previous: set-show-chiral-volume-errors-dialog, Up: Regularization and Refinement   [Contents][Index]

11.45.41 set-secondary-structure-restraints-type

function: set-secondary-structure-restraints-type itype

Where itype is an integer number

set the type of secondary structure restraints

0 no sec str restraints

1 alpha helix restraints

2 beta strand restraints


Next: , Previous: set-secondary-structure-restraints-type, Up: Regularization and Refinement   [Contents][Index]

11.45.42 secondary-structure-restraints-type

function: secondary-structure-restraints-type

return the secondary structure restraints type


Next: , Previous: secondary-structure-restraints-type, Up: Regularization and Refinement   [Contents][Index]

11.45.43 imol-refinement-map

function: imol-refinement-map

the molecule number of the map used for refinement

Returns: the map number, if it has been set or there is only one map, return -1 on no map set (ambiguous) or no maps.


Next: , Previous: imol-refinement-map, Up: Regularization and Refinement   [Contents][Index]

11.45.44 set-imol-refinement-map

function: set-imol-refinement-map imol

Where imol is an integer number

set the molecule number of the map to be used for refinement/fitting.

Returns: imol on success, -1 on failure


Next: , Previous: set-imol-refinement-map, Up: Regularization and Refinement   [Contents][Index]

11.45.45 does-residue-exist-p

function: does-residue-exist-p imol chain_id resno inscode

Where:

Does the residue exist? (Raw function)

Returns: 0 on not-exist, 1 on does exist.


Next: , Previous: does-residue-exist-p, Up: Regularization and Refinement   [Contents][Index]

11.45.46 delete-restraints

function: delete-restraints comp_id

Where comp_id is a string

delete the restraints for the given comp_id (i.e. residue name)

Returns: success status (0 is failed, 1 is success)


Next: , Previous: delete-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.47 add-extra-bond-restraint

function: add-extra-bond-restraint imol chain_id_1 res_no_1 ins_code_1 atom_name_1 alt_conf_1 chain_id_2 res_no_2 ins_code_2 atom_name_2 alt_conf_2 bond_dist esd

Where:

add a user-define bond restraint

this extra restraint is used when the given atoms are selected in refinement or regularization.

Returns: the index of the new restraint.

Returns: -1 when the atoms were not found and no extra bond restraint was stored.


Next: , Previous: add-extra-bond-restraint, Up: Regularization and Refinement   [Contents][Index]

11.45.48 add-extra-geman-mcclure-restraint

function: add-extra-geman-mcclure-restraint imol chain_id_1 res_no_1 ins_code_1 atom_name_1 alt_conf_1 chain_id_2 res_no_2 ins_code_2 atom_name_2 alt_conf_2 bond_dist esd

Where:

add a user-define GM distance restraint

this extra restraint is used when the given atoms are selected in refinement or regularization.

Returns: the index of the new restraint.

Returns: -1 when the atoms were not found and no extra bond restraint was stored.


Next: , Previous: add-extra-geman-mcclure-restraint, Up: Regularization and Refinement   [Contents][Index]

11.45.49 delete-all-extra-restraints

function: delete-all-extra-restraints imol

Where imol is an integer number

clear out all the extra/user-defined restraints for molecule number imol


Next: , Previous: delete-all-extra-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.50 delete-extra-restraints-for-residue

function: delete-extra-restraints-for-residue imol chain_id res_no ins_code

Where:

clear out all the extra/user-defined restraints for this residue in molecule number imol


Next: , Previous: delete-extra-restraints-for-residue, Up: Regularization and Refinement   [Contents][Index]

11.45.51 set-extra-restraints-prosmart-sigma-limits

function: set-extra-restraints-prosmart-sigma-limits imol limit_high limit_low

Where:

often we don’t want to see all prosmart restraints, just the (big) violations


Next: , Previous: set-extra-restraints-prosmart-sigma-limits, Up: Regularization and Refinement   [Contents][Index]

11.45.52 generate-local-self-restraints

function: generate-local-self-restraints imol chain_id local_dist_max

Where:

generate external distance local self restraints


Next: , Previous: generate-local-self-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.53 generate-self-restraints

function: generate-self-restraints imol local_dist_max

Where:

generate external distance all-molecule self restraints


Next: , Previous: generate-self-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.54 generate-local-self-restraints-by-residues-scm

function: generate-local-self-restraints-by-residues-scm imol residue_specs local_dist_max

Where:

generate external distance self restraints for selected residues


Next: , Previous: generate-local-self-restraints-by-residues-scm, Up: Regularization and Refinement   [Contents][Index]

11.45.55 write-interpolated-extra-restraints

function: write-interpolated-extra-restraints imol_1 imol_2 n_steps file_name_stub

Where:

proSMART interpolated restraints for model morphing


Next: , Previous: write-interpolated-extra-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.56 write-interpolated-models-and-extra-restraints

function: write-interpolated-models-and-extra-restraints imol_1 imol_2 n_steps file_name_stub interpolation_mode

Where:

proSMART interpolated restraints for model morphing and write interpolated model

interpolation_mode is currently dummy - in due course I will addd torion angle interpolation.


Next: , Previous: write-interpolated-models-and-extra-restraints, Up: Regularization and Refinement   [Contents][Index]

11.45.57 set-use-only-extra-torsion-restraints-for-torsions

function: set-use-only-extra-torsion-restraints-for-torsions state

Where state is an integer number

set use only extra torsion restraints for torsions


Next: , Previous: set-use-only-extra-torsion-restraints-for-torsions, Up: Regularization and Refinement   [Contents][Index]

11.45.58 use-only-extra-torsion-restraints-for-torsions-state

function: use-only-extra-torsion-restraints-for-torsions-state

return only-use-extra-torsion-restraints-for-torsions state


Next: , Previous: use-only-extra-torsion-restraints-for-torsions-state, Up: Regularization and Refinement   [Contents][Index]

11.45.59 show-restraints-editor

function: show-restraints-editor monomer_type

Where monomer_type is a string

show restraints editor


Next: , Previous: show-restraints-editor, Up: Regularization and Refinement   [Contents][Index]

11.45.60 show-restraints-editor-by-index

function: show-restraints-editor-by-index menu_item_index

Where menu_item_index is an integer number

show restraints editor using residue type index


Previous: show-restraints-editor-by-index, Up: Regularization and Refinement   [Contents][Index]

11.45.61 write-restraints-cif-dictionary

function: write-restraints-cif-dictionary monomer_type file_name

Where:

write cif restraints for monomer


Next: , Previous: Regularization and Refinement, Up: Scripting Functions   [Contents][Index]

11.46 Simplex Refinement Interface


Next: , Up: Simplex Refinement Interface   [Contents][Index]

11.46.1 fit-residue-range-to-map-by-simplex

function: fit-residue-range-to-map-by-simplex res1 res2 altloc chain_id imol imol_for_map

Where:

refine residue range using simplex optimization


Previous: fit-residue-range-to-map-by-simplex, Up: Simplex Refinement Interface   [Contents][Index]

11.46.2 score-residue-range-fit-to-map

function: score-residue-range-fit-to-map res1 res2 altloc chain_id imol imol_for_map

Where:

simply score the residue range fit to map


Next: , Previous: Simplex Refinement Interface, Up: Scripting Functions   [Contents][Index]

11.47 Nomenclature Errors


Next: , Up: Nomenclature Errors   [Contents][Index]

11.47.1 fix-nomenclature-errors

function: fix-nomenclature-errors imol

Where imol is an integer number

fix nomenclature errors in molecule number imol

Returns: the number of resides altered.


Previous: fix-nomenclature-errors, Up: Nomenclature Errors   [Contents][Index]

11.47.2 set-nomenclature-errors-on-read

function: set-nomenclature-errors-on-read mode

Where mode is a string

set way nomenclature errors should be handled on reading coordinates.

mode should be "auto-correct", "ignore", "prompt". The default is "prompt"


Next: , Previous: Nomenclature Errors, Up: Scripting Functions   [Contents][Index]

11.48 Atom Info Interface


Up: Atom Info Interface   [Contents][Index]

11.48.1 output-atom-info-as-text

function: output-atom-info-as-text imol chain_id resno ins_code atname altconf

Where:

output to the terminal the Atom Info for the give atom specs


Next: , Previous: Atom Info Interface, Up: Scripting Functions   [Contents][Index]

11.49 Residue Info


Up: Residue Info   [Contents][Index]

11.49.1 residue-info-dialog

function: residue-info-dialog imol chain_id resno ins_code

Where:

show residue info dialog for given residue


Next: , Previous: Residue Info, Up: Scripting Functions   [Contents][Index]

11.50 Residue Environment Functions


Next: , Up: Residue Environment Functions   [Contents][Index]

11.50.1 set-show-environment-distances

function: set-show-environment-distances state

Where state is an integer number

show environment distances. If state is 0, distances are turned off, otherwise distances are turned on.


Next: , Previous: set-show-environment-distances, Up: Residue Environment Functions   [Contents][Index]

11.50.2 set-show-environment-distances-bumps

function: set-show-environment-distances-bumps state

Where state is an integer number

show bumps environment distances. If state is 0, bump distances are turned off, otherwise bump distances are turned on.


Next: , Previous: set-show-environment-distances-bumps, Up: Residue Environment Functions   [Contents][Index]

11.50.3 set-show-environment-distances-h-bonds

function: set-show-environment-distances-h-bonds state

Where state is an integer number

show H-bond environment distances. If state is 0, bump distances are turned off, otherwise H-bond distances are turned on.


Next: , Previous: set-show-environment-distances-h-bonds, Up: Residue Environment Functions   [Contents][Index]

11.50.4 show-environment-distances-state

function: show-environment-distances-state

show the state of display of the environment distances


Next: , Previous: show-environment-distances-state, Up: Residue Environment Functions   [Contents][Index]

11.50.5 set-environment-distances-distance-limits

function: set-environment-distances-distance-limits min_dist max_dist

Where:

min and max distances for the environment distances


Next: , Previous: set-environment-distances-distance-limits, Up: Residue Environment Functions   [Contents][Index]

11.50.6 set-show-environment-distances-as-solid

function: set-show-environment-distances-as-solid state

Where state is an integer number

show the environment distances with solid modelling


Next: , Previous: set-show-environment-distances-as-solid, Up: Residue Environment Functions   [Contents][Index]

11.50.7 set-environment-distances-label-atom

function: set-environment-distances-label-atom state

Where state is an integer number

Label the atom on Environment Distances start/change.


Next: , Previous: set-environment-distances-label-atom, Up: Residue Environment Functions   [Contents][Index]

11.50.8 label-neighbours

function: label-neighbours

Label the atoms in the residues around the central residue.


Next: , Previous: label-neighbours, Up: Residue Environment Functions   [Contents][Index]

11.50.9 label-atoms-in-residue

function: label-atoms-in-residue

Label the atoms in the central residue.


Previous: label-atoms-in-residue, Up: Residue Environment Functions   [Contents][Index]

11.50.10 add-geometry-distance

function: add-geometry-distance imol_1 x_1 y_1 z_1 imol_2 x_2 y_2 z_2

Where:

Add a geometry distance between points in a given molecule.

Returns: the distance between the points


Next: , Previous: Residue Environment Functions, Up: Scripting Functions   [Contents][Index]

11.51 Pointer Position Function


Up: Pointer Position Function   [Contents][Index]

11.51.1 get-pointer-position-frac-py

function: get-pointer-position-frac-py

return the [x,y] position of the pointer in fractional coordinates.

the origin is top-left. may return false if pointer is not available


Next: , Previous: Pointer Position Function, Up: Scripting Functions   [Contents][Index]

11.52 Pointer Functions


Next: , Up: Pointer Functions   [Contents][Index]

11.52.1 set-show-pointer-distances

function: set-show-pointer-distances istate

Where istate is an integer number

turn on (or off) the pointer distance by passing 1 (or 0).


Previous: set-show-pointer-distances, Up: Pointer Functions   [Contents][Index]

11.52.2 show-pointer-distances-state

function: show-pointer-distances-state

show the state of display of the pointer distances


Next: , Previous: Pointer Functions, Up: Scripting Functions   [Contents][Index]

11.53 Zoom Functions


Next: , Up: Zoom Functions   [Contents][Index]

11.53.1 scale-zoom

function: scale-zoom f

Where f is a number

scale the view by f

external (scripting) interface (with redraw)


Next: , Previous: scale-zoom, Up: Zoom Functions   [Contents][Index]

11.53.2 zoom-factor

function: zoom-factor

return the current zoom factor


Next: , Previous: zoom-factor, Up: Zoom Functions   [Contents][Index]

11.53.3 set-smooth-scroll-do-zoom

function: set-smooth-scroll-do-zoom i

Where i is an integer number

set smooth scroll with zoom


Previous: set-smooth-scroll-do-zoom, Up: Zoom Functions   [Contents][Index]

11.53.4 smooth-scroll-do-zoom

function: smooth-scroll-do-zoom

return the state of the above system


Next: , Previous: Zoom Functions, Up: Scripting Functions   [Contents][Index]

11.54 CNS Data Functions


Next: , Up: CNS Data Functions   [Contents][Index]

11.54.1 handle-cns-data-file

function: handle-cns-data-file filename imol

Where:

read CNS data (currently only a placeholder)


Previous: handle-cns-data-file, Up: CNS Data Functions   [Contents][Index]

11.54.2 handle-cns-data-file-with-cell

function: handle-cns-data-file-with-cell filename imol a b c alpha beta gamma spg_info

Where:

read CNS data (currently only a placeholder)

a, b,c are in Angstroems. alpha, beta, gamma are in degrees. spg is the space group info, either ;-delimited symmetry operators or the space group name


Next: , Previous: CNS Data Functions, Up: Scripting Functions   [Contents][Index]

11.55 mmCIF Functions


Next: , Up: mmCIF Functions   [Contents][Index]

11.55.1 open-cif-dictionary-file-selector-dialog

function: open-cif-dictionary-file-selector-dialog

open the cif dictionary file selector dialog


Next: , Previous: open-cif-dictionary-file-selector-dialog, Up: mmCIF Functions   [Contents][Index]

11.55.2 non-standard-residue-names-scm

function: non-standard-residue-names-scm imol

Where imol is an integer number

non-standard residue/monomer names (note HOH is not non-standard).


Previous: non-standard-residue-names-scm, Up: mmCIF Functions   [Contents][Index]

11.55.3 non-standard-residue-names-py

function: non-standard-residue-names-py imol

Where imol is an integer number

non-standard residue/monomer names (note HOH is not non-standard).


Next: , Previous: mmCIF Functions, Up: Scripting Functions   [Contents][Index]

11.56 SHELXL Functions


Next: , Up: SHELXL Functions   [Contents][Index]

11.56.1 read-shelx-ins-file

function: read-shelx-ins-file filename recentre_flag

Where:

read a SHELXL .ins file


Previous: read-shelx-ins-file, Up: SHELXL Functions   [Contents][Index]

11.56.2 write-shelx-ins-file

function: write-shelx-ins-file imol filename

Where:

write a SHELXL .ins file for molecule number imol


Next: , Previous: SHELXL Functions, Up: Scripting Functions   [Contents][Index]

11.57 Validation Functions


Next: , Up: Validation Functions   [Contents][Index]

11.57.1 difference-map-peaks

function: difference-map-peaks imol imol_coords level max_closeness do_positive_level_flag do_negative_level_flag

Where:

generate a list of difference map peaks

peaks within max_closeness (2.0 A typically) of a larger peak are not listed.


Next: , Previous: difference-map-peaks, Up: Validation Functions   [Contents][Index]

11.57.2 gln-asn-b-factor-outliers

function: gln-asn-b-factor-outliers imol

Where imol is an integer number

Make a gui for GLN adn ASN B-factor outiers, compairing the O and N temperatur factors difference to the distribution of temperature factors from the other atoms.


Next: , Previous: gln-asn-b-factor-outliers, Up: Validation Functions   [Contents][Index]

11.57.3 map-peaks-py

function: map-peaks-py imol_map n_sigma

Where:

return a list of map peaks of molecule number imol_map above n_sigma. There will be cluster filtering of the map peaks. Return a list of 3d cartestian coordinates or Python False if imol_map is not suitable for peak picking.


Next: , Previous: map-peaks-py, Up: Validation Functions   [Contents][Index]

11.57.4 map-peaks-scm

function: map-peaks-scm imol_map n_sigma

Where:

return a list of map peaks of molecule number imol_map above n_sigma. There will be cluster filtering of the map peaks. Return a list of 3d cartestian coordinates or scheme false if imol_map is not suitable for peak picking.


Next: , Previous: map-peaks-scm, Up: Validation Functions   [Contents][Index]

11.57.5 set-torsion-scm

function: set-torsion-scm imol chain_id res_no insertion_code alt_conf atom_name_1 atom_name_2 atom_name_3 atom_name_4 tors

Where:

set the given torsion the given residue. tors is in degrees. Return the resulting torsion (also in degrees).


Next: , Previous: set-torsion-scm, Up: Validation Functions   [Contents][Index]

11.57.6 multi-residue-torsion-scm

function: multi-residue-torsion-scm imol residues_specs_scm

Where:

create a multi-residue torsion dialog (user manipulation of torsions)


Next: , Previous: multi-residue-torsion-scm, Up: Validation Functions   [Contents][Index]

11.57.7 set-torsion-py

function: set-torsion-py imol chain_id res_no insertion_code alt_conf atom_name_1 atom_name_2 atom_name_3 atom_name_4 tors

Where:

set the given torsion the given residue. tors is in degrees. Return the resulting torsion (also in degrees).


Previous: set-torsion-py, Up: Validation Functions   [Contents][Index]

11.57.8 multi-residue-torsion-py

function: multi-residue-torsion-py imol residues_specs_py

Where:

create a multi-residue torsion dialog (user manipulation of torsions)


Next: , Previous: Validation Functions, Up: Scripting Functions   [Contents][Index]

11.58 Ramachandran Plot Functions


Next: , Up: Ramachandran Plot Functions   [Contents][Index]

11.58.1 do-ramachandran-plot

function: do-ramachandran-plot imol

Where imol is an integer number

Ramachandran plot for molecule number imol.


Next: , Previous: do-ramachandran-plot, Up: Ramachandran Plot Functions   [Contents][Index]

11.58.2 set-kleywegt-plot-n-diffs

function: set-kleywegt-plot-n-diffs n_diffs

Where n_diffs is an integer number

set the number of biggest difference arrows on the Kleywegt plot.


Next: , Previous: set-kleywegt-plot-n-diffs, Up: Ramachandran Plot Functions   [Contents][Index]

11.58.3 set-ramachandran-plot-contour-levels

function: set-ramachandran-plot-contour-levels level_prefered level_allowed

Where:

set the contour levels for the ramachandran plot, default values are 0.02 (prefered) 0.002 (allowed)


Next: , Previous: set-ramachandran-plot-contour-levels, Up: Ramachandran Plot Functions   [Contents][Index]

11.58.4 set-ramachandran-plot-background-block-size

function: set-ramachandran-plot-background-block-size blocksize

Where blocksize is a number

set the ramachandran plot background block size.

Smaller is smoother but slower. Should be divisible exactly into


Next: , Previous: set-ramachandran-plot-background-block-size, Up: Ramachandran Plot Functions   [Contents][Index]

11.58.5 set-ramachandran-psi-axis-mode

function: set-ramachandran-psi-axis-mode mode

Where mode is an integer number

set the psi axis for the ramachandran plot. Default (0) from -180 to 180. Alternative (1) from -120 to 240.


Next: , Previous: set-ramachandran-psi-axis-mode, Up: Ramachandran Plot Functions   [Contents][Index]

11.58.6 ramachandran-plot-differences

function: ramachandran-plot-differences imol1 imol2

Where:

2 molecule ramachandran plot (NCS differences) a.k.a. A Kleywegt Plot.


Previous: ramachandran-plot-differences, Up: Ramachandran Plot Functions   [Contents][Index]

11.58.7 ramachandran-plot-differences-by-chain

function: ramachandran-plot-differences-by-chain imol1 imol2 a_chain b_chain

Where:

A chain-specific Kleywegt Plot.


Next: , Previous: Ramachandran Plot Functions, Up: Scripting Functions   [Contents][Index]

11.59 Sequence View Interface


Up: Sequence View Interface   [Contents][Index]

11.59.1 do-sequence-view

function: do-sequence-view imol

Where imol is an integer number

display the sequence view dialog for molecule number imol


Next: , Previous: Sequence View Interface, Up: Scripting Functions   [Contents][Index]

11.60 Atom Labelling


Next: , Up: Atom Labelling   [Contents][Index]

11.60.1 set-brief-atom-labels

function: set-brief-atom-labels istat

Where istat is an integer number

use brief atom names for on-screen labels

call with istat=1 to use brief labels, istat=0 for normal labels


Next: , Previous: set-brief-atom-labels, Up: Atom Labelling   [Contents][Index]

11.60.2 brief-atom-labels-state

function: brief-atom-labels-state

the brief atom label state


Previous: brief-atom-labels-state, Up: Atom Labelling   [Contents][Index]

11.60.3 set-seg-ids-in-atom-labels

function: set-seg-ids-in-atom-labels istat

Where istat is an integer number

set if brief atom labels should have seg-ids also


Next: , Previous: Atom Labelling, Up: Scripting Functions   [Contents][Index]

11.61 Screen Rotation


Next: , Up: Screen Rotation   [Contents][Index]

11.61.1 rotate-y-scene

function: rotate-y-scene nsteps stepsize

Where:

rotate view round y axis stepsize degrees for nstep such steps


Next: , Previous: rotate-y-scene, Up: Screen Rotation   [Contents][Index]

11.61.2 rotate-x-scene

function: rotate-x-scene nsteps stepsize

Where:

rotate view round x axis stepsize degrees for nstep such steps


Next: , Previous: rotate-x-scene, Up: Screen Rotation   [Contents][Index]

11.61.3 rotate-z-scene

function: rotate-z-scene nsteps stepsize

Where:

rotate view round z axis stepsize degrees for nstep such steps


Previous: rotate-z-scene, Up: Screen Rotation   [Contents][Index]

11.61.4 spin-zoom-trans

function: spin-zoom-trans axis nstep stepsize zoom_by x_rel y_rel z_rel

Where:

Bells and whistles rotation.

spin, zoom and translate.

where axis is either x,y or z, stepsize is in degrees, zoom_by and x_rel etc are how much zoom, x,y,z should have changed by after nstep steps.


Next: , Previous: Screen Rotation, Up: Scripting Functions   [Contents][Index]

11.62 Screen Translation


Next: , Up: Screen Translation   [Contents][Index]

11.62.1 translate-scene-x

function: translate-scene-x nsteps

Where nsteps is an integer number

translate rotation centre relative to screen axes for nsteps


Next: , Previous: translate-scene-x, Up: Screen Translation   [Contents][Index]

11.62.2 translate-scene-y

function: translate-scene-y nsteps

Where nsteps is an integer number

translate rotation centre relative to screen axes for nsteps


Previous: translate-scene-y, Up: Screen Translation   [Contents][Index]

11.62.3 translate-scene-z

function: translate-scene-z nsteps

Where nsteps is an integer number

translate rotation centre relative to screen axes for nsteps


Next: , Previous: Screen Translation, Up: Scripting Functions   [Contents][Index]

11.63 Views Interface


Next: , Up: Views Interface   [Contents][Index]

11.63.1 add-view-here

function: add-view-here view_name

Where view_name is a string

return the view number


Next: , Previous: add-view-here, Up: Views Interface   [Contents][Index]

11.63.2 add-view-raw

function: add-view-raw rcx rcy rcz quat1 quat2 quat3 quat4 zoom view_name

Where:

return the view number


Next: , Previous: add-view-raw, Up: Views Interface   [Contents][Index]

11.63.3 remove-named-view

function: remove-named-view view_name

Where view_name is a string

the view with the given name


Next: , Previous: remove-named-view, Up: Views Interface   [Contents][Index]

11.63.4 remove-view

function: remove-view view_number

Where view_number is an integer number

the given view number


Next: , Previous: remove-view, Up: Views Interface   [Contents][Index]

11.63.5 add-view-description

function: add-view-description view_number description

Where:

Add a view description/annotation to the give view number.


Next: , Previous: add-view-description, Up: Views Interface   [Contents][Index]

11.63.6 add-action-view

function: add-action-view view_name action_function

Where:

add a view (not add to an existing view) that does something (e.g. displays or undisplays a molecule) rather than move the graphics.

Returns: the view number for this (new) view.


Next: , Previous: add-action-view, Up: Views Interface   [Contents][Index]

11.63.7 insert-action-view-after-view

function: insert-action-view-after-view view_number view_name action_function

Where:

add an action view after the view of the given view number

Returns: the view number for this (new) view.


Next: , Previous: insert-action-view-after-view, Up: Views Interface   [Contents][Index]

11.63.8 save-views

function: save-views view_file_name

Where view_file_name is a string

save views to view_file_name


Next: , Previous: save-views, Up: Views Interface   [Contents][Index]

11.63.9 view-name

function: view-name view_number

Where view_number is an integer number

return the name of the given view, if view_number does not specify a view return scheme value False


Next: , Previous: view-name, Up: Views Interface   [Contents][Index]

11.63.10 view-name-py

function: view-name-py view_number

Where view_number is an integer number

return the name of the given view, if view_number does not specify a view return Python value False


Previous: view-name-py, Up: Views Interface   [Contents][Index]

11.63.11 clear-all-views

function: clear-all-views

Clear the view list.


Next: , Previous: Views Interface, Up: Scripting Functions   [Contents][Index]

11.64 Background Colour


Next: , Up: Background Colour   [Contents][Index]

11.64.1 set-background-colour

function: set-background-colour red green blue

Where:

set the background colour

red, green and blue are numbers between 0.0 and 1.0


Next: , Previous: set-background-colour, Up: Background Colour   [Contents][Index]

11.64.2 redraw-background

function: redraw-background

re draw the background colour when switching between mono and stereo


Previous: redraw-background, Up: Background Colour   [Contents][Index]

11.64.3 background-is-black-p

function: background-is-black-p

is the background black (or nearly black)?

Returns: 1 if the background is black (or nearly black), else return 0.


Next: , Previous: Background Colour, Up: Scripting Functions   [Contents][Index]

11.65 Ligand Fitting Functions


Next: , Up: Ligand Fitting Functions   [Contents][Index]

11.65.1 set-ligand-acceptable-fit-fraction

function: set-ligand-acceptable-fit-fraction f

Where f is a number

set the fraction of atoms which must be in positive density after a ligand fit


Next: , Previous: set-ligand-acceptable-fit-fraction, Up: Ligand Fitting Functions   [Contents][Index]

11.65.2 set-ligand-cluster-sigma-level

function: set-ligand-cluster-sigma-level f

Where f is a number

set the default sigma level that the map is searched to find potential ligand sites


Next: , Previous: set-ligand-cluster-sigma-level, Up: Ligand Fitting Functions   [Contents][Index]

11.65.3 set-ligand-flexible-ligand-n-samples

function: set-ligand-flexible-ligand-n-samples i

Where i is an integer number

set the number of conformation samples

big ligands require more samples. Default 10.


Next: , Previous: set-ligand-flexible-ligand-n-samples, Up: Ligand Fitting Functions   [Contents][Index]

11.65.4 set-find-ligand-n-top-ligands

function: set-find-ligand-n-top-ligands n

Where n is an integer number

search the top n sites for ligands.

Default 10.


Next: , Previous: set-find-ligand-n-top-ligands, Up: Ligand Fitting Functions   [Contents][Index]

11.65.5 set-find-ligand-multi-solutions-per-cluster

function: set-find-ligand-multi-solutions-per-cluster lim_1 lim_2

Where:

allow multiple ligand solutions per cluster.

The first limit is the fraction of the top scored positions that go on to correlation scoring (closer to 1 means less and faster - default 0.7).

The second limit is the fraction of the top correlation score that is considered interesting. Limits the number of solutions displayed to user. Default 0.9.

There is currently no chi-angle set redundancy filtering - I suspect that there should be.

Nino-mode.


Next: , Previous: set-find-ligand-multi-solutions-per-cluster, Up: Ligand Fitting Functions   [Contents][Index]

11.65.6 set-find-ligand-mask-waters

function: set-find-ligand-mask-waters istate

Where istate is an integer number

how shall we treat the waters during ligand fitting?

pass with istate=1 for waters to mask the map in the same way that protein atoms do.


Next: , Previous: set-find-ligand-mask-waters, Up: Ligand Fitting Functions   [Contents][Index]

11.65.7 set-ligand-search-protein-molecule

function: set-ligand-search-protein-molecule imol

Where imol is an integer number

set the protein molecule for ligand searching


Next: , Previous: set-ligand-search-protein-molecule, Up: Ligand Fitting Functions   [Contents][Index]

11.65.8 set-ligand-search-map-molecule

function: set-ligand-search-map-molecule imol_map

Where imol_map is an integer number

set the map molecule for ligand searching


Next: , Previous: set-ligand-search-map-molecule, Up: Ligand Fitting Functions   [Contents][Index]

11.65.9 add-ligand-search-ligand-molecule

function: add-ligand-search-ligand-molecule imol_ligand

Where imol_ligand is an integer number

add a rigid ligand molecule to the list of ligands to search for in ligand searching


Next: , Previous: add-ligand-search-ligand-molecule, Up: Ligand Fitting Functions   [Contents][Index]

11.65.10 add-ligand-search-wiggly-ligand-molecule

function: add-ligand-search-wiggly-ligand-molecule imol_ligand

Where imol_ligand is an integer number

add a flexible ligand molecule to the list of ligands to search for in ligand searching


Next: , Previous: add-ligand-search-wiggly-ligand-molecule, Up: Ligand Fitting Functions   [Contents][Index]

11.65.11 set-find-ligand-here-cluster

function: set-find-ligand-here-cluster state

Where state is an integer number

Allow the user a scripting means to find ligand at the rotation centre.


Next: , Previous: set-find-ligand-here-cluster, Up: Ligand Fitting Functions   [Contents][Index]

11.65.12 ligand-expert

function: ligand-expert

this sets the flag to have expert option ligand entries in the Ligand Searching dialog


Next: , Previous: ligand-expert, Up: Ligand Fitting Functions   [Contents][Index]

11.65.13 do-find-ligands-dialog

function: do-find-ligands-dialog

display the find ligands dialog

if maps, coords and ligands are available, that is.


Next: , Previous: do-find-ligands-dialog, Up: Ligand Fitting Functions   [Contents][Index]

11.65.14 overlap-ligands

function: overlap-ligands imol_ligand imol_ref chain_id_ref resno_ref

Where:

Overlap residue with "template"-based matching.

Overlap the first residue in imol_ligand onto the residue specified by the reference parameters. Use graph matching, not atom names.

Returns: success status, False = failed to find residue in either imol_ligand or imo_ref. If success, return the RT operator.


Next: , Previous: overlap-ligands, Up: Ligand Fitting Functions   [Contents][Index]

11.65.15 match-ligand-atom-names

function: match-ligand-atom-names imol_ligand chain_id_ligand resno_ligand ins_code_ligand imol_reference chain_id_reference resno_reference ins_code_reference

Where:

Match ligand atom names.

By using graph matching, make the names of the atoms of the given ligand/residue match those of the reference residue/ligand as closely as possible - where there would be an atom name clash, invent a new atom name.


Next: , Previous: match-ligand-atom-names, Up: Ligand Fitting Functions   [Contents][Index]

11.65.16 match-ligand-atom-names-to-comp-id

function: match-ligand-atom-names-to-comp-id imol_ligand chain_id_ligand resno_ligand ins_code_ligand comp_id_ref

Where:

Match ligand atom names to a reference ligand type (comp_id)

By using graph matching, make the names of the atoms of the given ligand/residue match those of the reference ligand from the geometry store as closely as possible. Where there would be an atom name clash, invent a new atom name.

This doesn’t create a new dictionary for the selected ligand - and that’s a big problem (see match_residue_and_dictionary).


Previous: match-ligand-atom-names-to-comp-id, Up: Ligand Fitting Functions   [Contents][Index]

11.65.17 flip-ligand

function: flip-ligand imol chain_id resno

Where:

flip the ligand (usually active residue) around its eigen vectors to the next flip number. Immediate replacement (like flip peptide).


Next: , Previous: Ligand Fitting Functions, Up: Scripting Functions   [Contents][Index]

11.66 Water Fitting Functions


Next: , Up: Water Fitting Functions   [Contents][Index]

11.66.1 wrapped-create-find-waters-dialog

function: wrapped-create-find-waters-dialog

create a dialog for water fitting


Next: , Previous: wrapped-create-find-waters-dialog, Up: Water Fitting Functions   [Contents][Index]

11.66.2 renumber-waters

function: renumber-waters imol

Where imol is an integer number

Renumber the waters of molecule number imol with consecutive numbering.


Next: , Previous: renumber-waters, Up: Water Fitting Functions   [Contents][Index]

11.66.3 execute-find-waters-real

function: execute-find-waters-real imol_for_map imol_for_protein new_waters_mol_flag rmsd_cut_off

Where:

find waters


Next: , Previous: execute-find-waters-real, Up: Water Fitting Functions   [Contents][Index]

11.66.4 move-waters-to-around-protein

function: move-waters-to-around-protein imol

Where imol is an integer number

move waters of molecule number imol so that they are around the protein.

Returns: the number of moved waters.


Next: , Previous: move-waters-to-around-protein, Up: Water Fitting Functions   [Contents][Index]

11.66.5 move-hetgroups-to-around-protein

function: move-hetgroups-to-around-protein imol

Where imol is an integer number

move all hetgroups (including waters) of molecule number imol so that they are around the protein.


Next: , Previous: move-hetgroups-to-around-protein, Up: Water Fitting Functions   [Contents][Index]

11.66.6 max-water-distance

function: max-water-distance imol

Where imol is an integer number

return the maximum minimum distance of any water atom to any protein atom - used in validation of move_waters_to_around_protein() funtion.


Next: , Previous: max-water-distance, Up: Water Fitting Functions   [Contents][Index]

11.66.7 set-water-check-spherical-variance-limit

function: set-water-check-spherical-variance-limit f

Where f is a number

set the limit of interesting variance, above which waters are listed (otherwise ignored)

default 0.12.


Next: , Previous: set-water-check-spherical-variance-limit, Up: Water Fitting Functions   [Contents][Index]

11.66.8 set-ligand-water-to-protein-distance-limits

function: set-ligand-water-to-protein-distance-limits f1 f2

Where:

set ligand to protein distance limits

f1 is the minimum distance, f2 is the maximum distance


Next: , Previous: set-ligand-water-to-protein-distance-limits, Up: Water Fitting Functions   [Contents][Index]

11.66.9 set-ligand-water-n-cycles

function: set-ligand-water-n-cycles i

Where i is an integer number

set the number of cycles of water searching


Next: , Previous: set-ligand-water-n-cycles, Up: Water Fitting Functions   [Contents][Index]

11.66.10 execute-find-blobs

function: execute-find-blobs imol_model imol_for_map cut_off interactive_flag

Where:

find blobs


Previous: execute-find-blobs, Up: Water Fitting Functions   [Contents][Index]

11.66.11 split-water

function: split-water imol chain_id res_no ins_code

Where:

split the given water and fit to map.

If refinement map is not defined, don’t do anything.

If there is more than one atom in the specified resiue, don’t do anything.

If the given atom does not have an alt conf of "", don’t do anything.


Next: , Previous: Water Fitting Functions, Up: Scripting Functions   [Contents][Index]

11.67 Bond Representation


Next: , Up: Bond Representation   [Contents][Index]

11.67.1 set-default-bond-thickness

function: set-default-bond-thickness t

Where t is an integer number

set the default thickness for bonds (e.g. in ~/.coot)


Next: , Previous: set-default-bond-thickness, Up: Bond Representation   [Contents][Index]

11.67.2 set-bond-thickness

function: set-bond-thickness imol t

Where:

set the thickness of the bonds in molecule number imol to t pixels


Next: , Previous: set-bond-thickness, Up: Bond Representation   [Contents][Index]

11.67.3 set-bond-thickness-intermediate-atoms

function: set-bond-thickness-intermediate-atoms t

Where t is a number

set the thickness of the bonds of the intermediate atoms to t pixels


Next: , Previous: set-bond-thickness-intermediate-atoms, Up: Bond Representation   [Contents][Index]

11.67.4 set-use-variable-bond-thickness

function: set-use-variable-bond-thickness state

Where state is an integer number

allow lines that are further away to be thinner


Next: , Previous: set-use-variable-bond-thickness, Up: Bond Representation   [Contents][Index]

11.67.5 set-bond-colour-rotation-for-molecule

function: set-bond-colour-rotation-for-molecule imol f

Where:

set bond colour for molecule


Next: , Previous: set-bond-colour-rotation-for-molecule, Up: Bond Representation   [Contents][Index]

11.67.6 set-draw-stick-mode-atoms-default

function: set-draw-stick-mode-atoms-default state

Where state is an integer number

set default for the drawing of atoms in stick mode (default is on (1))


Next: , Previous: set-draw-stick-mode-atoms-default, Up: Bond Representation   [Contents][Index]

11.67.7 get-bond-colour-rotation-for-molecule

function: get-bond-colour-rotation-for-molecule imol

Where imol is an integer number

get the bond colour for molecule.

Return -1 on err (bad molecule number)


Next: , Previous: get-bond-colour-rotation-for-molecule, Up: Bond Representation   [Contents][Index]

11.67.8 set-default-representation-type

function: set-default-representation-type type

Where type is an integer number

set the default representation type (default 1).


Next: , Previous: set-default-representation-type, Up: Bond Representation   [Contents][Index]

11.67.9 get-default-bond-thickness

function: get-default-bond-thickness

get the default thickness for bonds


Next: , Previous: get-default-bond-thickness, Up: Bond Representation   [Contents][Index]

11.67.10 set-draw-zero-occ-markers

function: set-draw-zero-occ-markers status

Where status is an integer number

set status of drawing zero occupancy markers.

default status is 1.


Next: , Previous: set-draw-zero-occ-markers, Up: Bond Representation   [Contents][Index]

11.67.11 set-draw-cis-peptide-markups

function: set-draw-cis-peptide-markups status

Where status is an integer number

set status of drawing cis-peptide markups

default status is 1.


Next: , Previous: set-draw-cis-peptide-markups, Up: Bond Representation   [Contents][Index]

11.67.12 set-draw-hydrogens

function: set-draw-hydrogens imol istat

Where:

set the hydrogen drawing state. istat = 0 is hydrogens off, istat = 1: show hydrogens


Next: , Previous: set-draw-hydrogens, Up: Bond Representation   [Contents][Index]

11.67.13 draw-hydrogens-state

function: draw-hydrogens-state imol

Where imol is an integer number

the state of draw hydrogens for molecule number imol.

return -1 on bad imol.


Next: , Previous: draw-hydrogens-state, Up: Bond Representation   [Contents][Index]

11.67.14 set-draw-stick-mode-atoms

function: set-draw-stick-mode-atoms imol state

Where:

draw little coloured balls on atoms

turn off with state = 0

turn on with state = 1


Next: , Previous: set-draw-stick-mode-atoms, Up: Bond Representation   [Contents][Index]

11.67.15 set-draw-missing-residues-loops

function: set-draw-missing-residues-loops state

Where state is an integer number

set the state for drawing missing resiude loops

For taking screenshots, we often don’t want to see them.


Next: , Previous: set-draw-missing-residues-loops, Up: Bond Representation   [Contents][Index]

11.67.16 graphics-to-ca-representation

function: graphics-to-ca-representation imol

Where imol is an integer number

draw molecule number imol as CAs


Next: , Previous: graphics-to-ca-representation, Up: Bond Representation   [Contents][Index]

11.67.17 graphics-to-ca-plus-ligands-representation

function: graphics-to-ca-plus-ligands-representation imol

Where imol is an integer number

draw molecule number imol as CA + ligands


Next: , Previous: graphics-to-ca-plus-ligands-representation, Up: Bond Representation   [Contents][Index]

11.67.18 graphics-to-ca-plus-ligands-and-sidechains-representation

function: graphics-to-ca-plus-ligands-and-sidechains-representation imol

Where imol is an integer number

draw molecule number imol as CA + ligands + sidechains


Next: , Previous: graphics-to-ca-plus-ligands-and-sidechains-representation, Up: Bond Representation   [Contents][Index]

11.67.19 graphics-to-bonds-no-waters-representation

function: graphics-to-bonds-no-waters-representation imol

Where imol is an integer number

draw molecule number imol with no waters


Next: , Previous: graphics-to-bonds-no-waters-representation, Up: Bond Representation   [Contents][Index]

11.67.20 graphics-to-bonds-representation

function: graphics-to-bonds-representation mol

Where mol is an integer number

draw molecule number imol with normal bonds


Next: , Previous: graphics-to-bonds-representation, Up: Bond Representation   [Contents][Index]

11.67.21 graphics-to-ca-plus-ligands-sec-struct-representation

function: graphics-to-ca-plus-ligands-sec-struct-representation imol

Where imol is an integer number

draw molecule number imol with CA bonds in secondary structure representation and ligands


Next: , Previous: graphics-to-ca-plus-ligands-sec-struct-representation, Up: Bond Representation   [Contents][Index]

11.67.22 graphics-to-sec-struct-bonds-representation

function: graphics-to-sec-struct-bonds-representation imol

Where imol is an integer number

draw molecule number imol with bonds in secondary structure representation


Next: , Previous: graphics-to-sec-struct-bonds-representation, Up: Bond Representation   [Contents][Index]

11.67.23 graphics-to-rainbow-representation

function: graphics-to-rainbow-representation imol

Where imol is an integer number

draw molecule number imol in Jones’ Rainbow


Next: , Previous: graphics-to-rainbow-representation, Up: Bond Representation   [Contents][Index]

11.67.24 graphics-to-b-factor-representation

function: graphics-to-b-factor-representation imol

Where imol is an integer number

draw molecule number imol coloured by B-factor


Next: , Previous: graphics-to-b-factor-representation, Up: Bond Representation   [Contents][Index]

11.67.25 graphics-to-b-factor-cas-representation

function: graphics-to-b-factor-cas-representation imol

Where imol is an integer number

draw molecule number imol coloured by B-factor, CA + ligands


Next: , Previous: graphics-to-b-factor-cas-representation, Up: Bond Representation   [Contents][Index]

11.67.26 graphics-to-occupancy-representation

function: graphics-to-occupancy-representation imol

Where imol is an integer number

draw molecule number imol coloured by occupancy


Next: , Previous: graphics-to-occupancy-representation, Up: Bond Representation   [Contents][Index]

11.67.27 graphics-to-user-defined-atom-colours-representation

function: graphics-to-user-defined-atom-colours-representation imol

Where imol is an integer number

draw molecule number imol in CA+Ligands mode coloured by user-defined atom colours


Next: , Previous: graphics-to-user-defined-atom-colours-representation, Up: Bond Representation   [Contents][Index]

11.67.28 graphics-to-user-defined-atom-colours-all-atoms-representation

function: graphics-to-user-defined-atom-colours-all-atoms-representation imol

Where imol is an integer number

draw molecule number imol all atoms coloured by user-defined atom colours


Next: , Previous: graphics-to-user-defined-atom-colours-all-atoms-representation, Up: Bond Representation   [Contents][Index]

11.67.29 graphics-molecule-bond-type

function: graphics-molecule-bond-type imol

Where imol is an integer number

what is the bond drawing state of molecule number imol


Next: , Previous: graphics-molecule-bond-type, Up: Bond Representation   [Contents][Index]

11.67.30 set-b-factor-bonds-scale-factor

function: set-b-factor-bonds-scale-factor imol f

Where:

scale the colours for colour by b factor representation


Next: , Previous: set-b-factor-bonds-scale-factor, Up: Bond Representation   [Contents][Index]

11.67.31 change-model-molecule-representation-mode

function: change-model-molecule-representation-mode up_or_down

Where up_or_down is an integer number

change the representation of the model molecule closest to the centre of the screen


Next: , Previous: change-model-molecule-representation-mode, Up: Bond Representation   [Contents][Index]

11.67.32 set-use-grey-carbons-for-molecule

function: set-use-grey-carbons-for-molecule imol state

Where:

make the carbon atoms for molecule imol be grey


Next: , Previous: set-use-grey-carbons-for-molecule, Up: Bond Representation   [Contents][Index]

11.67.33 set-grey-carbon-colour

function: set-grey-carbon-colour imol r g b

Where:

set the colour for the carbon atoms

can be not grey if you desire, r, g, b in the range 0 to 1.


Next: , Previous: set-grey-carbon-colour, Up: Bond Representation   [Contents][Index]

11.67.34 make-ball-and-stick

function: make-ball-and-stick imol atom_selection_str bond_thickness sphere_size do_spheres_flag

Where:

make a ball and stick representation of imol given atom selection

e.g. (make-ball-and-stick 0 "/1" 0.15 0.25 1)


Next: , Previous: make-ball-and-stick, Up: Bond Representation   [Contents][Index]

11.67.35 clear-ball-and-stick

function: clear-ball-and-stick imol

Where imol is an integer number

clear ball and stick representation of molecule number imol


Next: , Previous: clear-ball-and-stick, Up: Bond Representation   [Contents][Index]

11.67.36 additional-representation-by-string

function: additional-representation-by-string imol atom_selection representation_type bonds_box_type bond_width draw_hydrogens_flag

Where:

return the index of the additional representation. Return -1 on error


Previous: additional-representation-by-string, Up: Bond Representation   [Contents][Index]

11.67.37 additional-representation-by-attributes

function: additional-representation-by-attributes imol chain_id resno_start resno_end ins_code representation_type bonds_box_type bond_width draw_hydrogens_flag

Where:

return the index of the additional representation.

Returns: -1 on error.


Next: , Previous: Bond Representation, Up: Scripting Functions   [Contents][Index]

11.68 Dots Representation


Next: , Up: Dots Representation   [Contents][Index]

11.68.1 dots

function: dots imol atom_selection_str dots_object_name dot_density sphere_size_scale

Where:

display dotted surface

return a generic objects handle (which can be used to remove later)


Next: , Previous: dots, Up: Dots Representation   [Contents][Index]

11.68.2 set-dots-colour

function: set-dots-colour imol r g b

Where:

set the colour of the surface dots of the imol-th molecule to be the given single colour

r,g,b are values between 0.0 and 1.0


Next: , Previous: set-dots-colour, Up: Dots Representation   [Contents][Index]

11.68.3 unset-dots-colour

function: unset-dots-colour imol

Where imol is an integer number

no longer set the dots of molecule imol to a single colour

i.e. go back to element-based colours.


Next: , Previous: unset-dots-colour, Up: Dots Representation   [Contents][Index]

11.68.4 clear-dots

function: clear-dots imol dots_handle

Where:

clear dots in imol with dots_handle


Next: , Previous: clear-dots, Up: Dots Representation   [Contents][Index]

11.68.5 clear-dots-by-name

function: clear-dots-by-name imol dots_object_name

Where:

clear the first dots object for imol with given name


Previous: clear-dots-by-name, Up: Dots Representation   [Contents][Index]

11.68.6 n-dots-sets

function: n-dots-sets imol

Where imol is an integer number

return the number of dots sets for molecule number imol


Next: , Previous: Dots Representation, Up: Scripting Functions   [Contents][Index]

11.69 Pep-flip Interface


Up: Pep-flip Interface   [Contents][Index]

11.69.1 pepflip

function: pepflip imol chain_id resno inscode altconf

Where:

pepflip the given residue


Next: , Previous: Pep-flip Interface, Up: Scripting Functions   [Contents][Index]

11.70 Rigid Body Refinement Interface


Next: , Up: Rigid Body Refinement Interface   [Contents][Index]

11.70.1 rigid-body-refine-zone

function: rigid-body-refine-zone reso_start resno_end chain_id imol

Where:

setup rigid body refine zone

where we set the atom selection holders according to the arguments and then call execute_rigid_body_refine()


Next: , Previous: rigid-body-refine-zone, Up: Rigid Body Refinement Interface   [Contents][Index]

11.70.2 rigid-body-refine-by-residue-ranges-scm

function: rigid-body-refine-by-residue-ranges-scm imol residue_ranges

Where:

rigid body refine using residue ranges. residue_ranges is a list of residue ranges. A residue range is (list chain-id resno-start resno-end).


Next: , Previous: rigid-body-refine-by-residue-ranges-scm, Up: Rigid Body Refinement Interface   [Contents][Index]

11.70.3 rigid-body-refine-by-residue-ranges-py

function: rigid-body-refine-by-residue-ranges-py imol residue_ranges

Where:

rigid body refine using residue ranges. residue_ranges is a list of residue ranges. A residue range is [chain_id, resno_start, resno_end].


Previous: rigid-body-refine-by-residue-ranges-py, Up: Rigid Body Refinement Interface   [Contents][Index]

11.70.4 set-rigid-body-fit-acceptable-fit-fraction

function: set-rigid-body-fit-acceptable-fit-fraction f

Where f is a number

set rigid body fraction of atoms in positive density


Next: , Previous: Rigid Body Refinement Interface, Up: Scripting Functions   [Contents][Index]

11.71 Add Terminal Residue Functions


Next: , Up: Add Terminal Residue Functions   [Contents][Index]

11.71.1 set-add-terminal-residue-immediate-addition

function: set-add-terminal-residue-immediate-addition i

Where i is an integer number

set immediate addition of terminal residue

call with i=1 for immediate addtion


Next: , Previous: set-add-terminal-residue-immediate-addition, Up: Add Terminal Residue Functions   [Contents][Index]

11.71.2 add-terminal-residue

function: add-terminal-residue imol chain_id residue_number residue_type immediate_add

Where:

Add a terminal residue.

residue type can be "auto" and immediate_add is recommended to be 1.

Returns: 0 on failure, 1 on success


Next: , Previous: add-terminal-residue, Up: Add Terminal Residue Functions   [Contents][Index]

11.71.3 add-nucleotide

function: add-nucleotide imol chain_id res_no

Where:

Add a terminal nucleotide.

No fitting is done


Next: , Previous: add-nucleotide, Up: Add Terminal Residue Functions   [Contents][Index]

11.71.4 add-terminal-residue-using-phi-psi

function: add-terminal-residue-using-phi-psi imol chain_id res_no residue_type phi psi

Where:

Add a terminal residue using given phi and psi angles.

Returns: the success status, 0 on failure, 1 on success


Next: , Previous: add-terminal-residue-using-phi-psi, Up: Add Terminal Residue Functions   [Contents][Index]

11.71.5 set-add-terminal-residue-default-residue-type

function: set-add-terminal-residue-default-residue-type type

Where type is a string

set the residue type of an added terminal residue.


Next: , Previous: set-add-terminal-residue-default-residue-type, Up: Add Terminal Residue Functions   [Contents][Index]

11.71.6 set-add-terminal-residue-do-post-refine

function: set-add-terminal-residue-do-post-refine istat

Where istat is an integer number

set a flag to run refine zone on terminal residues after an addition.


Previous: set-add-terminal-residue-do-post-refine, Up: Add Terminal Residue Functions   [Contents][Index]

11.71.7 add-terminal-residue-do-post-refine-state

function: add-terminal-residue-do-post-refine-state

what is the value of the previous flag?


Next: , Previous: Add Terminal Residue Functions, Up: Scripting Functions   [Contents][Index]

11.72 Delete Residues


Next: , Up: Delete Residues   [Contents][Index]

11.72.1 delete-residue-range

function: delete-residue-range imol chain_id resno_start end_resno

Where:

delete residue range


Next: , Previous: delete-residue-range, Up: Delete Residues   [Contents][Index]

11.72.2 delete-residue

function: delete-residue imol chain_id resno inscode

Where:

delete residue


Next: , Previous: delete-residue, Up: Delete Residues   [Contents][Index]

11.72.3 delete-residue-with-full-spec

function: delete-residue-with-full-spec imol imodel chain_id resno inscode altloc

Where:

delete residue with altconf


Next: , Previous: delete-residue-with-full-spec, Up: Delete Residues   [Contents][Index]

11.72.4 delete-residues-scm

function: delete-residues-scm imol residue_specs_scm

Where:

delete residues in the residue spec list


Next: , Previous: delete-residues-scm, Up: Delete Residues   [Contents][Index]

11.72.5 delete-residues-py

function: delete-residues-py imol residue_specs_py

Where:

delete residues in the residue spec list


Next: , Previous: delete-residues-py, Up: Delete Residues   [Contents][Index]

11.72.6 delete-residue-hydrogens

function: delete-residue-hydrogens imol chain_id resno inscode altloc

Where:

delete hydrogen atoms in residue


Next: , Previous: delete-residue-hydrogens, Up: Delete Residues   [Contents][Index]

11.72.7 delete-atom

function: delete-atom imol chain_id resno ins_code at_name altloc

Where:

delete atom in residue


Next: , Previous: delete-atom, Up: Delete Residues   [Contents][Index]

11.72.8 delete-residue-sidechain

function: delete-residue-sidechain imol chain_id resno ins_code do_delete_dialog

Where:

delete all atoms in residue that are not main chain or CB


Next: , Previous: delete-residue-sidechain, Up: Delete Residues   [Contents][Index]

11.72.9 delete-hydrogen-atoms

function: delete-hydrogen-atoms imol

Where imol is an integer number

delete all hydrogens in molecule,

Returns: number of hydrogens deleted.


Next: , Previous: delete-hydrogen-atoms, Up: Delete Residues   [Contents][Index]

11.72.10 delete-hydrogens

function: delete-hydrogens imol

Where imol is an integer number

delete all hydrogens in molecule,

Returns: number of hydrogens deleted.


Next: , Previous: delete-hydrogens, Up: Delete Residues   [Contents][Index]

11.72.11 delete-waters

function: delete-waters imol

Where imol is an integer number

delete all waters in molecule,

Returns: number of waters deleted.


Next: , Previous: delete-waters, Up: Delete Residues   [Contents][Index]

11.72.12 delete-chain

function: delete-chain imol chain_id

Where:

delete the chain


Previous: delete-chain, Up: Delete Residues   [Contents][Index]

11.72.13 delete-sidechains-for-chain

function: delete-sidechains-for-chain imol chain_id

Where:

delete the side chains in the chain


Next: , Previous: Delete Residues, Up: Scripting Functions   [Contents][Index]

11.73 Mainchain Building Functions


Next: , Up: Mainchain Building Functions   [Contents][Index]

11.73.1 db-mainchain

function: db-mainchain imol chain_id iresno_start iresno_end direction

Where:

CA -> mainchain conversion.

direction is either "forwards" or "backwards"

See also the function below.

return the new molecule number


Previous: db-mainchain, Up: Mainchain Building Functions   [Contents][Index]

11.73.2 db-mainchains-fragment

function: db-mainchains-fragment imol chain_id res_no

Where:

CA-Zone to Mainchain for a fragment based on the given residue.

Both directions are built. This is the modern interface.


Next: , Previous: Mainchain Building Functions, Up: Scripting Functions   [Contents][Index]

11.74 Close Molecule Functions


Up: Close Molecule Functions   [Contents][Index]

11.74.1 close-molecule

function: close-molecule imol

Where imol is an integer number

close the molecule


Next: , Previous: Close Molecule Functions, Up: Scripting Functions   [Contents][Index]

11.75 Rotamer Functions


Next: , Up: Rotamer Functions   [Contents][Index]

11.75.1 set-rotamer-search-mode

function: set-rotamer-search-mode mode

Where mode is an integer number

set the mode of rotamer search, options are (ROTAMERSEARCHAUTOMATIC), (ROTAMERSEARCHLOWRES) (aka. "backrub rotamers"), (ROTAMERSEARCHHIGHRES) (with rigid body fitting)


Next: , Previous: set-rotamer-search-mode, Up: Rotamer Functions   [Contents][Index]

11.75.2 set-rotamer-lowest-probability

function: set-rotamer-lowest-probability f

Where f is a number

For Dunbrack rotamers, set the lowest probability to be considered. Set as a percentage i.e. 1.00 is quite low. For Richardson Rotamers, this has no effect.


Next: , Previous: set-rotamer-lowest-probability, Up: Rotamer Functions   [Contents][Index]

11.75.3 set-rotamer-check-clashes

function: set-rotamer-check-clashes i

Where i is an integer number

set a flag: 0 is off, 1 is on


Next: , Previous: set-rotamer-check-clashes, Up: Rotamer Functions   [Contents][Index]

11.75.4 auto-fit-best-rotamer

function: auto-fit-best-rotamer resno altloc insertion_code chain_id imol_coords imol_map clash_flag lowest_probability

Where:

auto fit by rotamer search.

return the score, for some not very good reason. clash_flag determines if we use clashes with other residues in the score for this rotamer (or not). It would be cool to call this from a script that went residue by residue along a (newly-built) chain (now available).


Next: , Previous: auto-fit-best-rotamer, Up: Rotamer Functions   [Contents][Index]

11.75.5 set-auto-fit-best-rotamer-clash-flag

function: set-auto-fit-best-rotamer-clash-flag i

Where i is an integer number

set the clash flag for rotamer search

And this functions for [pre-setting] the variables for auto_fit_best_rotamer called interactively (using a graphics_info_t function). 0 off, 1 on.


Next: , Previous: set-auto-fit-best-rotamer-clash-flag, Up: Rotamer Functions   [Contents][Index]

11.75.6 n-rotamers

function: n-rotamers imol chain_id resno ins_code

Where:

return the number of rotamers for this residue - return -1 on no residue found.


Next: , Previous: n-rotamers, Up: Rotamer Functions   [Contents][Index]

11.75.7 set-residue-to-rotamer-number

function: set-residue-to-rotamer-number imol chain_id resno ins_code alt_conf rotamer_number

Where:

set the residue specified to the rotamer number specifed.


Next: , Previous: set-residue-to-rotamer-number, Up: Rotamer Functions   [Contents][Index]

11.75.8 set-residue-to-rotamer-name

function: set-residue-to-rotamer-name imol chain_id resno ins_code alt_conf rotamer_name

Where:

set the residue specified to the rotamer name specified.

(rotamer names are the Richardson rotamer names.)

return value is 0 if atoms were not moved (e.g. because rotamer-name was not know)


Next: , Previous: set-residue-to-rotamer-name, Up: Rotamer Functions   [Contents][Index]

11.75.9 fill-partial-residues

function: fill-partial-residues imol

Where imol is an integer number

fill all the residues of molecule number imol that have missing atoms.

To be used to remove the effects of chainsaw.


Next: , Previous: fill-partial-residues, Up: Rotamer Functions   [Contents][Index]

11.75.10 simple-fill-partial-residues

function: simple-fill-partial-residues imol

Where imol is an integer number

Fill amino acid residues.

do backrub rotamer search for residues, but don’t do refinement


Next: , Previous: simple-fill-partial-residues, Up: Rotamer Functions   [Contents][Index]

11.75.11 rotamer-graphs

function: rotamer-graphs imol

Where imol is an integer number

Activate rotamer graph analysis for molecule number imol.

Return rotamer info - function used in testing.


Previous: rotamer-graphs, Up: Rotamer Functions   [Contents][Index]

11.75.12 rotamer-graphs-py

function: rotamer-graphs-py imol

Where imol is an integer number

Activate rotamer graph analysis for molecule number imol.

Return rotamer info - function used in testing.


Next: , Previous: Rotamer Functions, Up: Scripting Functions   [Contents][Index]

11.76 180 Flip Side chain


Up: 180 Flip Side chain   [Contents][Index]

11.76.1 do-180-degree-side-chain-flip

function: do-180-degree-side-chain-flip imol chain_id resno inscode altconf

Where:

rotate 180 degrees round the last chi angle


Next: , Previous: 180 Flip Side chain, Up: Scripting Functions   [Contents][Index]

11.77 Mutate Functions


Next: , Up: Mutate Functions   [Contents][Index]

11.77.1 setup-mutate-auto-fit

function: setup-mutate-auto-fit state

Where state is an integer number

Mutate then fit to map.

that we have a map define is checked first


Next: , Previous: setup-mutate-auto-fit, Up: Mutate Functions   [Contents][Index]

11.77.2 mutate-active-residue

function: mutate-active-residue

display a dialog that allows the choice of residue type to which to mutate


Next: , Previous: mutate-active-residue, Up: Mutate Functions   [Contents][Index]

11.77.3 mutate

function: mutate imol chain_id ires inscode target_res_type

Where:

mutate a given residue

target_res_type is a three-letter-code.

Return 1 on a good mutate.


Next: , Previous: mutate, Up: Mutate Functions   [Contents][Index]

11.77.4 mutate-base

function: mutate-base imol chain_id res_no ins_code res_type

Where:

mutate a base. return success status, 1 for a good mutate.


Next: , Previous: mutate-base, Up: Mutate Functions   [Contents][Index]

11.77.5 set-mutate-auto-fit-do-post-refine

function: set-mutate-auto-fit-do-post-refine istate

Where istate is an integer number

Do you want Coot to automatically run a refinement after every mutate and autofit?

1 for yes, 0 for no.


Next: , Previous: set-mutate-auto-fit-do-post-refine, Up: Mutate Functions   [Contents][Index]

11.77.6 mutate-auto-fit-do-post-refine-state

function: mutate-auto-fit-do-post-refine-state

what is the value of the previous flag?


Next: , Previous: mutate-auto-fit-do-post-refine-state, Up: Mutate Functions   [Contents][Index]

11.77.7 set-rotamer-auto-fit-do-post-refine

function: set-rotamer-auto-fit-do-post-refine istate

Where istate is an integer number

Do you want Coot to automatically run a refinement after every rotamer autofit?

1 for yes, 0 for no.


Next: , Previous: set-rotamer-auto-fit-do-post-refine, Up: Mutate Functions   [Contents][Index]

11.77.8 rotamer-auto-fit-do-post-refine-state

function: rotamer-auto-fit-do-post-refine-state

what is the value of the previous flag?


Next: , Previous: rotamer-auto-fit-do-post-refine-state, Up: Mutate Functions   [Contents][Index]

11.77.9 mutate-single-residue-by-serial-number

function: mutate-single-residue-by-serial-number ires_ser chain_id imol target_res_type

Where:

an alternate interface to mutation of a singe residue.

ires-ser is the serial number of the residue, not the seqnum There 2 functions don’t make backups, but

does - CHECKME Hence

is for use as a "one-by-one" type and the following 2 by wrappers that muate either a residue range or a whole chain

Note that the target_res_type is a char, not a string (or a char *). So from the scheme interface you’d use (for example) hash backslash A for ALA.

Returns: 1 on success, 0 on failure


Previous: mutate-single-residue-by-serial-number, Up: Mutate Functions   [Contents][Index]

11.77.10 set-residue-type-chooser-stub-state

function: set-residue-type-chooser-stub-state istat

Where istat is an integer number

set a flag saying that the residue chosen by mutate or auto-fit mutate should only be added as a stub (mainchain + CB)


Next: , Previous: Mutate Functions, Up: Scripting Functions   [Contents][Index]

11.78 Alternative Conformation


Next: , Up: Alternative Conformation   [Contents][Index]

11.78.1 add-alt-conf-scm

function: add-alt-conf-scm imol chain_id res_no ins_code alt_conf rotamer_number

Where:

add an alternative conformer to a residue. Add it in conformation rotamer number rotamer_number.

Return the new alt_conf chain_id on sucess, scheme false on fail


Previous: add-alt-conf-scm, Up: Alternative Conformation   [Contents][Index]

11.78.2 add-alt-conf-py

function: add-alt-conf-py imol chain_id res_no ins_code alt_conf rotamer_number

Where:

add an alternative conformer to a residue. Add it in conformation rotamer number rotamer_number.

Return the new alt_conf chain_id on sucess, python False on fail


Next: , Previous: Alternative Conformation, Up: Scripting Functions   [Contents][Index]

11.79 Pointer Atom Functions


Next: , Up: Pointer Atom Functions   [Contents][Index]

11.79.1 create-pointer-atom-molecule-maybe

function: create-pointer-atom-molecule-maybe

Return the current pointer atom molecule, create a pointer atom molecule if necessary (i.e. when the user has not set it).


Previous: create-pointer-atom-molecule-maybe, Up: Pointer Atom Functions   [Contents][Index]

11.79.2 pointer-atom-molecule

function: pointer-atom-molecule

Return the current pointer atom molecule.


Next: , Previous: Pointer Atom Functions, Up: Scripting Functions   [Contents][Index]

11.80 Baton Build Interface Functions


Next: , Up: Baton Build Interface Functions   [Contents][Index]

11.80.1 set-baton-mode

function: set-baton-mode i

Where i is an integer number

toggle so that mouse movement moves the baton not rotates the view.


Next: , Previous: set-baton-mode, Up: Baton Build Interface Functions   [Contents][Index]

11.80.2 try-set-draw-baton

function: try-set-draw-baton i

Where i is an integer number

draw the baton or not


Next: , Previous: try-set-draw-baton, Up: Baton Build Interface Functions   [Contents][Index]

11.80.3 accept-baton-position

function: accept-baton-position

accept the baton tip position - a prime candidate for a key binding


Next: , Previous: accept-baton-position, Up: Baton Build Interface Functions   [Contents][Index]

11.80.4 baton-tip-try-another

function: baton-tip-try-another

move the baton tip position - another prime candidate for a key binding


Next: , Previous: baton-tip-try-another, Up: Baton Build Interface Functions   [Contents][Index]

11.80.5 baton-tip-previous

function: baton-tip-previous

move the baton tip to the previous position


Next: , Previous: baton-tip-previous, Up: Baton Build Interface Functions   [Contents][Index]

11.80.6 shorten-baton

function: shorten-baton

shorten the baton length


Next: , Previous: shorten-baton, Up: Baton Build Interface Functions   [Contents][Index]

11.80.7 lengthen-baton

function: lengthen-baton

lengthen the baton


Next: , Previous: lengthen-baton, Up: Baton Build Interface Functions   [Contents][Index]

11.80.8 baton-build-delete-last-residue

function: baton-build-delete-last-residue

delete the most recently build CA position


Previous: baton-build-delete-last-residue, Up: Baton Build Interface Functions   [Contents][Index]

11.80.9 set-baton-build-params

function: set-baton-build-params istart_resno chain_id direction

Where:

set the parameters for the start of a new baton-built fragment. direction can either be "forwards" or "backwards"


Next: , Previous: Baton Build Interface Functions, Up: Scripting Functions   [Contents][Index]

11.81 Crosshairs Interface


Up: Crosshairs Interface   [Contents][Index]

11.81.1 set-draw-crosshairs

function: set-draw-crosshairs i

Where i is an integer number

draw the distance crosshairs, 0 for off, 1 for on.


Next: , Previous: Crosshairs Interface, Up: Scripting Functions   [Contents][Index]

11.82 Edit Chi Angles


Next: , Up: Edit Chi Angles   [Contents][Index]

11.82.1 set-find-hydrogen-torsions

function: set-find-hydrogen-torsions state

Where state is an integer number

show torsions that rotate hydrogens in the torsion angle manipulation dialog. Note that this may be needed if, in the dictionary cif file torsion which have as a 4th atom both a hydrogen and a heavier atom bonding to the 3rd atom, but list the 4th atom as a hydrogen (not a heavier atom).


Next: , Previous: set-find-hydrogen-torsions, Up: Edit Chi Angles   [Contents][Index]

11.82.2 edit-chi-angles

function: edit-chi-angles imol chain_id resno ins_code altconf

Where:

display the edit chi angles gui for the given residue

return a status of 0 if it failed to fined the residue, return a value of 1 if it worked.


Previous: edit-chi-angles, Up: Edit Chi Angles   [Contents][Index]

11.82.3 setup-torsion-general

function: setup-torsion-general state

Where state is an integer number

beloved torsion general at last makes an entrance onto the Coot scene...


Next: , Previous: Edit Chi Angles, Up: Scripting Functions   [Contents][Index]

11.83 Masks


Next: , Up: Masks   [Contents][Index]

11.83.1 mask-map-by-molecule

function: mask-map-by-molecule map_mol_no coord_mol_no invert_flag

Where:

generate a new map that has been masked by some coordinates

(mask-map-by-molecule map-no mol-no invert?) creates and displays a masked map, cuts down density where the coordinates are (invert is 0). If invert? is 1, cut the density down where there are no atoms atoms.


Next: , Previous: mask-map-by-molecule, Up: Masks   [Contents][Index]

11.83.2 mask-map-by-atom-selection

function: mask-map-by-atom-selection map_mol_no coords_mol_no mmdb_atom_selection invert_flag

Where:

mask map by atom selection


Next: , Previous: mask-map-by-atom-selection, Up: Masks   [Contents][Index]

11.83.3 make-masked-maps-split-by-chain

function: make-masked-maps-split-by-chain imol imol_map

Where:

make chain masked maps

needs to return a list of values


Next: , Previous: make-masked-maps-split-by-chain, Up: Masks   [Contents][Index]

11.83.4 set-map-mask-atom-radius

function: set-map-mask-atom-radius rad

Where rad is a number

set the atom radius for map masking


Previous: set-map-mask-atom-radius, Up: Masks   [Contents][Index]

11.83.5 map-mask-atom-radius

function: map-mask-atom-radius

get the atom radius for map masking


Next: , Previous: Masks, Up: Scripting Functions   [Contents][Index]

11.84 check Waters Interface


Next: , Up: check Waters Interface   [Contents][Index]

11.84.1 delete-checked-waters-baddies

function: delete-checked-waters-baddies imol b_factor_lim map_sigma_lim min_dist max_dist part_occ_contact_flag zero_occ_flag logical_operator_and_or_flag

Where:

Delete waters that are fail to meet the given criteria.


Next: , Previous: delete-checked-waters-baddies, Up: check Waters Interface   [Contents][Index]

11.84.2 highly-coordinated-waters-scm

function: highly-coordinated-waters-scm imol coordination_number dist_max

Where:

return an improper list first is list of metals, second is list of waters that are coordinated with at least coordination_number of other atoms at distances less than or equal to dist_max. Return scheme false on not able to make a list, otherwise a list of atoms and neighbours. Can return scheme false if imol is not a valid molecule.


Previous: highly-coordinated-waters-scm, Up: check Waters Interface   [Contents][Index]

11.84.3 highly-coordinated-waters-py

function: highly-coordinated-waters-py imol coordination_number dist_max

Where:

return a list first of waters, second metals that are coordinated with at least coordination_number of other atoms at distances less than or equal to dist_max. Return Python false on not able to make a list, otherwise a list of atoms and neighours. can return Python False if imol is not a valid molecule.


Next: , Previous: check Waters Interface, Up: Scripting Functions   [Contents][Index]

11.85 Least-Squares matching


Up: Least-Squares matching   [Contents][Index]

11.85.1 apply-lsq-matches

function: apply-lsq-matches imol_reference imol_moving

Where:

apply the LSQ matches

Returns: an rtop pair (proper list) on good match, else false


Next: , Previous: Least-Squares matching, Up: Scripting Functions   [Contents][Index]

11.86 Trim


Up: Trim   [Contents][Index]

11.86.1 trim-molecule-by-map

function: trim-molecule-by-map imol_coords imol_map map_level delete_or_zero_occ_flag

Where:

cut off (delete or give zero occupancy) atoms in the given molecule if they are below the given map (absolute) level.


Next: , Previous: Trim, Up: Scripting Functions   [Contents][Index]

11.87 External Ray-Tracing


Next: , Up: External Ray-Tracing   [Contents][Index]

11.87.1 raster3d

function: raster3d rd3_filename

Where rd3_filename is a string

create a r3d file for the current view


Next: , Previous: raster3d, Up: External Ray-Tracing   [Contents][Index]

11.87.2 set-raster3d-bond-thickness

function: set-raster3d-bond-thickness f

Where f is a number

set the bond thickness for the Raster3D representation


Next: , Previous: set-raster3d-bond-thickness, Up: External Ray-Tracing   [Contents][Index]

11.87.3 set-raster3d-atom-radius

function: set-raster3d-atom-radius f

Where f is a number

set the atom radius for the Raster3D representation


Next: , Previous: set-raster3d-atom-radius, Up: External Ray-Tracing   [Contents][Index]

11.87.4 set-raster3d-density-thickness

function: set-raster3d-density-thickness f

Where f is a number

set the density line thickness for the Raster3D representation


Next: , Previous: set-raster3d-density-thickness, Up: External Ray-Tracing   [Contents][Index]

11.87.5 set-renderer-show-atoms

function: set-renderer-show-atoms istate

Where istate is an integer number

set the flag to show atoms for the Raster3D representation


Next: , Previous: set-renderer-show-atoms, Up: External Ray-Tracing   [Contents][Index]

11.87.6 set-raster3d-bone-thickness

function: set-raster3d-bone-thickness f

Where f is a number

set the bone (skeleton) thickness for the Raster3D representation


Next: , Previous: set-raster3d-bone-thickness, Up: External Ray-Tracing   [Contents][Index]

11.87.7 set-raster3d-shadows-enabled

function: set-raster3d-shadows-enabled state

Where state is an integer number

turn off shadows for raster3d output - give argument 0 to turn off


Next: , Previous: set-raster3d-shadows-enabled, Up: External Ray-Tracing   [Contents][Index]

11.87.8 set-raster3d-water-sphere

function: set-raster3d-water-sphere istate

Where istate is an integer number

set the flag to show waters as spheres for the Raster3D representation. 1 show as spheres, 0 the usual stars.


Next: , Previous: set-raster3d-water-sphere, Up: External Ray-Tracing   [Contents][Index]

11.87.9 set-raster3d-font-size

function: set-raster3d-font-size size_in

Where size_in is a string

set the font size (as a string) for raster3d


Previous: set-raster3d-font-size, Up: External Ray-Tracing   [Contents][Index]

11.87.10 raster-screen-shot

function: raster-screen-shot

run raster3d and display the resulting image.


Next: , Previous: External Ray-Tracing, Up: Scripting Functions   [Contents][Index]

11.88 Superposition (SSM)


Next: , Up: Superposition (SSM)   [Contents][Index]

11.88.1 superpose

function: superpose imol1 imol2 move_imol2_flag

Where:

simple interface to superposition.

Superpose all residues of imol2 onto imol1. imol1 is reference, we can either move imol2 or copy it to generate a new molecule depending on the vaule of move_imol2_flag (1 for copy 0 for move).


Next: , Previous: superpose, Up: Superposition (SSM)   [Contents][Index]

11.88.2 superpose-with-chain-selection

function: superpose-with-chain-selection imol1 imol2 chain_imol1 chain_imol2 chain_used_flag_imol1 chain_used_flag_imol2 move_imol2_copy_flag

Where:

chain-based interface to superposition.

Superpose the given chains of imol2 onto imol1. imol1 is reference, we can either move imol2 or copy it to generate a new molecule depending on the vaule of move_imol2_flag (1 for move 0 for copy).


Previous: superpose-with-chain-selection, Up: Superposition (SSM)   [Contents][Index]

11.88.3 superpose-with-atom-selection

function: superpose-with-atom-selection imol1 imol2 mmdb_atom_sel_str_1 mmdb_atom_sel_str_2 move_imol2_copy_flag

Where:

detailed interface to superposition.

Superpose the given atom selection (specified by the mmdb atom selection strings) of imol2 onto imol1. imol1 is reference, we can either move imol2 or copy it to generate a new molecule depending on the vaule of move_imol2_flag (1 for move 0 for copy).

Returns: the index of the superposed molecule - which could either be a new molecule (if move_imol2_flag was 1) or the imol2 or -1 (signifying failure to do the SMM superposition).


Next: , Previous: Superposition (SSM), Up: Scripting Functions   [Contents][Index]

11.89 NCS


Next: , Up: NCS   [Contents][Index]

11.89.1 set-draw-ncs-ghosts

function: set-draw-ncs-ghosts imol istate

Where:

set drawing state of NCS ghosts for molecule number imol


Next: , Previous: set-draw-ncs-ghosts, Up: NCS   [Contents][Index]

11.89.2 draw-ncs-ghosts-state

function: draw-ncs-ghosts-state imol

Where imol is an integer number

return the drawing state of NCS ghosts for molecule number imol. Return -1 on imol is a bad molecule or no ghosts.


Next: , Previous: draw-ncs-ghosts-state, Up: NCS   [Contents][Index]

11.89.3 set-ncs-ghost-bond-thickness

function: set-ncs-ghost-bond-thickness imol f

Where:

set bond thickness of NCS ghosts for molecule number imol


Next: , Previous: set-ncs-ghost-bond-thickness, Up: NCS   [Contents][Index]

11.89.4 ncs-update-ghosts

function: ncs-update-ghosts imol

Where imol is an integer number

update ghosts for molecule number imol


Next: , Previous: ncs-update-ghosts, Up: NCS   [Contents][Index]

11.89.5 make-dynamically-transformed-ncs-maps

function: make-dynamically-transformed-ncs-maps imol_model imol_map overwrite_maps_of_same_name_flag

Where:

make NCS map


Next: , Previous: make-dynamically-transformed-ncs-maps, Up: NCS   [Contents][Index]

11.89.6 add-ncs-matrix

function: add-ncs-matrix imol this_chain_id target_chain_id m11 m12 m13 m21 m22 m23 m31 m32 m33 t1 t2 t3

Where:

Add NCS matrix.


Next: , Previous: add-ncs-matrix, Up: NCS   [Contents][Index]

11.89.7 add-strict-ncs-matrix

function: add-strict-ncs-matrix imol this_chain_id target_chain_id m11 m12 m13 m21 m22 m23 m31 m32 m33 t1 t2 t3

Where:

add an NCS matrix for strict NCS molecule representation

for CNS strict NCS usage: expand like normal symmetry does


Next: , Previous: add-strict-ncs-matrix, Up: NCS   [Contents][Index]

11.89.8 show-strict-ncs-state

function: show-strict-ncs-state imol

Where imol is an integer number

return the state of NCS ghost molecules for molecule number imol


Next: , Previous: show-strict-ncs-state, Up: NCS   [Contents][Index]

11.89.9 set-show-strict-ncs

function: set-show-strict-ncs imol state

Where:

set display state of NCS ghost molecules for molecule number imol


Next: , Previous: set-show-strict-ncs, Up: NCS   [Contents][Index]

11.89.10 set-ncs-homology-level

function: set-ncs-homology-level flev

Where flev is a number

At what level of homology should we say that we can’t see homology for NCS calculation? (default 0.8)


Next: , Previous: set-ncs-homology-level, Up: NCS   [Contents][Index]

11.89.11 copy-chain

function: copy-chain imol from_chain to_chain

Where:

Copy single NCS chain.


Next: , Previous: copy-chain, Up: NCS   [Contents][Index]

11.89.12 copy-from-ncs-master-to-others

function: copy-from-ncs-master-to-others imol chain_id

Where:

Copy chain from master to all related NCS chains.


Next: , Previous: copy-from-ncs-master-to-others, Up: NCS   [Contents][Index]

11.89.13 copy-residue-range-from-ncs-master-to-others

function: copy-residue-range-from-ncs-master-to-others imol master_chain_id residue_range_start residue_range_end

Where:

Copy residue range to all related NCS chains.

If the target residues do not exist in the peer chains, then create them.


Next: , Previous: copy-residue-range-from-ncs-master-to-others, Up: NCS   [Contents][Index]

11.89.14 ncs-master-chains-scm

function: ncs-master-chains-scm imol

Where imol is an integer number

Copy residue range to selected NCS chains.

If the target residues do not exist in the peer chains, then create them.

return a list of NCS masters or scheme false


Next: , Previous: ncs-master-chains-scm, Up: NCS   [Contents][Index]

11.89.15 copy-from-ncs-master-to-chains-scm

function: copy-from-ncs-master-to-chains-scm imol master_chain_id chain_id_list

Where:

Copy chain from master to a list of NCS chains.


Next: , Previous: copy-from-ncs-master-to-chains-scm, Up: NCS   [Contents][Index]

11.89.16 ncs-control-change-ncs-master-to-chain

function: ncs-control-change-ncs-master-to-chain imol ichain

Where:

change the NCS master chain (by number)


Next: , Previous: ncs-control-change-ncs-master-to-chain, Up: NCS   [Contents][Index]

11.89.17 ncs-control-change-ncs-master-to-chain-id

function: ncs-control-change-ncs-master-to-chain-id imol chain_id

Where:

change the NCS master chain (by chain_id)


Next: , Previous: ncs-control-change-ncs-master-to-chain-id, Up: NCS   [Contents][Index]

11.89.18 ncs-control-display-chain

function: ncs-control-display-chain imol ichain state

Where:

display the NCS master chain


Next: , Previous: ncs-control-display-chain, Up: NCS   [Contents][Index]

11.89.19 ncs-chain-ids-scm

function: ncs-chain-ids-scm imol

Where imol is an integer number

Return the ncs chains id for the given molecule.

return something like: ’(("A" "B")) or ’(("A" "C" "E") ("B" "D" "F")). The master chain goes in first.

If imol does not have NCS ghosts, return scheme false.


Next: , Previous: ncs-chain-ids-scm, Up: NCS   [Contents][Index]

11.89.20 ncs-chain-ids-py

function: ncs-chain-ids-py imol

Where imol is an integer number

Return the ncs chains id for the given molecule.

return something like: [["A", "B"]] or [["A", "C", "E"], ["B", "D", "F"]]. The master chain goes in first.

If imol does not have NCS ghosts, return python False.


Next: , Previous: ncs-chain-ids-py, Up: NCS   [Contents][Index]

11.89.21 ncs-ghosts-scm

function: ncs-ghosts-scm imol

Where imol is an integer number

get the NCS ghost description

Returns: false on bad imol or a list of ghosts on good imol. Can include NCS rtops if they are available, else the rtops are False


Previous: ncs-ghosts-scm, Up: NCS   [Contents][Index]

11.89.22 ncs-ghosts-py

function: ncs-ghosts-py imol

Where imol is an integer number

Get the NCS ghosts description.

Returns: False on bad imol or a list of ghosts on good imol. Can include NCS rtops if they are available, else the rtops are False


Next: , Previous: NCS, Up: Scripting Functions   [Contents][Index]

11.90 Helices and Strands


Next: , Up: Helices and Strands   [Contents][Index]

11.90.1 place-helix-here

function: place-helix-here

add a helix

Add a helix somewhere close to this point in the map, try to fit the orientation. Add to a molecule called "Helix", create it if needed. Create another moecule called "Reverse Helix" if the helix orientation isn’t completely unequivocal.

Returns: the index of the new molecule.


Next: , Previous: place-helix-here, Up: Helices and Strands   [Contents][Index]

11.90.2 place-strand-here

function: place-strand-here n_residues n_sample_strands

Where:

add a strands

Add a strand close to this point in the map, try to fit the orientation. Add to a molecule called "Strand", create it if needed. n_residues is the estimated number of residues in the strand.

n_sample_strands is the number of strands from the database tested to fit into this strand density. 8 is a suggested number. 20 for a more rigourous search, but it will be slower.

Returns: the index of the new molecule.


Next: , Previous: place-strand-here, Up: Helices and Strands   [Contents][Index]

11.90.3 place-strand-here-dialog

function: place-strand-here-dialog

show the strand placement gui.

Choose the python version in there, if needed. Call scripting function, display it in place, don’t return a widget.


Next: , Previous: place-strand-here-dialog, Up: Helices and Strands   [Contents][Index]

11.90.4 find-helices

function: find-helices

autobuild helices

Find secondary structure in the current map. Add to a molecule called "Helices", create it if needed.

Returns: the index of the new molecule.


Next: , Previous: find-helices, Up: Helices and Strands   [Contents][Index]

11.90.5 find-strands

function: find-strands

autobuild strands

Find secondary structure in the current map. Add to a molecule called "Strands", create it if needed.

Returns: the index of the new molecule.


Next: , Previous: find-strands, Up: Helices and Strands   [Contents][Index]

11.90.6 find-secondary-structure

function: find-secondary-structure use_helix helix_length helix_target use_strand strand_length strand_target

Where:

autobuild secondary structure

Find secondary structure in the current map. Add to a molecule called "SecStruc", create it if needed.

Returns: the index of the new molecule.


Previous: find-secondary-structure, Up: Helices and Strands   [Contents][Index]

11.90.7 find-secondary-structure-local

function: find-secondary-structure-local use_helix helix_length helix_target use_strand strand_length strand_target radius

Where:

autobuild secondary structure

Find secondary structure local to current view in the current map. Add to a molecule called "SecStruc", create it if needed.

Returns: the index of the new molecule.


Next: , Previous: Helices and Strands, Up: Scripting Functions   [Contents][Index]

11.91 Nucleotides


Up: Nucleotides   [Contents][Index]

11.91.1 find-nucleic-acids-local

function: find-nucleic-acids-local radius

Where radius is a number

autobuild nucleic acid chains

Find secondary structure local to current view in the current map. Add to a molecule called "NuclAcid", create it if needed.

Returns: the index of the new molecule.


Next: , Previous: Nucleotides, Up: Scripting Functions   [Contents][Index]

11.92 New Molecule by Section Interface


Next: , Up: New Molecule by Section Interface   [Contents][Index]

11.92.1 new-molecule-by-residue-type-selection

function: new-molecule-by-residue-type-selection imol residue_type

Where:

create a new molecule that consists of only the residue of type residue_type in molecule number imol

Returns: the new molecule number, -1 means an error.


Next: , Previous: new-molecule-by-residue-type-selection, Up: New Molecule by Section Interface   [Contents][Index]

11.92.2 new-molecule-by-atom-selection

function: new-molecule-by-atom-selection imol atom_selection

Where:

create a new molecule that consists of only the atoms specified by the mmdb atoms selection string in molecule number imol

Returns: the new molecule number, -1 means an error.


Next: , Previous: new-molecule-by-atom-selection, Up: New Molecule by Section Interface   [Contents][Index]

11.92.3 new-molecule-by-sphere-selection

function: new-molecule-by-sphere-selection imol x y z r allow_partial_residues

Where:

create a new molecule that consists of only the atoms within the given radius (r) of the given position.

Returns: the new molecule number, -1 means an error.


Next: , Previous: new-molecule-by-sphere-selection, Up: New Molecule by Section Interface   [Contents][Index]

11.92.4 new-molecule-by-residue-specs-py

function: new-molecule-by-residue-specs-py imol residue_spec_list_py

Where:

create a new molecule that consists of only the atoms of the specified list of residues

Returns: the new molecule number, -1 means an error.


Previous: new-molecule-by-residue-specs-py, Up: New Molecule by Section Interface   [Contents][Index]

11.92.5 new-molecule-by-residue-specs-scm

function: new-molecule-by-residue-specs-scm imol residue_spec_list_scm

Where:

create a new molecule that consists of only the atoms of the specified list of residues

Returns: the new molecule number, -1 means an error.


Next: , Previous: New Molecule by Section Interface, Up: Scripting Functions   [Contents][Index]

11.93 RNA/DNA


Next: , Up: RNA/DNA   [Contents][Index]

11.93.1 ideal-nucleic-acid

function: ideal-nucleic-acid RNA_or_DNA form single_stranged_flag sequence

Where:

create a molecule of idea nucleotides

use the given sequence (single letter code)

RNA_or_DNA is either "RNA" or "DNA"

form is either "A" or "B"

Returns: the new molecule number or -1 if a problem


Next: , Previous: ideal-nucleic-acid, Up: RNA/DNA   [Contents][Index]

11.93.2 pucker-info-scm

function: pucker-info-scm imol residue_spec do_pukka_pucker_check

Where:

get the pucker info for the specified residue

(where plane-distortion is for the other 4 atoms in the plane (I think)).

and if there is no following residue, then the phosphate distance cannot be calculated, so the (inner) list is null (not filled).

Returns: scheme false if residue not found, otherwise (list (list phosphate-distance puckered-atom out-of-plane-distance plane-distortion) chain-id resno ins-code)


Next: , Previous: pucker-info-scm, Up: RNA/DNA   [Contents][Index]

11.93.3 pucker-info-py

function: pucker-info-py imol residue_spec do_pukka_pucker_check

Where:

return False if residue not found, otherwise [[phosphate_distance, puckered_atom, out_of_plane_distance, plane_distortion], chain_id, resno, ins_code]

(where plane_distortion is for the other 4 atoms in the plane (I think)).

and if there is no following residue, then the phosphate distance cannot be calculated, so the (inner) list is null (not filled).


Next: , Previous: pucker-info-py, Up: RNA/DNA   [Contents][Index]

11.93.4 watson-crick-pair

function: watson-crick-pair imol chain_id resno

Where:

Return a molecule that contains a residue that is the WC pair partner of the clicked/picked/selected residue.


Previous: watson-crick-pair, Up: RNA/DNA   [Contents][Index]

11.93.5 watson-crick-pair-for-residue-range

function: watson-crick-pair-for-residue-range imol chain_id resno_start resno_end

Where:

add base pairs for the given residue range, modify molecule imol by creating a new chain


Next: , Previous: RNA/DNA, Up: Scripting Functions   [Contents][Index]

11.94 Sequence (Assignment)


Next: , Up: Sequence (Assignment)   [Contents][Index]

11.94.1 print-sequence-chain

function: print-sequence-chain imol chain_id

Where:

Print the sequence to the console of the given molecule.


Next: , Previous: print-sequence-chain, Up: Sequence (Assignment)   [Contents][Index]

11.94.2 print-sequence-chain-general

function: print-sequence-chain-general imol chain_id pir_format file_output file_name

Where:

optionally write the sequence to the file for the given molecule, optionally in PIR format


Next: , Previous: print-sequence-chain-general, Up: Sequence (Assignment)   [Contents][Index]

11.94.3 assign-fasta-sequence

function: assign-fasta-sequence imol chain_id_in seq

Where:

Assign a FASTA sequence to a given chain in the molecule.


Next: , Previous: assign-fasta-sequence, Up: Sequence (Assignment)   [Contents][Index]

11.94.4 assign-pir-sequence

function: assign-pir-sequence imol chain_id_in seq

Where:

Assign a PIR sequence to a given chain in the molecule. If the chain of the molecule already had a chain assigned to it, then this will overwrite that old assignment with the new one.


Next: , Previous: assign-pir-sequence, Up: Sequence (Assignment)   [Contents][Index]

11.94.5 assign-sequence-from-file

function: assign-sequence-from-file imol file

Where:

Assign a sequence to a given molecule from (whatever) sequence file.


Next: , Previous: assign-sequence-from-file, Up: Sequence (Assignment)   [Contents][Index]

11.94.6 assign-sequence-from-string

function: assign-sequence-from-string imol chain_id_in seq

Where:

Assign a sequence to a given molecule from a simple string.


Next: , Previous: assign-sequence-from-string, Up: Sequence (Assignment)   [Contents][Index]

11.94.7 delete-all-sequences-from-molecule

function: delete-all-sequences-from-molecule imol

Where imol is an integer number

Delete all the sequences from a given molecule.


Next: , Previous: delete-all-sequences-from-molecule, Up: Sequence (Assignment)   [Contents][Index]

11.94.8 delete-sequence-by-chain-id

function: delete-sequence-by-chain-id imol chain_id_in

Where:

Delete the sequence for a given chain_id from a given molecule.


Next: , Previous: delete-sequence-by-chain-id, Up: Sequence (Assignment)   [Contents][Index]

11.94.9 sequence-info

function: sequence-info imol

Where imol is an integer number

return the sequence info that has been assigned to molecule number imol. return as a list of dotted pairs (list (cons chain-id seq)). To be used in constructing the cootaneer gui. Return Scheme False when no sequence has been assigned to imol.


Next: , Previous: sequence-info, Up: Sequence (Assignment)   [Contents][Index]

11.94.10 alignment-mismatches-scm

function: alignment-mismatches-scm imol

Where imol is an integer number

do a internal alignment of all the assigned sequences, return a list of mismatches that need to be made to model number imol to match the input sequence.

Return a list of mutations deletions insetions. Return scheme false on failure to align (e.g. not assigned sequence) and the empty list on no alignment mismatches.


Next: , Previous: alignment-mismatches-scm, Up: Sequence (Assignment)   [Contents][Index]

11.94.11 sequence-info-py

function: sequence-info-py imol

Where imol is an integer number

return the sequence info that has been assigned to molecule number imol. return as a list of dotted pairs [[chain-id, seq]]. To be used in constructing the cootaneer gui. Return False when no sequence has been assigned.


Previous: sequence-info-py, Up: Sequence (Assignment)   [Contents][Index]

11.94.12 alignment-mismatches-py

function: alignment-mismatches-py imol

Where imol is an integer number

do a internal alignment of all the assigned sequences, return a list of mismatches that need to be made to model number imol to match the input sequence.

Return a list of mutations deletions insetions. Return False on failure to align (e.g. not assigned sequence) and the empty list on no alignment mismatches.


Next: , Previous: Sequence (Assignment), Up: Scripting Functions   [Contents][Index]

11.95 Surface Interface


Next: , Up: Surface Interface   [Contents][Index]

11.95.1 do-surface

function: do-surface imol istate

Where:

draw surface of molecule number imol

if state = 1 draw the surface (normal representation goes away)

if state = 0 don’t draw surface


Next: , Previous: do-surface, Up: Surface Interface   [Contents][Index]

11.95.2 do-clipped-surface-scm

function: do-clipped-surface-scm imol residue_specs

Where:

draw the surface of the imolth molecule clipped to the residues given by residue_specs.

residue_specs must not contain spec for waters (you wouldn’t want to surface over waters anyway).


Next: , Previous: do-clipped-surface-scm, Up: Surface Interface   [Contents][Index]

11.95.3 do-clipped-surface-py

function: do-clipped-surface-py imol residue_specs

Where:

draw the surface of the imolth molecule clipped to the residues given by residue_specs


Next: , Previous: do-clipped-surface-py, Up: Surface Interface   [Contents][Index]

11.95.4 set-transparent-electrostatic-surface

function: set-transparent-electrostatic-surface imol opacity

Where:

simple on/off screendoor transparency at the moment, an opacity > 0.0 will turn on screendoor transparency (stippling).


Previous: set-transparent-electrostatic-surface, Up: Surface Interface   [Contents][Index]

11.95.5 get-electrostatic-surface-opacity

function: get-electrostatic-surface-opacity imol

Where imol is an integer number

return 1.0 for non transparent and 0.5 if screendoor transparency has been turned on.


Next: , Previous: Surface Interface, Up: Scripting Functions   [Contents][Index]

11.96 FFFearing


Next: , Up: FFFearing   [Contents][Index]

11.96.1 fffear-search

function: fffear-search imol_model imol_map

Where:

fffear search model in molecule number imol_model in map number imol_map


Next: , Previous: fffear-search, Up: FFFearing   [Contents][Index]

11.96.2 set-fffear-angular-resolution

function: set-fffear-angular-resolution f

Where f is a number

set and return the fffear angular resolution in degrees


Previous: set-fffear-angular-resolution, Up: FFFearing   [Contents][Index]

11.96.3 fffear-angular-resolution

function: fffear-angular-resolution

return the fffear angular resolution in degrees


Next: , Previous: FFFearing, Up: Scripting Functions   [Contents][Index]

11.97 Remote Control


Next: , Up: Remote Control   [Contents][Index]

11.97.1 make-socket-listener-maybe

function: make-socket-listener-maybe

try to make socket listener


Next: , Previous: make-socket-listener-maybe, Up: Remote Control   [Contents][Index]

11.97.2 set-socket-string-waiting

function: set-socket-string-waiting s

Where s is a string

feed the main thread a scheme script to evaluate


Previous: set-socket-string-waiting, Up: Remote Control   [Contents][Index]

11.97.3 set-socket-python-string-waiting

function: set-socket-python-string-waiting s

Where s is a string

feed the main thread a python script to evaluate


Next: , Previous: Remote Control, Up: Scripting Functions   [Contents][Index]

11.98 Display Lists for Maps


Next: , Up: Display Lists for Maps   [Contents][Index]

11.98.1 set-display-lists-for-maps

function: set-display-lists-for-maps i

Where i is an integer number

Should display lists be used for maps? It may speed things up if these are turned on (or off) - depends on graphics card and drivers. Pass 1 for on, 0 for off.


Previous: set-display-lists-for-maps, Up: Display Lists for Maps   [Contents][Index]

11.98.2 display-lists-for-maps-state

function: display-lists-for-maps-state

return the state of display_lists_for_maps.


Next: , Previous: Display Lists for Maps, Up: Scripting Functions   [Contents][Index]

11.99 Browser Interface


Next: , Up: Browser Interface   [Contents][Index]

11.99.1 browser-url

function: browser-url url

Where url is a string

try to open given url in Web browser


Next: , Previous: browser-url, Up: Browser Interface   [Contents][Index]

11.99.2 set-browser-interface

function: set-browser-interface browser

Where browser is a string

set command to open the web browser,

examples are "open" or "mozilla"


Previous: set-browser-interface, Up: Browser Interface   [Contents][Index]

11.99.3 handle-online-coot-search-request

function: handle-online-coot-search-request entry_text

Where entry_text is a string

the search interface

find words, construct a url and open it.


Next: , Previous: Browser Interface, Up: Scripting Functions   [Contents][Index]

11.100 Molprobity Interface


Next: , Up: Molprobity Interface   [Contents][Index]

11.100.1 handle-read-draw-probe-dots

function: handle-read-draw-probe-dots dots_file

Where dots_file is a string

pass a filename that contains molprobity’s probe output in XtalView format


Next: , Previous: handle-read-draw-probe-dots, Up: Molprobity Interface   [Contents][Index]

11.100.2 handle-read-draw-probe-dots-unformatted

function: handle-read-draw-probe-dots-unformatted dots_file imol show_clash_gui_flag

Where:

pass a filename that contains molprobity’s probe output in unformatted format


Next: , Previous: handle-read-draw-probe-dots-unformatted, Up: Molprobity Interface   [Contents][Index]

11.100.3 set-do-probe-dots-on-rotamers-and-chis

function: set-do-probe-dots-on-rotamers-and-chis state

Where state is an integer number

shall we run molprobity for on edit chi angles intermediate atoms?


Next: , Previous: set-do-probe-dots-on-rotamers-and-chis, Up: Molprobity Interface   [Contents][Index]

11.100.4 do-probe-dots-on-rotamers-and-chis-state

function: do-probe-dots-on-rotamers-and-chis-state

return the state of if run molprobity for on edit chi angles intermediate atoms?


Next: , Previous: do-probe-dots-on-rotamers-and-chis-state, Up: Molprobity Interface   [Contents][Index]

11.100.5 set-do-probe-dots-post-refine

function: set-do-probe-dots-post-refine state

Where state is an integer number

shall we run molprobity after a refinement has happened?


Next: , Previous: set-do-probe-dots-post-refine, Up: Molprobity Interface   [Contents][Index]

11.100.6 do-probe-dots-post-refine-state

function: do-probe-dots-post-refine-state

show the state of shall we run molprobity after a refinement has happened?


Next: , Previous: do-probe-dots-post-refine-state, Up: Molprobity Interface   [Contents][Index]

11.100.7 unmangle-hydrogen-name

function: unmangle-hydrogen-name pdb_hydrogen_name

Where pdb_hydrogen_name is a string

make an attempt to convert pdb hydrogen name to the name used in Coot (and the refmac dictionary, perhaps).


Next: , Previous: unmangle-hydrogen-name, Up: Molprobity Interface   [Contents][Index]

11.100.8 set-interactive-probe-dots-molprobity-radius

function: set-interactive-probe-dots-molprobity-radius r

Where r is a number

set the radius over which we can run interactive probe, bigger is better but slower.

default is 6.0


Next: , Previous: set-interactive-probe-dots-molprobity-radius, Up: Molprobity Interface   [Contents][Index]

11.100.9 interactive-probe-dots-molprobity-radius

function: interactive-probe-dots-molprobity-radius

return the radius over which we can run interactive probe.


Next: , Previous: interactive-probe-dots-molprobity-radius, Up: Molprobity Interface   [Contents][Index]

11.100.10 user-mods-scm

function: user-mods-scm file_name

Where file_name is a string

return the parsed user mod fields from the PDB file file_name (output by reduce most likely)


Previous: user-mods-scm, Up: Molprobity Interface   [Contents][Index]

11.100.11 user-mods-py

function: user-mods-py file_name

Where file_name is a string

return the parsed user mod fields from the PDB file file_name (output by reduce most likely)


Next: , Previous: Molprobity Interface, Up: Scripting Functions   [Contents][Index]

11.101 Map Sharpening Interface


Next: , Up: Map Sharpening Interface   [Contents][Index]

11.101.1 sharpen

function: sharpen imol b_factor

Where:

Sharpen map imol by b_factor (note (of course) that positive numbers blur the map).


Previous: sharpen, Up: Map Sharpening Interface   [Contents][Index]

11.101.2 set-map-sharpening-scale-limit

function: set-map-sharpening-scale-limit f

Where f is a number

set the limit of the b-factor map sharpening slider (default 30)


Next: , Previous: Map Sharpening Interface, Up: Scripting Functions   [Contents][Index]

11.102 Intermediate Atom Manipulation Interface


Up: Intermediate Atom Manipulation Interface   [Contents][Index]

11.102.1 add-target-position-restraint-for-intermediate-atom-py

function: add-target-position-restraint-for-intermediate-atom-py atom_spec position

Where:

add a target position for an intermediate atom and refine


Next: , Previous: Intermediate Atom Manipulation Interface, Up: Scripting Functions   [Contents][Index]

11.103 Marking Fixed Atom Interface


Up: Marking Fixed Atom Interface   [Contents][Index]

11.103.1 clear-all-fixed-atoms

function: clear-all-fixed-atoms imol

Where imol is an integer number

clear all fixed atoms


Next: , Previous: Marking Fixed Atom Interface, Up: Scripting Functions   [Contents][Index]

11.104 Partial Charges


Up: Partial Charges   [Contents][Index]

11.104.1 show-partial-charge-info

function: show-partial-charge-info imol chain_id resno ins_code

Where:

show the partial charges for the residue of the given specs (charges are read from the dictionary)


Next: , Previous: Partial Charges, Up: Scripting Functions   [Contents][Index]

11.105 EM interface


Up: EM interface   [Contents][Index]

11.105.1 scale-cell

function: scale-cell imol_map fac_u fac_v fac_w

Where:

Scale the cell, for use with EM maps, where the cell needs to be adjusted. Use like: (scale-cell 2 1.012 1.012 1.012). Return error status, 1 means it worked, 0 means it did not work.


Next: , Previous: EM interface, Up: Scripting Functions   [Contents][Index]

11.106 CCP4mg Interface


Next: , Up: CCP4mg Interface   [Contents][Index]

11.106.1 ccp4i-projects-scm

function: ccp4i-projects-scm

return a list of pairs of strings, the project names and the directory. Include aliases.


Next: , Previous: ccp4i-projects-scm, Up: CCP4mg Interface   [Contents][Index]

11.106.2 ccp4i-projects-py

function: ccp4i-projects-py

return a list of pairs of strings, the project names and the directory. Include aliases.


Next: , Previous: ccp4i-projects-py, Up: CCP4mg Interface   [Contents][Index]

11.106.3 set-add-ccp4i-projects-to-file-dialogs

function: set-add-ccp4i-projects-to-file-dialogs state

Where state is an integer number

allow the user to not add ccp4i directories to the file choosers

use state=0 to turn it off


Next: , Previous: set-add-ccp4i-projects-to-file-dialogs, Up: CCP4mg Interface   [Contents][Index]

11.106.4 write-ccp4mg-picture-description

function: write-ccp4mg-picture-description filename

Where filename is a string

write a ccp4mg picture description file


Previous: write-ccp4mg-picture-description, Up: CCP4mg Interface   [Contents][Index]

11.106.5 get-atom-colour-from-mol-no

function: get-atom-colour-from-mol-no imol element

Where:

get element colour for imol as Python formatted list char


Next: , Previous: CCP4mg Interface, Up: Scripting Functions   [Contents][Index]

11.107 Dipoles


Next: , Up: Dipoles   [Contents][Index]

11.107.1 add-dipole-for-residues-scm

function: add-dipole-for-residues-scm imol residue_specs

Where:

generate a dipole from all atoms in the given residues. Return the dipole description


Next: , Previous: add-dipole-for-residues-scm, Up: Dipoles   [Contents][Index]

11.107.2 add-dipole-scm

function: add-dipole-scm imol chain_id res_no ins_code

Where:

return the dipole number


Next: , Previous: add-dipole-scm, Up: Dipoles   [Contents][Index]

11.107.3 add-dipole-py

function: add-dipole-py imol chain_id res_no ins_code

Where:

generate a dipole from all atoms in the given residues.


Previous: add-dipole-py, Up: Dipoles   [Contents][Index]

11.107.4 add-dipole-for-residues-py

function: add-dipole-for-residues-py imol residue_specs

Where:

add a dipole given a set of residues. Return a dipole description.


Next: , Previous: Dipoles, Up: Scripting Functions   [Contents][Index]

11.108 Aux functions


Up: Aux functions   [Contents][Index]

11.108.1 laplacian

function: laplacian imol

Where imol is an integer number

Create the "Laplacian" (-ve second derivative) of the given map.


Next: , Previous: Aux functions, Up: Scripting Functions   [Contents][Index]

11.109 SMILES


Up: SMILES   [Contents][Index]

11.109.1 do-smiles-gui

function: do-smiles-gui

display the SMILES string dialog


Next: , Previous: SMILES, Up: Scripting Functions   [Contents][Index]

11.110 PHENIX Support


Up: PHENIX Support   [Contents][Index]

11.110.1 set-button-label-for-external-refinement

function: set-button-label-for-external-refinement button_label

Where button_label is a string

set the button label of the external Refinement program


Next: , Previous: PHENIX Support, Up: Scripting Functions   [Contents][Index]

11.111 Graphics Text


Next: , Up: Graphics Text   [Contents][Index]

11.111.1 place-text

function: place-text text x y z size

Where:

Put text at x,y,z.

size variable is currently ignored.

Returns: a text handle


Next: , Previous: place-text, Up: Graphics Text   [Contents][Index]

11.111.2 remove-text

function: remove-text text_handle

Where text_handle is an integer number

Remove "3d" text item.


Previous: remove-text, Up: Graphics Text   [Contents][Index]

11.111.3 text-index-near-position

function: text-index-near-position x y z r

Where:

return the closest text that is with r A of the given position. If no text item is close, then return -1


Next: , Previous: Graphics Text, Up: Scripting Functions   [Contents][Index]

11.112 PISA Interaction


Up: PISA Interaction   [Contents][Index]

11.112.1 pisa-interaction

function: pisa-interaction imol_1 imol_2

Where:

return the molecule number of the interacting residues. Return -1 if no new model was created. Old, not very useful.


Next: , Previous: PISA Interaction, Up: Scripting Functions   [Contents][Index]

11.113 Jiggle Fit


Next: , Up: Jiggle Fit   [Contents][Index]

11.113.1 fit-to-map-by-random-jiggle

function: fit-to-map-by-random-jiggle imol chain_id resno ins_code n_trials jiggle_scale_factor

Where:

jiggle fit to the current refinment map. return < -100 if not possible, else return the new best fit for this residue.


Next: , Previous: fit-to-map-by-random-jiggle, Up: Jiggle Fit   [Contents][Index]

11.113.2 fit-molecule-to-map-by-random-jiggle

function: fit-molecule-to-map-by-random-jiggle imol n_trials jiggle_scale_factor

Where:

jiggle fit the molecule to the current refinment map. return < -100 if not possible, else return the new best fit for this molecule.


Next: , Previous: fit-molecule-to-map-by-random-jiggle, Up: Jiggle Fit   [Contents][Index]

11.113.3 fit-molecule-to-map-by-random-jiggle-and-blur

function: fit-molecule-to-map-by-random-jiggle-and-blur imol n_trials jiggle_scale_factor map_blur_factor

Where:

jiggle fit the molecule to the current refinment map. return < -100 if not possible, else return the new best fit for this molecule - create a map that is blurred by the given factor for fitting


Next: , Previous: fit-molecule-to-map-by-random-jiggle-and-blur, Up: Jiggle Fit   [Contents][Index]

11.113.4 fit-chain-to-map-by-random-jiggle

function: fit-chain-to-map-by-random-jiggle imol chain_id n_trials jiggle_scale_factor

Where:

jiggle fit the chain to the current refinment map. return < -100 if not possible, else return the new best fit for this chain.


Previous: fit-chain-to-map-by-random-jiggle, Up: Jiggle Fit   [Contents][Index]

11.113.5 fit-chain-to-map-by-random-jiggle-and-blur

function: fit-chain-to-map-by-random-jiggle-and-blur imol chain_id n_trials jiggle_scale_factor map_blur_factor

Where:

jiggle fit the chain to the current refinment map

Use a map that is blurred by the give factor for fitting.

Returns: < -100 if not possible, else return the new best fit for this chain.


Next: , Previous: Jiggle Fit, Up: Scripting Functions   [Contents][Index]

11.114 SBase interface


Next: , Up: SBase interface   [Contents][Index]

11.114.1 matching-compound-names-from-sbase-scm

function: matching-compound-names-from-sbase-scm compound_name_fragment

Where compound_name_fragment is a string

return a list of compoundIDs of in SBase of which the given string is a substring of the compound name


Next: , Previous: matching-compound-names-from-sbase-scm, Up: SBase interface   [Contents][Index]

11.114.2 matching-compound-names-from-sbase-py

function: matching-compound-names-from-sbase-py compound_name_fragment

Where compound_name_fragment is a string

return a list of compoundIDs of in SBase of which the given string is a substring of the compound name


Next: , Previous: matching-compound-names-from-sbase-py, Up: SBase interface   [Contents][Index]

11.114.3 get-ccp4srs-monomer-and-dictionary

function: get-ccp4srs-monomer-and-dictionary comp_id

Where comp_id is a string

return the new molecule number of the monomer.

The monomer will have chainid "A" and residue number 1.

Return -1 on failure to get monomer.


Previous: get-ccp4srs-monomer-and-dictionary, Up: SBase interface   [Contents][Index]

11.114.4 get-sbase-monomer

function: get-sbase-monomer comp_id

Where comp_id is a string

same as above but using old name for back-compatibility


Next: , Previous: SBase interface, Up: Scripting Functions   [Contents][Index]

11.115 FLE-View


Next: , Up: FLE-View   [Contents][Index]

11.115.1 fle-view-set-water-dist-max

function: fle-view-set-water-dist-max dist_max

Where dist_max is a number

set the maximum considered distance to water

default 3.25 A.


Previous: fle-view-set-water-dist-max, Up: FLE-View   [Contents][Index]

11.115.2 fle-view-set-h-bond-dist-max

function: fle-view-set-h-bond-dist-max h_bond_dist_max

Where h_bond_dist_max is a number

set the maximum considered hydrogen bond distance

default 3.9 A.


Next: , Previous: FLE-View, Up: Scripting Functions   [Contents][Index]

11.116 LSQ-improve


Up: LSQ-improve   [Contents][Index]

11.116.1 lsq-improve

function: lsq-improve imol_ref ref_selection imol_moving moving_selection n_res dist_crit

Where:

an slightly-modified implementation of the "lsq_improve" algorithm of Kleywegt and Jones (1997).

Note that if a residue selection is specified in the residue selection(s), then the first residue of the given range must exist in the molecule (if not, then mmdb will not select any atoms from that molecule).

Kleywegt and Jones set n_res to 4 and dist_crit to 6.0.


Next: , Previous: LSQ-improve, Up: Scripting Functions   [Contents][Index]

11.117 single-model view


Next: , Up: single-model view   [Contents][Index]

11.117.1 single-model-view-model-number

function: single-model-view-model-number imol imodel

Where:

put molecule number imol to display only model number imodel


Next: , Previous: single-model-view-model-number, Up: single-model view   [Contents][Index]

11.117.2 single-model-view-this-model-number

function: single-model-view-this-model-number imol

Where imol is an integer number

the current model number being displayed

return 0 on non-multimodel-molecule.


Next: , Previous: single-model-view-this-model-number, Up: single-model view   [Contents][Index]

11.117.3 single-model-view-next-model-number

function: single-model-view-next-model-number imol

Where imol is an integer number

change the representation to the next model number to be displayed

return 0 on non-multimodel-molecule.


Previous: single-model-view-next-model-number, Up: single-model view   [Contents][Index]

11.117.4 single-model-view-prev-model-number

function: single-model-view-prev-model-number imol

Where imol is an integer number

change the representation to the previous model number to be displayed

return 0 on non-multimodel-molecule.


Previous: single-model view, Up: Scripting Functions   [Contents][Index]

11.118 graphics 2D ligand view


Up: graphics 2D ligand view   [Contents][Index]

11.118.1 set-show-graphics-ligand-view

function: set-show-graphics-ligand-view state

Where state is an integer number

set the graphics ligand view state

(default is 1 (on)).


Next: , Previous: Scripting Functions, Up: Top   [Contents][Index]

12 More Scripting Functions


Next: , Up: More Scripting Functions   [Contents][Index]

12.1 More Symmetry Functions


Next: , Up: More Symmetry Functions   [Contents][Index]

12.1.1 get-symmetry

function: get-symmetry imol

Where imol is an integer number

return the symmetry of the imolth molecule

Return as a list of strings the symmetry operators of the given molecule. If imol is a not a valid molecule, return an empty list.


Previous: get-symmetry, Up: More Symmetry Functions   [Contents][Index]

12.1.2 clashes-with-symmetry

function: clashes-with-symmetry imol chain_id res_no ins_code clash_dist

Where:

return 1 if this residue clashes with the symmetry-related atoms of the same molecule.

0 means that it did not clash, -1 means that the residue or molecule could not be found or that there was no cell and symmetry.


Next: , Previous: More Symmetry Functions, Up: More Scripting Functions   [Contents][Index]

12.2 Extra Map Functions


Next: , Up: Extra Map Functions   [Contents][Index]

12.2.1 auto-read-make-and-draw-maps

function: auto-read-make-and-draw-maps filename

Where filename is a string

read MTZ file filename and from it try to make maps

Useful for reading the output of refmac. The default labels (FWT/PHWT and DELFWT/PHDELFWT) can be changed using ...[something]

Returns: a list of molecule numbers for the new maps


Next: , Previous: auto-read-make-and-draw-maps, Up: Extra Map Functions   [Contents][Index]

12.2.2 auto-read-make-and-draw-maps-from-mtz

function: auto-read-make-and-draw-maps-from-mtz filename

Where filename is a string

set the flag to do a difference map (too) on auto-read MTZ


Next: , Previous: auto-read-make-and-draw-maps-from-mtz, Up: Extra Map Functions   [Contents][Index]

12.2.3 sharpen-blur-map

function: sharpen-blur-map imol_map b_factor

Where:

make a sharpened or blurred map

blurred maps are generated by using a positive value of b_factor.

Returns: the index of the map created by applying a b-factor to the given map. Return -1 on failure.


Next: , Previous: sharpen-blur-map, Up: Extra Map Functions   [Contents][Index]

12.2.4 sharpen-blur-map-with-resampling

function: sharpen-blur-map-with-resampling imol_map b_factor resample_factor

Where:

make a sharpened or blurred map with resampling

resampling factor might typically be 1.3

blurred maps are generated by using a positive value of b_factor.

Returns: the index of the map created by applying a b-factor to the given map. Return -1 on failure.


Next: , Previous: sharpen-blur-map-with-resampling, Up: Extra Map Functions   [Contents][Index]

12.2.5 multi-sharpen-blur-map-scm

function: multi-sharpen-blur-map-scm imol_map b_factors_list

Where:

make many sharpened or blurred maps

blurred maps are generated by using a positive value of b_factor.


Next: , Previous: multi-sharpen-blur-map-scm, Up: Extra Map Functions   [Contents][Index]

12.2.6 multi-sharpen-blur-map-py

function: multi-sharpen-blur-map-py imol_map b_factors_list

Where:

make many sharpened or blurred maps

blurred maps are generated by using a positive value of b_factor.


Next: , Previous: multi-sharpen-blur-map-py, Up: Extra Map Functions   [Contents][Index]

12.2.7 flip-hand

function: flip-hand imol_map

Where imol_map is an integer number

Flip the hand of the map.

in case it was accidentally generated on the wrong one.

Returns: the molecule number of the flipped map.


Next: , Previous: flip-hand, Up: Extra Map Functions   [Contents][Index]

12.2.8 go-to-map-molecule-centre

function: go-to-map-molecule-centre imol_map

Where imol_map is an integer number

Go to the centre of the molecule - for Cryo-EM Molecules.

and recontour at a sensible value.


Next: , Previous: go-to-map-molecule-centre, Up: Extra Map Functions   [Contents][Index]

12.2.9 b-factor-from-map

function: b-factor-from-map imol_map

Where imol_map is an integer number

b-factor from map

calculate structure factors and use the amplitudes to estimate the B-factor of the data using a wilson plot using a low resolution limit of 4.5A.

Returns: -1 when given a bad map or there were no data beyond 4.5A


Next: , Previous: b-factor-from-map, Up: Extra Map Functions   [Contents][Index]

12.2.10 map-colour-components

function: map-colour-components imol

Where imol is an integer number

return the colour triple of the imolth map

(e.g.: (list 0.4 0.6 0.8). If invalid imol return scheme false.


Next: , Previous: map-colour-components, Up: Extra Map Functions   [Contents][Index]

12.2.11 map-colour-components-py

function: map-colour-components-py imol

Where imol is an integer number

return the colour triple of the imolth map

e.g.: [0.4, 0.6, 0.8]. If invalid imol return Py_False.


Previous: map-colour-components-py, Up: Extra Map Functions   [Contents][Index]

12.2.12 handle-read-ccp4-map

function: handle-read-ccp4-map filename is_diff_map_flag

Where:

read a CCP4 map or a CNS map (despite the name).


Next: , Previous: Extra Map Functions, Up: More Scripting Functions   [Contents][Index]

12.3 Multi-Residue Torsion


Next: , Up: Multi-Residue Torsion   [Contents][Index]

12.3.1 multi-residue-torsion-fit-scm

function: multi-residue-torsion-fit-scm imol residues_specs_scm n_trials

Where:

fit residues

(note: fit to the current-refinement map)


Previous: multi-residue-torsion-fit-scm, Up: Multi-Residue Torsion   [Contents][Index]

12.3.2 multi-residue-torsion-fit-py

function: multi-residue-torsion-fit-py imol residues_specs_py n_trials

Where:

fit residues

(note: fit to the current-refinement map)


Next: , Previous: Multi-Residue Torsion, Up: More Scripting Functions   [Contents][Index]

12.4 Merge Fragments


Up: Merge Fragments   [Contents][Index]

12.4.1 merge-fragments

function: merge-fragments imol

Where imol is an integer number

each fragment is presumed to be in its own chain.


Next: , Previous: Merge Fragments, Up: More Scripting Functions   [Contents][Index]

12.5 Execute Refmac


Next: , Up: Execute Refmac   [Contents][Index]

12.5.1 execute-refmac-real

function: execute-refmac-real pdb_in_filename pdb_out_filename mtz_in_filename mtz_out_filename cif_lib_filename fobs_col_name sigfobs_col_name r_free_col_name have_sensible_free_r_flag make_molecules_flag refmac_count_string swap_map_colours_post_refmac_flag imol_refmac_map diff_map_flag phase_combine_flag phib_string fom_string ccp4i_project_dir

Where:

if swap_map_colours_post_refmac_flag is not 1 thenn imol_refmac_map is ignored.


Previous: execute-refmac-real, Up: Execute Refmac   [Contents][Index]

12.5.2 refmac-name

function: refmac-name imol

Where imol is an integer number

the name for refmac

Returns: a stub name used in the construction of filename for refmac output


Next: , Previous: Execute Refmac, Up: More Scripting Functions   [Contents][Index]

12.6 Dictionary Functions


Up: Dictionary Functions   [Contents][Index]

12.6.1 dictionaries-read

function: dictionaries-read

return a list of all the dictionaries read


Next: , Previous: Dictionary Functions, Up: More Scripting Functions   [Contents][Index]

12.7 Restraints Interface


Up: Restraints Interface   [Contents][Index]

12.7.1 set-monomer-restraints

function: set-monomer-restraints monomer_type restraints

Where:

set the monomer restraints of the given monomer_type

Returns: scheme false or true for success or failure to set the restrains for monomer_type


Next: , Previous: Restraints Interface, Up: More Scripting Functions   [Contents][Index]

12.8 Atom Information functions


Next: , Up: Atom Information functions   [Contents][Index]

12.8.1 resname-from-serial-number

function: resname-from-serial-number imol chain_id serial_num

Where:

return the rename from a residue serial number

Returns: blank ("") on failure.


Next: , Previous: resname-from-serial-number, Up: Atom Information functions   [Contents][Index]

12.8.2 residue-name

function: residue-name imol chain_id resno ins_code

Where:

return the residue name of the specified residue


Next: , Previous: residue-name, Up: Atom Information functions   [Contents][Index]

12.8.3 serial-number-from-residue-specs

function: serial-number-from-residue-specs imol chain_id res_no ins_code

Where:

return the serial number of the specified residue

Returns: -1 on failure to find the residue


Next: , Previous: serial-number-from-residue-specs, Up: Atom Information functions   [Contents][Index]

12.8.4 residue-info

function: residue-info imol chain_id resno ins_code

Where:

Return a list of atom info for each atom in the specified residue.

output is like this: (list (list (list atom-name alt-conf) (list occ temp-fact element) (list x y z)))

occ can be a single number or a list of seven numbers of which the first is the isotropic B.


Next: , Previous: residue-info, Up: Atom Information functions   [Contents][Index]

12.8.5 chain-fragments-scm

function: chain-fragments-scm imol screen_output_also

Where:

chain fragments


Next: , Previous: chain-fragments-scm, Up: Atom Information functions   [Contents][Index]

12.8.6 add-molecule

function: add-molecule molecule_expression name

Where:

generate a molecule from an s-expression

return a molecule number, -1 on error


Next: , Previous: add-molecule, Up: Atom Information functions   [Contents][Index]

12.8.7 clear-and-update-molecule

function: clear-and-update-molecule molecule_number molecule_expression

Where:

update a molecule from a s-expression

And going the other way, given an s-expression, update molecule_number by the given molecule. Clear what’s currently there first though.


Next: , Previous: clear-and-update-molecule, Up: Atom Information functions   [Contents][Index]

12.8.8 active-residue

function: active-residue

return specs of the atom close to screen centre

Return a list of (list imol chain-id resno ins-code atom-name alt-conf) for atom that is closest to the screen centre in any displayed molecule. If there are multiple models with the same coordinates at the screen centre, return the attributes of the atom in the highest number molecule number.

return scheme false if no active residue


Next: , Previous: active-residue, Up: Atom Information functions   [Contents][Index]

12.8.9 closest-atom-simple-scm

function: closest-atom-simple-scm

return the specs of the closest displayed atom

Return a list of (list imol chain-id resno ins-code atom-name alt-conf (list x y z)) for atom that is closest to the screen centre in the given molecule (unlike active-residue, potential CA substition is not performed). If there is no atom, or if imol is not a valid model molecule, return scheme false.


Next: , Previous: closest-atom-simple-scm, Up: Atom Information functions   [Contents][Index]

12.8.10 closest-atom

function: closest-atom imol

Where imol is an integer number

return the specs of the closest atom in imolth molecule

Return a list of (list imol chain-id resno ins-code atom-name alt-conf (list x y z)) for atom that is closest to the screen centre in the given molecule (unlike active-residue, no account is taken of the displayed state of the molecule). If there is no atom, or if imol is not a valid model molecule, return scheme false.


Next: , Previous: closest-atom, Up: Atom Information functions   [Contents][Index]

12.8.11 closest-atom-raw-scm

function: closest-atom-raw-scm

return the specs of the closest atom to the centre of the screen

Return a list of (list imol chain-id resno ins-code atom-name alt-conf (list x y z)) for atom that is closest to the screen for displayed molecules. If there is no atom, return scheme false. Don’t choose the CA of the residue if there is a CA in the residue of the closest atom. 201602015-PE: I add this now, but I have a feeling that I’ve done this before.


Next: , Previous: closest-atom-raw-scm, Up: Atom Information functions   [Contents][Index]

12.8.12 residues-near-residue

function: residues-near-residue imol residue_in_scm radius

Where:

return residues near residue

Return residue specs for residues that have atoms that are closer than radius Angstroems to any atom in the residue specified by res_in.


Next: , Previous: residues-near-residue, Up: Atom Information functions   [Contents][Index]

12.8.13 residues-near-residues-scm

function: residues-near-residues-scm imol residues_in radius

Where:

return residues near the given residues

Return residue specs for residues that have atoms that are closer than radius Angstroems to any atom in the residue specified by res_in.


Next: , Previous: residues-near-residues-scm, Up: Atom Information functions   [Contents][Index]

12.8.14 residues-near-position-scm

function: residues-near-position-scm imol pos radius

Where:

residues near residue

Return a list of pairs of (imol, residue_spec). pos is a list of 3 numbers. (get imol from active-atom)

Returns: residues within radius of pos (x,y,z) position


Next: , Previous: residues-near-position-scm, Up: Atom Information functions   [Contents][Index]

12.8.15 label-closest-atoms-in-neighbour-residues-scm

function: label-closest-atoms-in-neighbour-residues-scm imol residue_spec_scm radius

Where:

label the closest atoms in the residues that neighbour residue_spec


Next: , Previous: label-closest-atoms-in-neighbour-residues-scm, Up: Atom Information functions   [Contents][Index]

12.8.16 hydrogenate-region

function: hydrogenate-region radius

Where radius is a number

find the active residue, find the near residues (within radius) create a new molecule, run reduce on that, import hydrogens from the result and apply them to the molecule of the active residue.


Next: , Previous: hydrogenate-region, Up: Atom Information functions   [Contents][Index]

12.8.17 add-hydrogens-from-file

function: add-hydrogens-from-file imol pdb_with_Hs_file_name

Where:

Add hydrogens to imol from the given pdb file.


Next: , Previous: add-hydrogens-from-file, Up: Atom Information functions   [Contents][Index]

12.8.18 atom-info-string-py

function: atom-info-string-py imol chain_id resno ins_code atname altconf

Where:

output atom info in a python list for use in scripting:

in this format [occ, temp_factor, element, x, y, z]. Return empty list if atom not found.


Next: , Previous: atom-info-string-py, Up: Atom Information functions   [Contents][Index]

12.8.19 molecule-to-pdb-string-py

function: molecule-to-pdb-string-py imol

Where imol is an integer number

Return the molecule as a PDB string.


Previous: molecule-to-pdb-string-py, Up: Atom Information functions   [Contents][Index]

12.8.20 residue-info-py

function: residue-info-py imol chain_id resno ins_code

Where:

Return a list of atom info for each atom in the specified residue:

output is like this: [ [[atom-name,alt-conf] [occ,temp_fact,element] [x,y,z]]]


Next: , Previous: Atom Information functions, Up: More Scripting Functions   [Contents][Index]

12.9 Using S-expression molecules


Next: , Up: Using S-expression molecules   [Contents][Index]

12.9.1 active-residue-py

function: active-residue-py

Return a list of [imol, chain-id, resno, ins-code, atom-name, alt-conf] for atom that is closest to the screen centre. If there are multiple models with the same coordinates at the screen centre, return the attributes of the atom in the highest number molecule number.

return False if no active residue


Next: , Previous: active-residue-py, Up: Using S-expression molecules   [Contents][Index]

12.9.2 closest-atom-simple-py

function: closest-atom-simple-py

return the spec of the closest displayed atom

Return a list of [imol, chain-id, resno, ins-code, atom-name, alt-conf, [x, y, z]] for atom that is closest to the screen centre in the given molecule (unlike active-residue, potential CA substition is not performed). If there is no atom, or if imol is not a valid model molecule, return False.


Next: , Previous: closest-atom-simple-py, Up: Using S-expression molecules   [Contents][Index]

12.9.3 closest-atom-py

function: closest-atom-py imol

Where imol is an integer number

return closest atom in imolth molecule

Return a list of [imol, chain-id, resno, ins-code, atom-name, alt-conf, [x, y, z]] for atom that is closest to the screen centre in the given molecule (unlike active-residue, no account is taken of the displayed state of the molecule). If there is no atom, or if imol is not a valid model molecule, return False.


Next: , Previous: closest-atom-py, Up: Using S-expression molecules   [Contents][Index]

12.9.4 closest-atom-raw-py

function: closest-atom-raw-py

return the specs of the closest atom to the centre of the screen

Return a list of (list imol chain-id resno ins-code atom-name alt-conf (list x y z)) for atom that is closest to the screen for displayed molecules. If there is no atom, return scheme false. Don’t choose the CA of the residue if there is a CA in the residue of the closest atom


Next: , Previous: closest-atom-raw-py, Up: Using S-expression molecules   [Contents][Index]

12.9.5 residues-near-position-py

function: residues-near-position-py imol pos_in radius

Where:

Return residue specs for residues that have atoms that are closer than radius Angstroems to the given position.


Next: , Previous: residues-near-position-py, Up: Using S-expression molecules   [Contents][Index]

12.9.6 label-closest-atoms-in-neighbour-residues-py

function: label-closest-atoms-in-neighbour-residues-py imol residue_spec_py radius

Where:

label the closest atoms in the residues that neighbour residue_spec


Next: , Previous: label-closest-atoms-in-neighbour-residues-py, Up: Using S-expression molecules   [Contents][Index]

12.9.7 get-bonds-representation

function: get-bonds-representation imol

Where imol is an integer number

return a Python object for the bonds


Next: , Previous: get-bonds-representation, Up: Using S-expression molecules   [Contents][Index]

12.9.8 get-dictionary-radii

function: get-dictionary-radii

return a Python object for the radii of the atoms in the dictionary


Next: , Previous: get-dictionary-radii, Up: Using S-expression molecules   [Contents][Index]

12.9.9 get-environment-distances-representation-py

function: get-environment-distances-representation-py imol residue_spec_py

Where:

return a Python object for the representation of bump and hydrogen bonds of


Next: , Previous: get-environment-distances-representation-py, Up: Using S-expression molecules   [Contents][Index]

12.9.10 get-intermediate-atoms-bonds-representation

function: get-intermediate-atoms-bonds-representation

return a Python object for the intermediate atoms bonds


Previous: get-intermediate-atoms-bonds-representation, Up: Using S-expression molecules   [Contents][Index]

12.9.11 get-continue-updating-refinement-atoms-state

function: get-continue-updating-refinement-atoms-state

return the continue-updating-refinement-atoms state


Next: , Previous: Using S-expression molecules, Up: More Scripting Functions   [Contents][Index]

12.10 Refinement with specs


Next: , Up: Refinement with specs   [Contents][Index]

12.10.1 all-residues-with-serial-numbers-scm

function: all-residues-with-serial-numbers-scm imol

Where imol is an integer number

a utility to return the specs of all the residues, each spec prefixed by the serial number


Next: , Previous: all-residues-with-serial-numbers-scm, Up: Refinement with specs   [Contents][Index]

12.10.2 regularize-residues

function: regularize-residues imol residues

Where:

regularize the given residues


Next: , Previous: regularize-residues, Up: Refinement with specs   [Contents][Index]

12.10.3 mtz-file-name

function: mtz-file-name imol

Where imol is an integer number

presumes that imol_Refinement_Map has been set


Previous: mtz-file-name, Up: Refinement with specs   [Contents][Index]

12.10.4 refine-zone-with-full-residue-spec-scm

function: refine-zone-with-full-residue-spec-scm imol chain_id resno1 inscode_1 resno2 inscode_2 altconf

Where:

Refine the given residue range.


Next: , Previous: Refinement with specs, Up: More Scripting Functions   [Contents][Index]

12.11 Water Chain Functions


Next: , Up: Water Chain Functions   [Contents][Index]

12.11.1 water-chain-from-shelx-ins-scm

function: water-chain-from-shelx-ins-scm imol

Where imol is an integer number

return the chain id of the water chain from a shelx molecule. Raw interface

Returns: scheme false if no chain or bad imol


Next: , Previous: water-chain-from-shelx-ins-scm, Up: Water Chain Functions   [Contents][Index]

12.11.2 water-chain-scm

function: water-chain-scm imol

Where imol is an integer number

return the chain id of the water chain. Raw interface


Previous: water-chain-scm, Up: Water Chain Functions   [Contents][Index]

12.11.3 water-chain-py

function: water-chain-py imol

Where imol is an integer number

return the chain id of the water chain. Raw interface


Next: , Previous: Water Chain Functions, Up: More Scripting Functions   [Contents][Index]

12.12 Glyco Tools


Up: Glyco Tools   [Contents][Index]

12.12.1 print-glyco-tree

function: print-glyco-tree imol chain_id resno ins_code

Where:

print the glycosylation tree that contains the specified residue


Next: , Previous: Glyco Tools, Up: More Scripting Functions   [Contents][Index]

12.13 Spin Search Functions


Next: , Up: Spin Search Functions   [Contents][Index]

12.13.1 spin-search

function: spin-search imol_map imol chain_id resno ins_code direction_atoms_list moving_atoms_list

Where:

for the given residue, spin the atoms in moving_atom_list around the bond defined by direction_atoms_list looking for the best fit to density of imol_map map of the first atom in moving_atom_list. Works (only) with atoms in altconf ""


Next: , Previous: spin-search, Up: Spin Search Functions   [Contents][Index]

12.13.2 spin-N-scm

function: spin-N-scm imol residue_spec_scm angle

Where:

Spin N and CB (and the rest of the side chain if extant)

Sometime on N-terminal addition, then N ends up pointing the wrong way. The allows us to (more or less) interchange the positions of the CB and the N. angle is in degrees.


Next: , Previous: spin-N-scm, Up: Spin Search Functions   [Contents][Index]

12.13.3 CG-spin-search-scm

function: CG-spin-search-scm imol_model imol_map

Where:

Spin search the density based on possible positions of CG of a side-chain.

c.f. EM-Ringer


Next: , Previous: CG-spin-search-scm, Up: Spin Search Functions   [Contents][Index]

12.13.4 spin-search-py

function: spin-search-py imol_map imol chain_id resno ins_code direction_atoms_list moving_atoms_list

Where:

for the given residue, spin the atoms in moving_atom_list...

around the bond defined by direction_atoms_list looking for the best fit to density of imom_map map of the first atom in moving_atom_list. Works (only) with atoms in altconf ""


Next: , Previous: spin-search-py, Up: Spin Search Functions   [Contents][Index]

12.13.5 spin-N-py

function: spin-N-py imol residue_spec angle

Where:

Spin N and CB (and the rest of the side chain if extant)

Sometime on N-terminal addition, then N ends up pointing the wrong way. The allows us to (more or less) interchange the positions of the CB and the N. angle is in degrees.


Previous: spin-N-py, Up: Spin Search Functions   [Contents][Index]

12.13.6 CG-spin-search-py

function: CG-spin-search-py imol_model imol_map

Where:

Spin search the density based on possible positions of CG of a side-chain.


Next: , Previous: Spin Search Functions, Up: More Scripting Functions   [Contents][Index]

12.14 Rotamer Scoring


Up: Rotamer Scoring   [Contents][Index]

12.14.1 score-rotamers-scm

function: score-rotamers-scm imol chain_id res_no ins_code alt_conf imol_map clash_flag lowest_probability

Where:

return the scores of the rotamers for this residue.


Next: , Previous: Rotamer Scoring, Up: More Scripting Functions   [Contents][Index]

12.15 protein-db


Up: protein-db   [Contents][Index]

12.15.1 protein-db-loops

function: protein-db-loops imol_coords residue_specs imol_map nfrags preserve_residue_names

Where:

Cowtan’s protein_db loops.


Next: , Previous: protein-db, Up: More Scripting Functions   [Contents][Index]

12.16 Coot’s Hole implementation


Next: , Up: Coot's Hole implementation   [Contents][Index]

12.16.1 hole

function: hole imol start_x start_y start_z end_x end_y end_z colour_map_multiplier colour_map_offset n_runs show_probe_radius_graph_flag export_surface_dots_file_name

Where:

starting piont and end point, colour map multiplier and shall the probe radius graph be shown (dummy value currently).

if export_dots_file_name string length is zero, then don’t try to export the surface dots.


Previous: hole, Up: Coot's Hole implementation   [Contents][Index]

12.16.2 make-link

function: make-link imol spec_1 spec_2 link_name length

Where:

make a link between the specified atoms


Next: , Previous: Coot's Hole implementation, Up: More Scripting Functions   [Contents][Index]

12.17 Drag and Drop Functions


Up: Drag and Drop Functions   [Contents][Index]

12.17.1 handle-drag-and-drop-string

function: handle-drag-and-drop-string uri

Where uri is a const std::string &

handle the string that get when a file or URL is dropped.


Next: , Previous: Drag and Drop Functions, Up: More Scripting Functions   [Contents][Index]

12.18 Map Contouring Functions


Up: Map Contouring Functions   [Contents][Index]

12.18.1 map-contours

function: map-contours imol contour_level

Where:

return two lists: a list of vertices and a list of indices for connection


Next: , Previous: Map Contouring Functions, Up: More Scripting Functions   [Contents][Index]

12.19 Map to Model Correlation


Next: , Up: Map to Model Correlation   [Contents][Index]

12.19.1 set-map-correlation-atom-radius

function: set-map-correlation-atom-radius r

Where r is a number

The atom radius is not passed as a parameter to correlation.


Next: , Previous: set-map-correlation-atom-radius, Up: Map to Model Correlation   [Contents][Index]

12.19.2 map-to-model-correlation-scm

function: map-to-model-correlation-scm imol residue_specs neighb_residue_specs atom_mask_mode imol_map

Where:

atom-mask-mode is as follows:


Next: , Previous: map-to-model-correlation-scm, Up: Map to Model Correlation   [Contents][Index]

12.19.3 map-to-model-correlation

function: map-to-model-correlation imol residue_specs neigh_residue_specs atom_mask_mode imol_map

Where:

atom-mask-mode is as follows:


Next: , Previous: map-to-model-correlation, Up: Map to Model Correlation   [Contents][Index]

12.19.4 map-to-model-correlation-stats

function: map-to-model-correlation-stats imol residue_specs neigh_residue_specs atom_mask_mode imol_map

Where:

map to model density correlation stats

atom-mask-mode is as follows:


Next: , Previous: map-to-model-correlation-stats, Up: Map to Model Correlation   [Contents][Index]

12.19.5 map-to-model-correlation-per-residue

function: map-to-model-correlation-per-residue imol specs atom_mask_mode imol_map

Where:

map to model density correlation, reported per residue

atom-mask-mode is as follows:


Next: , Previous: map-to-model-correlation-per-residue, Up: Map to Model Correlation   [Contents][Index]

12.19.6 map-to-model-correlation-stats-per-residue

function: map-to-model-correlation-stats-per-residue imol residue_specs atom_mask_mode atom_radius_for_masking imol_map

Where:

map to model density statistics, reported per residue


Next: , Previous: map-to-model-correlation-stats-per-residue, Up: Map to Model Correlation   [Contents][Index]

12.19.7 map-to-model-correlation-per-residue-scm

function: map-to-model-correlation-per-residue-scm imol residue_specs atom_mask_mode imol_map

Where:

map to model correlation


Next: , Previous: map-to-model-correlation-per-residue-scm, Up: Map to Model Correlation   [Contents][Index]

12.19.8 map-to-model-correlation-stats-per-residue-scm

function: map-to-model-correlation-stats-per-residue-scm imol residue_specs_scm atom_mask_mode atom_radius_for_masking imol_map

Where:

map to model stats


Next: , Previous: map-to-model-correlation-stats-per-residue-scm, Up: Map to Model Correlation   [Contents][Index]

12.19.9 qq-plot-map-and-model-scm

function: qq-plot-map-and-model-scm imol residue_specs_scm neigh_residue_specs_scm atom_mask_mode imol_map

Where:

QQ plot of the model density correlation, reported per residue.

atom-mask-mode is as follows:


Next: , Previous: qq-plot-map-and-model-scm, Up: Map to Model Correlation   [Contents][Index]

12.19.10 density-score-residue

function: density-score-residue imol chain_id res_no ins_code imol_map

Where:

simple density score for given residue (over-ridden by scripting function)


Next: , Previous: density-score-residue, Up: Map to Model Correlation   [Contents][Index]

12.19.11 map-mean-scm

function: map-mean-scm imol

Where imol is an integer number

return sigma for the given map. Return scheme False if not a valid map molecule number.


Next: , Previous: map-mean-scm, Up: Map to Model Correlation   [Contents][Index]

12.19.12 map-statistics-scm

function: map-statistics-scm imol

Where imol is an integer number

return either scheme false on non-a-map or list (mean, standard-deviation, skew, kurtosis)


Previous: map-statistics-scm, Up: Map to Model Correlation   [Contents][Index]

12.19.13 map-mean-py

function: map-mean-py imol

Where imol is an integer number

return sigma for the given map. Return Python False if not a valid map molecule number.


Previous: Map to Model Correlation, Up: More Scripting Functions   [Contents][Index]

12.20 Get Sequence


Next: , Up: Get Sequence   [Contents][Index]

12.20.1 get-sequence-as-fasta-for-chain

function: get-sequence-as-fasta-for-chain imol chain_id

Where:

get the sequence for chain_id in imol


Previous: get-sequence-as-fasta-for-chain, Up: Get Sequence   [Contents][Index]

12.20.2 write-sequence

function: write-sequence imol file_name

Where:

write the sequence for imol as fasta


Next: , Previous: More Scripting Functions, Up: Top   [Contents][Index]

13 More Refinement Scripting Functions


Up: More Refinement Scripting Functions   [Contents][Index]

13.1 More Refinement Functions


Next: , Up: More Refinement Functions   [Contents][Index]

13.1.1 use-unimodal-ring-torsion-restraints

function: use-unimodal-ring-torsion-restraints res_name

Where res_name is a const std::string &

use unimodal ring torsion restraints (e.g. for carbohydrate pyranose)


Next: , Previous: use-unimodal-ring-torsion-restraints, Up: More Refinement Functions   [Contents][Index]

13.1.2 use-unimodal-ring-torsion-restraints-for-residue

function: use-unimodal-ring-torsion-restraints-for-residue res_name torsions_info_list

Where:

use unimodal ring torsion restraints (e.g. for carbohydrate pyranose)


Next: , Previous: use-unimodal-ring-torsion-restraints-for-residue, Up: More Refinement Functions   [Contents][Index]

13.1.3 set-refinement-geman-mcclure-alpha

function: set-refinement-geman-mcclure-alpha alpha

Where alpha is a number

set the Geman-McClure distance alpha value (weight)


Next: , Previous: set-refinement-geman-mcclure-alpha, Up: More Refinement Functions   [Contents][Index]

13.1.4 get-refinement-geman-mcclure-alpha

function: get-refinement-geman-mcclure-alpha

get the Geman-McClure distance alpha value (weight)


Next: , Previous: get-refinement-geman-mcclure-alpha, Up: More Refinement Functions   [Contents][Index]

13.1.5 set-refinement-lennard-jones-epsilon

function: set-refinement-lennard-jones-epsilon epsilon

Where epsilon is a number

set the Lennard Jones epsilon parameter


Next: , Previous: set-refinement-lennard-jones-epsilon, Up: More Refinement Functions   [Contents][Index]

13.1.6 set-log-cosh-target-distance-scale-factor

function: set-log-cosh-target-distance-scale-factor sf

Where sf is a number

set the log cosh scale factor for target position restraints


Next: , Previous: set-log-cosh-target-distance-scale-factor, Up: More Refinement Functions   [Contents][Index]

13.1.7 crankshaft-peptide-rotation-optimization-scm

function: crankshaft-peptide-rotation-optimization-scm imol residue_spec_smc

Where:

Apply crankshaft peptide rotation optimization to the specified residue.


Previous: crankshaft-peptide-rotation-optimization-scm, Up: More Refinement Functions   [Contents][Index]

13.1.8 crankshaft-peptide-rotation-optimization-py

function: crankshaft-peptide-rotation-optimization-py imol residue_spec_py

Where:

Apply crankshaft peptide rotation optimization to the specified residue.


Next: , Previous: More Refinement Scripting Functions, Up: Top   [Contents][Index]

14 Scheme Scripting Functions


Next: , Up: Scheme Scripting Functions   [Contents][Index]

14.1 shelx

procedure: shelxl-refine
procedure: shelxl-refine-primitive

hkl-file-in can be null ’() or (list astring).

procedure: read-shelx-lst-file

ie. create a interesting-things GUI for split (and other things?) in a shelx .lst file.


Next: , Previous: shelx, Up: Scheme Scripting Functions   [Contents][Index]

14.2 run-mogul

procedure: run-mogul mode imol chain-id res-no ins-code prefix-str use-cache?

prefix-str can be blank

return: a string that is the mogul-out file-name a symbol: something went wrong

procedure: run-mogul-show-results imol code mode chain-id res-no ins-code

return a string that is the mogul results file name that gets parsed to make results (return #f on failure) mode is ’all or ’bonds-and-angles


Next: , Previous: run-mogul, Up: Scheme Scripting Functions   [Contents][Index]

14.3 remote-control

procedure: %coot-listener-socket

a place-holder for the coot listener socket

procedure: open-coot-listener-socket port-number host-name

Open a coot listener socket, return nothing much, but do set! %coot-listener-socket.

Hmmm... why make a side-effect like that? Why not return %coot-listener-socket so that the caller can set it? There may be a reason...

And the reason is that I can then call coot-listener-idle-function-proc without having to use a c++ variable.

procedure: open-coot-listener-socket-with-timeout port-number host-name

yet another go to make a coot port reader work. This time, we use a gtk-timer to read stuff from the socket.

The gtk-timer function must return 1 to be called again. When we want to close the socket reader, simply make the function return 0.

procedure: coot-socket-timeout-func

based on coot-listener-idle-function-proc

procedure: coot-listener-idle-function-proc

Do this thing when idle

currently set to listen to the %coot-listener-socket

procedure: eval-socket-string s

the function to run from the main thread to evaluate a string:


Next: , Previous: remote-control, Up: Scheme Scripting Functions   [Contents][Index]

14.4 tips

procedure: tip-list

a list of tips for Coot

procedure: no-coot-tips

Function to turn off coot tips at start


Next: , Previous: tips, Up: Scheme Scripting Functions   [Contents][Index]

14.5 refmac

procedure: refmac-exe

This is the default refmac version, it is presumed to be in the path. It can be overridden using a re-definition either at the scripting interface or in one’s ~/.coot file. E.g.: (define refmac-exec "/y/programs/xtal/refmac-latest/bin/refmac5-3-dec-2004")

procedure: refmac-extra-params

Set this to a list of parameter strings:

If refmac-extra-params is a list of strings, it is used in preference to the "refmac-extra-params" file (should it exist). e.g. (set! refmac-extra-params (list "WEIGHT 0.2" "NCYC 10" "REFI BREF ISO" "REFI METH CGMAT" "REFI TYPE REST RESO 20 1.64"))

procedure: run-refmac-by-filename pdb-in-filename pdb-out-filename mtz-in-filename mtz-out-filename extra-cif-lib-filename imol-refmac-count swap-map-colours-post-refmac? imol-mtz-molecule show-diff-map-flag phase-combine-flag phib-fom-pair force-n-cycles make-molecules-flag ccp4i-project-dir f-col sig-f-col . r-free-col
procedure: extra-params-include-weight? params-list

Return #t if the list of strings params-list contains a string beginning with "WEIGHT". If not return #f

procedure: get-refmac-extra-params

If refmac-extra-params is defined (as a list of strings), then return that, else read the file "refmac-extra-params".

Return a list a list of strings.

procedure: run-refmac-for-phases

this is not run as a sub-thread, no useful return value.


Next: , Previous: refmac, Up: Scheme Scripting Functions   [Contents][Index]

14.6 refmac-problems

procedure: refmac-problems-gui imol problem-list

The gui for the refmac problems


Next: , Previous: refmac-problems, Up: Scheme Scripting Functions   [Contents][Index]

14.7 redefine-functions

procedure: enhanced-ligand-coot?

scm aliases.

procedure: set-find-hydrogen-torsion

fix typo of set-find-hydrogen-torsions (backward compatibility in case anyone was using that)

procedure: cif-file-for-comp-id

(define residue->sdf-file residue-to-sdf-file)

procedure: toggle-idle-ligand-interactions

I changed the function name - save those (just a few) with scripts that I’ve handed out


Next: , Previous: redefine-functions, Up: Scheme Scripting Functions   [Contents][Index]

14.8 tips-gui

procedure: show-coot-tip-from-list n text

given a number and a gtk text widget text, put tip number n into the widget.

procedure: increment-coot-tip-number

increment the tip number when the user sees a tip

procedure: decrease-coot-tip-number

decrement the tip number when the user sees a tip

procedure: tips-gui

run the tips gui.


Next: , Previous: tips-gui, Up: Scheme Scripting Functions   [Contents][Index]

14.9 raster3d-from-scheme

procedure: render-image

run raster3d

procedure: raytrace

Run either raster3d or povray


Next: , Previous: raster3d-from-scheme, Up: Scheme Scripting Functions   [Contents][Index]

14.10 quat-convert

procedure: matrix->quaternion

convert a view matrix to a view quaternion to set Coot view internals.

procedure: set-view-matrix m00 m10 m20 m01 m11 m21 m02 m12 m22

Set the view matrix


Next: , Previous: quat-convert, Up: Scheme Scripting Functions   [Contents][Index]

14.11 gui-prosmart

procedure: run-prosmart imol-target imol-ref include-side-chains?

target is my molecule, ref is the homologous (high-res) model


Next: , Previous: gui-prosmart, Up: Scheme Scripting Functions   [Contents][Index]

14.12 mutate-from-scheme

procedure: povray-version

this should negate the need for Bill’s patch here.

procedure: povray-args

args not including the output filename

procedure: povray-image

Run provray using current displayed image and write .pov file to default filename


Next: , Previous: mutate-from-scheme, Up: Scheme Scripting Functions   [Contents][Index]

14.13 parse-pisa-xml

procedure: *pisa-command*

(define *pisa-command* "/home/paule/ccp4/ccp4-6.1.2/bin/pisa")

procedure: pisa-assemblies-xml imol file-name

it calls parse-pisa-assemblies which does the work

procedure: pisa-handle-sxml-molecule imol molecule pisa-results-type

a interface-molecule record contains information about pvalue and residues.

procedure: parse-pisa-assemblies

—————————————————- pisa assemblies: —————————————————-

pisa_results name status total_asm asm_set ser_no assembly id size mmsize diss_energy asa bas entropy diss_area int_energy n_uc n_diss symNumber molecule chain_id rxx rxy rxz tx ryx ryy ryz ty rzx rzy rzz tz rxx-f rxy-f rxz-f tx-f ryx-f ryy-f ryz-f ty-f rzx-f rzy-f rzz-f tz-f

procedure: prep-for-pisa mode imol

20100213 prep-for-pisa needs to make directory, config file, write the pdb file and thre return value should be #f if there was a problem or some value where we can check that pisa -analyse ran (probably a directory). It is not clear right now where the output is going. config files has PISA_WORK_ROOT coot-pisa but things seems to be written to DATA_ROOT /home/emsley/ccp4/ccp4-6.1.3/share/pisa which seems like a bug (or something like it) in pisa. Needs rechecking.

procedure: cached-pisa-analysis dir

needs fleshing out (see notes for prep-for-pisa).

procedure: parse-pisa-interfaces imol sxml-entity

pdb_entry pdb_code status n_interfaces interface id type n_occ int_area int_solv_en pvalue stab_en css overlap x-rel fixed h-bonds n_bonds bond chain-1 res-1 seqnum-1 inscode-1 atname-1 chain-2 res-2 seqnum-2 inscode-2 atname-2 dist salt-bridges n-bonds bond chain-1 res-1 seqnum-1 inscode-1 atname-1 chain-2 res-2 seqnum-2 inscode-2 atname-2 dist ss-bonds n-bonds bond chain-1 res-1 seqnum-1 inscode-1 atname-1 chain-2 res-2 seqnum-2 inscode-2 atname-2 dist cov-bonds n-bonds bond chain-1 res-1 seqnum-1 inscode-1 atname-1 chain-2 res-2 seqnum-2 inscode-2 atname-2 dist molecule id chain_id class symop symop_no cell_i cell_j cell_k rxx rxy rxz tx ryx ryy ryz ty rzx rzy rzz tz int_natoms int_nres int_area int_solv_en pvalue residues residue ser_no name seq_num ins_code bonds asa bsa solv_en


Next: , Previous: parse-pisa-xml, Up: Scheme Scripting Functions   [Contents][Index]

14.14 add-linked-cho

procedure: new-molecule-from-this-glyco-tree

return the new molecule number

procedure: complex-mammal-tree

complex mammal bianntennary mammal

procedure: complex-plant-tree

complex plant plant bianntennary

procedure: *add-linked-residue-tree-correlation-cut-off*

now users can set this


Next: , Previous: add-linked-cho, Up: Scheme Scripting Functions   [Contents][Index]

14.15 ncs

procedure: skip-to-next-ncs-chain direction

Skip the residue in the next chain (typically of a molecule with NCS) with the same residue number. If on the last chain, then wrap to beginning. If it can’t find anything then don’t move (and put a message in the status bar)

procedure: single-manual-ncs-ghost imol resno-start resno-end ref-chain peer-chain

We can only see one peer at a time with this (each time we do a clear-ncs-ghost-matrices).

procedure: manual-ncs-ghosts imol resno-start resno-end chain-id-list

chain-id-list is (list "A" "B" "C" "D")), i.e. the reference/target/master chain-id first and then the peers. This allows us to add many peers at the same time (unlike above function).

procedure: update-ncs-ghosts-by-local-sphere

Update NCS ghosts based on local environment (residues within 6A of (and including) the active residue).

Typically one would bind this function to a key.

procedure: ncs-master-chain-id imol

Return the first master chain id (usually there is only one of course) or #f.

procedure: ncs-ligand imol-protein ncs-master-chain-id imol-ligand chain-id-ligand resno-ligand-start resno-ligand-stop

This was designed to create an NCS copy of a ligand (or range of residues) in the active site of one chain to the as yet unoccupied active site of another, i.e. it makes a NCS ligand "D"1 that is a NCS copy of ligand "C"1 using an NCS operator that maps protein chain "A" onto chain "B".


Next: , Previous: ncs, Up: Scheme Scripting Functions   [Contents][Index]

14.16 acedrg-link

procedure: hack-link fn

return the new file name


Next: , Previous: acedrg-link, Up: Scheme Scripting Functions   [Contents][Index]

14.17 ligand-check

procedure: get-metrics-for-ligand imol chain-id res-no ins-code refmac-input-mtz-file-name fobs-col sig-fobs-col rfree-col refmac-dir

test: (using-active-atom (get-metrics-for-ligand aa-imol aa-chain-id aa-res-no aa-ins-code "rnasa-1.8-all_refmac1.mtz" "FGMP18" "SIGFGMP18" "FreeR_flag" "coot-refmac"))

refmac-dir: the dir where input/output refmac files should be written.

return (list correlation mogul bumps difference-map-stats b-factor-info) where: mogul is an improper pair (mogul-z-worst . mogul-out-file-name) or an error status difference-map-stats: the output of map-to-model-correlation-stats-scm (list correlation var_x var_y n sum_x sum_y D D2 (based on mean/sd of the map at the ligand) map_mean map_mean_at_ligand map_sd map_sd_at_ligand SCM_UNDEFINED) and b-factor-info list of (median-ratio median-ligand median-env ks-test-result)

procedure: *ligand-check-resolution-limit*

only look at ligands in maps with resolution worse than this: (to look at everything, set it to 0.1)

procedure: filter-out-waters imol env-residues

remove residues that are waters from env-residues


Next: , Previous: ligand-check, Up: Scheme Scripting Functions   [Contents][Index]

14.18 what-check

procedure: strip-leading-spaces str

" 53" -> "53", " " -> ""

procedure: go-to-residue-by-spec imol spec

consider for coot-utils

procedure: residue-spec->string spec

consider for coot-utils

procedure: get-flip-residue line

make this internal

where line is something like " 53 HIS ( 53 ) A12" ignore xxxxI Cyy xxxx is 4char resno, I insertion code, C chain id, yy is model number

return a residue spec, or #f

procedure: problem-residues->dialog imol problemed-res-list-list

A problemed-res-list is improper pair where the car is a pair of string, one describing the problem, and the other being the "fix it" button label. The cdr is a list of residue specs.

A problemed-flip-list-list is a list of those things.

procedure: parse-check-db imol file-name action

action is either ’gui (then we get a gui) or ’apply-actions, then the model modifications are automatically applied.


Next: , Previous: what-check, Up: Scheme Scripting Functions   [Contents][Index]

14.19 user-define-restraints

procedure: add-base-restraint imol spec-1 spec-2 atom-name-1 atom-name-2 dist

spec-1 and spec-2 are 7-element atom-specs

procedure: write-refmac-parallel-plane-restraint file-name res-spec-0 res-spec-1 atom-list-0 atom-list-1

Example of a stack restraint: "exte stac plan 1 firs resi 99 chai A atoms substitute-open-brace CB CG CD1 CD2 CE1 CE2 CZ OH substitute-close-brace plan 2 firs resi 61 chai B atoms substitute-open-brace CB CG CD1 CD2 CE1 CE2 CZ substitute-close-brace dist 3.4 sddi 0.2 sdan 6.0 type 1"


Next: , Previous: user-define-restraints, Up: Scheme Scripting Functions   [Contents][Index]

14.20 jligand-gui

procedure: launch-jligand-function

This happens when user clicks on the "Launch JLigand" button. It starts a jligand and puts it in the background.

procedure: click-select-residues-for-jligand

This happens when user clicks on the "Select Residues for JLigand" (or some such) button. It expects the user to click on atoms of the two residues involved in the link.


Next: , Previous: jligand-gui, Up: Scheme Scripting Functions   [Contents][Index]

14.21 gui-ligand-sliders

procedure: mtz-file-name->refinement-column-labels file-name

return 3 values


Next: , Previous: gui-ligand-sliders, Up: Scheme Scripting Functions   [Contents][Index]

14.22 snarf-coot-docs

procedure: directory-as-file-name dir

remove any trailing /s

procedure: file-name-file file-name

return the file component of file-name "x/y" -> "y" "x" -> "x"

procedure: useful-glob dir pat

prepend the files with the directory dir

(note that the args are reversed to "natural" order (which is the reverse of glob args)

procedure: glob pat dir

return a list of file names that match pattern pat in directory dir.

procedure: strip-extension s

"a.b.res" -> "a.b" file-name-sans-extension

procedure: command-in-path? cmd

Return #t or #f:

procedure: goosh-command cmd args data-list log-file-name screen-output-also?

Where cmd is e.g. "refmac" args is (list "HKLIN" "thing.mtz") log-file-name is "refmac.log" data-list is (list "HEAD" "END")

Return the exist status e.g. 0 or 1.

procedure: run-command/strings cmd args data-list

Return the strings screen output of cmd or #f if command was not found

procedure: string->list-of-strings str

Return a list if str is a string, else return ’()

procedure: directory-files dir

The following functions from PLEAC (guile version thereof of course).

or define a utility function for this

procedure: add-to-list-section-texis
procedure: delete-section-texi-files

Next: , Previous: snarf-coot-docs, Up: Scheme Scripting Functions   [Contents][Index]

14.23 mutate-in-scheme

procedure: mutate-chain imol chain-id sequence

Mutate chain-id of molecule number imol given sequence. This presumes a protein sequence.

The number of residues in chain-id must match the length of sequence.

procedure: multi-mutate

An internal function of mutate. This presumes a protein sequence.

procedure: mutate-residue-range imol chain-id start-res-no stop-res-no sequence

The stop-res-no is inclusive, so usage e.g. (mutate-residue-range 0 "A" 1 2 "AC")

This presumes a protein sequence (not nucleic acid).

procedure: mutate-and-autofit-residue-range imol chain-id start-res-no stop-res-no sequence

mutate and auto fit a residue range.

This presumes a protein sequence (not nucleic acid).

The sequence is a string of one letter codes

procedure: mutate-and-auto-fit residue-number chain-id mol mol-for-map residue-type

mutate and autofit whole chain

This presumes a protein sequence (not nucleic acid).

procedure: maf

a short-hand for mutate-and-auto-fit

procedure: 3-letter-code->single-letter residue-type

return a char, return #\A for unknown residue-type

procedure: mutate-residue-redundant

a wrapper for mutate-single-residue-by-seqno (which uses slightly inconvenient single letter code)

Here residue-type is the 3-letter code

procedure: delete-sidechain-range

Delete (back to the CB stub) the side change in the range resno-start to resno-end


Next: , Previous: mutate-in-scheme, Up: Scheme Scripting Functions   [Contents][Index]

14.24 entry+do-button

procedure: teb

test that function:

procedure: teb2

test that function:


Next: , Previous: entry+do-button, Up: Scheme Scripting Functions   [Contents][Index]

14.25 dictionary-generators

procedure: generate-molecule-from-mmcif-by-dict-gen comp-id mmcif-file-name

return a molecule number. Return -1 on fail.


Next: , Previous: dictionary-generators, Up: Scheme Scripting Functions   [Contents][Index]

14.26 extra-top-level

procedure: my-button-callback

This is what to do when the button is pressed. It can be any guile or coot function.

procedure: my-top-level

define a simple window and put a button in it


Next: , Previous: extra-top-level, Up: Scheme Scripting Functions   [Contents][Index]

14.27 coot-lsq

procedure: lsq-match-type-symbol->number match-type-in

Internal type conversion for LSQ fitting. Return a number according to the symbol match-type-in

procedure: set-match-element

Create matchers, 7 elements: (list ref-start-resno ref-end-resno ref-chain-id imol-ref mov-start-resno mov-end-resno mov-chain-id imol-mov match-type)

procedure: lsq-match imol-ref imol-moving match-list

The scripting interface to LSQ matching. Pass molecule numbers for the reference (imol-ref) and moving (imol-moving) molecules and a match list. The match list format is described in the manual.

procedure: simple-lsq-match ref-start-resno ref-end-resno ref-chain-id imol-ref mov-start-resno mov-end-resno mov-chain-id imol-mov match-type

Simple interface to LSQ fitting. More often than not this is what you will want, I imagine, e.g. (simple-lsq-match 940 950 "A" 0 940 950 "A" 1 ’main)


Next: , Previous: coot-lsq, Up: Scheme Scripting Functions   [Contents][Index]

14.28 get-ebi

procedure: net-get-url my-url file-name

return 0 on success

procedure: check-dir-and-get-url

check the directory and get url url-string.

procedure: get-url-str

get url-string for data type ’pdb or ’sfs

procedure: get-ebi-pdb id

Return a molecule number on success or not a number (#f) or -1 on error.

procedure: get-eds-pdb-and-mtz id

Return a list of molecules (i.e. the model molecule and the 2 maps).

or, if it didn’t work then return #f


Next: , Previous: get-ebi, Up: Scheme Scripting Functions   [Contents][Index]

14.29 coot-gui

procedure: run-gtk-pending-events
procedure: coot-gui

Fire up the coot scripting gui. This function is called from the main C++ code of coot. Not much use if you don’t have a gui to type functions in to start with.

procedure: handle-smiles-go tlc-entry smiles-entry

The callback from pressing the Go button in the smiles widget, an interface to run libcheck.

procedure: smiles-gui

smiles GUI

procedure: generic-single-entry function-label entry-1-default-text go-button-label handle-go-function

Generic single entry widget

Pass the hint labels of the entries and a function that gets called when user hits "Go". The handle-go-function accepts one argument that is the entry text when the go button is pressed.

procedure: generic-double-entry label-1 label-2 entry-1-default-text entry-2-default-text check-button-label handle-check-button-function go-button-label handle-go-function

handle-go-function takes 3 arguments, the third of which is the state of the check button.

if check-button-label not a string, then we don’t display (or create, even) the check-button. If it *is* a string, create a check button and add the callback handle-check-button-function which takes as an argument the active-state of the the checkbutton.

procedure: generic-multiple-entries-with-check-button entry-info-list check-button-info go-button-label handle-go-function

generic double entry widget, now with a check button

OLD:

pass a the hint labels of the entries and a function (handle-go-function) that gets called when user hits "Go" (which takes two string aguments and the active-state of the check button (either #t of #f).

if check-button-label not a string, then we don’t display (or create, even) the check-button. If it *is* a string, create a check button and add the callback handle-check-button-function which takes as an argument the active-state of the the checkbutton.

procedure: molecule-centres-gui

A demo gui to move about to molecules.

procedure: old-coot?

old coot test

procedure: interesting-things-gui title baddie-list

We can either go to a place (in which case the element is a list of button label (string) and 3 numbers that represent the x y z coordinates) or an atom (in which case the element is a list of a button label (string) followed by the molecule-number chain-id residue-number ins-code atom-name altconf)

e.g. (interesting-things-gui "Bad things by Analysis X" (list (list "Bad Chiral" 0 "A" 23 "" "CA" "A") (list "Bad Density Fit" 0 "B" 65 "" "CA" "") (list "Interesting blob" 45.6 46.7 87.5)))

procedure: interesting-things-with-fix-maybe title baddie-list

In this case, each baddie can have a function at the end which is called when the fix button is clicked.

procedure: fill-option-menu-with-mol-options menu filter-function

Fill an option menu with the "right type" of molecules. If filter-function returns #t then add it. Typical value of filter-function is valid-model-molecule?

procedure: fill-option-menu-with-coordinates-mol-options menu

Helper function for molecule chooser. Not really for users.

Return a list of models, corresponding to the menu items of the option menu.

The returned list will not contain references to map or closed molecules.

procedure: fill-option-menu-with-number-options menu number-list default-option-value
procedure: get-option-menu-active-molecule option-menu model-mol-list

Helper function for molecule chooser. Not really for users.

return the molecule number of the active item in the option menu, or return #f if there was a problem (e.g. closed molecule)

procedure: get-option-menu-active-item option-menu item-list

Here we return the active item in an option menu of generic items

procedure: molecule-chooser-gui-generic chooser-label callback-function option-menu-fill-function

Typically option-menu-fill-function is fill-option-menu-with-coordinates-mol-options

procedure: molecule-chooser-gui

Fire up a coordinates/model molecule chooser dialog, with a given label and on OK we call the call-back-fuction with an argument of the chosen molecule number.

chooser-label is a directive to the user such as "Choose a Molecule"

callback-function is a function that takes a molecule number as an argument.

procedure: map-molecule-chooser-gui

Fire up a map molecule chooser dialog, with a given label and on OK we call the call-back-fuction with an argument of the chosen molecule number.

chooser-label is a directive to the user such as "Choose a Molecule"

callback-function is a function that takes a molecule number as an argument.

procedure: generic-chooser-and-entry chooser-label entry-hint-text defaut-entry-text callback-function . always-dismiss-on-ok-clicked?

if always-dismiss-on-ok-clicked? is false then the dialog is not dismissed if callback-function returns #f.

procedure: generic-chooser-and-entry-and-checkbutton chooser-label entry-hint-text defaut-entry-text check-button-label callback-function . always-dismiss-on-ok-clicked?

as above, plus we also have a check-button and an additional argument in the callback If check-button-label is false, then don’t create a check-button.

procedure: generic-chooser-and-file-selector chooser-label chooser-filter file-selector-hint default-file-name callback-function

Create a window.

Return a pair of widgets, a molecule chooser and an entry. callback-function is a function that takes a molecule number and a file-name

chooser-filter is typically valid-map-molecule? or valid-model-molecule?

procedure: coot-menubar-menu menu-label

If a menu with label menu-label is not found in the coot main menubar, then create it and return it. If it does exist, simply return it.

procedure: add-simple-coot-menu-menuitem menu menu-item-label activate-function

Given that we have a menu (e.g. one called "Extensions") provide a cleaner interface to adding something to it:

activate-function is a thunk.

procedure: missing-atoms-gui imol

Make an interesting things GUI for residues with missing atoms

procedure: generic-buttons-dialog dialog-name button-list

button-list is a list of pairs (improper list) the first item of which is the button label text the second item is a lambda function, what to do when the button is pressed.

procedure: generic-interesting-things imol gui-title-string residue-test-func

Generic interesting things gui: user passes a function that takes 4 args: the chain-id, resno, inscode and residue-serial-number (should it be needed) and returns either #f or something interesting (e.g. a label/value). It is the residue-test-func of the residue-matching-criteria function.

procedure: generic-number-chooser number-list default-option-value hint-text go-button-label go-function

A gui that makes a generic number chooser the go function is a lambda function that takes the value of the active menu item - as a number.

procedure: generic-molecule-chooser hbox hint-text

pack a hint text and a molecule chooser option menu into the given vbox.

return the option-menu and model molecule list:

procedure: file-selector-entry hbox hint-text

Return an entry, the widget is inserted into the hbox passed to this function.

procedure: cootaneer-gui imol

Cootaneer gui

procedure: view-saver-gui

The gui for saving views

procedure: add-view-to-views-panel view-name view-number
procedure: dialog-box-of-buttons-with-check-button window-name geometry buttons close-button-label check-button-label check-button-func check-button-is-initially-on-flag

If check-button-label is #f, don’t make one, otherwise create with with the given label and "on" state.

procedure: dialog-box-of-pairs-of-buttons imol window-name geometry buttons close-button-label

geometry is an improper list of ints buttons is a list of: (list (list button-1-label button-1-action button-2-label button-2-action)) The button-1-action function takes as an argument the imol The button-2-action function takes as an argument the imol

procedure: views-panel-gui

A gui showing views:

procedure: nudge-screen-centre-gui

nudge screen centre box. Useful when Ctrl left-mouse has been taken over by another function.

procedure: make-difference-map-gui

A gui to make a difference map (from arbitrarily gridded maps (that’s it’s advantage))

procedure: cis-peptides-gui imol

A GUI to display all the CIS peptides and navigate to them.

procedure: associate-pir-with-molecule-gui do-alignment?

Associate the contents of a PIR file with a molecule. Select file from a GUI.

procedure: alignment-mismatches-gui imol

Make a box-of-buttons GUI for the various modifications that need to be made to match the model sequence to the assigned sequence(s).

Call this when the associated sequence(s) have been read in already.

procedure: wrapper-alignment-mismatches-gui imol

Wrapper in that we test if there have been sequence(s) assigned to imol before we look for the sequence mismatches

procedure: run-clustalw-alignment imol chain-id target-sequence-pir-file

Use clustalw to do the alignment. Then mutate using that alignement.

procedure: residue-range-gui

(Notice that we are not dealing with insertion codes).

procedure: user-mods-gui imol pdb-file-name

USER MODS gui

procedure: rename-residue-gui

simple rename residue GUI

procedure: water-coordination-gui

close-button

procedure: pepflips-by-difference-map-gui

interface to the difference-map based pepflip finder

procedure: min-max-residues-from-atom-specs specs

return a list, or #f (e.g. if not in same chain and molecule)

procedure: *db-loop-preserve-residue-names*

by default, rename loop residues to UNK. If scheme true, then leave them as the residue names found in the database.


Next: , Previous: coot-gui, Up: Scheme Scripting Functions   [Contents][Index]

14.30 hello

procedure: first-non-trivial-name

Primarily for Indian Names.

Say we are given str: (list "M." "D." "Albert" "Dorkins"). We want to return ""Albert" not "M.") We reject names that are one character long and names that are 2 characters long that end in ".". So, "M." is rejected, but "Ma" is not.

An excercise for the committed is to also reject run-together dotted initials such as "D.K.". I was sufficiently committed.


Next: , Previous: hello, Up: Scheme Scripting Functions   [Contents][Index]

14.31 coot-crash-catcher

procedure: filter fn ls

Basic scheme function, filter the objects in list ls by function fn. e.g. (filter even? (list 0 1 2 3) -> ’(0 2)

procedure: string-concatenate ls

simple scheme functions to concat the strings in ls (ls must contain only strings)

procedure: directory-files dir

The following functions from PLEAC (guile version thereof of course).

or define a utility function for this

procedure: glob pat dir

return a list of file names that match pattern pat in directory dir.

procedure: run-command/strings cmd args data-list

Return the strings screen output of cmd (reversed) or #f if command was not found

procedure: command-in-path? cmd

Return #t or #f:

procedure: string->list-of-strings str

Return a list if str is a string, else return ’()

procedure: shell-command-to-string cmd

code from thi <ttn at mingle.glug.org>

run command and put the output into a string and return it. (c.f. run-command/strings)

procedure: make-gdb-script
procedure: get-gdb-strings

return #f or list of strings

procedure: make-gui

gui


Next: , Previous: coot-crash-catcher, Up: Scheme Scripting Functions   [Contents][Index]

14.32 coot-utils

procedure: *annotations*

3D annotations - a bit of a hack currently

procedure: *default-ball-and-stick-selection*

used in Extensions -> Representation -> Ball & Stick

procedure: rigid-body-refine-by-residue-ranges

rigid body refine using residue ranges. Takes 2 arguments, the first is the molecule number, the second is a list of residue-ranges. A residue range is (list chain-id resno-start resno-end).

procedure: find-aligned-residue-type

add terminal residue is the normal thing we do with an aligned sequence, but also we can try ton find the residue type of a residue in the middle of the chain that is modelled as an ALA, say.

procedure: all-true? ls

not tail-recursive

procedure: get-directory dir-name

make the directory and return the directory name. If you cant make it directly in this directory try to make it in $HOME. Return #f if complete failure. e.g. coot-ccp4 or coot-backup

procedure: molecule-has-hydrogens? imol

schemify function

procedure: add-hydrogens-using-refmac-inner imol in-file-name out-file-name

out-file-name has been written, in-file-name needs to be read.

procedure: post-manipulation-hook
procedure: post-set-rotation-centre-hook

do something based on the active residue (presumably)

procedure: pre-release?

Return a boolean

procedure: molecule-number-list

Return a list of molecule numbers (closed and open) The elements of the returned list need to be tested against is-valid-model-molecule?

procedure: undisplay-all-maps-except imol-map

c.f. graphics_info_t::undisplay_all_model_molecules_except(int imol)

procedure: just-one-or-next-map

is isn’t quite because one of the options is "all"

procedure: first-n n ls

first n fields of ls. if length ls is less than n, return ls. if ls is not a list, return ls. If n is negative, return ls.

procedure: directory-is-modifiable? prefix-dir

Test for prefix-dir (1) being a string (2) existing (3) being a directory (4) modifiable by user (ie. u+rwx). prefix-dir must be a string.

Return #t or #f.

procedure: absolutify file-name

return an absolute file-name for file-name or #f

procedure: file-name-directory file-name

return the directory component of file-name, leave "/" on, if it’s there. Note "x", "", "/" -> ""

procedure: file-name-file file-name

return the file component of file-name "x/y" -> "y" "x" -> "x"

procedure: most-recently-created-file

return #f on no-such-file

procedure: residue-spec->atom-selection-string centre-residue-spec

Convert a residue-spec to an mmdb atom selection string.

procedure: residue-atom->atom-name ra

residue-info atom

procedure: residue-atom->alt-conf ra

residue-info atom

procedure: residue-atom->occupancy ra

residue-info atom

procedure: residue-atom->position ra

residue-info atom

procedure: residue-atom->atom-spec ra chain-id res-no ins-code

residue-info atom needs other parameters to make a spec for an atom

procedure: residue-spec->chain-id rs

residue spec (e.g. from residue-near-residue)

procedure: residue-spec-less-than spec-1 spec-2

for sorting residue specs

procedure: map-molecule-list

Return a list of molecules that are maps

procedure: model-molecule-list

Return a list of molecules that are maps

procedure: shelx-molecule? imol

Return #t (#f) if imol is (isn’t) a shelx molecule.

procedure: set-virtual-trackball-type type

Set the virtual trackball behaviour.

trackball type is a symbol: either ’flat or ’spherical-surface.

procedure: list-of-strings? ls

Is ls a list of strings? Return #t or #f

procedure: coot-replace-string string-in target replacing-str

(coot-replace-string "one two three" " " "_") -> "one_two_three"

procedure: string-append-with-spaces ls

string concat with spaces, ls must be a list of strings.

procedure: rotation-centre

The screen centre.

return the rotation centre as a 3 membered list of numbers

procedure: number-list a b

Make list of integers, a to b: eg (number-list 2 5) -> (2 3 4 5)

procedure: string-member? atom ls

ls must be a list of strings, atom must be a string.

return either #t or #f.

procedure: member? atom ls
procedure: range first . second

range: works like the eponymous python function e.g. (range 3) -> ’(0, 1, 2) e.g. (range 1 3) -> ’(1, 2)

procedure: shell-command-to-string cmd

code from thi <ttn at mingle.glug.org>

run command and put the output into a string and return it. (c.f. run-command/strings)

procedure: shell-command-to-file-with-data cmd file-name data-list

run cmd putting output to file-name and reading commands data from the list of strings data-list.

procedure: command-in-path? f

Is the command f in the path? return #t or #f.

Thank you for this, rixed at happyleptic.org

procedure: command-in-path-or-absolute? cmd

Return #t or #f

procedure: goosh-command cmd args data-list log-file-name screen-output-also?

Where cmd is e.g. "refmac" args is (list "HKLIN" "thing.mtz") log-file-name is "refmac.log" data-list is (list "HEAD" "END")

Return the exist status e.g. 0 or 1.

procedure: goosh-command-with-file-input cmd args input-file log-file-name

run commands from an input file.

procedure: run-command/strings cmd args data-list

Return the strings screen output of cmd or #f if command was not found

procedure: close-float? x1 x2

Crude test to see of 2 floats are the same (more or less). Used in a greg test after setting the atom position.

procedure: strip-spaces str

if passed a string, return a string with no spaces, else return #f.

procedure: strip-leading-spaces str

" 53" -> "53", " " -> ""

procedure: string-append-with-string str-ls tag-str

Append strings with tag-str between them

procedure: strip-extension s

"a.b.res" -> "a.b" file-name-sans-extension

procedure: file-name-extension

What is the extension of file-name?

"a.pdb" -> "pdb" "" -> ""

procedure: add-tmp-extension-to

e.g. "a.pdb" -> "a-tmp.pdb"

procedure: file-name-sans-extension

Same function as strip-extension, different name, as per scsh, in fact.

procedure: strip-path s

/a/b.t -> b.t d/e.ext -> e.ext file-name-sans-path

procedure: slash-start? s

does s start with a "/" ? return #t or #f

procedure: string-concatenate ls

simple scheme functions to concat the strings in ls (ls must contain only strings)

procedure: unique-date/time-str

return a string that contains the date/time e.g. "2006-01-02_2216.03"

procedure: every-nth ls n

return a list that has only every-nth members; e.g. (every-nth '(0 1 2 3 4 5 6 7 8) 2) -> ’(0 2 3 6 8) (every-nth '(0 1 2 3 4 5 6 7 8) 3) -> ’(0 3 6)

n must be positive

procedure: get-atom-from-residue atom-name residue-atoms alt-conf

now useful in testing

residue-atoms must be a list

procedure: get-atom imol chain-id resno ins-code atom-name . alt-conf

Return an atom info or #f (if atom not found).

procedure: multi-read-pdb glob-pattern dir

multi-read-pdb reads all the files matching glob-pattern in directory dir. Typical usage of this might be: (multi-read-pdb "a*.pdb" ".")

procedure: read-pdb-all

read-pdb-all reads all the "*.pdb" files in the current directory.

procedure: string->list-of-strings str

Return a list if str is a string, else return ’()

procedure: append-dir-file dir-name file-name

In a laughable attempt to minimise system dependence.

procedure: append-dir-dir dir-name sub-dir-name

Similarly attempting to minimise system dependence.

procedure: join-dir-file path-elements

the first elements are directories, the last is the file name c.f. os.path.join

procedure: directory-as-file-name dir

remove any trailing /s

procedure: is-directory? file-name

return #t or #f depending on if file-name (which must be a string) is a directory.

procedure: coot-mkdir dir-name

return the dir-name on success.

return #f if dir-name is a file or we can’t do the mkdir.

procedure: directory-files dir

The following functions from PLEAC (guile version thereof of course).

Return: a list of files in the given directory

procedure: glob pat dir

return a list of file names that match pattern pat in directory dir.

procedure: useful-glob dir pat

prepend the files with the directory dir

(note that the args are reversed to "natural" order (which is the reverse of glob args)

procedure: view-matrix

return the view matrix (useful for molscript, perhaps).

procedure: view-quaternion

return the view quaternion

procedure: add-view position quaternion zoom view-name

Return the view number

procedure: matrix->quaternion

Convert a view matrix to a view quaternion to set Coot view internals.

procedure: set-view-matrix m00 m10 m20 m01 m11 m21 m02 m12 m22

Set the view matrix using matrix->quaternion.

Useful for using a view matrix from another program, perhaps.

procedure: molecule-centre imol

Return the molecule centre as a list of 3 numbers.

Note: mol-cen could contain values less than -9999.

procedure: move-molecule-to-screen-centre imol

Move the centre of molecule number imol to the current screen centre

procedure: move-molecule-here

This is a short name for the above.

procedure: move-molecule-to-screen-center

this is an americanism

procedure: identity-matrix

Return a nine-membered list of numbers.

procedure: translation axis length

e.g. (translation ’x 2) -> ’(2 0 0) Return: "scheme false" on error

procedure: rotate-about-screen-axis axis degrees

Rotate degrees about screen axis, where axis is either ’x, ’y or ’z.

procedure: toggle-display-map imol idummy

Support for old toggle functions. (consider instead the raw functions use the direct set_displayed functions).

procedure: toggle-display-mol imol

toggle the display of imol

procedure: toggle-active-mol imol

toggle the active state (clickability) of imol

procedure: scheme-representation imol

return a scheme representation of molecule imol, or #f if we can’t do it (imol is a map, say).

procedure: reorder-chains imol

reorder chains

procedure: transform-coords-molecule imol rtop

transform a coordinates molecule by a coot-rtop (which is a SCM expression of a clipper::RTop), i.e. a list of a 9-element list and a 3 element list. e.g. (list (list 1 0 0 0 1 0 0 0 1) (list 4.5 0.4 1.2)).

procedure: transform-map

(transform-map imol mat trans about-pt radius space-group cell)

where space-group is a HM-symbol and cell is a list of 6 parameters, where the cell angles are in degrees.

or (transform-map imol trans about-pt radius) for a simple translation

or (transform-map imol trans radius) when using the default rotation-centre as the about-pt

procedure: get-first-ncs-master-chain

return the NCS master of the first molecule that has NCS.

return "" on fail to find an ncs chain

procedure: transform-map-using-lsq-matrix imol-ref ref-chain ref-resno-start ref-resno-end imol-mov mov-chain mov-resno-start mov-resno-end imol-map about-pt radius

Remember, that now the about-pt is the "to" point, i.e. the maps are brought from somewhere else and generated about the about-pt.

procedure: brighten-map imol scale-factor

Make the imol-th map brighter.

procedure: brighten-maps

Make all maps brighter

procedure: darken-maps

Make all maps darker.

procedure: chain-ids imol

Return a list of chain ids for given molecule number imol. return empty list on error

procedure: is-solvent-chain? imol chain-id

convert from interface name to schemish name

Return #t or #f.

procedure: valid-model-molecule? imol

schemey interface to eponymous scripting interface function. Return scheme true or false

procedure: valid-map-molecule? imol

schemey interface to eponymous scripting interface function. Return scheme true or false.

procedure: valid-refinement-map?

Return #t or #f

procedure: shelx-molecule? imol

schemey interface to shelx molecule test

Return #t or #f.

procedure: is-difference-map? imol-map

Return #t or #f.

procedure: residue-exists? imol chain-id resno ins-code

Does residue resno with insertion code ins-code of chain chain-id and in molecule number imol exist?

Return #t or #f.

procedure: residue-has-hetatms? imol chain-id res-no ins-code

Does the residue contain hetatoms? Return #t or #f.

procedure: atom-specs imol chain-id resno ins-code atom-name alt-conf

Return as a list the occupancy temperature-factor element x y z coordinates of the given atom. (the x,y,z are in Cartesian Angstroms).

on error (e.g. atom not found) return #f

procedure: guess-refinement-map

return a guess at the map to be refined (usually called after imol-refinement-map returns -1)

procedure: target-auto-weighting-value

Ian Tickle says (as far as I can understand) that the target rmsd should be 0.25 or thereabouts. You can over-ride it now.

procedure: auto-weight-for-refinement

Set the refinement weight (matrix) by iterating the refinement and varying the weight until the chi squares (not including the non-bonded terms) reach 1.0 =/- 10%. It uses sphere refinement. The refinement map must be set. At the end show the new weight in the status bar. Seems to take about 5 rounds.

procedure: print-sequence imol

Print the sequence of molecule number imol

This is not really a util, perhaps it should be somewhere else?

procedure: pir-file-name->pir-sequence pir-file-name

simple utility function to return the contents of a file as a string.

procedure: associate-pir-file imol chain-id pir-file-name

Associate the contents of a PIR file with a molecule.

procedure: graphics-comma-key-pressed-hook

comma key hook

procedure: graphics-dot-key-pressed-hook

dot key hook

procedure: *key-bindings*

a list of (code key name thunk) e.g. ’(103 "g" "Goto Blob" (blob-under-pointer-to-screen-centre))

procedure: add-key-binding name key thunk

Add a key binding

with a given name, key (e.g. "x" or "S") and the function to run (a thunk) when that key is pressed.

procedure: graphics-general-key-press-hook key

general key press hook, not for public use.

procedure: read-vu-file

Function requested by Mark White.

read XtalView (and maybe other) .vu files and convert them into generic objects.

Pass the filename and an object name e.g. (read-vu-file "axes.vu" "axes")

Returns: nothing interesting.

procedure: residues-matching-criteria imol residue-test-func

Return a list of residues, each of which has a return value at the start, ie. (list return-value chain-id res-no ins-code)

procedure: residues-in-chain imol chain-id-in

Return a list of all the residues in the chain

procedure: residues-with-alt-confs imol

Return a list of all residues that have alt confs: where a residue is specified thusly: (list chain-id resno ins-code)

procedure: residue-alt-confs imol chain-id res-no ins-code

Return a list of all the altconfs in the residue. Typically this will return (list "") or (list "A" "B")

procedure: atom-spec->chain-id atom-spec

extraction function

procedure: atom-spec->res-no atom-spec

extraction function

procedure: atom-spec->ins-code atom-spec

extraction function

procedure: atom-spec->atom-name atom-spec

extraction function

procedure: atom-spec->alt-loc atom-spec

extraction function

procedure: res-spec->chain-id res-spec

simple extraction function

procedure: res-spec->res-no res-spec

simple extraction function

procedure: res-spec->ins-code res-spec

simple extraction function

procedure: residue-spec->atom-for-centre imol chain-id res-no ins-code

Return #f if no atom can be found given the spec else return a list consisting of the atom name and alt-conf specifier.

Choose an atom that is called " CA ". Failing that choose the first atom.

procedure: update-go-to-atom-from-current-atom
procedure: flip-active-ligand
procedure: delete-atom-by-active-residue

Typically one might want to use this on a water, but it deletes the nearest CA currently... Needs a re-think. Should active-atom just return the nearest atom and not be clever about returning a CA.

procedure: merge-solvent-chains imol
procedure: mutate-by-overlap imol chain-id-in resno tlc

change chain ids with residue range for the PTY

procedure: phosphorylate-active-residue

A bit of fun

procedure: overlay-my-ligands imol-mov chain-id-mov resno-mov imol-ref chain-id-ref resno-ref

A function for Overlaying ligands. The transformation is applied to all the atoms of the molecule that contains the moving ligand.

procedure: label-all-CAs imol
procedure: label-all-atoms-in-residue imol chain-id resno inscode
procedure: label-all-active-residue-atoms
procedure: sanitise-alt-confs atom-info atom-ls

Resets alt confs and occupancies of atoms in residue that have orphan alt-loc attributes.

procedure: sanitise-alt-confs-in-residue imol chain-id resno inscode
procedure: sanitise-alt-confs-active-residue

Resets alt confs and occupancies of atoms in residue that have orphan alt-loc attributes. Use the active-residue.

procedure: print-molecule-names
procedure: save-dialog-positions-to-init-file
procedure: multi-chicken imol . n-colours

multiple maps of varying colour from a given map.

procedure: BALL_AND_STICK

simple enumeration

procedure: hilight-binding-site imol centre-residue-spec hilight-colour radius

hilight-colour is specified in degrees (round the colour wheel - starting at yellow (e.g. 230 is purple))

procedure: pukka-puckers? imol

To paraphrase: The distance of the plane of the base to the following phosphate is highly correlated to the pucker of the ribose.

An analysis of the structures in RNADB2005 shows that a critical distance of 3.3A provides a partition function to separate C2’ from C3’ endo puckering. Not all ribose follow this rule. There may be some errors in the models comprising RNADB2005. So we check the distance of the following phosphate to the plane of the ribose and record the riboses that are inconsitent. We also report puckers that are not C2’ or C3’. The puckers are determined by the most out-of-plane atom of the ribose (the rms deviation of the 4 atoms in the plane is calculated, but not used to determine the puckering atom).

procedure: *use-mogul*

if you don’t have mogul, set this to #f

procedure: prodrg-ify imol chain-id res-no ins-code

Generate restraints from the residue at the centre of the screen using PRODRG. Delete hydrogens from the residue because PRODRG has anomalous hydrogens.

procedure: add-annotation-here text
procedure: save-annotations file-name
procedure: load-annotations file-name
procedure: make-latest-version-url

Here we construct the url that contains the latest (pre) release info adding in "pre-release" if this binary is a pre-release. args ends up as something like: ("-s" "xxx/phone-home.scm" "pre-release" "binary" "Linux-1386-fedora-10-python-gtk2" "command-line" "/home/xx/coot/bin/coot")

procedure: run-download-binary-curl revision version-string pending-install-in-place-func set-file-name-func

Get the binary (i.e. the action that happens when the download button is pressed). This is run in a thread, so it can’t do any graphics stuff.

return #t if tar file was successfully downloaded and untared and #f if not.

procedure: get-revision-from-string str

(used in downloading new version)

procedure: coot-split-version-string str

e.g. input: "coot-0.6.2-pre-1-revision-2765\n" output: "coot-0.6.2-pre-1-revision-2765"

procedure: load-default-sequence

In the first case the sequence is assigned to the closest match (model sequence to target sequence), subsequently only chains without a sequence associated with them are candidates for matching. The protein sequence has to have at least 95% sequence identity with the target sequence in "default.seq"

procedure: coot-updates-error-handler key . args

not really for public manipulation.

procedure: update-self

keep a copy of the old directories around in a directory named after expiration time.

procedure: chiral-centre-inverter-scm-version

This should almost all be c++ code so that Bernie doesn’t have to redo it. This is temporary then.

procedure: get-drug-via-wikipedia drug-name-in

return a string "DB00xxxx.mol" or some such - this is the file name of the mdl mol file from drugbank. Or #f/undefined on fail. Test result with string?.

If you are debugging this function, you probably want to be looking at handle-rev-string or drugbox->drugitem.

procedure: coot-has-pygtk?

to determine if we have pygtk


Next: , Previous: coot-utils, Up: Scheme Scripting Functions   [Contents][Index]

14.33 contact-score-isolated-ligand

procedure: contact-score-ligand imol res-spec

This will hydrogenate the active residue, not imol


Next: , Previous: contact-score-isolated-ligand, Up: Scheme Scripting Functions   [Contents][Index]

14.34 libcheck

procedure: libcheck-exe

this is override-able by the user in their .coot file (for example).

procedure: monomer-molecule-from-3-let-code code dict-cif-libin . ccp4i-project-dir

Return -2 on code is not a string Return -3 on libcheck failure Return imol on success Return handle-read-draw-molecule error code on failure to read resultant pdb file

Actually, it would be nice to know if this code represented a full description - or a minimal one... perhaps we can parse the log file and call a pop-up that will tell us.

dict-cif-libin should be a string. If it is "" then it is ignored. If it is not "" then it is used to create input to libcheck (not a command line argument) so that bespoke dictionary libraries can produce coords using "Get Monomer".


Next: , Previous: libcheck, Up: Scheme Scripting Functions   [Contents][Index]

14.35 cns2coot

procedure: cns->coot 2fofc-coeffs fofc-coeffs model-pdb

Read in cns coeff-data (given filenames) and a pdb molecule filename to make maps.


Next: , Previous: cns2coot, Up: Scheme Scripting Functions   [Contents][Index]

14.36 clear-backup

procedure: delete-coot-backup-files action-type
procedure: clear-backup-gui

Return #t or #f depending on if the GUI dialog was shown (it isn’t show if there are no files to delete).

procedure: clear-backups-maybe

Return a status, #f or #t, did the GUI run?

Note that clear-backup-gui returns either #t or #f too.

If this function returns #f, then coot_real_exit() just exits with coot_real_exit(). Otherwise we wait for the GUI.


Next: , Previous: clear-backup, Up: Scheme Scripting Functions   [Contents][Index]

14.37 generic-objects

procedure: generic-object-is-displayed?

map to scheme names:

procedure: is-closed-generic-object?

map to scheme names:

procedure: generic-object-with-name

return a new generic object number for the given object obj-name. If there is no such object with name obj-name, then create a new one. (Maybe you want the generic object to be cleaned if it exists before returning, this function does not do that).

procedure: generic-objects-gui

display a GUI for generic objects

procedure: reduce-on-pdb-file imol pdb-in pdb-out

return status.

procedure: reduce-on-pdb-file-no-flip imol pdb-in pdb-out

return status.

procedure: reduce-on-pdb-file-generic imol no-flip-or-build pdb-in pdb-out

return status.

procedure: probe

run molprobity (well reduce and probe) to make generic objects (and display the generic objects gui)

procedure: write-reduce-het-dict imol reduce-het-dict-file-name

Write the connectivity for the non-standard (non-water) residues in the given molecule for which we have the dictionary.

Don’t return anything interesting.

procedure: *interactive-probe-is-OK?*

gets set the first time we run interactive-probe. Takes values unset (initial value) ’yes and ’no)

procedure: interactive-probe

run "probe" interactively, which in the current implementation, means that this function can run during a edit-chi angles manipulation, or after a real space refine zone.

Thus function presumes that there are 2 pdb files in the current directory, one of which is the reference pdb file and the other is a pdb file containing the tmp/moving atom set.

The function takes arguments for the centre of the probe dots and the radius of the probe dots sphere. The chain id and residue number are also needed to pass as arguments to probe.

procedure: probe-local-sphere imol radius

Update the generic objects probe dots from residues within radius of the screen centre.

Return nothing interesting.


Next: , Previous: generic-objects, Up: Scheme Scripting Functions   [Contents][Index]

14.38 exercise-scm-mol

procedure: jiggled-mol reference-mol current-mol traj-frac
procedure: disrupt reference-mol biggness

Next: , Previous: exercise-scm-mol, Up: Scheme Scripting Functions   [Contents][Index]

14.39 check-for-updates

procedure: get-stable-release-from-server-string str

Is this true?

procedure: get-stable-release-from-coot-version

Needs testing.

procedure: notify-of-new-version str

show the dialog

procedure: download-binary-dialog

version-string is something like: "coot-0.6-pre-1-revision-2060"

procedure: directory-is-modifiable? prefix-dir

Test for prefix-dir 1) existing 2) being a directory 3) modifiable by user (ie. u+rwx)

Return #t or #f.


Next: , Previous: check-for-updates, Up: Scheme Scripting Functions   [Contents][Index]

14.40 brute-lsqman

procedure: lsqman-count

brute-lsqman - run lsqman on chains A of two pdb-files and read in the result to coot. Charlie Bond 2003. Can keep a count of the number of successful runs if necessary


Next: , Previous: brute-lsqman, Up: Scheme Scripting Functions   [Contents][Index]

14.41 fitting

procedure: fit-protein imol

Note that residue with alt confs do not undergo auto-fit-rotamer. This is because that autofit-rotamer then refine will tend to put both rotamers into the same place. Not good. It seems a reasonable expectation that residues with an alternate conformation are already resonably well-fitted. So residues with alternate conformations undergo only real space refinement.

This is simple-minded and outdated now we have the interruptible version (below).

procedure: *continue-multi-refine*

These 2 variables are used by multi-refine function(s), called by idle functions to refine just one residue.

procedure: fit-protein-make-specs imol chain-specifier

chain-specifier can be a string, where it is the chain of interest. or ’all-chains, where all chains are chosen.

procedure: interruptible-fit-protein imol func

func is a refinement function that takes 2 args, one a residue spec, the other the imol-refinement-map. e.g. fit-protein-fit-function

procedure: fit-chain imol chain-id

For each residue in chain chain-id of molecule number imol, do a rotamer fit and real space refinement of each residue. Don’t update the graphics while this is happening (which makes it faster than fit-protein, but much less interesting to look at).

procedure: fit-waters imol . animate?

For each residue in the solvent chains of molecule number imol, do a rigid body fit of the water to the density.

procedure: stepped-refine-protein imol . res-step

Step through the residues of molecule number imol and at each step do a residue range refinement (unlike fit-protein for example, which does real-space refinement for every residue).

The step is set internally to 2.

procedure: stepped-refine-protein-for-rama imol

refine each residue with ramachandran restraints

procedure: stepped-refine-protein-with-refine-func imol refine-func . res-step
procedure: post-ligand-fit-gui

The GUI that you see after ligand finding.

procedure: molecules-matching-criteria test-func

test-func is a function given one argument (a molecule number) that returns either #f if the condition is not satisfied or something else if it is. And that "something else" can be a list like (list label x y z) or (list "Bad Chiral" 0 "A" 23 "" "CA" "A")

It is used in the create a button label and "what to do when the button is pressed".

procedure: refine-active-residue-generic side-residue-offset

This totally ignores insertion codes. A clever algorithm would need a re-write, I think. Well, we’d have at this end a function that took a chain-id res-no-1 ins-code-1 res-no-2 ins-code-2

And refine-zone would need to be re-written too, of course. So let’s save that for a rainy day (days... (weeks)).

procedure: refine-active-residue

refine active residue

procedure: refine-active-residue-triple

refine active residue triple

procedure: manual-refine-residues side-residue-offset

For just one (this) residue, side-residue-offset is 0.

procedure: pepflip-active-residue

Pepflip the active residue - needs a key binding.

procedure: auto-fit-rotamer-active-residue

Auto-fit rotamer on active residues

procedure: add-extra-restraints-to-other-molecule imol chain-id resno-range-start resno-range-end atom-sel-type imol-ref

atom-sel-type is either ’all ’main-chain or ’ca


Next: , Previous: fitting, Up: Scheme Scripting Functions   [Contents][Index]

14.42 group-settings

procedure: rapper-dir

The rapper installation dir. This is just a guess, that it is installed in the users home directory.


Next: , Previous: group-settings, Up: Scheme Scripting Functions   [Contents][Index]

14.43 background-demo

procedure: background-demo

flash the background different colours in some uninteresting way.


Next: , Previous: background-demo, Up: Scheme Scripting Functions   [Contents][Index]

14.44 americanisms

procedure: set-rotation-center

an americanism

procedure: handle-read-draw-molecule-with-recenter

an americanism

procedure: set-rotation-center-size

an americanism

procedure: center-atom-label-status

an americanism

procedure: set-last-map-color

an americanism

procedure: center-of-mass

an americanism

procedure: set-swap-difference-map-colors

an americanism

procedure: set-font-color

an americanism

procedure: set-dots-color

an americanism

procedure: invert-chiral-center

an americanism


Next: , Previous: americanisms, Up: Scheme Scripting Functions   [Contents][Index]

14.45 filter

procedure: filter fn ls

Basic scheme function, filter the objects in list ls by function fn. e.g. (filter even? (list 0 1 2 3) -> ’(0 2)


Next: , Previous: filter, Up: Scheme Scripting Functions   [Contents][Index]

14.46 a-rapper-gui

procedure: rapper-dir

something that the user sets:

procedure: a-rapper-gui loop-building-tool

loop-building-tool is either ’rapper or ’ARP/wARP


Next: , Previous: a-rapper-gui, Up: Scheme Scripting Functions   [Contents][Index]

14.47 fascinating-things

procedure: fascinating-clusters-gui window-name sorting-options cluster-list

(list cluster-name-string cluster-center-go-button-label-string ccgb-x ccgb-y ccgb-z ; now a list of specific items (list (list specific-button-label-string button-red button-green button-blue specific-x specific-y specific-z) (list specific-button-label-string button-red button-green button-blue specific-x specific-y specific-z)))))


Next: , Previous: fascinating-things, Up: Scheme Scripting Functions   [Contents][Index]

14.48 get-recent-pdbe

procedure: coot-thread-dispatcher

(coot-thread-dispatcher image-name thunk)

procedure: dialog-box-of-buttons-with-async-ligands window-name geometry buttons close-button-label

If check-button-label is #f, don’t make one, otherwise create with with the given label and "on" state.

procedure: cache-or-net-get-image image-url image-name func

Get image-name (caller doesn’t care how) and when it is in place run thunk func.

This is a generally useful function, so it has been promoted outside of dig-table.

procedure: refmac-calc-sfs-make-mtz-with-columns pdb-in-file-name mtz-file-name mtz-refmaced-file-name f-col sigf-col r-free-col

return refmac-result or #f

procedure: pdbe-get-pdb-and-sfs-cif include-get-sfs-flag entry-id

Use progress bars

include-get-sfs-flag is either ’no-sfs or ’include-sfs

procedure: pdbe-latest-releases-gui

Sameer Velankar says to get this file for the latest releases "http://www.ebi.ac.uk/pdbe-apps/jsonizer/latest/released/" (note the end "/").


Next: , Previous: get-recent-pdbe, Up: Scheme Scripting Functions   [Contents][Index]

14.49 3d-generator-import

procedure: prodrg-xyzin

if there is a prodrg-xyzin set the current-time to its mtime, else #f

procedure: import-from-3d-generator-from-mdl mdl-file-name comp-id

This function can be overwritten by your favourite 3d conformer and restraints generator.

procedure: new-molecule-by-smiles-string tlc-text smiles-text

Run libcheck to convert from SMILES string

procedure: get-mdl-latest-time

not needed?

procedure: prodrg-flat imol-in chain-id-in res-no-in

return #f (if fail) or a list of: the molecule number of the selected residue, the prodrg output mol file-name, the prodrg output pdb file-name

procedure: get-ccp4srs-monomer-and-overlay comp-id

import from SBASE, callback using sbase_import_function


Next: , Previous: 3d-generator-import, Up: Scheme Scripting Functions   [Contents][Index]

14.50 coot

procedure: *probe-command*

This is full pathname of molprobity’s probe program

procedure: *reduce-command*

This is full pathname of molprobity’s reduce program

procedure: *do-coot-tips-flag*

This has be be here (in a general place) because tips-gui (where it used to be is conditionally loaded). (default to tips-gui displayed is true).

procedure: load-all-scheme

Note the position of coot-gui is important. It seem that if there are too many files in front of it (even blank ones!) coot barfs when it gets to coot-gui.scm.

20060203 I have now enabled coot in scripting mode (no graphics (–no-graphics command line option)). In that case, we need to not load up scheme files which load up gtk (currently coot-gui and tips-gui).


Previous: coot, Up: Scheme Scripting Functions   [Contents][Index]

14.51 jligand

procedure: *to-jligand-secret-file-name*

JLigand sends Coot a file that contains filenames for the link and new dictionary/restraints.

procedure: *imol-jligand-link*

jligand internal parameter

procedure: get-file-mtime file-name

this could be in utils

procedure: start-jligand-listener

every fraction of a second look to see if *from-jligand-secret-link-file-name* has been updated. If so, then run the handle-read-from-jligand-file function.


Next: , Previous: Scheme Scripting Functions, Up: Top   [Contents][Index]

Concept Index

Jump to:   .  
A   B   C   D   E   F   G   H   I   L   M   N   O   P   R   S   T   U   V   W   Y   Z  
Index Entry  Section

.
.coot: Scheme
.coot.py: Python

A
alternate conformation: Adding Alternative Conformations
anisotropic atoms: Anisotropic Atoms
annotations: 3D Annotations
atom colouring: Display Manager
atom colouring: Atom Colouring
atom info: Atom Info
atom label, brief: Atom Labeling
atom labeling: Atom Labeling
atom picking: Clear Pending Picks
atomic dots: Atomic Dots
auto-fit rotamer: Rotamers
average map: Make an Averaged Map

B
B-Factor, New Atoms: Temperature Factor for New Atoms
background colour: Background colour
backrub rotamers: Rotamers
backups: Backups and Undo
backups, clearing: Clearing Backups
ball and stick: Ball and Stick Representation
baton build: Baton Building
baton mode: Baton Building
big maps: Dynamic Map Sampling and Display Size
blobs: sec_blobs
bond thickness: Bond Parameters
bones: Skeletonization

C
C-terminus: Add OXT Atom to Residue
carbohydrates: Refining Carbohydrates
chain id: Changing Chain IDs
change contour level: Maps in General
changing chain ids: Changing Chain IDs
changing the Refinement Map: Changing the Map for Building/Refinement
chi angles: Editing Chi Angles
cif dictionary: Dictionary
citing coot: Citing Coot
clashing residues: Rotamers
Clear Pending Picks: Clear Pending Picks
clearing backups: Clearing Backups
clipping: Clipping Manipulation
colour by chain: Display Manager
colouring, atoms: Atom Colouring
colouring, map: Map colouring
command line arguments: Command Line Arguments
contouring, map: Scrollwheel
contouring, map: Map Contouring
coordinates format: Reading coordinates
coot droppings: Coot Droppings
crash: Crash
crash recovery: Crash
crosshairs: Crosshairs
C\alpha representation: Display Manager
C\alpha symmetry: Symmetry

D
debugger: Crash
default refmac executable: Running Refmac
delete: Delete
density line thickness: Map Line Width
depth-cueing: Display Issues
dictionary, cif: Environment Variables
dictionary, cif: Find Ligands
dictionary, ligands: Environment Variables
difference map: Map Contouring
difference map: Make a Difference Map
difference map colours: Map Contouring
directory for save coordinates: The file selector
Display Manager: Display Manager
DNA, ideal: Building Ideal DNA and RNA
DNA, mutating: Mutation
docking sidechains: Docking Sidechains
droppings: Coot Droppings
dual conformations: Adding Alternative Conformations

E
edit B-factors: Atom Info
edit occupancy: Atom Info
edit \chi angles: Editing Chi Angles
Electron Density Server: Get Coordinates and Map from EDS
executing commands: Scripting
export map: Export Map
EYC-TIED: Maps in General

F
file-name filtering: The file selector
fill partial residues: Fill Partial Residues
findligand: findligand
flip peptide: Pep-flip
fragment direction change: Reversing Direction of Fragment
frame rate: Frame Rate

G
gdb: Crash
GLN and ASN B-factor Outliers: GLN and ASN B-factor Outliers
goose: Download coordinates
guano: Coot Droppings
guile: Scheme

H
helix placement: Place Helix
hydrogens: Bond Parameters

I
initialization file: Scheme

L
Least Squares Fitting: Least-Squares Fitting
ligand orientation: Flip Ligand
ligand torsion angles: Torsion General
ligand, overlay: Ligand Overlaying
ligands: Importing Ligands/Monomers
ligands: Find Ligands
ligands, flexible: Find Ligands

M
mainchain: C-alpha -> Mainchain
mainchain torsions: Backbone Torsion Angles
map box radius: Map Extent
map changing (for refinement/building): Changing the Map for Building/Refinement
map extent: Map Extent
map line width: Map Line Width
map re-Interpolation: Map Re-Interpolation
map scrolling: Scrollwheel
map transformation: Map Transformation
masks: masks
mean B-factor: Mean and Median Temperature Factors
median B-factor: Mean and Median Temperature Factors
merge molecules: Merge Molecules
missing symmetry: Symmetry
mmCIF dictionary: Dictionary
modelling toolbar: The Modelling Toolbar
modified labels: Modifying the Labels on the Model/Fit/Refine dialog
molecule centre: Moving Molecules/Ligands
molecule number: Molecule Number
Molprobity Tools: Molprobity Tools Interface
monomers: Importing Ligands/Monomers
mouse: Hardware Requirements
mouse buttons: Mousing and Keyboarding
moving ligands: Moving Molecules/Ligands
moving molecules: Moving Molecules/Ligands
Moving Zero Occupancy Atoms: Moving Zero Occupancy Atoms
multi-mutate: Mutation
multiple coordinates files: Reading coordinates
mutate: Mutation
mutating DNA: Mutation
mutating RNA: Mutation

N
NCS: Bond Parameters
NCS averaging: Bond Parameters
NCS edits: Applying NCS Edits
negative contour levels: Map Contour ``Scrolling'' Limits

O
OCA: Download coordinates
OpenGL: Display Issues
Orientation Axes: Orientation Axes
origin marker: Display Issues
output: Program Output
overlaying ligands: Ligand Overlaying
OXT atom: Add OXT Atom to Residue

P
packing diagram: Symmetry
Patterson: Pattersons
pepflip: Pep-flip
peptide restraints, planar: Planar Peptide Restraints
PHS data: Create a Map
PHS data format: Create a Map
picking: sec_picking
pink pointer: Rotation Centre Pointer
planar peptide restraints: Planar Peptide Restraints
planes: Regularization and Real Space Refinement
polynucleotides: Building Ideal DNA and RNA
post-manipulation-hook: Post-manipulation-hook
Print Sequence: Print Sequence
probe: Molprobity Tools Interface
python: Python

R
Ramachandran plot: Ramachandran Plots
Raster3D: Raster3D
reading multiple pdb files: Reading coordinates
recentring view: Recentring View
recover session: Crash
redo: Backups and Undo
reduce: Molprobity Tools Interface
reference manual: Introduction
reference structures: Environment Variables
refine single click: Regularization and Real Space Refinement
refinement: Regularization and Real Space Refinement
refinement weight: Regularization and Real Space Refinement
refinement, rigid body: Rigid Body Refinement
refinement, simplex: Simplex Refinement
refining residues: Refining Specific Residues
refmac: Running Refmac
refmac map colour: Running Refmac
refmac parameters: Running Refmac
refmac, default: Running Refmac
regularization: Regularization and Real Space Refinement
render: Raster3D
renumbering residues: Mutation
residue info: Atom Info
resizing view: Resizing View
restore after crash: Backups and Undo
reverse direction: Reversing Direction of Fragment
rigid body fit: Rigid Body Refinement
RNA, ideal: Building Ideal DNA and RNA
RNA, mutating: Mutation
rotamers: Rotamers
rotate/translate, manual: Rotate/Translate Zone
rotation centre: Recentring View
rotation centre pointer: Rotation Centre Pointer
running refmac: Running Refmac
running SHELXL: Running SHELXL

S
save coordinates directory: The file selector
scheme: Scheme
screenshot.: Screenshot
scripting: Scripting
Scroll: Display Manager
scroll wheel, map for: Scroll-wheel
scroll, map contour change by: Scrollwheel
scroll-wheel: Scrollwheel
Secondary Structure Matching (SSM): Secondary Structure Matching (SSM)
sequence view: Sequence View
set-matrix: Regularization and Real Space Refinement
set-rotation-centre: Recentring View
setting space group: Setting the Space Group
sharpening, map: Map Sharpening
SHELX .ins: Reading coordinates
SHELXL: Running SHELXL
sidechains: Docking Sidechains
simplex refinement: Simplex Refinement
single click refine: Regularization and Real Space Refinement
skeleton updating: Skeletonization
skeleton, missing: Baton Building
skeletonization: Skeletonization
slab: Clipping Manipulation
sliding: Recentring View
slow computer: Slow Computer Configuration
SMILES strings: Ligand from SMILES strings
space group names: Reading coordinates
space group operators: Space Group and Symmetry
sphere refinement: Sphere Refinement
startup dialog (state): Coot State
startup settings (python): Python
startup settings (scheme): Scheme
state: Coot State
superposition: Secondary Structure Matching (SSM)
symmetry: Symmetry
symmetry operators: Space Group and Symmetry

T
terminal oxygen: Add OXT Atom to Residue
terminal residue: Add Terminal Residue
thickness of density lines: Map Line Width
tooltips: General Features
torsion angles, ligand: Torsion General
torsion general: Torsion General
torsion restraints: Regularization and Real Space Refinement
torsions: Editing Chi Angles
trackball, virtual: Virtual Trackball
traffic lights: Regularization and Real Space Refinement
translate molecule: Moving Molecules/Ligands
translation, keyboard: Keyboard Z Translation
translation, mouse: Mouse Z Translation
trimming atoms: Trimming Atoms

U
undo: Backups and Undo
unexplained density: sec_blobs
unit cell: Unit Cell
UNK residue: The UNK residue type
unmodelled density: sec_blobs

V
Validation Graphs: Validation Graphs
version number: Version number
view matrix: View Matrix

W
waters, finding: Find Waters
web page: Web Page
weight, real space refinement: Regularization and Real Space Refinement
width, bonds: Bond Parameters
write map: Export Map
writing PDBs: Writing PDB files

Y
yellow box: Display Issues

Z
z-rotation: Virtual Trackball
zero occupancy: Zero Occupancy Marker
zoom: Resizing View
zoom, slider: more on zooming

Jump to:   .  
A   B   C   D   E   F   G   H   I   L   M   N   O   P   R   S   T   U   V   W   Y   Z  

Previous: Concept Index, Up: Top   [Contents][Index]

Function Index

Jump to:   %   *   3  
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   Z  
Index Entry  Section

%
%coot-listener-socket: remote-control

*
*add-linked-residue-tree-correlation-cut-off*: add-linked-cho
*annotations*: coot-utils
*continue-multi-refine*: fitting
*db-loop-preserve-residue-names*: coot-gui
*default-ball-and-stick-selection*: coot-utils
*do-coot-tips-flag*: coot
*imol-jligand-link*: jligand
*interactive-probe-is-OK?*: generic-objects
*key-bindings*: coot-utils
*ligand-check-resolution-limit*: ligand-check
*pisa-command*: parse-pisa-xml
*probe-command*: coot
*reduce-command*: coot
*to-jligand-secret-file-name*: jligand
*use-mogul*: coot-utils

3
3-letter-code->single-letter: mutate-in-scheme

A
a-rapper-gui: a-rapper-gui
absolutify: coot-utils
accept-baton-position: accept-baton-position
accept-moving-atoms: accept-moving-atoms
accept-regularizement: accept-regularizement
accept-reject-dialog-docked-show-state: accept-reject-dialog-docked-show-state
accept-reject-dialog-docked-state: accept-reject-dialog-docked-state
active-residue: active-residue
active-residue-py: active-residue-py
add-action-view: add-action-view
add-alt-conf-py: add-alt-conf-py
add-alt-conf-scm: add-alt-conf-scm
add-annotation-here: coot-utils
add-base-restraint: user-define-restraints
add-coordinates-glob-extension: add-coordinates-glob-extension
add-data-glob-extension: add-data-glob-extension
add-dictionary-glob-extension: add-dictionary-glob-extension
add-dipole-for-residues-py: add-dipole-for-residues-py
add-dipole-for-residues-scm: add-dipole-for-residues-scm
add-dipole-py: add-dipole-py
add-dipole-scm: add-dipole-scm
add-extra-bond-restraint: add-extra-bond-restraint
add-extra-geman-mcclure-restraint: add-extra-geman-mcclure-restraint
add-extra-restraints-to-other-molecule: fitting
add-geometry-distance: add-geometry-distance
add-header-secondary-structure-info: add-header-secondary-structure-info
add-hydrogens-from-file: add-hydrogens-from-file
add-hydrogens-using-refmac-inner: coot-utils
add-key-binding: coot-utils
add-ligand-delete-residue-copy-molecule: add-ligand-delete-residue-copy-molecule
add-ligand-search-ligand-molecule: add-ligand-search-ligand-molecule
add-ligand-search-wiggly-ligand-molecule: add-ligand-search-wiggly-ligand-molecule
add-map-glob-extension: add-map-glob-extension
add-molecule: add-molecule
add-ncs-matrix: add-ncs-matrix
add-non-auto-load-residue-name: add-non-auto-load-residue-name
add-nucleotide: add-nucleotide
add-omega-torsion-restriants: add-omega-torsion-restriants
add-planar-peptide-restraints: add-planar-peptide-restraints
add-simple-coot-menu-menuitem: coot-gui
add-status-bar-text: add-status-bar-text
add-strict-ncs-matrix: add-strict-ncs-matrix
add-target-position-restraint-for-intermediate-atom-py: add-target-position-restraint-for-intermediate-atom-py
add-terminal-residue: add-terminal-residue
add-terminal-residue-do-post-refine-state: add-terminal-residue-do-post-refine-state
add-terminal-residue-using-phi-psi: add-terminal-residue-using-phi-psi
add-tmp-extension-to: coot-utils
add-to-list-section-texis: snarf-coot-docs
add-view: coot-utils
add-view-description: add-view-description
add-view-here: add-view-here
add-view-raw: add-view-raw
add-view-to-views-panel: coot-gui
additional-representation-by-attributes: additional-representation-by-attributes
additional-representation-by-string: additional-representation-by-string
align-and-mutate: align-and-mutate
alignment-mismatches-gui: coot-gui
alignment-mismatches-py: alignment-mismatches-py
alignment-mismatches-scm: alignment-mismatches-scm
all-residues-with-serial-numbers-scm: all-residues-with-serial-numbers-scm
all-true?: coot-utils
allow-duplicate-sequence-numbers: allow-duplicate-sequence-numbers
another-level: another-level
another-level-from-map-molecule-number: another-level-from-map-molecule-number
append-dir-dir: coot-utils
append-dir-file: coot-utils
apply-lsq-matches: apply-lsq-matches
apply-ncs-to-view-orientation: apply-ncs-to-view-orientation
apply-ncs-to-view-orientation-and-screen-centre: apply-ncs-to-view-orientation-and-screen-centre
apply-redo: apply-redo
apply-undo: apply-undo
assign-fasta-sequence: assign-fasta-sequence
assign-hetatms: assign-hetatms
assign-pir-sequence: assign-pir-sequence
assign-sequence-from-file: assign-sequence-from-file
assign-sequence-from-string: assign-sequence-from-string
associate-pir-file: coot-utils
associate-pir-with-molecule-gui: coot-gui
atom-info-string-py: atom-info-string-py
atom-spec->alt-loc: coot-utils
atom-spec->atom-name: coot-utils
atom-spec->chain-id: coot-utils
atom-spec->ins-code: coot-utils
atom-spec->res-no: coot-utils
atom-spec-to-atom-index: atom-spec-to-atom-index
atom-specs: coot-utils
auto-fit-best-rotamer: auto-fit-best-rotamer
auto-fit-rotamer-active-residue: fitting
auto-load-dictionary: auto-load-dictionary
auto-read-do-difference-map-too-state: auto-read-do-difference-map-too-state
auto-read-make-and-draw-maps: auto-read-make-and-draw-maps
auto-read-make-and-draw-maps-from-mtz: auto-read-make-and-draw-maps-from-mtz
auto-weight-for-refinement: coot-utils
average-map-py: average-map-py
average-map-scm: average-map-scm
average-temperature-factor: average-temperature-factor

B
b-factor-from-map: b-factor-from-map
background-demo: background-demo
background-is-black-p: background-is-black-p
backup-compress-files-state: backup-compress-files-state
backup-state: backup-state
BALL_AND_STICK: coot-utils
baton-build-delete-last-residue: baton-build-delete-last-residue
baton-tip-previous: baton-tip-previous
baton-tip-try-another: baton-tip-try-another
blob-under-pointer-to-screen-centre: blob-under-pointer-to-screen-centre
brief-atom-labels-state: brief-atom-labels-state
brighten-map: coot-utils
brighten-maps: coot-utils
browser-url: browser-url

C
cache-or-net-get-image: get-recent-pdbe
cached-pisa-analysis: parse-pisa-xml
calc-phases-generic: calc-phases-generic
ccp4i-projects-py: ccp4i-projects-py
ccp4i-projects-scm: ccp4i-projects-scm
cell-py: cell-py
cell-scm: cell-scm
center-atom-label-status: americanisms
center-of-mass: americanisms
CG-spin-search-py: CG-spin-search-py
CG-spin-search-scm: CG-spin-search-scm
chain-fragments-scm: chain-fragments-scm
chain-id-scm: chain-id-scm
chain-ids: coot-utils
chain-n-residues: chain-n-residues
change-contour-level: change-contour-level
change-model-molecule-representation-mode: change-model-molecule-representation-mode
change-residue-number: change-residue-number
check-chiral-volumes: check-chiral-volumes
check-dir-and-get-url: get-ebi
check-for-dark-blue-density: check-for-dark-blue-density
chiral-centre-inverter-scm-version: coot-utils
cif-file-for-comp-id: redefine-functions
cis-peptides-gui: coot-gui
clashes-with-symmetry: clashes-with-symmetry
clear-all-fixed-atoms: clear-all-fixed-atoms
clear-all-views: clear-all-views
clear-and-update-model-molecule-from-file: clear-and-update-model-molecule-from-file
clear-and-update-molecule: clear-and-update-molecule
clear-backup-gui: clear-backup
clear-backups-maybe: clear-backup
clear-ball-and-stick: clear-ball-and-stick
clear-dots: clear-dots
clear-dots-by-name: clear-dots-by-name
clear-pending-picks: clear-pending-picks
click-select-residues-for-jligand: jligand-gui
close-float?: coot-utils
close-molecule: close-molecule
closest-atom: closest-atom
closest-atom-py: closest-atom-py
closest-atom-raw-py: closest-atom-raw-py
closest-atom-raw-scm: closest-atom-raw-scm
closest-atom-simple-py: closest-atom-simple-py
closest-atom-simple-scm: closest-atom-simple-scm
cns->coot: cns2coot
cns-file-has-phases-p: cns-file-has-phases-p
command-in-path-or-absolute?: coot-utils
command-in-path?: snarf-coot-docs
command-in-path?: coot-crash-catcher
command-in-path?: coot-utils
comp-id-to-name-py: comp-id-to-name-py
comp-id-to-name-scm: comp-id-to-name-scm
complex-mammal-tree: add-linked-cho
complex-plant-tree: add-linked-cho
contact-score-ligand: contact-score-isolated-ligand
control-key-for-rotate-state: control-key-for-rotate-state
coot-clear-backup-or-real-exit: coot-clear-backup-or-real-exit
coot-gui: coot-gui
coot-has-pygtk?: coot-utils
coot-listener-idle-function-proc: remote-control
coot-menubar-menu: coot-gui
coot-mkdir: coot-utils
coot-no-state-real-exit: coot-no-state-real-exit
coot-real-exit: coot-real-exit
coot-replace-string: coot-utils
coot-save-state-and-exit: coot-save-state-and-exit
coot-socket-timeout-func: remote-control
coot-split-version-string: coot-utils
coot-thread-dispatcher: get-recent-pdbe
coot-updates-error-handler: coot-utils
cootaneer-gui: coot-gui
copy-chain: copy-chain
copy-from-ncs-master-to-chains-scm: copy-from-ncs-master-to-chains-scm
copy-from-ncs-master-to-others: copy-from-ncs-master-to-others
copy-molecule: copy-molecule
copy-residue-range: copy-residue-range
copy-residue-range-from-ncs-master-to-others: copy-residue-range-from-ncs-master-to-others
crankshaft-peptide-rotation-optimization-py: crankshaft-peptide-rotation-optimization-py
crankshaft-peptide-rotation-optimization-scm: crankshaft-peptide-rotation-optimization-scm
create-pointer-atom-molecule-maybe: create-pointer-atom-molecule-maybe

D
darken-maps: coot-utils
data-resolution: data-resolution
db-mainchain: db-mainchain
db-mainchains-fragment: db-mainchains-fragment
decoloned-backup-file-names-state: decoloned-backup-file-names-state
decrease-coot-tip-number: tips-gui
default-new-atoms-b-factor: default-new-atoms-b-factor
delete-all-extra-restraints: delete-all-extra-restraints
delete-all-sequences-from-molecule: delete-all-sequences-from-molecule
delete-atom: delete-atom
delete-atom-by-active-residue: coot-utils
delete-chain: delete-chain
delete-checked-waters-baddies: delete-checked-waters-baddies
delete-coot-backup-files: clear-backup
delete-extra-restraints-for-residue: delete-extra-restraints-for-residue
delete-hydrogen-atoms: delete-hydrogen-atoms
delete-hydrogens: delete-hydrogens
delete-residue: delete-residue
delete-residue-hydrogens: delete-residue-hydrogens
delete-residue-range: delete-residue-range
delete-residue-sidechain: delete-residue-sidechain
delete-residue-with-full-spec: delete-residue-with-full-spec
delete-residues-py: delete-residues-py
delete-residues-scm: delete-residues-scm
delete-restraints: delete-restraints
delete-section-texi-files: snarf-coot-docs
delete-sequence-by-chain-id: delete-sequence-by-chain-id
delete-sidechain-range: mutate-in-scheme
delete-sidechains-for-chain: delete-sidechains-for-chain
delete-waters: delete-waters
density-at-point: density-at-point
density-score-residue: density-score-residue
dialog-box-of-buttons-with-async-ligands: get-recent-pdbe
dialog-box-of-buttons-with-check-button: coot-gui
dialog-box-of-pairs-of-buttons: coot-gui
dictionaries-read: dictionaries-read
difference-map: difference-map
difference-map-peaks: difference-map-peaks
directory-as-file-name: snarf-coot-docs
directory-as-file-name: coot-utils
directory-files: snarf-coot-docs
directory-files: coot-crash-catcher
directory-files: coot-utils
directory-is-modifiable?: coot-utils
directory-is-modifiable?: check-for-updates
display-lists-for-maps-state: display-lists-for-maps-state
display-maps-scm: display-maps-scm
display-only-active: display-only-active
disrupt: exercise-scm-mol
do-180-degree-side-chain-flip: do-180-degree-side-chain-flip
do-anti-aliasing-state: do-anti-aliasing-state
do-clipped-surface-py: do-clipped-surface-py
do-clipped-surface-scm: do-clipped-surface-scm
do-find-ligands-dialog: do-find-ligands-dialog
do-GL-lighting-state: do-GL-lighting-state
do-probe-dots-on-rotamers-and-chis-state: do-probe-dots-on-rotamers-and-chis-state
do-probe-dots-post-refine-state: do-probe-dots-post-refine-state
do-ramachandran-plot: do-ramachandran-plot
do-sequence-view: do-sequence-view
do-smiles-gui: do-smiles-gui
do-surface: do-surface
does-residue-exist-p: does-residue-exist-p
dots: dots
download-binary-dialog: check-for-updates
dragged-refinement-steps-per-frame: dragged-refinement-steps-per-frame
draw-hydrogens-state: draw-hydrogens-state
draw-ncs-ghosts-state: draw-ncs-ghosts-state

E
edit-chi-angles: edit-chi-angles
enhanced-ligand-coot?: redefine-functions
esoteric-depth-cue-state: esoteric-depth-cue-state
eval-socket-string: remote-control
every-nth: coot-utils
exchange-chain-ids-for-seg-ids: exchange-chain-ids-for-seg-ids
execute-find-blobs: execute-find-blobs
execute-find-waters-real: execute-find-waters-real
execute-refmac-real: execute-refmac-real
export-map: export-map
export-map-fragment: export-map-fragment
export-map-fragment-to-plain-file: export-map-fragment-to-plain-file
export-map-fragment-with-origin-shift: export-map-fragment-with-origin-shift
extra-params-include-weight?: refmac

F
fascinating-clusters-gui: fascinating-things
fffear-angular-resolution: fffear-angular-resolution
fffear-search: fffear-search
file-name-directory: coot-utils
file-name-extension: coot-utils
file-name-file: snarf-coot-docs
file-name-file: coot-utils
file-name-sans-extension: coot-utils
file-selector-entry: coot-gui
file-type-coords: file-type-coords
fill-option-menu-with-coordinates-mol-options: coot-gui
fill-option-menu-with-mol-options: coot-gui
fill-option-menu-with-number-options: coot-gui
fill-partial-residues: fill-partial-residues
filter: coot-crash-catcher
filter: filter
filter-fileselection-filenames-state: filter-fileselection-filenames-state
filter-out-waters: ligand-check
find-aligned-residue-type: coot-utils
find-helices: find-helices
find-nucleic-acids-local: find-nucleic-acids-local
find-secondary-structure: find-secondary-structure
find-secondary-structure-local: find-secondary-structure-local
find-strands: find-strands
first-coords-imol: first-coords-imol
first-molecule-with-symmetry-displayed: first-molecule-with-symmetry-displayed
first-n: coot-utils
first-non-trivial-name: hello
first-small-coords-imol: first-small-coords-imol
first-unsaved-coords-imol: first-unsaved-coords-imol
fit-chain: fitting
fit-chain-to-map-by-random-jiggle: fit-chain-to-map-by-random-jiggle
fit-chain-to-map-by-random-jiggle-and-blur: fit-chain-to-map-by-random-jiggle-and-blur
fit-molecule-to-map-by-random-jiggle: fit-molecule-to-map-by-random-jiggle
fit-molecule-to-map-by-random-jiggle-and-blur: fit-molecule-to-map-by-random-jiggle-and-blur
fit-protein: fitting
fit-protein-make-specs: fitting
fit-residue-range-to-map-by-simplex: fit-residue-range-to-map-by-simplex
fit-to-map-by-random-jiggle: fit-to-map-by-random-jiggle
fit-waters: fitting
fix-nomenclature-errors: fix-nomenclature-errors
fle-view-set-h-bond-dist-max: fle-view-set-h-bond-dist-max
fle-view-set-water-dist-max: fle-view-set-water-dist-max
fleur-cursor: fleur-cursor
flip-active-ligand: coot-utils
flip-hand: flip-hand
flip-ligand: flip-ligand
full-atom-spec-to-atom-index: full-atom-spec-to-atom-index

G
generate-local-self-restraints: generate-local-self-restraints
generate-local-self-restraints-by-residues-scm: generate-local-self-restraints-by-residues-scm
generate-molecule-from-mmcif-by-dict-gen: dictionary-generators
generate-self-restraints: generate-self-restraints
generic-buttons-dialog: coot-gui
generic-chooser-and-entry: coot-gui
generic-chooser-and-entry-and-checkbutton: coot-gui
generic-chooser-and-file-selector: coot-gui
generic-double-entry: coot-gui
generic-interesting-things: coot-gui
generic-molecule-chooser: coot-gui
generic-multiple-entries-with-check-button: coot-gui
generic-number-chooser: coot-gui
generic-object-is-displayed?: generic-objects
generic-object-with-name: generic-objects
generic-objects-gui: generic-objects
generic-single-entry: coot-gui
get-active-map-drag-flag: get-active-map-drag-flag
get-aniso-probability: get-aniso-probability
get-atom: coot-utils
get-atom-colour-from-mol-no: get-atom-colour-from-mol-no
get-atom-from-residue: coot-utils
get-auto-recontour-map: get-auto-recontour-map
get-bond-colour-rotation-for-molecule: get-bond-colour-rotation-for-molecule
get-bonds-representation: get-bonds-representation
get-ccp4srs-monomer-and-dictionary: get-ccp4srs-monomer-and-dictionary
get-ccp4srs-monomer-and-overlay: 3d-generator-import
get-continue-updating-refinement-atoms-state: get-continue-updating-refinement-atoms-state
get-contour-level-absolute: get-contour-level-absolute
get-contour-level-in-sigma: get-contour-level-in-sigma
get-default-bond-thickness: get-default-bond-thickness
get-dictionary-radii: get-dictionary-radii
get-diff-map-iso-level-increment: get-diff-map-iso-level-increment
get-directory: coot-utils
get-drug-via-wikipedia: coot-utils
get-ebi-pdb: get-ebi
get-eds-pdb-and-mtz: get-ebi
get-electrostatic-surface-opacity: get-electrostatic-surface-opacity
get-environment-distances-representation-py: get-environment-distances-representation-py
get-file-mtime: jligand
get-first-ncs-master-chain: coot-utils
get-flip-residue: what-check
get-font-size: get-font-size
get-fps-flag: get-fps-flag
get-gdb-strings: coot-crash-catcher
get-intermediate-atoms-bonds-representation: get-intermediate-atoms-bonds-representation
get-limit-aniso: get-limit-aniso
get-map-radius: get-map-radius
get-map-sampling-rate: get-map-sampling-rate
get-map-weight: get-map-weight
get-mdl-latest-time: 3d-generator-import
get-metrics-for-ligand: ligand-check
get-molecule-bonds-colour-map-rotation: get-molecule-bonds-colour-map-rotation
get-option-menu-active-item: coot-gui
get-option-menu-active-molecule: coot-gui
get-pointer-position-frac-py: get-pointer-position-frac-py
get-refinement-geman-mcclure-alpha: get-refinement-geman-mcclure-alpha
get-refmac-extra-params: refmac
get-reset-b-factor-moved-atoms-state: get-reset-b-factor-moved-atoms-state
get-revision-from-string: coot-utils
get-sbase-monomer: get-sbase-monomer
get-sequence-as-fasta-for-chain: get-sequence-as-fasta-for-chain
get-show-aniso: get-show-aniso
get-show-limit-aniso: get-show-limit-aniso
get-show-symmetry: get-show-symmetry
get-show-unit-cell: get-show-unit-cell
get-smooth-scroll: get-smooth-scroll
get-stable-release-from-coot-version: check-for-updates
get-stable-release-from-server-string: check-for-updates
get-symmetry: get-symmetry
get-symmetry-as-calphas-state: get-symmetry-as-calphas-state
get-url-str: get-ebi
get-view-quaternion-internal: get-view-quaternion-internal
git-revision-count: git-revision-count
gln-asn-b-factor-outliers: gln-asn-b-factor-outliers
glob: snarf-coot-docs
glob: coot-crash-catcher
glob: coot-utils
go-to-atom-alt-conf: go-to-atom-alt-conf
go-to-atom-atom-name: go-to-atom-atom-name
go-to-atom-chain-id: go-to-atom-chain-id
go-to-atom-ins-code: go-to-atom-ins-code
go-to-atom-molecule-number: go-to-atom-molecule-number
go-to-atom-residue-number: go-to-atom-residue-number
go-to-ligand: go-to-ligand
go-to-map-molecule-centre: go-to-map-molecule-centre
go-to-residue-by-spec: what-check
goosh-command: snarf-coot-docs
goosh-command: coot-utils
goosh-command-with-file-input: coot-utils
graphics-comma-key-pressed-hook: coot-utils
graphics-dot-key-pressed-hook: coot-utils
graphics-draw: graphics-draw
graphics-general-key-press-hook: coot-utils
graphics-molecule-bond-type: graphics-molecule-bond-type
graphics-n-molecules: graphics-n-molecules
graphics-to-b-factor-cas-representation: graphics-to-b-factor-cas-representation
graphics-to-b-factor-representation: graphics-to-b-factor-representation
graphics-to-bonds-no-waters-representation: graphics-to-bonds-no-waters-representation
graphics-to-bonds-representation: graphics-to-bonds-representation
graphics-to-ca-plus-ligands-and-sidechains-representation: graphics-to-ca-plus-ligands-and-sidechains-representation
graphics-to-ca-plus-ligands-representation: graphics-to-ca-plus-ligands-representation
graphics-to-ca-plus-ligands-sec-struct-representation: graphics-to-ca-plus-ligands-sec-struct-representation
graphics-to-ca-representation: graphics-to-ca-representation
graphics-to-occupancy-representation: graphics-to-occupancy-representation
graphics-to-rainbow-representation: graphics-to-rainbow-representation
graphics-to-sec-struct-bonds-representation: graphics-to-sec-struct-bonds-representation
graphics-to-user-defined-atom-colours-all-atoms-representation: graphics-to-user-defined-atom-colours-all-atoms-representation
graphics-to-user-defined-atom-colours-representation: graphics-to-user-defined-atom-colours-representation
graphics-window-size-and-position-to-preferences: graphics-window-size-and-position-to-preferences
guess-refinement-map: coot-utils

H
hack-link: acedrg-link
handle-cns-data-file: handle-cns-data-file
handle-cns-data-file-with-cell: handle-cns-data-file-with-cell
handle-drag-and-drop-string: handle-drag-and-drop-string
handle-online-coot-search-request: handle-online-coot-search-request
handle-read-ccp4-map: handle-read-ccp4-map
handle-read-draw-molecule: handle-read-draw-molecule
handle-read-draw-molecule-and-move-molecule-here: handle-read-draw-molecule-and-move-molecule-here
handle-read-draw-molecule-with-recenter: americanisms
handle-read-draw-molecule-with-recentre: handle-read-draw-molecule-with-recentre
handle-read-draw-probe-dots: handle-read-draw-probe-dots
handle-read-draw-probe-dots-unformatted: handle-read-draw-probe-dots-unformatted
handle-smiles-go: coot-gui
hardware-stereo-angle-factor-state: hardware-stereo-angle-factor-state
hardware-stereo-mode: hardware-stereo-mode
has-unit-cell-state: has-unit-cell-state
have-unsaved-changes-p: have-unsaved-changes-p
het-group-n-atoms: het-group-n-atoms
het-group-residues-py: het-group-residues-py
het-group-residues-scm: het-group-residues-scm
hetify-residue: hetify-residue
hide-main-toolbar: hide-main-toolbar
hide-modelling-toolbar: hide-modelling-toolbar
highly-coordinated-waters-py: highly-coordinated-waters-py
highly-coordinated-waters-scm: highly-coordinated-waters-scm
hilight-binding-site: coot-utils
hole: hole
hydrogenate-region: hydrogenate-region

I
ideal-nucleic-acid: ideal-nucleic-acid
identity-matrix: coot-utils
idle-function-rotate-angle: idle-function-rotate-angle
imol-refinement-map: imol-refinement-map
import-from-3d-generator-from-mdl: 3d-generator-import
import-python-module: import-python-module
increment-coot-tip-number: tips-gui
info-dialog: info-dialog
info-dialog-and-text: info-dialog-and-text
info-dialog-with-markup: info-dialog-with-markup
insert-action-view-after-view: insert-action-view-after-view
insertion-code-from-serial-number: insertion-code-from-serial-number
interactive-probe: generic-objects
interactive-probe-dots-molprobity-radius: interactive-probe-dots-molprobity-radius
interesting-things-gui: coot-gui
interesting-things-with-fix-maybe: coot-gui
interruptible-fit-protein: fitting
invert-chiral-center: americanisms
is-closed-generic-object?: generic-objects
is-difference-map?: coot-utils
is-directory?: coot-utils
is-mtz-file-p: is-mtz-file-p
is-nucleotide-chain-p: is-nucleotide-chain-p
is-protein-chain-p: is-protein-chain-p
is-solvent-chain-p: is-solvent-chain-p
is-solvent-chain?: coot-utils

J
jiggled-mol: exercise-scm-mol
join-dir-file: coot-utils
just-one-or-next-map: coot-utils

K
keep-map-colour-after-refmac-state: keep-map-colour-after-refmac-state

L
label-all-active-residue-atoms: coot-utils
label-all-atoms-in-residue: coot-utils
label-all-CAs: coot-utils
label-atoms-in-residue: label-atoms-in-residue
label-closest-atoms-in-neighbour-residues-py: label-closest-atoms-in-neighbour-residues-py
label-closest-atoms-in-neighbour-residues-scm: label-closest-atoms-in-neighbour-residues-scm
label-neighbours: label-neighbours
laplacian: laplacian
launch-jligand-function: jligand-gui
lengthen-baton: lengthen-baton
libcheck-exe: libcheck
ligand-expert: ligand-expert
list-of-strings?: coot-utils
load-all-scheme: coot
load-annotations: coot-utils
load-default-sequence: coot-utils
lsq-improve: lsq-improve
lsq-match: coot-lsq
lsq-match-type-symbol->number: coot-lsq
lsqman-count: brute-lsqman

M
maf: mutate-in-scheme
make-and-draw-map: make-and-draw-map
make-and-draw-map-with-refmac-params: make-and-draw-map-with-refmac-params
make-and-draw-map-with-reso-with-refmac-params: make-and-draw-map-with-reso-with-refmac-params
make-backup: make-backup
make-ball-and-stick: make-ball-and-stick
make-difference-map-gui: coot-gui
make-directory-maybe: make-directory-maybe
make-dynamically-transformed-ncs-maps: make-dynamically-transformed-ncs-maps
make-gdb-script: coot-crash-catcher
make-gui: coot-crash-catcher
make-latest-version-url: coot-utils
make-link: make-link
make-masked-maps-split-by-chain: make-masked-maps-split-by-chain
make-socket-listener-maybe: make-socket-listener-maybe
make-tight-planar-peptide-restraints: make-tight-planar-peptide-restraints
make-updating-map: make-updating-map
make-updating-model-molecule: make-updating-model-molecule
manage-column-selector: manage-column-selector
manual-ncs-ghosts: ncs
manual-refine-residues: fitting
map-colour-components: map-colour-components
map-colour-components-py: map-colour-components-py
map-contours: map-contours
map-from-mtz-by-calc-phases: map-from-mtz-by-calc-phases
map-from-mtz-by-refmac-calc-phases: map-from-mtz-by-refmac-calc-phases
map-is-difference-map: map-is-difference-map
map-is-displayed: map-is-displayed
map-line-width-state: map-line-width-state
map-mask-atom-radius: map-mask-atom-radius
map-mean-py: map-mean-py
map-mean-scm: map-mean-scm
map-molecule-chooser-gui: coot-gui
map-molecule-list: coot-utils
map-parameters-py: map-parameters-py
map-parameters-scm: map-parameters-scm
map-peaks-py: map-peaks-py
map-peaks-scm: map-peaks-scm
map-statistics-scm: map-statistics-scm
map-to-model-correlation: map-to-model-correlation
map-to-model-correlation-per-residue: map-to-model-correlation-per-residue
map-to-model-correlation-per-residue-scm: map-to-model-correlation-per-residue-scm
map-to-model-correlation-scm: map-to-model-correlation-scm
map-to-model-correlation-stats: map-to-model-correlation-stats
map-to-model-correlation-stats-per-residue: map-to-model-correlation-stats-per-residue
map-to-model-correlation-stats-per-residue-scm: map-to-model-correlation-stats-per-residue-scm
mask-map-by-atom-selection: mask-map-by-atom-selection
mask-map-by-molecule: mask-map-by-molecule
match-ligand-atom-names: match-ligand-atom-names
match-ligand-atom-names-to-comp-id: match-ligand-atom-names-to-comp-id
matching-compound-names-from-dictionary-py: matching-compound-names-from-dictionary-py
matching-compound-names-from-dictionary-scm: matching-compound-names-from-dictionary-scm
matching-compound-names-from-sbase-py: matching-compound-names-from-sbase-py
matching-compound-names-from-sbase-scm: matching-compound-names-from-sbase-scm
matrix->quaternion: quat-convert
matrix->quaternion: coot-utils
matrix-state: matrix-state
max-water-distance: max-water-distance
median-temperature-factor: median-temperature-factor
member?: coot-utils
merge-fragments: merge-fragments
merge-solvent-chains: coot-utils
min-max-residues-from-atom-specs: coot-gui
missing-atoms-gui: coot-gui
mmcif-sfs-to-mtz: mmcif-sfs-to-mtz
model-fit-refine-dialog-stays-on-top-state: model-fit-refine-dialog-stays-on-top-state
model-molecule-list: coot-utils
model-resolution: model-resolution
mol-is-active: mol-is-active
mol-is-displayed: mol-is-displayed
molecule-centre: coot-utils
molecule-centre-internal: molecule-centre-internal
molecule-centres-gui: coot-gui
molecule-chooser-gui: coot-gui
molecule-chooser-gui-generic: coot-gui
molecule-has-hydrogens?: coot-utils
molecule-name: molecule-name
molecule-name-stub-py: molecule-name-stub-py
molecule-name-stub-scm: molecule-name-stub-scm
molecule-number-list: coot-utils
molecule-to-pdb-string-py: molecule-to-pdb-string-py
molecules-matching-criteria: fitting
mono-mode: mono-mode
monomer-molecule-from-3-let-code: libcheck
most-recently-created-file: coot-utils
move-hetgroups-to-around-protein: move-hetgroups-to-around-protein
move-molecule-here: coot-utils
move-molecule-to-screen-center: coot-utils
move-molecule-to-screen-centre: coot-utils
move-waters-to-around-protein: move-waters-to-around-protein
mtz-file-has-phases-p: mtz-file-has-phases-p
mtz-file-name: mtz-file-name
mtz-file-name->refinement-column-labels: gui-ligand-sliders
mtz-fp-for-map: mtz-fp-for-map
mtz-hklin-for-map: mtz-hklin-for-map
mtz-phi-for-map: mtz-phi-for-map
mtz-use-weight-for-map: mtz-use-weight-for-map
mtz-weight-for-map: mtz-weight-for-map
multi-chicken: coot-utils
multi-mutate: mutate-in-scheme
multi-read-pdb: coot-utils
multi-residue-torsion-fit-py: multi-residue-torsion-fit-py
multi-residue-torsion-fit-scm: multi-residue-torsion-fit-scm
multi-residue-torsion-py: multi-residue-torsion-py
multi-residue-torsion-scm: multi-residue-torsion-scm
multi-sharpen-blur-map-py: multi-sharpen-blur-map-py
multi-sharpen-blur-map-scm: multi-sharpen-blur-map-scm
mutate: mutate
mutate-active-residue: mutate-active-residue
mutate-and-auto-fit: mutate-in-scheme
mutate-and-autofit-residue-range: mutate-in-scheme
mutate-auto-fit-do-post-refine-state: mutate-auto-fit-do-post-refine-state
mutate-base: mutate-base
mutate-by-overlap: coot-utils
mutate-chain: mutate-in-scheme
mutate-residue-range: mutate-in-scheme
mutate-residue-redundant: mutate-in-scheme
mutate-single-residue-by-serial-number: mutate-single-residue-by-serial-number
my-button-callback: extra-top-level
my-top-level: extra-top-level

N
n-atoms: n-atoms
n-chains: n-chains
n-dots-sets: n-dots-sets
n-models: n-models
n-residues: n-residues
n-rotamers: n-rotamers
n-symops: n-symops
ncs-chain-ids-py: ncs-chain-ids-py
ncs-chain-ids-scm: ncs-chain-ids-scm
ncs-control-change-ncs-master-to-chain: ncs-control-change-ncs-master-to-chain
ncs-control-change-ncs-master-to-chain-id: ncs-control-change-ncs-master-to-chain-id
ncs-control-display-chain: ncs-control-display-chain
ncs-ghosts-py: ncs-ghosts-py
ncs-ghosts-scm: ncs-ghosts-scm
ncs-ligand: ncs
ncs-master-chain-id: ncs
ncs-master-chains-scm: ncs-master-chains-scm
ncs-update-ghosts: ncs-update-ghosts
nearest-residue-by-sequence-py: nearest-residue-by-sequence-py
nearest-residue-by-sequence-scm: nearest-residue-by-sequence-scm
net-get-url: get-ebi
new-molecule-by-atom-selection: new-molecule-by-atom-selection
new-molecule-by-residue-specs-py: new-molecule-by-residue-specs-py
new-molecule-by-residue-specs-scm: new-molecule-by-residue-specs-scm
new-molecule-by-residue-type-selection: new-molecule-by-residue-type-selection
new-molecule-by-smiles-string: 3d-generator-import
new-molecule-by-sphere-selection: new-molecule-by-sphere-selection
new-molecule-by-symmetry: new-molecule-by-symmetry
new-molecule-by-symmetry-with-atom-selection: new-molecule-by-symmetry-with-atom-selection
new-molecule-by-symop: new-molecule-by-symop
new-molecule-from-this-glyco-tree: add-linked-cho
no-coot-tips: tips
non-standard-residue-names-py: non-standard-residue-names-py
non-standard-residue-names-scm: non-standard-residue-names-scm
normal-cursor: normal-cursor
notify-of-new-version: check-for-updates
nudge-screen-centre-gui: coot-gui
number-list: coot-utils

O
old-coot?: coot-gui
open-cif-dictionary-file-selector-dialog: open-cif-dictionary-file-selector-dialog
open-coords-dialog: open-coords-dialog
open-coot-listener-socket: remote-control
open-coot-listener-socket-with-timeout: remote-control
origin-pre-shift-py: origin-pre-shift-py
origin-pre-shift-scm: origin-pre-shift-scm
output-atom-info-as-text: output-atom-info-as-text
overlap-ligands: overlap-ligands
overlay-my-ligands: coot-utils

P
parse-check-db: what-check
parse-pisa-assemblies: parse-pisa-xml
parse-pisa-interfaces: parse-pisa-xml
pdbe-get-pdb-and-sfs-cif: get-recent-pdbe
pdbe-latest-releases-gui: get-recent-pdbe
pepflip: pepflip
pepflip-active-residue: fitting
pepflips-by-difference-map-gui: coot-gui
phosphorylate-active-residue: coot-utils
pick-cursor-maybe: pick-cursor-maybe
pir-file-name->pir-sequence: coot-utils
pisa-assemblies-xml: parse-pisa-xml
pisa-handle-sxml-molecule: parse-pisa-xml
pisa-interaction: pisa-interaction
place-helix-here: place-helix-here
place-strand-here: place-strand-here
place-strand-here-dialog: place-strand-here-dialog
place-text: place-text
pointer-atom-molecule: pointer-atom-molecule
post-display-control-window: post-display-control-window
post-go-to-atom-window: post-go-to-atom-window
post-ligand-fit-gui: fitting
post-manipulation-hook: coot-utils
post-model-fit-refine-dialog: post-model-fit-refine-dialog
post-other-modelling-tools-dialog: post-other-modelling-tools-dialog
post-python-scripting-window: post-python-scripting-window
post-scheme-scripting-window: post-scheme-scripting-window
post-scripting-window: post-scripting-window
post-set-rotation-centre-hook: coot-utils
povray-args: mutate-from-scheme
povray-image: mutate-from-scheme
povray-version: mutate-from-scheme
pre-release?: coot-utils
prefer-python: prefer-python
prep-for-pisa: parse-pisa-xml
print-all-history-in-python: print-all-history-in-python
print-all-history-in-scheme: print-all-history-in-scheme
print-glyco-tree: print-glyco-tree
print-header-secondary-structure-info: print-header-secondary-structure-info
print-molecule-names: coot-utils
print-sequence: coot-utils
print-sequence-chain: print-sequence-chain
print-sequence-chain-general: print-sequence-chain-general
print-view-matrix: print-view-matrix
probe: generic-objects
probe-available-p: probe-available-p
probe-local-sphere: generic-objects
problem-residues->dialog: what-check
prodrg-flat: 3d-generator-import
prodrg-ify: coot-utils
prodrg-xyzin: 3d-generator-import
protein-db-loops: protein-db-loops
pucker-info-py: pucker-info-py
pucker-info-scm: pucker-info-scm
pukka-puckers?: coot-utils
python-at-prompt-at-startup-state: python-at-prompt-at-startup-state

Q
qq-plot-map-and-model-scm: qq-plot-map-and-model-scm
quanta-buttons: quanta-buttons
quanta-like-zoom: quanta-like-zoom
quick-save: quick-save

R
ramachandran-plot-differences: ramachandran-plot-differences
ramachandran-plot-differences-by-chain: ramachandran-plot-differences-by-chain
range: coot-utils
rapper-dir: group-settings
rapper-dir: a-rapper-gui
raster-screen-shot: raster-screen-shot
raster3d: raster3d
raytrace: raster3d-from-scheme
read-pdb: read-pdb
read-pdb-all: coot-utils
read-phs-and-coords-and-make-map: read-phs-and-coords-and-make-map
read-phs-and-make-map-using-cell-symm: read-phs-and-make-map-using-cell-symm
read-phs-and-make-map-using-cell-symm-from-mol: read-phs-and-make-map-using-cell-symm-from-mol
read-phs-and-make-map-using-cell-symm-from-previous-mol: read-phs-and-make-map-using-cell-symm-from-previous-mol
read-phs-and-make-map-with-reso-limits: read-phs-and-make-map-with-reso-limits
read-shelx-ins-file: read-shelx-ins-file
read-shelx-lst-file: shelx
read-vu-file: coot-utils
reattach-modelling-toolbar: reattach-modelling-toolbar
recentre-on-read-pdb: recentre-on-read-pdb
recover-session: recover-session
redraw-background: redraw-background
reduce-on-pdb-file: generic-objects
reduce-on-pdb-file-generic: generic-objects
reduce-on-pdb-file-no-flip: generic-objects
refine-active-residue: fitting
refine-active-residue-generic: fitting
refine-active-residue-triple: fitting
refine-auto-range: refine-auto-range
refine-residues-py: refine-residues-py
refine-residues-scm: refine-residues-scm
refine-with-torsion-restraints-state: refine-with-torsion-restraints-state
refine-zone: refine-zone
refine-zone-atom-index-define: refine-zone-atom-index-define
refine-zone-with-full-residue-spec-scm: refine-zone-with-full-residue-spec-scm
refinement-already-ongoing-p: refinement-already-ongoing-p
refinement-immediate-replacement-state: refinement-immediate-replacement-state
refinement-move-atoms-with-zero-occupancy-state: refinement-move-atoms-with-zero-occupancy-state
refinement-refine-per-frame-state: refinement-refine-per-frame-state
refmac-calc-sfs-make-mtz-with-columns: get-recent-pdbe
refmac-exe: refmac
refmac-extra-params: refmac
refmac-name: refmac-name
refmac-problems-gui: refmac-problems
regularize-residues: regularize-residues
regularize-zone: regularize-zone
reinterp-map: reinterp-map
reload-dictionary: reload-dictionary
remarks-dialog: remarks-dialog
remarks-scm: remarks-scm
remove-coordinates-glob-extension: remove-coordinates-glob-extension
remove-data-glob-extension: remove-data-glob-extension
remove-dictionary-glob-extension: remove-dictionary-glob-extension
remove-map-glob-extension: remove-map-glob-extension
remove-named-view: remove-named-view
remove-non-auto-load-residue-name: remove-non-auto-load-residue-name
remove-omega-torsion-restriants: remove-omega-torsion-restriants
remove-planar-peptide-restraints: remove-planar-peptide-restraints
remove-text: remove-text
remove-view: remove-view
rename-residue-gui: coot-gui
render-image: raster3d-from-scheme
renumber-residue-range: renumber-residue-range
renumber-waters: renumber-waters
reorder-chains: coot-utils
repeat-refine-zone: repeat-refine-zone
replace-fragment: replace-fragment
replace-residues-from-mol-scm: replace-residues-from-mol-scm
res-spec->chain-id: coot-utils
res-spec->ins-code: coot-utils
res-spec->res-no: coot-utils
reset-view: reset-view
residue-alt-confs: coot-utils
residue-atom->alt-conf: coot-utils
residue-atom->atom-name: coot-utils
residue-atom->atom-spec: coot-utils
residue-atom->occupancy: coot-utils
residue-atom->position: coot-utils
residue-density-fit-scale-factor: residue-density-fit-scale-factor
residue-exists?: coot-utils
residue-has-hetatms: residue-has-hetatms
residue-has-hetatms?: coot-utils
residue-info: residue-info
residue-info-dialog: residue-info-dialog
residue-info-py: residue-info-py
residue-name: residue-name
residue-range-gui: coot-gui
residue-spec->atom-for-centre: coot-utils
residue-spec->atom-selection-string: coot-utils
residue-spec->chain-id: coot-utils
residue-spec->string: what-check
residue-spec-less-than: coot-utils
residues-in-chain: coot-utils
residues-matching-criteria: coot-utils
residues-near-position-py: residues-near-position-py
residues-near-position-scm: residues-near-position-scm
residues-near-residue: residues-near-residue
residues-near-residues-scm: residues-near-residues-scm
residues-with-alt-confs: coot-utils
resname-from-serial-number: resname-from-serial-number
restore-previous-map-colour: restore-previous-map-colour
rigid-body-refine-by-residue-ranges: coot-utils
rigid-body-refine-by-residue-ranges-py: rigid-body-refine-by-residue-ranges-py
rigid-body-refine-by-residue-ranges-scm: rigid-body-refine-by-residue-ranges-scm
rigid-body-refine-zone: rigid-body-refine-zone
rotamer-auto-fit-do-post-refine-state: rotamer-auto-fit-do-post-refine-state
rotamer-graphs: rotamer-graphs
rotamer-graphs-py: rotamer-graphs-py
rotate-about-screen-axis: coot-utils
rotate-cursor: rotate-cursor
rotate-x-scene: rotate-x-scene
rotate-y-scene: rotate-y-scene
rotate-z-scene: rotate-z-scene
rotation-centre: coot-utils
run-clear-backups: run-clear-backups
run-clustalw-alignment: coot-gui
run-command/strings: snarf-coot-docs
run-command/strings: coot-crash-catcher
run-command/strings: coot-utils
run-download-binary-curl: coot-utils
run-gtk-pending-events: coot-gui
run-guile-script: run-guile-script
run-mogul: run-mogul
run-mogul-show-results: run-mogul
run-prosmart: gui-prosmart
run-python-script: run-python-script
run-refmac-by-filename: refmac
run-refmac-for-phases: refmac
run-script: run-script
run-state-file: run-state-file
run-state-file-maybe: run-state-file-maybe

S
sanitise-alt-confs: coot-utils
sanitise-alt-confs-active-residue: coot-utils
sanitise-alt-confs-in-residue: coot-utils
save-annotations: coot-utils
save-coordinates: save-coordinates
save-dialog-positions-to-init-file: coot-utils
save-previous-map-colour: save-previous-map-colour
save-state: save-state
save-state-file: save-state-file
save-state-file-name-py: save-state-file-name-py
save-state-file-name-scm: save-state-file-name-scm
save-state-file-py: save-state-file-py
save-symmetry-coords: save-symmetry-coords
save-views: save-views
scale-cell: scale-cell
scale-zoom: scale-zoom
scheme-representation: coot-utils
score-residue-range-fit-to-map: score-residue-range-fit-to-map
score-rotamers-scm: score-rotamers-scm
screendump-image: screendump-image
scroll-by-wheel-mouse-state: scroll-by-wheel-mouse-state
scroll-wheel-map: scroll-wheel-map
secondary-structure-restraints-type: secondary-structure-restraints-type
select-atom-under-pointer-py: select-atom-under-pointer-py
select-atom-under-pointer-scm: select-atom-under-pointer-scm
seqnum-from-serial-number: seqnum-from-serial-number
sequence-info: sequence-info
sequence-info-py: sequence-info-py
serial-number-from-residue-specs: serial-number-from-residue-specs
set-accept-reject-dialog-docked-show: set-accept-reject-dialog-docked-show
set-accept-reject-dialog-position: set-accept-reject-dialog-position
set-active-map-drag-flag: set-active-map-drag-flag
set-add-ccp4i-projects-to-file-dialogs: set-add-ccp4i-projects-to-file-dialogs
set-add-terminal-residue-default-residue-type: set-add-terminal-residue-default-residue-type
set-add-terminal-residue-do-post-refine: set-add-terminal-residue-do-post-refine
set-add-terminal-residue-immediate-addition: set-add-terminal-residue-immediate-addition
set-alignment-gap-and-space-penalty: set-alignment-gap-and-space-penalty
set-all-maps-displayed: set-all-maps-displayed
set-all-models-displayed-and-active: set-all-models-displayed-and-active
set-aniso-probability: set-aniso-probability
set-atom-attribute: set-atom-attribute
set-atom-attributes: set-atom-attributes
set-atom-string-attribute: set-atom-string-attribute
set-auto-fit-best-rotamer-clash-flag: set-auto-fit-best-rotamer-clash-flag
set-auto-h-bond-restraints: set-auto-h-bond-restraints
set-auto-read-column-labels: set-auto-read-column-labels
set-auto-recontour-map: set-auto-recontour-map
set-auto-updating-sfcalc-genmap: set-auto-updating-sfcalc-genmap
set-b-factor-bonds-scale-factor: set-b-factor-bonds-scale-factor
set-background-colour: set-background-colour
set-backup-compress-files: set-backup-compress-files
set-baton-build-params: set-baton-build-params
set-baton-mode: set-baton-mode
set-bond-colour-rotation-for-molecule: set-bond-colour-rotation-for-molecule
set-bond-thickness: set-bond-thickness
set-bond-thickness-intermediate-atoms: set-bond-thickness-intermediate-atoms
set-brief-atom-labels: set-brief-atom-labels
set-browser-interface: set-browser-interface
set-button-label-for-external-refinement: set-button-label-for-external-refinement
set-clipping-back: set-clipping-back
set-clipping-front: set-clipping-front
set-colour-by-chain: set-colour-by-chain
set-colour-by-chain-goodsell-mode: set-colour-by-chain-goodsell-mode
set-colour-by-molecule: set-colour-by-molecule
set-colour-map-rotation-for-map: set-colour-map-rotation-for-map
set-colour-map-rotation-on-read-pdb: set-colour-map-rotation-on-read-pdb
set-colour-map-rotation-on-read-pdb-c-only-flag: set-colour-map-rotation-on-read-pdb-c-only-flag
set-colour-map-rotation-on-read-pdb-flag: set-colour-map-rotation-on-read-pdb-flag
set-console-display-commands-hilights: set-console-display-commands-hilights
set-console-display-commands-state: set-console-display-commands-state
set-contour-by-sigma-step-by-mol: set-contour-by-sigma-step-by-mol
set-contour-level-absolute: set-contour-level-absolute
set-contour-level-in-sigma: set-contour-level-in-sigma
set-control-key-for-rotate: set-control-key-for-rotate
set-convert-to-v2-atom-names: set-convert-to-v2-atom-names
set-decoloned-backup-file-names: set-decoloned-backup-file-names
set-default-bond-thickness: set-default-bond-thickness
set-default-initial-contour-level-for-difference-map: set-default-initial-contour-level-for-difference-map
set-default-initial-contour-level-for-map: set-default-initial-contour-level-for-map
set-default-representation-type: set-default-representation-type
set-default-temperature-factor-for-new-atoms: set-default-temperature-factor-for-new-atoms
set-delete-dialog-position: set-delete-dialog-position
set-density-size: set-density-size
set-diff-map-iso-level-increment: set-diff-map-iso-level-increment
set-diff-map-iso-level-increment-from-text: set-diff-map-iso-level-increment-from-text
set-display-control-dialog-position: set-display-control-dialog-position
set-display-intro-string: set-display-intro-string
set-display-lists-for-maps: set-display-lists-for-maps
set-display-only-model-mol: set-display-only-model-mol
set-do-anti-aliasing: set-do-anti-aliasing
set-do-GL-lighting: set-do-GL-lighting
set-do-probe-dots-on-rotamers-and-chis: set-do-probe-dots-on-rotamers-and-chis
set-do-probe-dots-post-refine: set-do-probe-dots-post-refine
set-dots-color: americanisms
set-dots-colour: set-dots-colour
set-dragged-refinement-steps-per-frame: set-dragged-refinement-steps-per-frame
set-draw-cis-peptide-markups: set-draw-cis-peptide-markups
set-draw-crosshairs: set-draw-crosshairs
set-draw-hydrogens: set-draw-hydrogens
set-draw-map-standard-lines: set-draw-map-standard-lines
set-draw-missing-residues-loops: set-draw-missing-residues-loops
set-draw-ncs-ghosts: set-draw-ncs-ghosts
set-draw-solid-density-surface: set-draw-solid-density-surface
set-draw-stick-mode-atoms: set-draw-stick-mode-atoms
set-draw-stick-mode-atoms-default: set-draw-stick-mode-atoms-default
set-draw-zero-occ-markers: set-draw-zero-occ-markers
set-edit-chi-angles-dialog-position: set-edit-chi-angles-dialog-position
set-environment-distances-distance-limits: set-environment-distances-distance-limits
set-environment-distances-label-atom: set-environment-distances-label-atom
set-esoteric-depth-cue: set-esoteric-depth-cue
set-extra-restraints-prosmart-sigma-limits: set-extra-restraints-prosmart-sigma-limits
set-fffear-angular-resolution: set-fffear-angular-resolution
set-file-chooser-selector: set-file-chooser-selector
set-filter-fileselection-filenames: set-filter-fileselection-filenames
set-find-hydrogen-torsion: redefine-functions
set-find-hydrogen-torsions: set-find-hydrogen-torsions
set-find-ligand-here-cluster: set-find-ligand-here-cluster
set-find-ligand-mask-waters: set-find-ligand-mask-waters
set-find-ligand-multi-solutions-per-cluster: set-find-ligand-multi-solutions-per-cluster
set-find-ligand-n-top-ligands: set-find-ligand-n-top-ligands
set-fix-chiral-volumes-before-refinement: set-fix-chiral-volumes-before-refinement
set-flat-shading-for-solid-density-surface: set-flat-shading-for-solid-density-surface
set-font-color: americanisms
set-font-colour: set-font-colour
set-font-size: set-font-size
set-fps-flag: set-fps-flag
set-go-to-atom-chain-residue-atom-name: set-go-to-atom-chain-residue-atom-name
set-go-to-atom-chain-residue-atom-name-full: set-go-to-atom-chain-residue-atom-name-full
set-go-to-atom-chain-residue-atom-name-no-redraw: set-go-to-atom-chain-residue-atom-name-no-redraw
set-go-to-atom-molecule: set-go-to-atom-molecule
set-go-to-atom-window-position: set-go-to-atom-window-position
set-go-to-ligand-n-atoms-limit: set-go-to-ligand-n-atoms-limit
set-graphics-window-position: set-graphics-window-position
set-graphics-window-size: set-graphics-window-size
set-grey-carbon-colour: set-grey-carbon-colour
set-hardware-stereo-angle-factor: set-hardware-stereo-angle-factor
set-have-unsaved-changes: set-have-unsaved-changes
set-idle-function-rotate-angle: set-idle-function-rotate-angle
set-imol-refinement-map: set-imol-refinement-map
set-interactive-probe-dots-molprobity-radius: set-interactive-probe-dots-molprobity-radius
set-iso-level-increment: set-iso-level-increment
set-keep-map-colour-after-refmac: set-keep-map-colour-after-refmac
set-kleywegt-plot-n-diffs: set-kleywegt-plot-n-diffs
set-last-map-color: americanisms
set-last-map-colour: set-last-map-colour
set-last-map-contour-level: set-last-map-contour-level
set-last-map-contour-level-by-sigma: set-last-map-contour-level-by-sigma
set-last-map-sigma-step: set-last-map-sigma-step
set-ligand-acceptable-fit-fraction: set-ligand-acceptable-fit-fraction
set-ligand-cluster-sigma-level: set-ligand-cluster-sigma-level
set-ligand-flexible-ligand-n-samples: set-ligand-flexible-ligand-n-samples
set-ligand-search-map-molecule: set-ligand-search-map-molecule
set-ligand-search-protein-molecule: set-ligand-search-protein-molecule
set-ligand-water-n-cycles: set-ligand-water-n-cycles
set-ligand-water-to-protein-distance-limits: set-ligand-water-to-protein-distance-limits
set-limit-aniso: set-limit-aniso
set-log-cosh-target-distance-scale-factor: set-log-cosh-target-distance-scale-factor
set-main-window-title: set-main-window-title
set-map-colour: set-map-colour
set-map-correlation-atom-radius: set-map-correlation-atom-radius
set-map-displayed: set-map-displayed
set-map-is-difference-map: set-map-is-difference-map
set-map-line-width: set-map-line-width
set-map-mask-atom-radius: set-map-mask-atom-radius
set-map-radius: set-map-radius
set-map-radius-em: set-map-radius-em
set-map-sampling-rate: set-map-sampling-rate
set-map-sampling-rate-text: set-map-sampling-rate-text
set-map-sharpening-scale-limit: set-map-sharpening-scale-limit
set-match-element: coot-lsq
set-matrix: set-matrix
set-max-skeleton-search-depth: set-max-skeleton-search-depth
set-model-fit-refine-dialog-position: set-model-fit-refine-dialog-position
set-model-fit-refine-dialog-stays-on-top: set-model-fit-refine-dialog-stays-on-top
set-model-fit-refine-place-atom-at-pointer-label: set-model-fit-refine-place-atom-at-pointer-label
set-model-fit-refine-rotate-translate-zone-label: set-model-fit-refine-rotate-translate-zone-label
set-model-toolbar-docked-position: set-model-toolbar-docked-position
set-mol-active: set-mol-active
set-mol-displayed: set-mol-displayed
set-molecule-bonds-colour-map-rotation: set-molecule-bonds-colour-map-rotation
set-molecule-name: set-molecule-name
set-monomer-restraints: set-monomer-restraints
set-mutate-auto-fit-do-post-refine: set-mutate-auto-fit-do-post-refine
set-ncs-ghost-bond-thickness: set-ncs-ghost-bond-thickness
set-ncs-homology-level: set-ncs-homology-level
set-nomenclature-errors-on-read: set-nomenclature-errors-on-read
set-only-last-model-molecule-displayed: set-only-last-model-molecule-displayed
set-pick-cursor-index: set-pick-cursor-index
set-prefer-python: set-prefer-python
set-ramachandran-plot-background-block-size: set-ramachandran-plot-background-block-size
set-ramachandran-plot-contour-levels: set-ramachandran-plot-contour-levels
set-ramachandran-plot-dialog-position: set-ramachandran-plot-dialog-position
set-ramachandran-psi-axis-mode: set-ramachandran-psi-axis-mode
set-raster3d-atom-radius: set-raster3d-atom-radius
set-raster3d-bond-thickness: set-raster3d-bond-thickness
set-raster3d-bone-thickness: set-raster3d-bone-thickness
set-raster3d-density-thickness: set-raster3d-density-thickness
set-raster3d-font-size: set-raster3d-font-size
set-raster3d-shadows-enabled: set-raster3d-shadows-enabled
set-raster3d-water-sphere: set-raster3d-water-sphere
set-recentre-on-read-pdb: set-recentre-on-read-pdb
set-refine-auto-range-step: set-refine-auto-range-step
set-refine-max-residues: set-refine-max-residues
set-refine-ramachandran-angles: set-refine-ramachandran-angles
set-refine-ramachandran-restraints-type: set-refine-ramachandran-restraints-type
set-refine-ramachandran-restraints-weight: set-refine-ramachandran-restraints-weight
set-refine-with-torsion-restraints: set-refine-with-torsion-restraints
set-refinement-drag-elasticity: set-refinement-drag-elasticity
set-refinement-geman-mcclure-alpha: set-refinement-geman-mcclure-alpha
set-refinement-immediate-replacement: set-refinement-immediate-replacement
set-refinement-lennard-jones-epsilon: set-refinement-lennard-jones-epsilon
set-refinement-move-atoms-with-zero-occupancy: set-refinement-move-atoms-with-zero-occupancy
set-refinement-refine-per-frame: set-refinement-refine-per-frame
set-refmac-counter: set-refmac-counter
set-renderer-show-atoms: set-renderer-show-atoms
set-reorienting-next-residue-mode: set-reorienting-next-residue-mode
set-reset-b-factor-moved-atoms: set-reset-b-factor-moved-atoms
set-residue-density-fit-scale-factor: set-residue-density-fit-scale-factor
set-residue-name: set-residue-name
set-residue-selection-flash-frames-number: set-residue-selection-flash-frames-number
set-residue-to-rotamer-name: set-residue-to-rotamer-name
set-residue-to-rotamer-number: set-residue-to-rotamer-number
set-residue-type-chooser-stub-state: set-residue-type-chooser-stub-state
set-rigid-body-fit-acceptable-fit-fraction: set-rigid-body-fit-acceptable-fit-fraction
set-rocking-factors: set-rocking-factors
set-rotamer-auto-fit-do-post-refine: set-rotamer-auto-fit-do-post-refine
set-rotamer-check-clashes: set-rotamer-check-clashes
set-rotamer-lowest-probability: set-rotamer-lowest-probability
set-rotamer-search-mode: set-rotamer-search-mode
set-rotamer-selection-dialog-position: set-rotamer-selection-dialog-position
set-rotate-translate-dialog-position: set-rotate-translate-dialog-position
set-rotation-center: americanisms
set-rotation-center-size: americanisms
set-rotation-centre: set-rotation-centre
set-rotation-centre-size: set-rotation-centre-size
set-run-state-file-status: set-run-state-file-status
set-save-coordinates-in-original-directory: set-save-coordinates-in-original-directory
set-save-state-file-name: set-save-state-file-name
set-scroll-by-wheel-mouse: set-scroll-by-wheel-mouse
set-scroll-wheel-map: set-scroll-wheel-map
set-scrollable-map: set-scrollable-map
set-secondary-structure-restraints-type: set-secondary-structure-restraints-type
set-seg-ids-in-atom-labels: set-seg-ids-in-atom-labels
set-show-aniso: set-show-aniso
set-show-chiral-volume-errors-dialog: set-show-chiral-volume-errors-dialog
set-show-environment-distances: set-show-environment-distances
set-show-environment-distances-as-solid: set-show-environment-distances-as-solid
set-show-environment-distances-bumps: set-show-environment-distances-bumps
set-show-environment-distances-h-bonds: set-show-environment-distances-h-bonds
set-show-graphics-ligand-view: set-show-graphics-ligand-view
set-show-origin-marker: set-show-origin-marker
set-show-paths-in-display-manager: set-show-paths-in-display-manager
set-show-pointer-distances: set-show-pointer-distances
set-show-strict-ncs: set-show-strict-ncs
set-show-symmetry-master: set-show-symmetry-master
set-show-symmetry-molecule: set-show-symmetry-molecule
set-show-unit-cell: set-show-unit-cell
set-show-unit-cells-all: set-show-unit-cells-all
set-skeleton-box-size: set-skeleton-box-size
set-smooth-scroll-do-zoom: set-smooth-scroll-do-zoom
set-smooth-scroll-flag: set-smooth-scroll-flag
set-smooth-scroll-limit: set-smooth-scroll-limit
set-smooth-scroll-steps: set-smooth-scroll-steps
set-socket-python-string-waiting: set-socket-python-string-waiting
set-socket-string-waiting: set-socket-string-waiting
set-solid-density-surface-opacity: set-solid-density-surface-opacity
set-space-group: set-space-group
set-sticky-sort-by-date: set-sticky-sort-by-date
set-stop-scroll-diff-map: set-stop-scroll-diff-map
set-stop-scroll-diff-map-level: set-stop-scroll-diff-map-level
set-stop-scroll-iso-map: set-stop-scroll-iso-map
set-stop-scroll-iso-map-level: set-stop-scroll-iso-map-level
set-swap-difference-map-colors: americanisms
set-swap-difference-map-colours: set-swap-difference-map-colours
set-symmetry-atom-labels-expanded: set-symmetry-atom-labels-expanded
set-symmetry-colour: set-symmetry-colour
set-symmetry-colour-by-symop: set-symmetry-colour-by-symop
set-symmetry-molecule-rotate-colour-map: set-symmetry-molecule-rotate-colour-map
set-symmetry-shift-search-size: set-symmetry-shift-search-size
set-symmetry-size: set-symmetry-size
set-symmetry-whole-chain: set-symmetry-whole-chain
set-torsion-py: set-torsion-py
set-torsion-scm: set-torsion-scm
set-transparent-electrostatic-surface: set-transparent-electrostatic-surface
set-undo-molecule: set-undo-molecule
set-unit-cell-and-space-group: set-unit-cell-and-space-group
set-unit-cell-and-space-group-using-molecule: set-unit-cell-and-space-group-using-molecule
set-unpathed-backup-file-names: set-unpathed-backup-file-names
set-use-grey-carbons-for-molecule: set-use-grey-carbons-for-molecule
set-use-only-extra-torsion-restraints-for-torsions: set-use-only-extra-torsion-restraints-for-torsions
set-use-stroke-characters: set-use-stroke-characters
set-use-trans-peptide-restraints: set-use-trans-peptide-restraints
set-use-variable-bond-thickness: set-use-variable-bond-thickness
set-view-matrix: quat-convert
set-view-matrix: coot-utils
set-view-quaternion: set-view-quaternion
set-virtual-trackball-type: coot-utils
set-water-check-spherical-variance-limit: set-water-check-spherical-variance-limit
setup-mutate-auto-fit: setup-mutate-auto-fit
setup-torsion-general: setup-torsion-general
sfcalc-genmap: sfcalc-genmap
sharpen: sharpen
sharpen-blur-map: sharpen-blur-map
sharpen-blur-map-with-resampling: sharpen-blur-map-with-resampling
shell-command-to-file-with-data: coot-utils
shell-command-to-string: coot-crash-catcher
shell-command-to-string: coot-utils
shelx-molecule?: coot-utils
shelx-molecule?: coot-utils
shelxl-refine: shelx
shelxl-refine-primitive: shelx
shiftfield-b-factor-refinement: shiftfield-b-factor-refinement
shiftfield-xyz-factor-refinement: shiftfield-xyz-factor-refinement
shorten-baton: shorten-baton
show-coot-tip-from-list: tips-gui
show-environment-distances-state: show-environment-distances-state
show-main-toolbar: show-main-toolbar
show-model-toolbar-all-icons: show-model-toolbar-all-icons
show-model-toolbar-main-icons: show-model-toolbar-main-icons
show-modelling-toolbar: show-modelling-toolbar
show-origin-marker-state: show-origin-marker-state
show-partial-charge-info: show-partial-charge-info
show-paths-in-display-manager-state: show-paths-in-display-manager-state
show-pointer-distances-state: show-pointer-distances-state
show-remarks-browswer: show-remarks-browswer
show-restraints-editor: show-restraints-editor
show-restraints-editor-by-index: show-restraints-editor-by-index
show-select-map-dialog: show-select-map-dialog
show-set-undo-molecule-chooser: show-set-undo-molecule-chooser
show-spacegroup: show-spacegroup
show-strict-ncs-state: show-strict-ncs-state
side-by-side-stereo-mode: side-by-side-stereo-mode
simple-fill-partial-residues: simple-fill-partial-residues
simple-lsq-match: coot-lsq
single-manual-ncs-ghost: ncs
single-model-view-model-number: single-model-view-model-number
single-model-view-next-model-number: single-model-view-next-model-number
single-model-view-prev-model-number: single-model-view-prev-model-number
single-model-view-this-model-number: single-model-view-this-model-number
skeletonize-map: skeletonize-map
skip-to-next-ncs-chain: ncs
slash-start?: coot-utils
smiles-gui: coot-gui
smooth-map: smooth-map
smooth-scroll-do-zoom: smooth-scroll-do-zoom
sort-chains: sort-chains
sort-residues: sort-residues
space-group-scm: space-group-scm
spin-N-py: spin-N-py
spin-N-scm: spin-N-scm
spin-search: spin-search
spin-search-py: spin-search-py
spin-zoom-trans: spin-zoom-trans
split-water: split-water
standard-deviation-temperature-factor: standard-deviation-temperature-factor
start-graphics-interface: start-graphics-interface
start-jligand-listener: jligand
stepped-refine-protein: fitting
stepped-refine-protein-for-rama: fitting
stepped-refine-protein-with-refine-func: fitting
stereo-mode-state: stereo-mode-state
store-graphics-window-position: store-graphics-window-position
string->list-of-strings: snarf-coot-docs
string->list-of-strings: coot-crash-catcher
string->list-of-strings: coot-utils
string-append-with-spaces: coot-utils
string-append-with-string: coot-utils
string-concatenate: coot-crash-catcher
string-concatenate: coot-utils
string-member?: coot-utils
strip-extension: snarf-coot-docs
strip-extension: coot-utils
strip-leading-spaces: what-check
strip-leading-spaces: coot-utils
strip-path: coot-utils
strip-spaces: coot-utils
suck-model-fit-dialog: suck-model-fit-dialog
superpose: superpose
superpose-with-atom-selection: superpose-with-atom-selection
superpose-with-chain-selection: superpose-with-chain-selection
svn-revision: svn-revision
swap-map-colours: swap-map-colours
symmetry-as-calphas: symmetry-as-calphas
symmetry-molecule-rotate-colour-map-state: symmetry-molecule-rotate-colour-map-state
symmetry-operators-py: symmetry-operators-py
symmetry-operators-scm: symmetry-operators-scm

T
target-auto-weighting-value: coot-utils
teb: entry+do-button
teb2: entry+do-button
text-index-near-position: text-index-near-position
tip-list: tips
tips-gui: tips-gui
toggle-active-mol: coot-utils
toggle-display-map: coot-utils
toggle-display-mol: coot-utils
toggle-idle-ligand-interactions: redefine-functions
toggle-idle-rock-function: toggle-idle-rock-function
toggle-idle-spin-function: toggle-idle-spin-function
transform-coords-molecule: coot-utils
transform-map: coot-utils
transform-map-using-lsq-matrix: coot-utils
transform-molecule-by: transform-molecule-by
transform-zone: transform-zone
translate-molecule-by: translate-molecule-by
translate-scene-x: translate-scene-x
translate-scene-y: translate-scene-y
translate-scene-z: translate-scene-z
translation: coot-utils
trim-molecule-by-map: trim-molecule-by-map
try-set-draw-baton: try-set-draw-baton
turn-off-backup: turn-off-backup
turn-on-backup: turn-on-backup

U
undisplay-all-maps-except: coot-utils
undo-last-move: undo-last-move
undo-symmetry-view: undo-symmetry-view
unique-date/time-str: coot-utils
unmangle-hydrogen-name: unmangle-hydrogen-name
unpathed-backup-file-names-state: unpathed-backup-file-names-state
unset-dots-colour: unset-dots-colour
unset-model-fit-refine-dialog: unset-model-fit-refine-dialog
unset-refine-params-dialog: unset-refine-params-dialog
unset-sticky-sort-by-date: unset-sticky-sort-by-date
unskeletonize-map: unskeletonize-map
update-go-to-atom-from-current-atom: coot-utils
update-go-to-atom-from-current-position: update-go-to-atom-from-current-position
update-go-to-atom-window-on-changed-mol: update-go-to-atom-window-on-changed-mol
update-go-to-atom-window-on-new-mol: update-go-to-atom-window-on-new-mol
update-ncs-ghosts-by-local-sphere: ncs
update-self: coot-utils
use-graphics-interface-state: use-graphics-interface-state
use-only-extra-torsion-restraints-for-torsions-state: use-only-extra-torsion-restraints-for-torsions-state
use-unimodal-ring-torsion-restraints: use-unimodal-ring-torsion-restraints
use-unimodal-ring-torsion-restraints-for-residue: use-unimodal-ring-torsion-restraints-for-residue
useful-glob: snarf-coot-docs
useful-glob: coot-utils
user-mods-gui: coot-gui
user-mods-py: user-mods-py
user-mods-scm: user-mods-scm

V
valid-labels: valid-labels
valid-map-molecule?: coot-utils
valid-model-molecule?: coot-utils
valid-refinement-map?: coot-utils
view-matrix: coot-utils
view-name: view-name
view-name-py: view-name-py
view-quaternion: coot-utils
view-saver-gui: coot-gui
views-panel-gui: coot-gui
vt-surface: vt-surface
vt-surface-status: vt-surface-status

W
water-chain-from-shelx-ins-scm: water-chain-from-shelx-ins-scm
water-chain-py: water-chain-py
water-chain-scm: water-chain-scm
water-coordination-gui: coot-gui
watson-crick-pair: watson-crick-pair
watson-crick-pair-for-residue-range: watson-crick-pair-for-residue-range
wrapped-create-find-waters-dialog: wrapped-create-find-waters-dialog
wrapper-alignment-mismatches-gui: coot-gui
write-ccp4mg-picture-description: write-ccp4mg-picture-description
write-cif-file: write-cif-file
write-interpolated-extra-restraints: write-interpolated-extra-restraints
write-interpolated-models-and-extra-restraints: write-interpolated-models-and-extra-restraints
write-pdb-file: write-pdb-file
write-reduce-het-dict: generic-objects
write-refmac-parallel-plane-restraint: user-define-restraints
write-residue-range-to-pdb-file: write-residue-range-to-pdb-file
write-restraints-cif-dictionary: write-restraints-cif-dictionary
write-sequence: write-sequence
write-shelx-ins-file: write-shelx-ins-file

Z
zalman-stereo-mode: zalman-stereo-mode
zoom-factor: zoom-factor

Jump to:   %   *   3  
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   Z  

Footnotes

(1)

The official CCP4 graphics program (which contains parts of Coot (and Coot contains parts of CCP4MG)), CCP4MG is under the direct control of Liz Potterton and Stuart McNicholas.

(2)

although it does have a local refinement algorithm it is no substitute for refmac (a wrapper for refmac is available).

(3)

that’s the job of the CCP4 Program Suite.

(4)

it’s Free Software after all and I could give you a hand.

(5)

I can get by with a one button Macintosh - but it’s not ideal.

(6)

as it is known in Clipper.

(7)

coot has several influences and dependencies, but these will not be discussed here in the User Manual.

(8)

COOT_BACKUP_DIR is used in preference if set

(9)

The map-reading problem (documented in Section Maps in General) is already known.

(10)

now there’s a hostage to fortune.

(11)

to do so, please send me the output of the following: $ gdb `which coot-real` corefile and then at the (gdb) prompt type: where, where corefile is the core dump file, core or core.4536 or some such.

(12)

See also more on zooming

(13)

Mouse movement in “Spherical Surface” mode generates a component of (often undesirable) screen z-rotation, particularly noticeable when the mouse is at the edge of the screen.

(14)

(vt-surface 0) to turn it back to “Spherical” mode.

(15)

this is off by default because I find it annoying.

(16)

Put your mouse over a widget for a couple of seconds, if that widget has a tooltip, it will pop-up in a yellow box (or a grey box for some reason if you are using Macintosh).

(17)

that works for me, at least.

(18)

Povray support is only semi-working, there is a problem with the orientation of the image.

(19)

to a limited extent.

(20)

the substantial majority of the time you will want your the buttons to be both either depressed or undepressed, rarely one but not the other.

(21)

British modelling, of course

(22)

which causes the evaluation of the command.

(23)

such as the Coot state file (Section Coot State).

(24)

in that particular directory.

(25)

funny that

(26)

this might be initially surprising since this could chew up a lot of disk space. However, disk space is cheap compared to losing you molecule.

(27)

The coordinates are written in pdb format - that’s OK, isn’t it?.

(28)

unless you tell it not to, of course - use (e.g.) (turn-off-backup 0) to turn off the backup (for molecule 0 in this case).

(29)

or system manager.

(30)

It works like the “Forwards” buttons in a web browser - which is not available immediately after viewing a new page.

(31)

for example, if coot crashes.

(32)

if no space group has been assigned it returns ``No spacegroup for this molecule''

(33)

I find a clipping level of about 3.5 to 4 comfortable for viewing electron density maps - it is a little “thinner” than the default startup thickness.

(34)

Inspired by PyMol? Yep… sure was!

(35)

and C again to toggle them off.

(36)

compared to some other one.

(37)

prompted by changing the contour level.

(38)

i.e. the terminal in which you started Coot.

(39)

Hue Saturation Value (Intensity).

(40)

they can be redisplayed using (set-draw-hydrogens mol-no 1).

(41)

the reference chain is, by default, the first chain of that type in the coordinates file. The reference (master) chain can be changed using the NCS Ghosts Control dialog.

(42)

that also only makes sense in the region of the reference chain.

(43)

OCA is “goose” in Spanish (and Italian)

(44)

the default is the Weizmann Institute - which for reasons I won’t go into here is currently much faster than the EBI server.

(45)

which (currently) only a fraction are.

(46)

using thermal ellipsoids

(47)

in the case of isotropic atoms, ellipsoids are spherical, of course.

(48)

symmetry labels are in pale blue/purple and also provide the symmetry operator number and the translations along the a, b and c axes.

(49)

contacts involving two hydrogens or at least one carbon atom are yellow, denoting ’bump’. Hydrogen contacts display cut-off are based on the user-defined maximum distance, but shortened by 0.5Å per hydrogen atom.

(50)

Use Angle for an angle, of course.

(51)

e.g. this molecule was a map or a closed molecule.

(52)

the same one as in the CCP4 program SUPERPOSE

(53)

given a half-decent window manager

(54)

Diamond, R. (1971). A Real-Space Refinement Procedure for Proteins. Acta Crystallographica A27, 436-452.

(55)

but the resulting \chi^2 values are higher.

(56)

And a few extras, such as phosphate

(57)

unless you are using Buccaneer, of course

(58)

if you want to move only one residue, then click the same atom twice.

(59)

like Refinement and Regularization

(60)

like Regularization and Refinement.

(61)

T. J. Oldfield & R. E. Hubbard (1994). “Analysis of C\alpha Geometry in Protein Structures” Proteins-Structure Function and Genetics 18(4) 324 – 337.

(62)

which is quite likely at first since coot has no knowledge of where the chain has been and cannot score according to geometric criteria.

(63)

“b” again toggles the mode off.

(64)

high-resolution map interpretation is planned.

(65)

i.e. one less than the starting residue in the forward direction (defaults to 1).

(66)

R. M. Esnouf “Polyalanine Reconstruction from C\alpha Positions Using the Program CALPHA Can Aid Initial Phasing of Data by Molecular Replacement Procedures” Acta Cryst. , D53, 666-672 (1997).

(67)

T.A. Jones & S. Thirup “Using known substructures in protein model building and crystallography” EMBO J. 5, 819–822 (1986).

(68)

and high resolution

(69)

i.e. there are severely misplaced atoms

(70)

as for Rotate/Translate Zone (Section Rotate/Translate Zone).

(71)

since version 0.4

(72)

SC Lovell, JM Word, JS Richardson and DC Richardson (2000) "The Penultimate Rotamer Library" Proteins: Structure Function and Genetics 40: 389-408. You can get the paper from http://kinemage.biochem.duke.edu/databases/rotamer.php

(73)

"The Backrub Motion: How Protein Backbone Shrugs When a Sidechain Dances" Structure, Volume 14, Issue 2, Pages 265-274 I. Davis, W. Bryan Arendall III, D. Richardson, J. Richardson

(74)

for example, in preparation of a model for molecular replacement

(75)

atoms of residues that are too close to each other

(76)

that’s “zero”.

(77)

Note that selecting a residue type that matches the residue in the graphics will also result in a mutation

(78)

i.e. the current residue type matches the residue type to which you wish to mutate the residue

(79)

e.g. after using Ca -> Mainchain.

(80)

i.e. the residue atoms will remain untouched

(81)

this is a wrapper round LIBCHECK, so you must have CCP4 suite to installed for this function to work

(82)

rather than running LIBCHECK again

(83)

you can search for many different ligand types.

(84)

usually if this still fails after two repetitions then it never seems to work.

(85)

The map is selected using “Refine/Regularize Control”

(86)

e.g. (add-OXT-to-residue 0 428 "" "A")

(87)

including sulfate or phosphate ions (in such a case, it is probably useful to do a “Rigid Body Fit Zone” on that new residue).

(88)

For example, after a ligand search has been performed.

(89)

i.e. Coot is idle and ignores all input.

(90)

This is not an ideal feature, of course and will be addressed in future.... Digressive Musing: If only computers were fast enough to run Refmac interactively…

(91)

such that Coot would subsequently expect an atom selection “pick” in the graphics window.

(92)

the current single function doesn’t always perform very well in tests

(93)

R.W.W. Hooft, G. Vriend, C. Sander, E.E. Abola, Errors in protein structures. Nature (1996) 381, 272-272.

(94)

e.g. it’s a directory or a coordinate filename.

(95)

like I don’t on my Mac.

(96)

actually, it’s a box.

(97)

in a coot difference map you will get to see the negative level contoured at the inverted level of the positive level, what I mean is that you don’t want to see the “positive” level going less than 0.

(98)

takes you right back to the good old Frodo days, no?

(99)

Jan Dohnalek, for instance.

(100)

a value of 2.5 is often sufficient.

(101)

If you’re living in Sweden... or Captain Kirk, that is.

(102)

you may think it strange that a box has a radius, this is an idiosyncrasy of Coot.

(103)

or set their occupancy to zero

(104)

the not-GLY-or-PRO is the most familiar Ramachandran plot.

(105)

prolines have a grey outline rather than a black one, triangles are glycines.

(106)

but that’s partly the idea, I suppose.

(107)

and therefore most interesting

(108)

or the water should be more properly modelled as anistrotropic or a split partial site

(109)

and remember to check the difference map button in the “Run Refmac” dialog