Recent changes to OpenMPS from Source

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Tue, 07 Jul 2020 20:38:28 -0000

--- v14
+++ v15
@@ -6,6 +6,24 @@
 git clone git://git.code.sf.net/p/openmps/v3code openmps
 ```
 # Acquire the dependencies
+## Additional steps for macOS
+If you are installing onto a linux-based operating system, you can skip this section.
+In recent updates to macOS, Apple has changed the default shell script to `zsh`. The utility scripts packaged with OpenMPS source do not work under `zsh`. The simplest solution is to change your default shell to `bash` by typing this in the macOS Terminal application:
+```bash
+chsh -s /bin/bash
+```
+**important note:** macOS will warn you that `zsh` is the default shell for macOS (beginning with Catalina), and print a message like the following:
+```bash
+The default interactive shell is now zsh.
+To update your account to use zsh, please run `chsh -s /bin/zsh`.
+For more details, please visit https://support.apple.com/kb/HT208050.
+```
+If you change the default shell back to `zsh`, you will not be able to access your `conda` environment unless you reinitialize `conda` by typing
+```bash
+source $CONDA_ROOT/bin/activate && conda init
+```
+where `$CONDA_ROOT` is a user-defined path. It is the root directory for `conda` where Anaconda is installed (e.g.) the path where the `conda` binary is located: `$CONDA_ROOT/bin/conda`
+## Install Anaconda and create the virtual environment
 [Install Anaconda](https://docs.anaconda.com/anaconda/install/) by following the posted instructions.
 Alternatively, you can install Anaconda by using our utilities scripts:
 ```bash
@@ -16,11 +34,12 @@
 **important note:** `CONDA_ROOT` is a user-defined path ... you must choose where you want `conda` to be installed
 **important note:** `OPENMPS_ROOT` is a user-defined path ... it must be the location to the OpenMPS source code
 **important note:** you may choose either `macOS` or `linux` ... the script will error if one of these is not supplied
-**important note:** you will need to resource your bash environment: `source ~/.bashrc`
+**important note:** you will need to resource your bash environment: `source ~/.bashrc` if you're using linux; otherwise, `source ~/.bash_profile` if you're using macOS.

-Use `conda` to create a virtual environment from the `openmps.yml` specification and acquire all of the dependencies:
+Use `conda` to create a virtual environment from the `[macos, linux].yml` specification and acquire all of the dependencies. For example:
 ```bash
-conda env create --name openmps --file conda/environments/openmps.yml
+conda env create --name openmps --file conda/environments/linux.yml  # for linux
+conda env create --name openmps --file conda/environments/macos.yml  # for macOS
 ```
 # Install OpenMPS
 From the `OPENMPS_ROOT` directory, issue this command
@@ -37,18 +56,15 @@
 ```bash
 conda activate openmps
 ```
-
 To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
 python $OPENMPS_ROOT/Examples/01_IsingStatics.py --PostProcess=False && \
 python $OPENMPS_ROOT/Examples/01_IsingStatics.py --PostProcess=True
 ```
-
 This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
 ```bash
 ls $OPENMPS_ROOT/Examples
 ```
-
 The first three examples produce plots:
 1. `01_IsingStatics.py`
 2. `02_BoseHubbardStatics.py`

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Thu, 07 May 2020 18:47:26 -0000

--- v13
+++ v14
@@ -1,162 +1,61 @@
-# Download the Source
-
+# Acquire the source
+**Important Note:** we will define `OPENMPS_ROOT` to be the file location for the OpenMPS source code acquired from either of the following methods
 ## Using `git`
-
+Clone the source code
 ```bash
 git clone git://git.code.sf.net/p/openmps/v3code openmps
 ```
-## Using your Web Browser 
+# Acquire the dependencies
+[Install Anaconda](https://docs.anaconda.com/anaconda/install/) by following the posted instructions.
+Alternatively, you can install Anaconda by using our utilities scripts:
+```bash
+CONDA_ROOT=/path/to/conda/root
+OPENMPS_ROOT=/path/to/openmps
+bash $OPENMPS_ROOT/Utilities/install-conda.sh [macOS, linux] $CONDA_ROOT
+```
+**important note:** `CONDA_ROOT` is a user-defined path ... you must choose where you want `conda` to be installed
+**important note:** `OPENMPS_ROOT` is a user-defined path ... it must be the location to the OpenMPS source code
+**important note:** you may choose either `macOS` or `linux` ... the script will error if one of these is not supplied
+**important note:** you will need to resource your bash environment: `source ~/.bashrc`

-[Download from this link](https://sourceforge.net/projects/openmps/files/latest/download "OpenMPS Download")
-
-**Important Note:** we will define `OPENMPS_ROOT` to be the file location for the OpenMPS source code acquired from either of the above methods
-# Using `apt` package management
-
-0) Change directories to `$OPENMPS_ROOT`
+Use `conda` to create a virtual environment from the `openmps.yml` specification and acquire all of the dependencies:
 ```bash
