Difference between revisions of "Windows Install"

From PyMOLWiki
Jump to navigation Jump to search
m (download link)
(42 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Installation|Windows]]
+
This page describes how to install PyMOL on Microsoft Windows.
  
== Problems & Solutions ==
+
== Incentive PyMOL ==
  
===Problem: Installing PyMol 0.98 on WinXP Pro SP2===
+
[http://www.schrodinger.com Schrödinger] provides an installer to paying sponsors (EXE for PyMOL 2.0, MSI for previous version). The bundle also includes ready-to-use [[APBS]], [[morph|RigiMOL]], an MPEG encoder for movie export, and a small molecule energy minimization engine.
If you get the following error '''while''' installing
 
<pre>
 
"16-bit Windows Subsystem.":
 
"C:\WINDOWS\SYSTEM32\AUTOEXEC.NT. The system file is not
 
suitable for running MS-DOS and Microsoft Windows applications.
 
Choose 'Close' to terminate the application.
 
</pre>
 
'''Fix''': Sounds like the '''AUTOEXEC.NT''' file is corrupt.  You can fix this problem by replacing
 
c:\WINDOWS\SYSTEM32\AUTOEXEC.NT
 
with the one in
 
c:\windows\repair
 
However if this doesn't work (or if the file is absent from this repair folder), use the file on the installation CDROM, it is
 
autoexec.nt_
 
in the '''i386''' folder.  Just type in a command window:
 
expand X:\i386\autoexec.nt_ c:\windows\system32\autoexec.nt
 
where '''X''' is the drive letter of your CDROM.
 
  
If this does not resolve your issue, visit this link:
+
Download: https://pymol.org/#download
[http://support.microsoft.com/default.aspx?scid=kb;en-us;324767 MS Support For This Issue]
 
where you may also find the answer to your question.
 
  
 +
== Open-Source PyMOL ==
  
 +
Open-Source PyMOL is available [https://sourceforge.net/p/pymol/code/HEAD/tree/trunk/pymol/LICENSE free of charge]. It also allows sponsors to create highly customized PyMOL installations which might not be possible with the MSI installer.
  
===Problem: PyMol Binary Crashes===
+
Pre-compiled Open-Source PyMOL is available free from [http://www.lfd.uci.edu/~gohlke/pythonlibs/#pymol Christoph Gohlke of the Laboratory for Fluorescence Dynamics, University of California, Irvine].
==== Video Driver ====
 
'''Fix''': Try updating your video card's driver software. This is a common problem on laptops.
 
  
==== msvcr71.dll ====
+
# Install Python 2.7 for Windows (e.g., by going to http://www.python.org/downloads/). Use the standard options (which should mean that the installation directory is C:\Python27). It may be useful if C:\Python27 is listed in your system PATH variable.
'''Fix''': find the file '''msvcr71.dll''' on your computer and copy it to the directory that PyMol was installed to.
+
# Download the [http://www.lfd.uci.edu/~gohlke/pythonlibs/#pymol appropriate wheel files], along with all requirement wheel files (including [http://www.lfd.uci.edu/~gohlke/pythonlibs/#pip pip], [http://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy Numpy] and [http://www.lfd.uci.edu/~gohlke/pythonlibs/#pmw PMW]) into a single file directory, e.g., <code>C:\PyMOL_installation</code>
 +
# From this installation directory (to get there you can run <source lang = python>cd C:\PyMOL_installation</source> from the command prompt), run:
 +
<source lang = python>C:\Python27\python.exe pip-6.x.x-py2.py3-none-any.whl/pip install --no-index --find-links="%CD%" pymol_launcher</source>
  
 +
if <code>C:\Python27</code> is part of your PATH variable, then running (where x refers to the version number of pip):
 +
<source lang = python>python pip-6.x.x-py2.py3-none-any.whl/pip install --no-index --find-links="%CD%" pymol_launcher</source>
 +
should suffice. To update PyMOL update the files in the PyMOL install directory and run:
  
 +
<source lang = python>pip install --upgrade --no-deps pymol.whl</source>
  
===Problem: Path Does Not Exist Error ===
+
where <code>pymol.whl</code> is replaced by the PyMOL wheel file name (not the launcher, the launcher should not require updating).
  
'''Install Shield Problem with some Dell Laptops'''
+
=== Extend PyMOL with additional scripts ===
 +
If you now want to extend the capabilities of PyMOL, and take advantage of all the available plugins+scripts "out there", then do the following. <br>
 +
# First install "numpy" as an available module to Python. [http://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy Select appropriate installer from here]
 +
# Download the script/plugin collection [[Git | Pymol-script-repo]] from [https://github.com/Pymol-Scripts/Pymol-script-repo/zipball/master a .zip file from here]
 +
git clone https://github.com/Pymol-Scripts/Pymol-script-repo
 +
# Unpack it to here: '''C:\Python27\Lib\site-packages\pymol\pymol_path\Pymol-script-repo'''  Double check that the folder name is correct and the same.
 +
Open "Notepad" and write.
 +
<syntaxhighlight lang="python">
 +
# 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'])
  
With this problem irrespective of where you place the binaries for installing PyMol you receive an error claiming that the path\setup.exe does not exist.
+
# 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}
 +
</syntaxhighlight>
 +
'''Then "File->Save as->All files-> C:\Python27\Lib\site-packages\pymol\pymol_path\run_on_startup.py'''
  
'''Fix''': Install the windows binary through 16-bit MS-DOS console.  
+
Now start pymol, and enjoy all the plugins available from the menu.
  
First place the PyMol setup binaries in an easy to find folder, e.g. C:\PyMol
+
'''PyMOL''' shortcut<br>
 +
Make a '''pymol''' directory in your homepath. '''mkdir %HOMEPATH%\pymol'''  Then make sure, PyMOL starts here, when you open the shortcut.<br>
 +
Make a shortcut to the .cmd file, and modify it. <br>
 +
Target: C:\python27\PyMOL\pymol.cmd <br>
 +
Start in: %HOMEPATH%\pymol
  
Use the '''RUN''' command via '''Windows Start'''.
+
== See Also ==
 
 
In the '''CLI''' type '''COMMAND.COM''' (note CMD will not work as it is a native interface and not true DOS).
 
 
 
In the '''DOS CLI''' that opens go back to the root directory '''C:\''' using the '''cd..''' command.
 
 
 
Then go to the folder into which you placed PyMol, e.g. '''cd PyMol'''.
 
 
 
Then type in '''setup.exe'''.
 
 
 
PyMol should now install, simply type '''exit''' to close the '''DOS CLI'''
 
  
 +
* [[pymolrc]]
 +
* [[Linux Install]]
 +
* [[MAC Install]]
  
 +
[[Category:Installation|Windows]]
 
[[Category:Technical Issues|Windows Install]]
 
[[Category:Technical Issues|Windows Install]]
 +
[[Category:Windows]]

Revision as of 04:02, 26 July 2018

This page describes how to install PyMOL on Microsoft Windows.

Incentive PyMOL

Schrödinger provides an installer to paying sponsors (EXE for PyMOL 2.0, MSI for previous version). The bundle also includes ready-to-use APBS, RigiMOL, an MPEG encoder for movie export, and a small molecule energy minimization engine.

Download: https://pymol.org/#download

Open-Source PyMOL

Open-Source PyMOL is available free of charge. It also allows sponsors to create highly customized PyMOL installations which might not be possible with the MSI installer.

Pre-compiled Open-Source PyMOL is available free from Christoph Gohlke of the Laboratory for Fluorescence Dynamics, University of California, Irvine.

  1. Install Python 2.7 for Windows (e.g., by going to http://www.python.org/downloads/). Use the standard options (which should mean that the installation directory is C:\Python27). It may be useful if C:\Python27 is listed in your system PATH variable.
  2. Download the appropriate wheel files, along with all requirement wheel files (including pip, Numpy and PMW) into a single file directory, e.g., C:\PyMOL_installation
  3. From this installation directory (to get there you can run
    cd C:\PyMOL_installation
    
    from the command prompt), run:
C:\Python27\python.exe pip-6.x.x-py2.py3-none-any.whl/pip install --no-index --find-links="%CD%" pymol_launcher

if C:\Python27 is part of your PATH variable, then running (where x refers to the version number of pip):

python pip-6.x.x-py2.py3-none-any.whl/pip install --no-index --find-links="%CD%" pymol_launcher

should suffice. To update PyMOL update the files in the PyMOL install directory and run:

pip install --upgrade --no-deps pymol.whl

where pymol.whl is replaced by the PyMOL wheel file name (not the launcher, the launcher should not require updating).

Extend PyMOL with additional scripts

If you now want to extend the capabilities of PyMOL, and take advantage of all the available plugins+scripts "out there", then do the following.

  1. First install "numpy" as an available module to Python. Select appropriate installer from here
  2. Download the script/plugin collection Pymol-script-repo from a .zip file from here
git clone https://github.com/Pymol-Scripts/Pymol-script-repo
  1. Unpack it to here: C:\Python27\Lib\site-packages\pymol\pymol_path\Pymol-script-repo Double check that the folder name is correct and the same.

Open "Notepad" and write.

# 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 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}

Then "File->Save as->All files-> C:\Python27\Lib\site-packages\pymol\pymol_path\run_on_startup.py

Now start pymol, and enjoy all the plugins available from the menu.

PyMOL shortcut
Make a pymol directory in your homepath. mkdir %HOMEPATH%\pymol Then make sure, PyMOL starts here, when you open the shortcut.
Make a shortcut to the .cmd file, and modify it.
Target: C:\python27\PyMOL\pymol.cmd
Start in: %HOMEPATH%\pymol

See Also