HNN “Python” install (Mac OS)

Opening a terminal window

Run pre-install checks

Prerequisite 1: Xcode Command Line Tools

The Xcode Command Line Tools package includes utilities for compiling code from the terminal (gcc, make, etc.). This is needed for compiling mod files in NEURON.

  1. To install the package, type the following from a terminal.app window:

     xcode-select --install
    
    • If you get the following error, you can skip this step. xcode-select: error: command line tools are already installed, use "Software Update" to install updates
  2. Then press Install in the pop-up dialog

Prerequisite 2: Miniconda (Python 3)

Prepare the Python environment

  1. Create a conda environment with the Python prerequisites for HNN.

     conda env create -f environment.yml
    
  2. Activate the HNN conda environment and install nlopt and NEURON

     source activate hnn
     pip install nlopt NEURON
    
  3. Set the LD_LIBRARY_PATH for openmpi on conda activation. This environnement variable must be set before HNN can run simulations with openmpi. The variable is only useful inside the ‘hnn’ conda environment, so we will set the variable when conda is activated with source activate hnn. Run the following commands to make this automatic.

     cd ${CONDA_PREFIX}
     mkdir -p etc/conda/activate.d etc/conda/deactivate.d
     echo "export OLD_LD_LIBRARY_PATH=\$LD_LIBRARY_PATH" >> etc/conda/activate.d/env_vars.sh
     echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:\${CONDA_PREFIX}/lib" >> etc/conda/activate.d/env_vars.sh
     echo "export LD_LIBRARY_PATH=\$OLD_LD_LIBRARY_PATH" >> etc/conda/deactivate.d/env_vars.sh
     echo "unset OLD_LD_LIBRARY_PATH" >> etc/conda/deactivate.d/env_vars.sh
    
  4. Open a new terminal window for the settings in the previous step to take effect and activate the HNN conda environment

     source activate hnn
    

Run post-install checks

Download HNN source code

Run the HNN model

  1. Start the HNN GUI from a terminal window:

     source activate hnn
     python hnn.py
    
  2. The HNN GUI should show up. Make sure that you can run simulations by clicking the ‘Run Simulation’ button. This will run a simulation with the default configuration. After it completes, graphs should be displayed in the main window.

  3. When you run simulations for the first time, the following dialog boxes may pop-up and ask you for permission to allow connections through the firewall. Saying ‘Deny’ is fine since simulations will just run locally on your Mac.

  4. You can now proceed to running the tutorials at https://hnn.brown.edu/index.php/tutorials/ . Some things to note:

    • A directory called “hnn_out” exists in your home directory where the results from your simulations (data and param files) will be stored.

Upgrading to a new version of HNN

HNN Releases can be seen on the GitHub releases page. You can also be notified of new releases by watching the hnn repository on GitHub.

If you downloaded the tar.gz file, simply re-run the steps above, but replace hnn_source_code with a new directory name.

Otherwise, if you are using git, then run git pull origin master from the source code directory.

Troubleshooting

For Mac OS specific issues: please see the Mac OS troubleshooting page

If you run into other issues with the installation, please open an issue on our GitHub. Our team monitors these issues and will investigate possible fixes.

Another option for users that are running into problems with the above methods, we provide a VirtualBox VM pre-installed with HNN.