Merge pull request #480 from stan-dev/cmdstan-missing-message

Clarify cmdstan installation issue

Author: mitzimorris

cmdstanpy/utils.py

@@ -161,12 +161,14 @@ def cmdstan_path() -> str:
         cmdstan_dir = os.path.expanduser(os.path.join('~', _DOT_CMDSTAN))
         if not os.path.exists(cmdstan_dir):
             raise ValueError(
-                'No CmdStan installation found, run "install_cmdstan".'
+                'No CmdStan installation found, run "install_cmdstan" or'
+                ' (re)activate your conda environment!'
             )
         latest_cmdstan = get_latest_cmdstan(cmdstan_dir)
         if latest_cmdstan is None:
             raise ValueError(
-                'No CmdStan installation found, run "install_cmdstan".'
+                'No CmdStan installation found, run "install_cmdstan" or'
+                ' (re)activate your conda environment!'
             )
         cmdstan = os.path.join(cmdstan_dir, latest_cmdstan)
         os.environ['CMDSTAN'] = cmdstan

docsrc/installation.rst

@@ -20,7 +20,8 @@ We recommend creating a new environment for CmdStan[Py]:
 
     conda create -n cmdstan -c conda-forge cmdstanpy
 
-but installation is possible in an existing environment:
+but installation is possible in an existing environment
+(Note: you must re-activate the environment after running this command!):
 
 .. code-block:: bash