-OPENMPS_ROOT=/path/to/openmps && \
-cd $OPENMPS_ROOT
+conda env create --name openmps --file conda/environments/openmps.yml
+```
+# Install OpenMPS
+From the `OPENMPS_ROOT` directory, issue this command
+```bash
+conda activate openmps && \
+python setup.py install && \
+python BuildOSMPS.py --prefix=$CONDA_PREFIX/bin \
+                     --option=FC:$CONDA_PREFIX/bin/gfortran \
+                     --option=INCFLAGS:-I$CONDA_PREFIX/include \
+                     --option=LIBFLAGS:-L$CONDA_PREFIX/lib
+```
+# Use OpenMPS
+You must activate the virtual environment. This is done via
+```bash
+conda activate openmps
 ```

-1)  Install core library dependencies using your OS package manager
+To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-sudo apt install \
-        liblapack-dev \
-        libarpack2-dev \
-        libopenmpi-dev
-```
-2)  Install python dependencies using your python package manager
-```bash
-pip3 install \
-        sphinx sphinxcontrib-bibtex \
-        jupyterlab \
-        numpy \
-        scipy \
-        matplotlib \
-        nose
-```
-3)  Build and install OpenMPS
-```bash
-sudo python3 setup.py install && \
-sudo python3 BuildOSMPS.py
-```
-Note: you may install to a local directory by specifying a `--prefix`:
-```bash
-sudo python3 BuildOSMPS.py --prefix=/path/to/bin
-```
-4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
-```bash
-python3 Examples/01_IsingStatics.py --PostProcess=False && \
-python3 Examples/01_IsingStatics.py --PostProcess=True
+python $OPENMPS_ROOT/Examples/01_IsingStatics.py --PostProcess=False && \
+python $OPENMPS_ROOT/Examples/01_IsingStatics.py --PostProcess=True
 ```

 This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
 ```bash
-ls Examples
+ls $OPENMPS_ROOT/Examples
 ```

-The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`
+The first three examples produce plots:
+1. `01_IsingStatics.py`
+2. `02_BoseHubbardStatics.py`
+3. `03_BoseHubbardDynamics.py`

-5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command
+If you'd like to start an interactive session in your web browser using JupyterLab, run this command
 ```bash
