vmd installation guide-共享资料网
vmd installation guide
VMD Installation GuideVersion 1.9March 9, 2011NIH Resource for Macromolecular Modeling and BioinformaticsTheoretical and Computational Biophysics Group1 Beckman Institute for Advanced Science and Technology University of Illinois at Urbana-Champaign 405 N. Mathews Urbana, IL 61801 http://www.ks.uiuc.edu/Research/vmd/DescriptionThis document describes how to install one of the precompiled releases of VMD and contains links to information on compilation of VMD from the source code release. VMD development is supported by the National Institutes of Health grant P41-RR005969.1http://www.ks.uiuc.edu/1Registering VMDVMD is made available free of charge for all interested end-users of the software (but please see the Copyright and Disclaimer notices). Please check the current VMD license agreement for details. Registration is part of our software download procedure. Once you’ve ?lled out the forms on the VMD download area and have read and agreed to the license, you are ?nished with the registration process.2Citation ReferenceThe authors request that any published work or images created using VMD include the following reference: Humphrey, W., Dalke, A. and Schulten, K., “VMD - Visual Molecular Dynamics” J. Molec. Graphics , 33-38. VMD has been developed by the Theoretical and Computational Biophysics Group at the Beckman Institute for Advanced Science and Technology of the University of Illinois at UrbanaChampaign. This work is supported by the National Institutes of Health under grant number P41-RR005969.3AcknowledgmentsThe authors would particularly like to thank those individuals who have contributed suggestions and improvements, particularly those contributing new features. Special thanks go to Anton Arkhipov, Andrew Dalke, Michael Bach, Alexander Balae?, Ilya Balabin, Robert Brunner, Eamon Caddigan, Jordi Cohen, Simon Cross, Markus Dittrich, John Eargle, Peter Freddolino, Todd Furlong, Luis Gracia, Paul Grayson, Justin Gullingsrud, James Gumbart, David Hardy, Konrad Hinsen, Barry Isralewitz, Sergei Izrailev, Robert Johnson, Axel Kohlmeyer, Michell Kuttel, John Mongan, Jim Phillips, Jan Saam, Alexander Spaar, Charles Schwieters, Marcos Sotomayor, John E. Stone, Leonardo Trabuco, Dan Wright, and Kirby Vandivort. The entire VMD user community now bene?ts from your contributions. The authors would like to thank individuals who have indirectly helped with development by making suggestions, pushing for new features, and trying out buggy code. Thanks go to Aleksei Aksimentiev, Daniel Barsky, Axel Berg, Tom Bishop, Robert Brunner, Ivo Hofacker, Mu Gao, James Gumbart, Xiche Hu, Tim Isgro, Dorina Kosztin, Ioan Kosztin, Joe Landman, Ilya Logunov, Clare Macrae, Amy Shih, Lukasz Salwinski, Stephen Searle, Charles Schwieters, Ari Shinozaki, Svilen Tzonev, Emad Tajkhorshid, Michael Tiemann, Elizabeth Villa, Raymond de Vries, Simon War?eld Willy Wriggers, Dong Xu, and Feng Zhou. Many external libraries and packages are used in VMD, and the program would not be as capable without them. The authors of VMDwish to thank the authors of FLTK; the authors of Tcl and Tk; the authors of P the authors of VRPN; Jon Leech for uniform Amitabh Varshney for SURF; Dmitrij Frishman for developing STRIDE; Jack Lund for the Brad Grantham for the ACTC triangle c John E. Stone for the Tachyon ray tracer, WorkForce threading and timer routines, hash table code, and S and Ethan Merrit for one of the ribbon drawing algorithms.24Copyright and Disclaimer NoticesVMD is Copyright c
Theoretical and Computational Biophysics Group and the Board of Trustees of the University of IllinoisPortions of this code are copyright c
Andrew Dalke. The terms for using, copying, modifying, and distributing VMD are speci?ed by the VMD License. The license agreement is distributed with VMD in the ?le LICENSE. If for any reason you do not have this ?le in your distribution, it can be downloaded from: http://www.ks.uiuc.edu/Research/vmd/current/LICENSE.html Some of the code and executables used by VMD have their own usage restrictions: ? ACTC ACTC, the triangle consolidation library used in some versions of VMD, is Copyright (C) 2000, Brad Grantham and Applied Conjecture, all rights reserved. Redistribution and use in source and binary forms, with or without modi?cation, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgment: This product includes software developed by Brad Grantham and Applied Conjecture. 4. Neither the name Brad Grantham nor Applied Conjecture may be used to endorse or promote products derived from this software without speci?c prior written permission. 5. Noti?cation must be made to Brad Grantham about inclusion of this software in a product including the author of the product and the name and purpose of the product. Noti?cation can be made using email to Brad Grantham’s current address (grantham@plunk.org as of September 20th, 2000) or current U.S. mail address. ? Python Python is made available subject to the terms and conditions in CNRI’s License Agreement. This Agreement together with Python may be obtained from a proxy server on the Internet using the following URL: http://hdl.handle.net/2 ? PCRE The Perl Compatible Regular Expressions (PCRE) library used in VMD was written by Philip Hazel and is Copyright (c)
University of Cambridge. Permission is granted to anyone to use this software for any purpose on any computer system, and to redistribute it freely, subject to the following restrictions: 1. This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 2. The origin of this software must not be misrepresented, either by explicit claim or by omission. 33. Altered versions must be plainly marked as such, and must not be misrepresented as being the original software. 4. If PCRE is embedded in any software that is released under the GNU General Purpose License (GPL), then the terms of that license shall supersede any condition above with which it is incompatible. ? STRIDE STRIDE, the program used for secondary structure calculation, is free to both academic and commercial sites provided that STRIDE will not be a part of a package sold for money. The use of STRIDE in commercial packages is not allowed without a prior written commercial license agreement. See http://www.embl-heidelberg.de/argos/stride/stride info.html ? SURF The source code for SURF is copyrighted by the original author, Amitabh Varshney, and the University of North Carolina at Chapel Hill. Permission to use, copy, modify, and distribute this software and its documentation for educational, research, and non-pro?t purposes is hereby granted, provided this notice, all the source ?les, and the name(s) of the original author(s) appear in all such copies. BECAUSE THE CODE IS PROVIDED FREE OF CHARGE, IT IS PROVIDED ”AS IS” AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED. This software was developed and is made available for public use with the support of the National Institutes of Health, National Center for Research Resources under grant RR02170. ? Tachyon The Tachyon multiprocessor ray tracing system and derivative code built into VMD is Copyright (c)
by John E. Stone. See the Tachyon distribution for redistribution and licensing information. ? Desmond and Maestro plugins by D. E. Shaw Research Copyright 2009, D. E. Shaw Research, LLC All rights reserved. Redistribution and use in source and binary forms, with or without modi?cation, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of D. E. Shaw Research, LLC nor the names of its contributors may be used to endorse or promote products derived from this software without speci?c prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ”AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 4HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.55Obtaining VMD Source and Binary DistributionsThe VMD source code and binary distributions can be obtained after registering at the VMD web page. Download the appropriate distribution ?le with your web browser. Windows binary distributions are self extracting, so once the distribution ?le is downloaded, proceed to the installation directions below. For source distributions and Unix binary distributions, uncompress and untar the ?le. This will produce a subdirectory named vmd-1.9. Unless otherwise speci?ed, all references to VMD code will be from this subdirectory, so cd there.6Installing a Pre-Compiled Version of VMDTo install the pre-compiled Windows version of VMD, simply run the self-extracting executable, and it will start the VMD Windows installer program, which includes built-in help. This process is automated and should be familiar to most Windows users. When installing VMD be sure that you have administrator privileges. To install the pre-compiled MacOS X bundle version of VMD, open the VMD disk image and drag the VMD application into an appropriate directory. Once the VMD application has been placed appropriately it should be ready for immediate use as no other installation steps are required. To install the pre-compiled Unix version of VMD, then only three steps remain to be done after you uncompress and untar the distribution. ? Edit the configure script. If necessary, change the following values: $install_bin_dir This is the location of the startup script ’vmd’. It should be located in the path of users interested in running VMD. $install_library_dir This is the location of all other VMD files. This includes the binary and helper scripts. It should not be in the path. ? Next generate the Make?le based on these con?guration variables. This is done by running ./configure . ? After con?guration is complete, cd to the src directory and type make install. This will put the code in the two directories listed above. After this, you just type vmd to begin, provided that vmd is in your path.7Customizing VMD StartupThe Unix version of VMD reads in several data ?les (if they exist) when it starts up. These ?les control the initial appearance and behavior of VMD at the start, and may be customized to 6suit each users particular tastes. Default versions of these ?les are placed in the INSTALLLIBDIR directory (usually /usr/local/lib/vmd). While each user may specify to use di?erent versions of these ?les, unless this is done the commands and values in the default ?les are used. In this way, an administrator may customize the default behavior of VMD for all users, while allowing each user the option to change the default behavior however they choose. This chapter describes each of these data ?les. Several con?gurable parameters may also be set in a number of ways, including by commandline options or by environment variables. The order of precedence of these methods is as follows (highest precedence to lowest): 1. Command-line options (see the Users Guide). 2. Environment variable settings (see the Users Guide). 3. Built-in defaults, as speci?ed by compilation con?gurable parameters. These are used only if no other values are speci?ed by the other methods mentioned in this list.8The .vmdrc and vmd.rc ?lesAfter initialization is complete, VMD reads the startup ?le. This ?le contains text commands for VMD to execute, just as if they had been entered at the VMD text console command prompt. The ?le can contain any number of commands, including blank lines and comment lines (which begin with the # character). If an error is encountered while reading this ?le, the command in error is skipped and processing of the ?le continues. The base ?lename for this startup ?le is .vmdrc by default on Unix systems and vmd.rc on W this is determined by the con?guration parameter STARTUPFILENAME. VMD searches for this ?le in a number of locations, and reads in the ?rst version of the ?le it ?nds. The order of searching for the ?le is: 1. ./STARTUPFILENAME 2. $HOME/STARTUPFILENAME 3. INSTALLLIBDIR/STARTUPFILENAME See the Users Guide for a list of all VMD text commands.9The .vmdsensors ?leIf VMD is compiled with the VRPN option, it will look for ?les that specify how to access the external spatial tracking devices. These ?les are read whenever VMD is told to initialize a speci?c external device. The Tracker library will load the ?rst ?le it ?nds in the following search order: 1. $HOME/.vmdsensors 2. The $VMDSENSOR environment variable. 3. INSTALLLIBDIR/.vmdsensors This last ?le (INSTALLLIBDIR/.vmdsensors) contains extensive comments on how to con?gure the sensor description ?les properly. If the VRPN option is omitted when compiling VMD, this ?le is not used. 710What to Do If It Doesn’t WorkIf you are running a VMD binary which has been built with a native OpenGL implementation (i.e. not Mesa), you should make sure that you have the vendor provided OpenGL runtime libraries and the X server extensions correctly installed. SGI systems normally have the OpenGL runtime support installed on them. Sun, HP, and IBM systems often do not come with OpenGL support by default. If you don’t have the OpenGL runtime libraries for these systems, they can be downloaded for free from the Sun, HP, and IBM web sites respectively. Each of the vendor’s OpenGL implementations generally include ”install check” programs which verify the correct installation and operation of the OpenGL libraries. ? Sun’s OpenGL site is at /software/graphics/opengl/ ? HP’s OpenGL site is at /unixwork/products/opengl.html ? IBM’s OpenGL site is at http://www./software/OpenGL/ We suggest that you check that you are doing everything correctly, and if it still doesn’t work, report the problem by e-mail to vmd@ks.uiuc.edu. We’ll try to help you.11Compiling Your Own Version of VMDIf for some reason you want to recompile VMD, then you will need to read the rest of this document. Most users will want to use the binary distributions we provide since they have been thorougly tested prior to release. It may be necessary for you to compile your own version of VMD in cases where we do not provide a binary for your platform, or when the provided binaries will not run correctly with a particular version of your operating system. Full compilation instructions for VMD are found in the online VMD Programmer’s Guide: http://www.ks.uiuc.edu/Research/vmd/doxygen/8