Merge pull request #542 from py4dstem/dev

version 0.14.5 release

.github/scripts/update_version.py

@@ -8,7 +8,7 @@
     lines = f.readlines()
 
 line_split = lines[0].split(".")
-patch_number = line_split[2].split("'")[0]
+patch_number = line_split[2].split("'")[0].split('"')[0]
 
 # Increment patch number
 patch_number = str(int(patch_number) + 1) + "'"

.github/workflows/check_install_dev.yml

@@ -17,10 +17,10 @@ jobs:
                 runs-on: [ubuntu-latest]
                 architecture: [x86_64]
                 python-version: ["3.9", "3.10", "3.11",]
-                include:
-                    - python-version: "3.12.0-beta.4"
-                      runs-on: ubuntu-latest
-                      allow_failure: true
+                # include:
+                #     - python-version: "3.12.0-beta.4"
+                #       runs-on: ubuntu-latest
+                #       allow_failure: true
                 # Currently no public runners available for this but this or arm64 should work next time
                 # include:
                 #     - python-version: "3.10"

README.md

@@ -46,42 +46,50 @@ First, download and install Anaconda: www.anaconda.com/download.
 If you prefer a more lightweight conda client, you can instead install Miniconda: https://docs.conda.io/en/latest/miniconda.html.
 Then open a conda terminal and run one of the following sets of commands to ensure everything is up-to-date and create a new environment for your py4DSTEM installation:
 
-
 ```
 conda update conda
 conda create -n py4dstem
 conda activate py4dstem
+conda install -c conda-forge py4dstem pymatgen jupyterlab
 ```
 
-Next, install py4DSTEM.  To simultaneously install py4DSTEM with `pymatgen` (used in some crystal structure workflows) and `jupyterlab` (providing an interface for running Python notebooks like those provided in the [py4DSTEM tutorials repository](https://github.com/py4dstem/py4DSTEM_tutorials)) run:
+In order, these commands
+- ensure your installation of anaconda is up-to-date
+- make a virtual environment (see below)
+- enter the environment
+- install py4DSTEM, as well as pymatgen (used for crystal structure calculations) and JupyterLab (an interface for running Python notebooks like those in the [py4DSTEM tutorials repository](https://github.com/py4dstem/py4DSTEM_tutorials))
+
+
+We've had some recent reports install of `conda` getting stuck trying to solve the environment using the above installation.  If you run into this problem, you can install py4DSTEM using `pip` instead of `conda` by running:
 
 ```
-conda install -c conda-forge py4dstem pymatgen jupyterlab
+conda update conda
+conda create -n py4dstem python=3.10 
+conda activate py4dstem
+pip install py4dstem pymatgen 
 ```
 
-Or if you would prefer to install only the base modules of **py4DSTEM**, you can instead run:
+Both `conda` and `pip` are programs which manage package installations, i.e. make sure different codes you're installing which depend on one another are using mutually compatible versions.  Each has advantages and disadvantages; `pip` is a little more bare-bones, and we've seen this install work when `conda` doesn't.  If you also want to use Jupyterlab you can then use either `pip install jupyterlab` or `conda install jupyterlab`.
+
+If you would prefer to install only the base modules of **py4DSTEM**, and skip pymategen and Jupterlab, you can instead run:
 
 ```
 conda install -c conda-forge py4dstem
 ```
 
-In Windows you should then also run:
+Finally, regardless of which of the above approaches you used, in Windows you should then also run:
 
 ```
 conda install pywin32
 ```
 
-In order, these commands
-- ensure your installation of anaconda is up-to-date
-- make a virtual environment (see below)
-- enter the environment
-- install py4DSTEM, and optionally also pymatgen and JupyterLab
-- on Windows, enable python to talk to the windows API
+which enables Python to talk to the Windows API.
 
 Please note that virtual environments are used in the instructions above in order to make sure packages that have different dependencies don't conflict with one another.
 Because these directions install py4DSTEM to its own virtual environment, each time you want to use py4DSTEM you'll need to activate this environment.
 You can do this in the command line by running `conda activate py4dstem`, or, if you're using the Anaconda Navigator, by clicking on the Environments tab and then clicking on `py4dstem`.
 
+Last - as of the version 0.14.4 update, we've had a few reports of problems upgrading to the newest version.  We're not sure what's causing the issue yet, but have found the new version can be installed successfully in these cases using a fresh Anaconda installation.
 
 
 <a id='legacyinstall'></a>

docs/requirements.txt

@@ -1,2 +1,3 @@
 emdfile
-# py4dstem
+sphinx_rtd_theme
+# py4dstem

docs/source/conf.py

@@ -36,7 +36,12 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx.ext.autodoc", "sphinx.ext.napoleon", "sphinx.ext.intersphinx"]
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.intersphinx",
+    "sphinx_rtd_theme",
+]
 
 # Other useful extensions
 # sphinx_copybutton

py4DSTEM/braggvectors/diskdetection_aiml_cuda.py

@@ -17,8 +17,8 @@
 
 try:
     import cupy as cp
-except:
-    raise ImportError("Import Error: Please install cupy before proceeding")
+except ModuleNotFoundError:
+    raise ImportError("AIML CUDA Requires cupy")
 
 try:
     import tensorflow as tf

py4DSTEM/preprocess/utils.py

@@ -5,8 +5,8 @@
 
 try:
     import cupy as cp
-except ImportError:
-    cp = None
+except ModuleNotFoundError:
+    cp = np
 
 
 def bin2D(array, factor, dtype=np.float64):