Focus Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
1_0:external-tools [2021/05/10 18:55]
admin [Python and PILLOW] 		1_0:external-tools [2025/05/22 16:10] (current)
admin [CCP4 (Only for 2D crystallography projects)]
Line 12: Line 12:
  
 ==== Python  and PILLOW ==== ==== Python  and PILLOW ====
-Many utilities and specific-purpose tools used by FOCUS are written in the [[http://ww.python.org|Python]] scripting language (version 2.7.x). We recommend using a scientific Python installation like [[http://www.anaconda.com|Anaconda]] or [[http://www.enthought.com/product/canopy/|Canopy]]. You can also use the [[http://blake.bcm.edu/emanwiki/EMAN2|EMAN2.2]] Python environment based on Anaconda (see below).+Many utilities and specific-purpose tools used by FOCUS are written in the [[http://ww.python.org|Python]] scripting language. We recommend using a scientific Python installation like [[http://www.anaconda.com|Anaconda]] or [[http://www.enthought.com/product/canopy/|Canopy]]. You can also use the [[http://blake.bcm.edu/emanwiki/EMAN2|EMAN2.2]] Python environment based on Anaconda (see below).
  
 You also need **pip** and the module **pil** (or **pillow**).  You also need **pip** and the module **pil** (or **pillow**). 
Line 18: Line 18:
 On OSX, try  On OSX, try 
  
-// +  * xcode-select --install 
-<nowiki> +  * brew install python3 
-     xcode-select --install +  * brew install pillow 
-</nowiki> +  * brew install python-matplotlib 
-// +  * brew install numpy
- +
-// +
-<nowiki> +
-     brew install python2.7 +
-</nowiki> +
-// +
- +
-// +
-<nowiki> +
-     pip3 install pillow +
-</nowiki> +
-//+
  
 or alternatively: or alternatively:
  
-// +  * pip3 install pillow
-<nowiki> +
-     pip install pillow +
-</nowiki> +
-//+
  
 On Linux, try: On Linux, try:
Line 50: Line 34:
   * pip3 install matplotlib   * pip3 install matplotlib
  
-and make sure in the Preferences panel of FOCUS, that FOCUS is using this python2.7 binary, which may reside in /usr/local/bin/python2.7+and make sure in the Preferences panel of FOCUS, that FOCUS is using the correct version of python, which may reside in /usr/local/bin/python3  or  in /opt/homebrew/bin/python3 
 + 
 +Or to install those in python2.7:  
 +  * /usr/bin/python -mpip install -U pillow 
 +  * /usr/bin/python -mpip install -U matplotlib 
  
 ==== MRCZ ==== ==== MRCZ ====
 Many of the Python scripts called within FOCUS rely on the [[http://github.com/em-MRCZ/python-mrcz|Python-MRCZ]] module. You can install ''mrcz'' in your Python environment with the following ''pip'' command: Many of the Python scripts called within FOCUS rely on the [[http://github.com/em-MRCZ/python-mrcz|Python-MRCZ]] module. You can install ''mrcz'' in your Python environment with the following ''pip'' command:
  
-''pip install mrcz''+''pipx install mrcz''
  
 Please ensure you have a version >= 0.5.1 of ''mrcz''. Please ensure you have a version >= 0.5.1 of ''mrcz''.
Line 62: Line 51:
 For accelerating some heavy calculations in Python scripts, FOCUS uses the [[https://numexpr.readthedocs.io|NumExpr]] evaluator. You can install ''numexpr'' in your Python environment with the following ''pip'' command: For accelerating some heavy calculations in Python scripts, FOCUS uses the [[https://numexpr.readthedocs.io|NumExpr]] evaluator. You can install ''numexpr'' in your Python environment with the following ''pip'' command:
  
-''pip install numexpr''+  * pipx install numexpr 
 + 
 +or alternatively on OSX: 
 + 
 +  * brew install numexpr
  
 ==== EMAN2 ==== ==== EMAN2 ====
-[[http://blake.bcm.edu/emanwiki/EMAN2|EMAN2]]  is a great package with lots of tools available. We might not use the tools present in EMAN2 directly, but we definitely use python distribution attached with the source. EMAN2 is easy to install and is available for MacOS and Linux on their website: http://blake.bcm.edu/emanwiki/EMAN2+[[http://blake.bcm.edu/emanwiki/EMAN2|EMAN2]]  is a great package with lots of tools available. 
  
-If you want to use the EMAN2 python (that is python 2.7), then you can link that python in the FOCUS Preferences dialogue, on **MacOS** for example as  /Applications/EMAN2/bin/python2.7 (or, where-ever you installed EMAN2). +We might not use the tools present in EMAN2 directly, but it is very helpful.  
 +EMAN2 is easy to install and is available for MacOS and Linux on their website: http://blake.bcm.edu/emanwiki/EMAN2
  
-If you compile FOCUS from source (which is recommended), sure that the ''build_all'' script does not accidentally use the EMAN2 version of qmake. You can test this by typing in a terminal ''which qmake'', or ''qmake ''''-''''-version'', to see, which qmake shows up first in your path. If the EMAN2 qmake is taken first, you might want to rename that to a different qmake name, such as "qmake-4.8.7".+If you compile FOCUS from source (which is recommended), make sure that the ''build_all'' script does not accidentally use the EMAN2 version of qmake. You can test this by typing in a terminal ''which qmake'', or ''qmake ''''-''''-version'', to see, which qmake shows up first in your path. If the EMAN2 qmake is taken first, you might want to rename that to a different qmake name, such as "qmake-4.8.7".
 ==== IMOD ==== ==== IMOD ====
 We directly use many command line utilities present in IMOD. It can be downloaded from the website: http://bio3d.colorado.edu/imod/ We directly use many command line utilities present in IMOD. It can be downloaded from the website: http://bio3d.colorado.edu/imod/
  
 ==== CCP4 (Only for 2D crystallography projects) ==== ==== CCP4 (Only for 2D crystallography projects) ====
-Focus uses CCP4 in order to generate merged maps of the protein in 2D crystallography projects. The software can be downloaded from http://www.ccp4.ac.uk/download.php. Please follow their installation guide.+Focus uses CCP4 in order to generate merged maps of the protein in 2D crystallography projects. The software can be downloaded from  
 + 
 +  * https://www.ccp4.ac.uk/download  
 + 
 +Please follow their installation guide.
  
 ===== Software for drift correction ===== ===== Software for drift correction =====