README
This directory contains the Python 3 source code for IV Swinger 1 and IV
Swinger 2.


Installing Python 3 and required packages
-----------------------------------------

NOTE: 3.x.x below should be replaced with the actual Python version you
      are installing, e.g. 3.8.5.


 macOS with Python 3.x.x:
 ------------------------

  There are multiple ways to install Python 3.x.x. The easiest is to
  download and run the installer from python.org. But the best way (in
  my opinion) is to use the pyenv tool. This makes it easy to switch
  between different Python versions:

    - Install homebrew per instructions at https://brew.sh/

      % /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

         or update it, if it is already installed:

      % brew update

    - Install pyenv using homebrew

      % brew install pyenv

    - Set up your shell environment for pyenv:

        https://github.com/pyenv/pyenv#set-up-your-shell-environment-for-pyenv

    - Install tcl-tk:

      % brew install tcl-tk

    - Install python 3.x.x with --enable-framework option (for pyinstaller):

      % env PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install 3.x.x

    - Configure pyenv to use Python 3.x.x in the IV_Swinger/python3 directory:

      % cd <your GitHub path>/IV_Swinger/python3
      % pyenv local 3.x.x
      % python -V
      3.x.x

    - Install Python packages required by the IV Swinger 3 code:

      % cd <your GitHub path>/IV_Swinger/python3
      % pip install Pillow pyserial numpy matplotlib scipy Send2Trash pyzmq

    - Test:

      % cd <your GitHub path>/IV_Swinger/python3
      % python IV_Swinger2_gui.py


 Windows with Python 3.x.x:
 ---------------------------

  There are multiple ways to install Python 3.x.x. The easiest is to
  download and run the installer from python.org. But the best way (in
  my opinion) is to use the Windows port of the pyenv tool. This makes
  it easy to switch between different Python versions:


    - Install and configure pyenv-win using instructions at:

        https://github.com/pyenv-win/pyenv-win#installation

    - Install python 3.x.x:

      > pyenv install 3.x.x

    - Configure pyenv to use Python 3.x.x in the IV_Swinger/python3 directory:

      > cd <your GitHub path>\IV_Swinger\python3
      > pyenv local 3.x.x
      > python -V
      3.x.x

    - Install Python packages required by the IV Swinger 2 code:

      > cd <your GitHub path>\IV_Swinger\python3
      > pip install Pillow pyserial numpy matplotlib scipy Send2Trash pyzmq pywin32

    - Test:

      > cd <your GitHub path>\IV_Swinger\python3
      > python IV_Swinger2_gui.py