-bash Docker-Utils/start-jupyter.sh
+bash $OPENMPS_ROOT/Utilities/start-jupyter.sh
 ```
-
-6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
-# Using Anaconda `conda` package management
-
-0) If you have not done so, download and install Anaconda
-```bash
-curl "https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh" -o ./miniconda.sh && 
-sh ./miniconda.sh -b -p ./conda && \
-./conda/bin/conda init && source .bashrc && \
-conda update --name base conda && \
-rm -f ./miniconda.sh
-```
-
-1) Change directories to `$OPENMPS_ROOT`
-```bash
-OPENMPS_ROOT=/path/to/openmps && \
-cd $OPENMPS_ROOT
-```
-
-Use `conda` to create a virtual environment from the `openmps.yml` specification
-```bash
-conda env create --name openmps --file conda/environments/openmps.yml
-```
-
-
-2) Upon completion, and without changinge directories (stay in `$OPENMPS_ROOT`), issue this command
-```bash
-conda activate openmps && \
-python setup.py install && \
-python BuildOSMPS.py --prefix=$CONDA_PREFIX/bin \
-                     --option=FC:x86_64-conda_cos6-linux-gnu-gfortran \
-                     --option=INCFLAGS:-I$CONDA_PREFIX/include \
-                     --option=LIBFLAGS:-L$CONDA_PREFIX/lib
-```
-
-3) To use OpenMPS, you must activate the virtual environment. This is done via
-```bash
-conda activate openmps
-```
-
-4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
-```bash
-python Examples/01_IsingStatics.py --PostProcess=False && \
-python Examples/01_IsingStatics.py --PostProcess=True
-```
-
-This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
-```bash
-ls Examples
-```
-
-The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`
-
-5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command
-```bash
-bash Docker-Utils/start-jupyter.sh
-```
-
-6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
-# Using Docker
-
-0) Change directories to `$OPENMPS_ROOT`
-```bash
-OPENMPS_ROOT=/path/to/openmps && \
-cd $OPENMPS_ROOT
-```
-
-1) Run the following command to build the Docker image for OpenMPS
-```bash
-bash Docker-Utils/build-openmps.sh
-```
-
-2) To run a Docker container for OpenMPS type, 
-```bash
-bash Docker-Utils/run-openmps.sh
-```
-
-Note: this bash script will create a directory called `workspace` under `$OPENMPS_ROOT`, and virtually mount this directory (`$OPENMPS_ROOT/workspace`) within the container runtime under `/workspace/external`. From within the container runtime, any files or data saved to `/workspace/external` will be available on your machine under `$OPENMPS_ROOT/workspace`.
-
-3) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
-```bash
-python examples/01_IsingStatics.py --PostProcess=False && \
-python examples/01_IsingStatics.py --PostProcess=True
-cp 01_IsingStatics.pdf external/
-```
-
-Notice that we explicity copy the plot-file to `/workspace/external` so that it is available to your host operating system. This means that, once the command completes, you can navigate to `$OPENMPS_ROOT/workspace` and open the file to view the plot. To see all available examples, run this command
-```bash
-ls examples
-```
-
-The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`
-
-4) If you'd like to start an interactive session in your web browser using JupyterLab, run this command
-```bash
-bash utils/start-jupyter.sh
-```
-
-5) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
+Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Thu, 27 Jun 2019 20:26:12 -0000

--- v12
+++ v13
@@ -69,6 +69,7 @@
 ```bash
 curl "https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh" -o ./miniconda.sh && 
 sh ./miniconda.sh -b -p ./conda && \
+./conda/bin/conda init && source .bashrc && \
 conda update --name base conda && \
 rm -f ./miniconda.sh
 ```
@@ -87,7 +88,7 @@

 2) Upon completion, and without changinge directories (stay in `$OPENMPS_ROOT`), issue this command
 ```bash
-source activate openmps && \
+conda activate openmps && \
 python setup.py install && \
 python BuildOSMPS.py --prefix=$CONDA_PREFIX/bin \
                      --option=FC:x86_64-conda_cos6-linux-gnu-gfortran \

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Mon, 27 May 2019 03:18:18 -0000

--- v11
+++ v12
@@ -46,7 +46,8 @@
 ```
 4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-python3 Examples/01_IsingStatics.py
+python3 Examples/01_IsingStatics.py --PostProcess=False && \
+python3 Examples/01_IsingStatics.py --PostProcess=True
 ```

 This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
@@ -101,7 +102,8 @@

 4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-python Examples/01_IsingStatics.py
+python Examples/01_IsingStatics.py --PostProcess=False && \
+python Examples/01_IsingStatics.py --PostProcess=True
 ```

 This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
@@ -139,7 +141,8 @@

 3) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-python examples/01_IsingStatics.py && \
+python examples/01_IsingStatics.py --PostProcess=False && \
+python examples/01_IsingStatics.py --PostProcess=True
 cp 01_IsingStatics.pdf external/
 ```

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Mon, 27 May 2019 02:02:08 -0000

--- v10
+++ v11
@@ -143,14 +143,14 @@
 cp 01_IsingStatics.pdf external/
 ```

-Notice that we explicity copy the plot-file to `/workspace/external` so that it is available to your host operating system. This means that, once the command completes, you can navigate to `$OPENMPS_ROOT/workspace` and open the file to view the plot. To see all available examples, run this command:
+Notice that we explicity copy the plot-file to `/workspace/external` so that it is available to your host operating system. This means that, once the command completes, you can navigate to `$OPENMPS_ROOT/workspace` and open the file to view the plot. To see all available examples, run this command
 ```bash
 ls examples
 ```

 The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`

