Alternative installation for macOS

If you already have Anaconda installed on your computer, you must use the recommended method of installing Fusion to prevent multiple copies of Anaconda from being installed on your system–multiple installations could lead to system conflicts.

If you do not have Anaconda installed on your computer, and do not want to follow the recommended installation method–using Navigator, Fusion can be installed on your macOS in 2 other ways:

Installing using a conda package on macOS

If you already have an Anaconda installation, and are familiar with conda packages, you can install Fusion as a conda package.

NOTE: Fusion requires Python 3.5. You may create a Python 3.5 conda environment and install Fusion there even if your conda root environment uses another Python version such as Python 2.7.

To install Fusion as a conda package:

  1. After Excel has been updated, open a terminal window.

  2. In the terminal window, run the following command to create the new conda environment where you will install Fusion:

    conda create -n fusion-env python=3.5
    source activate fusion-env
    

    NOTE: Replace fusion-env with the name you choose for your Fusion environment.

  3. After your Fusion environment is created, run the following command to install Fusion:

    conda install -c anaconda-fusion anaconda-fusion
    
  4. Close and reopen your terminal window to allow the changes to take effect.

  5. To start Fusion in the terminal window, run the command fusion.

The installation is complete. You can open Excel and see Starting Fusion on macOS for information about activating Fusion in Excel.

TIP: To find the Fusion Examples folder, run the command fusion-examples to open a new Finder window with a list of the examples files displayed.

NOTE: When you start Excel during your first Fusion activation on macOS, you must grant permissions. For more information, see Adding Fusion to Excel on macOS.

Updating the conda package

To update Fusion with each new release:

  1. If you have an open instance of Excel, close that program.

  2. Open a terminal window and run:

    conda update -c anaconda-fusion anaconda-fusion
    

Uninstalling the conda package

To uninstall Fusion:

  1. Open a terminal window.

  2. Run the following command:

    source activate your-environment-name
    
  3. After the environment is active, run:

    bashconda remove anaconda-fusion
    

    NOTE: Replace your-environment-name with the name you used for your environment.

Installing using a standalone installer on macOS

To install Fusion on a macOS:

  1. Download the Fusion macOS installer

  2. Open a terminal window.

  3. Change the directory–using command cd–to the downloads folder of your directory–by default this folder is called Downloads

  4. To install Fusion, run the following command:

    bash AnacondaFusion-1.0.2-MacOSX-x86_64.sh
    
  5. Close and reopen the terminal window to allow the changes to take effect.

  6. In a terminal window, run the command fusion to start Fusion.

The installation is complete. You can open Excel and see Starting Fusion on macOS for information about activating Fusion in Excel.

TIP: To find the Fusion Examples folder, run the fusion-examples command to open a new Finder window with a list of the examples files displayed in .xlsx format.

NOTE: When you start Excel during your first Fusion activation on macOS, you must grant permissions. For more information, see Adding Fusion to Excel on macOS.

Starting Fusion on macOS

To run Fusion, follow the steps below–depending on which installation method you used.

If you followed the macOS standalone installation instructions:

  1. Open a terminal window.
  2. Run the command fusion.

If you have followed the macOS conda installation instructions:

  1. Open a terminal window.

  2. Activate your conda environment by running the following command:

    source activate your-environment-name
    

    NOTE: Replace your-environment-name with the name you used for your environment.

  3. After the environment is active, start Fusion by running fusion.

Installing additional dependencies

If you have installed Fusion with an installer, you can install additional conda packages by taking the following steps:

  1. Open a terminal window.

  2. In the terminal window, run the following command:

    conda install your-dependency-name
    

    NOTE: Replace your-dependency-name with the actual name of the package you want to install.

If you have installed Fusion as a conda package, you can install additional conda packages:

  1. Open a terminal window.

  2. In the terminal window, run:

    source activate your-environment-name
    

    NOTE: Replace your-environment-name with the name you used for your environment.

  3. After the environment is active, run:

    conda install your-dependency-name
    

    NOTE: Replace your-dependency-name with the actual name of the package you want to install.

Installing the License files

The first time you start Fusion, it will ask you to upload the license file:

../../../_images/fusion_install_license.png

To upload your license file:

  1. Browse your local directory and find the Fusion license file–by default it is named license_bundle_20160524191753.txt.
  2. Click the Upload button.

Fusion restarts.

Updating on macOS

To update Fusion with each new release:

  1. Close Excel.
  2. Uninstall the current version of Fusion.
  3. Install the new version.

Fusion is updated.

Uninstalling on macOS

To uninstall Fusion:

  1. Open a terminal window.

  2. To remove the folder where Fusion was installed, run:

    rm -r ~/AnacondaFusion
    

Fusion is uninstalled.

Next steps

For information about using Fusion, see Getting started.