Skip to content

Mac Installation Instructions

Jump to bottom
Bharat Medasani edited this page Jun 25, 2021 · 22 revisions

Mac installation instructions

Before installing simsopt, get openmpi either through HomeBrew or MacPorts. Then use a virtual environment either from conda or python3 venv.

Macports

  1. Install macports. The installation instructions can be found here. (For catalina, you need to install xcode 11.5 and command line tools 11.5 to be compatible with macports)

  2. Install openmpi. Multiple versions of openmpi are avaialable. Here openmpi version that matches with clang11 is installed.

    sudo port install openmpi-clang11
sudo port select --set mpi openmpi-clang11-fortran

    Installation of openmpi-clang11 also install python 3.9. Set this version of python3.9 as default python version.

    sudo port select --set python python39
sudo port select --set python3 python39

  3. (Optional) Install wget, if you want to download simsopt source code as a zip file

    sudo port install wget

Conda

Coming soon.

Python3 venv

Mac Catalina (10.15) comes with python 3.7, which can be accessed with python3 command. But we are using the python3.9 from macports. Assuming you ran the step 2 in Macports section

  1. Create a virtual environment named simsopt_ve using venv module 
    python3 -m venv <path_where_you_want_the_venv>/simsopt_ve
  2. Activate the virtual environment. 
    source <path_where_you_want_the_venv>/simsopt_ve/bin/activate
    After activating the virtual environment, (simsopt_ve) should appear in front of the command prompt.
  3. To confirm that simsopt_ve is activated, run which python, which should point to <path_where_you_want_the_venv>/simsopt_ve/bin/python.

Install simsopt

  1. If using conda virtual environment, activate the virtual environment 
    conda activate <your_ve>
    Otherwise use python3-venv module 
    source <path_where_you_want_the_venv>/simsopt_ve/bin/activate
  2. Install simsopt. It is advisable to install mpi4py also along with simsopt.
    1. If installing from pypi, it is very simple. 
      pip install "simsopt[MPI]"
    2. For local install, get the source code either by downloading the zip file and unzip or via git. If using zip file 
       wget https://github.com/hiddenSymmetries/simsopt/archive/refs/heads/master.zip
 unzip master.zip
 cd simsopt-master
    3. If you are cloning from github 
      git clone [email protected]:hiddenSymmetries/simsopt.git
cd simsopt
    4. For editable install (if you are a developer, you don't want to repeatedly reinstall simsopt after changing the source code), use the -e flag. Otherwise you can omit the -e flag. 
      pip install -e ".[MPI]"

Notes

  1. If you are installing simsopt at multiple environments with different compilers or different versions of libraries, use --no-cache-dir option when running the pip command. 
    pip install --no-cache-dir "simsopt[MPI]"
Clone this wiki locally