Installation

Windows (Tested on Windows 10)

• Download the latest release from the Releases page.
• Install Microsoft Visual C++ 2008 Redistributable Package (x86).
• Run the installer or unzip the files you downloaded from the release page.
• Run CarbonXS_GUI.exe

Mac OSX (Requires version 10.10 and newer)

• Download the latest release from the Releases page.
• Extract the file from the .dmg package.
• Run CarbonXS_GUI.app

From Source

Linux

Ubuntu Linux (Tested on Ubuntu 16.04 LTS)

• Open a terminal
• Install GCC: sudo apt-get install gcc
• Install Git: sudo apt-get install git
• Clone the repository: git clone https://github.com/lktsui/carbon_xs_gui/
• Navigate to carbonxs directory: cd carbon_xs_gui/carbonxs
• Compile CarbonXS: gfortran CARBONXS.FOR -fno-automatic -static-libgcc -std=legacy -O3 -o carbonxs_app
• Install Python dependencies
  • pip install ujson
  • pip install matplotlib
  • pip install appdirs
  • sudo apt-get install python-pyside
• Launch CarbonXS GUI: python CarbonXS_GUI.py

Fedora Linux (Tested on Fedora 25 Workstation)

• Open a terminal
• Install Development Tools: sudo dnf group install "Development Tools"
• Install Gfortran: sudo dnf install gcc-gfortran
• Install Python: sudo dnf install python
• Install Python Development Tools: sudo dnf install python-devel
• Clone the repository: git clone https://github.com/lktsui/carbon_xs_gui/
• Navigate to carbonxs directory: cd carbon_xs_gui/carbonxs
• Compile CarbonXS: gfortran CARBONXS.FOR -fno-automatic -static-libgcc -std=legacy -O3 -o carbonxs_app
• Install Python dependencies
  • sudo dnf install python-pyside
  • sudo dnf install python-matplotlib
  • sudo dnf install python-matplotlib-qt4
  • sudo pip install appdirs
  • sudo pip install ujson
• Launch CarbonXS GUI: python CarbonXS_GUI.py

Mac OSX (Tested on macOS 10.12 Sierra)

• Open a terminal
• Install Xcode tools: xcode-select --install
• Install the Homebrew package manager: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
• Install GCC: brew install gcc
• Install wget: brew install wget
• Install cmake: brew install cmake
• Install Git: brew install git
• Install Homebrew Python: brew install python
• Make the Homebrew Python default: brew link --overwrite python
• Clone the repository: git clone https://github.com/lktsui/carbon_xs_gui/
• Navigate to carbonxs directory: cd carbon_xs_gui/carbonxs
• Compile CarbonXS: gfortran CARBONXS.FOR -fno-automatic -static-libgcc -std=legacy -O3 -o carbonxs_app
• Install Python dependencies
  • pip install ujson
  • pip install appdirs
  • pip install matplotlib
  • Option 1: pip install pyside
  • Option 2: If Option 1 fails, follow these instructions to compile Pyside: Building PySide on a Mac OSX System. Briefly:
  • brew tap cartr/qt4
  • brew tap-pin cartr/qt4
  • brew install cartr/qt4/qt
  • wget https://pypi.python.org/packages/source/P/PySide/PySide-1.2.4.tar.gz
  • tar -xvzf PySide-1.2.4.tar.gz
  • cd PySide-1.2.4
  • python setup.py bdist_wheel - Note! This may take up to an hour to complete.
  • pip install dist/PySide-1.2.4-cp27-{Your version of OSX}-x86_64.whl
• Launch CarbonXS GUI: python CarbonXS_GUI.py

Compiling CarbonXS

• If you ever need to modify the CarbonXS program, follow these instructions. CarbonXS is written in Fortran 77 and requires these compilation flags to work on a modern compiler like GCC.
• Install the GNU Compiler Collection (GCC)
• Ubuntu Linux: sudo apt-get install gcc. For other distributions, follow your package management instructions
• Mac OSX (with Homebrew installed): brew install gcc
• Windows: Download and install the MinGW package.
• In Windows, include the following files from the MinGW package located in the mingw64/bin directory to use the compiled version on a different computer.
• libgcc_s_seh-1.dll
• libquadmath-0.dll
• libwinpthread-1.dll
• Compile CarbonXS (Linux/OSX): gfortran CARBONXS.FOR -fno-automatic -static-libgfortran -static-libgcc -std=legacy -O3 -o carbonxs_app
• Portability on OSX: libquadmath is not appropriately static linked on OSX and compiled versions on one computer are not guaranteed to work on another. Per this answer on Stack Overflow, the files libquadmath.0.dylib and libquadmath.dylib must be removed or renamed in the gcc library folder.
• Compile CarbonXS (Windows): gfortran CARBONXS.FOR -fno-automatic -static-libgcc -static-libgfortran -std=legacy -O3 -o carbonxs_gfortran.exe