Coot: Difference between revisions

Jump to navigation Jump to search
1,189 bytes added ,  19 June 2020
m
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Image:Coot-with-ATP-vector.png|400px|thumb|right]]
[[Image:Coot-with-ATP-vector.png|25%|thumb|right]]
Coot is a graphics program for building, refining and analysing macromolecular models obtained with crystallographic procedures.
Coot is a graphics program for building, refining and analysing macromolecular models obtained with crystallographic procedures.


Line 12: Line 12:


==Installing Coot on Windows==
==Installing Coot on Windows==
Please refer to the [http://www.ysbl.york.ac.uk/~lohkamp/coot/wincoot-download.html WinCoot install and download] page.
Please refer to [https://github.com/bernhardcl/coot/releases Bernhard Lohkamp's WinCoot download] page.


==Installing Coot on Linux==
==Installing Coot on Linux==
Line 21: Line 21:
This is the recommended way for those who do not want to delve into the mysteries of compiling and linking a great but complex piece of software. Read the (somewhat outdated, it seems) [http://www.ysbl.york.ac.uk/%7Eemsley/coot/coot-faq.html Coot FAQ] to find "Additional Notes" for your operating system.
This is the recommended way for those who do not want to delve into the mysteries of compiling and linking a great but complex piece of software. Read the (somewhat outdated, it seems) [http://www.ysbl.york.ac.uk/%7Eemsley/coot/coot-faq.html Coot FAQ] to find "Additional Notes" for your operating system.


In short, just go to http://www.ysbl.york.ac.uk/~emsley/software/binaries/nightlies/pre-release/ (a mirror is at ftp://turn5.biologie.uni-konstanz.de/coot/software/binaries/nightlies/pre-release/ ) and pick a suitable binary, e.g.
In short, just go to http://www.ysbl.york.ac.uk/~emsley/software/binaries/nightlies/pre-release/ and pick a suitable binary, e.g.
coot-0.5-pre-1-revision-1003-binary-Linux-i386-fedora-5.tar.gz for a Red Hat Enterprise Linux 5 or CentOS-5 system (Fedora 6 corresponds to RHEL5, thus Fedora 5 binaries are OK). If you prefer a "stable" binary, these are at http://www.ysbl.york.ac.uk/~emsley/software/binaries/stable/.
coot-0.5-pre-1-revision-1003-binary-Linux-i386-fedora-5.tar.gz for a Red Hat Enterprise Linux 5 or CentOS-5 system (Fedora 6 corresponds to RHEL5, thus Fedora 5 binaries are OK). If you prefer a "stable" binary, these are at http://www.ysbl.york.ac.uk/~emsley/software/binaries/stable/.


Line 32: Line 32:
==== Example: installing a 64bit nightly CentOS5 binary build on 64bit SL6.1 ====
==== Example: installing a 64bit nightly CentOS5 binary build on 64bit SL6.1 ====
First of all, SL (Scientific Linux) is a derivative of RHEL, as is CentOS. So all three OSs behave exactly the same.
First of all, SL (Scientific Linux) is a derivative of RHEL, as is CentOS. So all three OSs behave exactly the same.
The binaries with "x86_64" binaries are for 64bit systems; the "i386" binaries are for 32bit systems. Since my notebook is 64bits ("uname -a" reports "x86_64" more than once), I download ftp://turn5.biologie.uni-konstanz.de/coot/software/binaries/nightlies/pre-release/coot-0.7-pre-1-revision-3999-binary-Linux-x86_64-centos-5-python-gtk2.tar.gz (the main server is slow, so I use the mirror). As root, I "cd /usr/local/src" and un-tar. Next, have to find out which libraries are missing. This can be achieved by (''note the use of LD_LIBRARY_PATH in the second command - do not permanently modify LD_LIBRARY_PATH !''):
The binaries with "x86_64" binaries are for 64bit systems; the "i386" binaries are for 32bit systems. Since my notebook is 64bits ("uname -a" reports "x86_64" more than once), I download coot-0.7-pre-1-revision-3999-binary-Linux-x86_64-centos-5-python-gtk2.tar.gz. As root, I "cd /usr/local/src" and un-tar. Next, have to find out which libraries are missing. This can be achieved by (''note the use of LD_LIBRARY_PATH in the second command - do not permanently modify LD_LIBRARY_PATH !''):
  [root@localhost]# cd coot-Linux-x86_64-centos-5-gtk2-python
  [root@localhost]# cd coot-Linux-x86_64-centos-5-gtk2-python
  [root@localhost]# LD_LIBRARY_PATH=lib ldd bin/coot-real | grep found  
  [root@localhost]# LD_LIBRARY_PATH=lib ldd bin/coot-real | grep found  
Line 75: Line 75:
and make it executable with  
and make it executable with  
  chmod a+x /usr/local/bin/coot
  chmod a+x /usr/local/bin/coot
=== Installation on Debian/Ubuntu from debian archive files ===
As an alternative, you might wish to exploit the debain dpkg/apt/synaptic package management system on Ubuntu and other Debian linux distributions using (unofficial)
[http://diablo.ucsc.edu/~wgscott/debian/coot_hardy/  pre-compiled debian packages for coot and its dependencies]. (These will be discontinued when official packages become available.)
To do so, simply download the deb files and install with the command
sudo dpkg -i *.deb
dpkg will complain if a dependency is missing rather than install a broken program.
=== Packages for Ubuntu ===
A pre-packaged version of Coot (0.7-pre-1) for Ubuntu is available from mok0's Personal Package Archive (PPA) on Launchpad. Currently, packages for Ubuntu 10.04 (Lucid) and 10.10 (Maverick) are available.
To install the coot package on your system, you first need to install the public key for mok0's PPA:
  sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1DC81A57
Next, add the PPA repository to your /etc/apt/sources.list file:
  sudo add-apt-repository ppa:mok0/ppa
That's it! Now, you should be able to:
  apt-get update && apt-get install coot
This version of Coot only supports the Python scripting language.
=== Mandriva Installation ===
To install the coot on Mandriva 2010.0 use the ubuntu distribution:
tar zxf coot-0.6.2-binary-Linux-i686-ubuntu-8.04.1-python-gtk2.tar.gz
in the .cshrc file:
alias coot  'source /prog/CCP4/ccp4-6.1.13/include/ccp4.setup-csh ; /prog/coot-Linux-i686-ubuntu-8.04.1-gtk2-python/bin/coot'
=== Converting to rpm packages ===
You can convert any debian package file into an rpm file using the program ''alien''.  I have done this and have made the [http://diablo.ucsc.edu/~wgscott/debian/rpm/coot/ resulting packages] available.


=== Installation from source code via autobuild scripts ===
=== Installation from source code via autobuild scripts ===
Line 148: Line 108:
===Controls===
===Controls===


[[Image:Coot-controls-small.png|200px]]
[[Image:Coot-controls-small.png]]




Line 166: Line 126:


[[Image:a_zalman_zm_m220w__2d_35_pic.jpg|150px|thumb|right|3d lcd]]
[[Image:a_zalman_zm_m220w__2d_35_pic.jpg|150px|thumb|right|3d lcd]]
Control stereo separation / depth in coot 0.9: the transformation between the eyes is no longer a rotation and is now a shear. Which means that now we don't get part of the map showing up in the left eye but not the right (or vice versa).
This is documented in Section 3.4.1, e.g.
set_hardware_stereo_angle_factor(0.5) # for the Python fans
Hardware stereo failure: try the line
(set-display-lists-for-maps 0)
in ~/.coot for coot 0.9 - see https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind2002&L=COOT&P=R312 and https://www.jiscmail.ac.uk/cgi-bin/wa-jisc.exe?A2=COOT;49fa8d15.2006


==== Zalman Stereo ====
==== Zalman Stereo ====
Line 190: Line 161:


===External Links===
===External Links===
====[http://www.ysbl.york.ac.uk/~emsley/coot/doc/user-manual.html On-line User Manual]====
====[https://www2.mrc-lmb.cam.ac.uk/personal/pemsley/coot/web/docs/coot.html On-line User Manual]====
====[http://www.ysbl.york.ac.uk/~emsley/coot/ Coot's home page]====
====[https://www2.mrc-lmb.cam.ac.uk/personal/pemsley/coot/ Coot's home page]====
====[http://www.mail-archive.com/coot@jiscmail.ac.uk/ Current mailing list archives]====
====[http://www.mail-archive.com/coot@jiscmail.ac.uk/ Current mailing list archives]====
====[http://www.ysbl.york.ac.uk/~emsley/coot/mbox/ Mailing list archives: (no longer) current]====
====[http://www.ysbl.york.ac.uk/~emsley/coot/mbox-2004-2005/ Mailing list archives: 2004-05]====


==Scheme Scripts==
==Scheme Scripts==
Line 364: Line 331:


[[morph_residues_gui.py]]
[[morph_residues_gui.py]]
===Example 5: Ensemble GUI===
GUI to allow navigation through structural ensembles as obtained e.g. from ensemble refinement:
[[ensemble_plugin.py]]


==Python to Scheme and return==
==Python to Scheme and return==
Line 449: Line 422:
Q: Is it possible to deactivate the nomenclature errors check? Sometimes this check is not very useful and it becomes rather annoying when one has several molecules loaded only wants to look at the structures...
Q: Is it possible to deactivate the nomenclature errors check? Sometimes this check is not very useful and it becomes rather annoying when one has several molecules loaded only wants to look at the structures...


A: Add to your ~/.coot or whatever:
A: The [https://www2.mrc-lmb.cam.ac.uk/personal/pemsley/coot/web/docs/coot.html#set_002dnomenclature_002derrors_002don_002dread Coot manual] should help: Add to your ~/.coot or whatever:
  (set-nomenclature-errors-on-read "ignore")
  (set-nomenclature-errors-on-read "ignore")
 
In case you are using the python file, e.g. “.coot.py”, I think you have to change this to “set_nomenclature_errors_on_read ignore”.


==NCS edits==  
==NCS edits==  
Line 483: Line 456:


A: Well, it's hard to know what's the problem without details - the console should say something. But when handling the output of shelxl, I suggest you read the .res file rather than the pdb, then the subsequent .ins file contains lots of "header" information.
A: Well, it's hard to know what's the problem without details - the console should say something. But when handling the output of shelxl, I suggest you read the .res file rather than the pdb, then the subsequent .ins file contains lots of "header" information.
Another answer to questions 1+2 is to rename the hydrogen atoms in the shelxl res-file to match the mmCIF dictionaries used by Coot. This only needs to be done once as shelxl does not modify these names. Except for a few manual editions, the renaming can be done semi-automatically using regular expressions (replacing A->1, B->2, etc).
Concerning question 3, the Coot -> Extensions -> Module -> SHELXL menu entry works really well now. It reads in all relevant shelxl files and provides a menu highlighting the problematic areas in the model.


==Image quality on NVidia cards==
==Image quality on NVidia cards==
Line 554: Line 531:
A: there are 2 loop fitting tools in Coot
A: there are 2 loop fitting tools in Coot


# C alpha -> Mainchain [http://lmb.bioch.ox.ac.uk/coot/doc/coot.html#C_002dalpha-_002d_003e-Mainchain],[http://lmb.bioch.ox.ac.uk/coot/doc/coot.html#Building-Links-and-Loops]
# C alpha -> Mainchain [http://www2.mrc-lmb.cam.ac.uk/personal/pemsley/coot/web/docs/coot.html#C_002dalpha-_002d_003e-Mainchain],[http://www2.mrc-lmb.cam.ac.uk/personal/pemsley/coot/web/docs/coot.html#Building-Links-and-Loops]
# DB Loop: (No good documentation) [http://lmb.bioch.ox.ac.uk/coot/doc/coot/protein_002ddb_002dloops.html#protein_002ddb_002dloops] Extensions -> Modelling -> DB Loop...  
# DB Loop: (No good documentation) [http://www2.mrc-lmb.cam.ac.uk/personal/pemsley/coot/web/docs/coot.html#protein_002ddb_002dloops] Extensions -> Modelling -> DB Loop...


==LSQ superpositions==
==LSQ superpositions==
Line 696: Line 673:


A: It used to be 0.167, I think.
A: It used to be 0.167, I think.
== Molprobity not active in COOT ==
Q: I am using COOT 0.8.1 EL that comes with the CCP4 6.5.010 on my Mac OS X 10.10.2. I wanted to run molprobity but the Validate > Probe clashes button in my pull down menu is not active. Is this function available in this COOT version?
A: Reduce and probe are separate programs available from the Richardson’s lab at Duke http://kinemage.biochem.duke.edu/. Download and install on your box. Then coot needs to be told in some instances where it can find these executables. I have the following lines in my ~/.coot file in Linux.
<pre>
;; .coot
;; This file is required. As of coot 0.8pre no other mechanism for
;; enabling probe in coot works
;;
;; This is full pathname of molprobity's probe program
(define *probe-command* "/apps/xray/bin/probe")
;; This is full pathname of molprobity's reduce program
(define *reduce-command* "/apps/xray/bin/reduce")
</pre>
Untried: if you have Phenix installed: it comes with phenix.probe and phenix.reduce - you could insert the paths to these binaries into the above definitions.
== some symmetry mates not shown ==
Q: This structure has been solved and refined using phenix in the hexagonal setting of space group R 3. There is one copy per asymmetric unit in R 3. As you can see from the attached image, coot is rendering some but not all of the symmetry mates.
A: Turn up the radius a bit and use (set-symmetry-shift-search-size 3) . I would have thought that 2 is big enough, but maybe not in this case.
== specify Coot download directory, like specifying backup dir by COOT_BACKUP_DIR? ==
here is my working startup.py (of course replace src folder with your preferred location):
import os
try:
    os.symlink('/ccp4/xray/tmp/', 'coot-download')
except:
    pass
(Eugene Osipov on 22/04/2020 14:43)
1,328

edits

Cookies help us deliver our services. By using our services, you agree to our use of cookies.

Navigation menu