-4) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
+4) If you'd like to start an interactive session in your web browser using JupyterLab, run this command
 ```bash
 bash utils/start-jupyter.sh
 ```

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Mon, 27 May 2019 01:58:12 -0000

--- v9
+++ v10
@@ -9,16 +9,16 @@

 [Download from this link](https://sourceforge.net/projects/openmps/files/latest/download "OpenMPS Download")

-**Important Note:** we will define *OPENMPS_ROOT* to be the file location for the OpenMPS source code acquired from either of the above methods
+**Important Note:** we will define `OPENMPS_ROOT` to be the file location for the OpenMPS source code acquired from either of the above methods
 # Using `apt` package management

-0) Change directories to *OPENMPS_ROOT*:
+0) Change directories to `$OPENMPS_ROOT`
 ```bash
 OPENMPS_ROOT=/path/to/openmps && \
 cd $OPENMPS_ROOT
 ```

-1)  Install core library dependencies using your OS package manager:
+1)  Install core library dependencies using your OS package manager
 ```bash
 sudo apt install \
         liblapack-dev \
@@ -49,15 +49,14 @@
 python3 Examples/01_IsingStatics.py
 ```

-This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
-
+This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
 ```bash
 ls Examples
 ```

 The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`

-5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
+5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command
 ```bash
 bash Docker-Utils/start-jupyter.sh
 ```
@@ -65,7 +64,7 @@
 6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
 # Using Anaconda `conda` package management

-0) If you have not done so, download and install Anaconda:
+0) If you have not done so, download and install Anaconda
 ```bash
 curl "https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh" -o ./miniconda.sh && 
 sh ./miniconda.sh -b -p ./conda && \
@@ -73,18 +72,19 @@
 rm -f ./miniconda.sh
 ```

-1) Change directories to the OpenMPS root directory:
+1) Change directories to `$OPENMPS_ROOT`
 ```bash
 OPENMPS_ROOT=/path/to/openmps && \
 cd $OPENMPS_ROOT
 ```

-Use `conda` to create a virtual environment from the `openmps.yml` specification:
+Use `conda` to create a virtual environment from the `openmps.yml` specification
 ```bash
 conda env create --name openmps --file conda/environments/openmps.yml
 ```

-2) Upon completion, and without changing directories (stay in the OpenMPS root directory), issue this command at the command-line:
+
+2) Upon completion, and without changinge directories (stay in `$OPENMPS_ROOT`), issue this command
 ```bash
 source activate openmps && \
 python setup.py install && \
@@ -104,15 +104,14 @@
 python Examples/01_IsingStatics.py
 ```

-This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
-
+This will produce a plot called **01_IsingStatics.pdf** in `$OPENMPS_ROOT` directory. To view it, use your file browser, navigate to `$OPENMPS_ROOT`, and open the file. To view all available examples, type
 ```bash
 ls Examples
 ```

 The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`

-5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
+5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command
 ```bash
 bash Docker-Utils/start-jupyter.sh
 ```
@@ -120,21 +119,23 @@
 6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
 # Using Docker

-0) Change directories to *OPENMPS_ROOT*:
+0) Change directories to `$OPENMPS_ROOT`
 ```bash
 OPENMPS_ROOT=/path/to/openmps && \
 cd $OPENMPS_ROOT
 ```

-1) From the root directory of the OpenMPS source code, run the following command
+1) Run the following command to build the Docker image for OpenMPS
 ```bash
 bash Docker-Utils/build-openmps.sh
 ```

-2) To run the Docker container, 
+2) To run a Docker container for OpenMPS type, 
 ```bash
 bash Docker-Utils/run-openmps.sh
 ```
+
+Note: this bash script will create a directory called `workspace` under `$OPENMPS_ROOT`, and virtually mount this directory (`$OPENMPS_ROOT/workspace`) within the container runtime under `/workspace/external`. From within the container runtime, any files or data saved to `/workspace/external` will be available on your machine under `$OPENMPS_ROOT/workspace`.

 3) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
