Changes between Version 6 and Version 7 of InstallConda

Timestamp:

Jun 9, 2020 2:21:42 PM (3 years ago)

Author:

toby

Comment:

--

InstallConda

@@ -1 +1 @@
 = Installing GSAS-II via conda (Anaconda Python) =
 
-Python enthusiasts are likely quite familiar with the [https://www.anaconda.com/what-is-anaconda/ Anaconda package manager]. GSAS-II can be installed using a simple conda command, after installing [https://www.anaconda.com/download anaconda] or [https://conda.io/miniconda.html miniconda]. Note that Python 2.7 or 3.6+ can be used, but not all platforms/combinations have been tested. We recommend Python 3.7 at present. When this conda package is used, it ensures that the [https://gsas-ii.readthedocs.io/en/latest/packages.html packages required by GSAS-II] are installed, including subversion, and then subversion is used to download the latest version of GSAS-II from the APS server. This download will fail if your computer network
+Python enthusiasts are likely quite familiar with the [https://www.anaconda.com/what-is-anaconda/ Anaconda package manager]. GSAS-II can be installed using a simple conda command, after installing [https://www.anaconda.com/download anaconda] or [https://conda.io/miniconda.html miniconda]. We are recommending Python 3.7. With Python 3.8 or later, you will likely need to compile binaries. When this conda package is used, it ensures that the [https://gsas-ii.readthedocs.io/en/latest/packages.html packages required by GSAS-II] are installed, including subversion, and then subversion is used to download the latest version of GSAS-II from the APS server. This download will fail if your computer network
 requires a proxy ([ProxyInfo more info on proxies here]), but rerunning the bootstrap.py command (see bottom of this page) 
 will work after the proxy information is entered. 
 
-Use this command to install GSAS-II:  
-
-    
 {{{
-conda install gsas2pkg -c briantoby 
+conda install gsas2pkg=1.1 -c briantoby
 }}}
  
+To use a separate conda environment for GSAS-II, use these commands to install GSAS-II: 
+
+{{{
+conda create -n GSASII
+conda install gsas2pkg=1.1 -c briantoby -n GSASII
+}}}
+Note that you may need to activate the environment manually before starting GSAS-II.
+ 
+
+After the conda install completes, one of the following occurs: 
+
+ * On the Mac, an app is created that can be dragged to the doc (or create a shortcut to GSAS-II.app and drag that anywhere).
+
+ * On Windows a desktop shortcut is created. 
+
+ * On Linux (at present) the command-line is needed to start GSAS-II:
+{{{
+<condapath>/bin/python <condapath>/GSASII/GSASII.py
+}}}
+
+**Activating**: 
 If you get an error that conda is an unknown command, this means anaconda/miniconda is not in your path (which is my recommended way to install anaconda) and you will need to first use the ananconda activate command:
 
@@ -24 +42 @@
 }}}
 
-After the conda install completes, one of the following occurs: 
+With GSAS-II in an environment, the activate command becomes 
+`...activate GSASII`
 
- * On the Mac, an app is created that can be dragged to the doc (or create a shortcut to GSAS-II.app and drag that anywhere).
+**Python 2.7**: We are no longer confirming that all sections of GSAS-II are compatible with Python 2.7 (but will usually fix problems, if reported). An older version of gsas2pkg is compatible with Python 2.7: 
 
- * On Windows a desktop shortcut is created. 
-
- * On Linux (at present) the command-line is needed to start GSAS-II:
 {{{
-<condapath>/bin/python <condapath>/GSASII/GSASII.py
+conda install gsas2pkg=1.0.6 -c briantoby 
 }}}
-
-This mechanism has gotten some use since created (June 2018) 
-and no problems have been reported, but feedback is welcome. 
 
 == GSAS-II Updates ==