This is a read-only mirror of pymolwiki.org
Difference between revisions of "Git install scripts"
m (→For Linux users: changed the output path (deleted /Software/pymol)) |
m (1 revision) |
(No difference)
|
Revision as of 02:16, 28 March 2014
Manual download of scripts
If you don't have the option or want't to install git on your system, then go to
https://github.com/Pymol-Scripts/Pymol-script-repo
Click the "ZIP" button, near the top left corner. Now unpack the files to a directory. For example:
C:/Users/YOURNAME/Pymol-script-repo /home/YOURNAME/Pymol-script-repo
Now go to: Adding Pymol-script-repo to PyMOL search path [1]
Git install instructions
For Windows users
- Install Git for Windows.
Use following settings in options, (You can read more here).
- Windows Explorer Integration -> Context Menu Entries -> Git Bash Here + Git GUI here
- Run Git and included Unix tools from Windows Command prompts
- Checkout Windows style, commit Unix-style endings
- Navigate to: C:\Users\YOURNAME
- Right click in folder -> Select: Git Gui -> Clone Existing Repository
- Source Location: git://github.com/Pymol-Scripts/Pymol-script-repo.git
- Target Directory: C:\\Users\\YOURNAME\\Pymol-script-repo
- A backslash "\" in a string is is used for escape sequences. To get a real backslash in a string, use double backslash "\\"
You now have all the scripts available in your directory.
For Linux users
- Install git
# Debian/Ubuntu/Mint sudo apt-get install git # Fedora su -c 'yum install git' # openSUSE sudo zypper in git
- Navigate to desired folder:
cd /home/YOURNAME/ git clone git://github.com/Pymol-Scripts/Pymol-script-repo.git
You now have all the scripts available in: /home/YOURNAME/Pymol-script-repo
Adding Pymol-script-repo to PyMOL search path
You now have to add the "Pymol-script-repo" directory to the PyMOL search path.
PyMOL has since revision 3997 (30 April 2012) an improved plugin/script manager. You have to remove old installations of plugins first, to get the automatic plugin installation to work.
Making a personal "pymolrc" file - for personal use
- Open notepad/gedit and save under:
- Win: C:\Users\YOURNAME\pymolrc.pym (Set: "Save as type" to "All files")
- Linux: ~/.pymolrc
# Add paths to sys.path so PyMOL can find modules and scripts
import sys, os
pymol_git = os.path.abspath(os.path.join(os.path.expanduser('~'), 'Pymol-script-repo'))
os.environ['PYMOL_GIT_MOD'] = os.path.join(pymol_git,'modules')
sys.path.append(pymol_git)
sys.path.append(os.environ['PYMOL_GIT_MOD'])
# Make starting directory and change to it.
home_dir = os.path.abspath(os.path.join(os.path.expanduser('~'), 'pymol'))
if not os.path.exists(home_dir): os.makedirs(home_dir)
os.chdir(home_dir)
Then open PyMOL. Go to top menu: Plugin->Plugin Manager
- Installed plugins: Unclick "apbs_tools" as "load on startup". (The Pymol-script-repo has a fine-tuned version, "apbsplugin")
- Settings->Add new directory: Point to: /custom/path/Pymol-script-repo/plugins
- Restart PyMOL
Making a general "run_on_startup.py" - for all users
If you have a shared PyMOL installation for several linux computers, you can make general wide changes for the startup of PyMOL.
First locate your PYMOL_PATH. Start PyMOL, and write:
import os print os.environ['PYMOL_PATH']
In this folder, you place "run_on_startup.py" and the Pymol-script-repo directory.
Write in "run_on_startup.py" :
# Add paths to sys.path so PyMOL can find modules and scripts
import sys, os
pymol_git = os.path.abspath(os.path.join(os.environ['PYMOL_PATH'], 'Pymol-script-repo'))
os.environ['PYMOL_GIT_MOD'] = os.path.join(pymol_git,'modules')
sys.path.append(pymol_git)
sys.path.append(os.environ['PYMOL_GIT_MOD'])
# Make starting directory and change to it.
home_dir = os.path.abspath(os.path.join(os.path.expanduser('~'), 'pymol'))
if not os.path.exists(home_dir): os.makedirs(home_dir)
os.chdir(home_dir)
# Make setting changes to Plugin Manager
import pymol.plugins
pymol.plugins.preferences = {'instantsave': False, 'verbose': False}
pymol.plugins.autoload = {'apbs_tools': False}
pymol.plugins.set_startup_path([os.path.join(pymol_git, 'plugins'), os.path.join(sys.prefix, 'Lib', 'site-packages', 'pmg_tk', 'startup')])
pymol.plugins.preferences = {'instantsave': True, 'verbose': False}
Test the Scripts
Now start PyMOL, and test in PyMOL.
print sys.path import colorbydisplacement help(colorbydisplacement)
Get latest changes to scripts
If new scripts are available or changes have been made, then:
For windows users
- Navigate to C:\Users\YOURNAME\Pymol-script-repo
- Right click in folder -> Select: Git Bash
- Write in terminal
git pull origin master
For Ubuntu/Mint users
- Navigate to /home/YOURNAME/Pymol-script-repo
- Write in terminal.
git pull origin master
Do you want to contribute with a script?
Information how to contribute scripts to the repository. It's easy!
http://www.pymolwiki.org/index.php/git_authors