@@ -142,8 +143,7 @@
 cp 01_IsingStatics.pdf external/
 ```

-This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT*  workspace directory. To view it, use your file browser, navigate to your *OPENMPS_ROOT* workspace, and open the file. To view all available examples, type
-
+Notice that we explicity copy the plot-file to `/workspace/external` so that it is available to your host operating system. This means that, once the command completes, you can navigate to `$OPENMPS_ROOT/workspace` and open the file to view the plot. To see all available examples, run this command:
 ```bash
 ls examples
 ```

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Sun, 26 May 2019 08:38:54 -0000

--- v8
+++ v9
@@ -152,7 +152,7 @@

 4) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
 ```bash
-bash Docker-Utils/start-jupyter.sh
+bash utils/start-jupyter.sh
 ```

 5) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Sun, 26 May 2019 08:35:53 -0000

--- v7
+++ v8
@@ -136,27 +136,23 @@
 bash Docker-Utils/run-openmps.sh
 ```

-3) Once inside the container, run
+3) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-source activate openmps
+python examples/01_IsingStatics.py && \
+cp 01_IsingStatics.pdf external/
 ```

-4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
-```bash
-python Examples/01_IsingStatics.py
-```
-
-This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
+This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT*  workspace directory. To view it, use your file browser, navigate to your *OPENMPS_ROOT* workspace, and open the file. To view all available examples, type

 ```bash
-ls Examples
+ls examples
 ```

 The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`

-5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
+4) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
 ```bash
 bash Docker-Utils/start-jupyter.sh
 ```

-6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
+5) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Sun, 26 May 2019 07:48:34 -0000

--- v6
+++ v7
@@ -101,7 +101,7 @@

 4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-python3 Examples/01_IsingStatics.py
+python Examples/01_IsingStatics.py
 ```

 This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
@@ -143,7 +143,7 @@

 4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-python3 Examples/01_IsingStatics.py
+python Examples/01_IsingStatics.py
 ```

 This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type

OpenMPS from Source modified by Matthew Jones

Matthew Jones — Sun, 26 May 2019 07:48:07 -0000

--- v5
+++ v6
@@ -44,13 +44,25 @@
 ```bash
 sudo python3 BuildOSMPS.py --prefix=/path/to/bin
 ```
+4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
+```bash
+python3 Examples/01_IsingStatics.py
+```

-4) Start the JupyterLab environment:
+This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
+
+```bash
+ls Examples
+```
+
+The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`
+
+5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
 ```bash
 bash Docker-Utils/start-jupyter.sh
 ```

-5) Navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
+6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
 # Using Anaconda `conda` package management

 0) If you have not done so, download and install Anaconda:
@@ -87,12 +99,25 @@
 conda activate openmps
 ```

-4) Start the JupyterLab environment:
+4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
+```bash
+python3 Examples/01_IsingStatics.py
+```
+
+This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
+
+```bash
+ls Examples
+```
+
+The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`
+
+5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
 ```bash
 bash Docker-Utils/start-jupyter.sh
 ```

-5) Navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
+6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
 # Using Docker

 0) Change directories to *OPENMPS_ROOT*:
@@ -116,9 +141,22 @@
 source activate openmps
 ```

-4) Start the JupyterLab environment:
+4) To run the first OpenMPS example (called **01_IsingStatics.py**) from the command-line, type
 ```bash
-bash utils/start-jupyter.sh
+python3 Examples/01_IsingStatics.py
 ```

-5) Navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")
+This will produce a plot called **01_IsingStatics.pdf** in *OPENMPS_ROOT* directory. To view it, use your file browser, navigate to *OPENMPS_ROOT*, and open the file. To view all available examples, type
+
+```bash
+ls Examples
+```
+
+The first three examples produce plots: `01_IsingStatics.py`,  `02_BoseHubbardStatics.py`,  `03_BoseHubbardDynamics.py`
+
+5) If you'd like to start an interactive session in your web browser using JupyterLab, run this command:
+```bash
+bash Docker-Utils/start-jupyter.sh
+```
+
+6) Then navigate to [http://localhost:8888/lab](http://localhost:8888/lab "JupyterLab hosted on your local machine")