Build

Contributers can build El-MAVEN on Windows, Ubuntu or Mac systems by following these instructions. Users are recommended to download the installers provided on the El-MAVEN website.

Windows

  • Download MSYS2 installer and follow the installation instructions provided on their website.

  • Open MSYS2 and give the following commands to set up libraries and tool chains for El-MAVEN. Reopen MSYS2 when required:

    • For 64 bit

      • pacman --force -Sy
      • pacman --force -Syu
      • pacman --force -Su
      • pacman --force -Sy base-devel msys2-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-qt5 mingw64/mingw-w64-x86_64-hdf5 mingw64/mingw-w64-x86_64-netcdf mingw64/mingw-w64-x86_64-boost msys/git

    • For 32 bit

      • pacman --force -Sy
      • pacman --force -Syu
      • pacman --force -Su
      • pacman --force -Sy base-devel msys2-devel mingw-i686-toolchain mingw-i686-qt5 mingw32/mingw-i686-hdf5 mingw32/mingw-i686-netcdf mingw32/mingw-i686-boost msys/git

  • Open mingw64.exe from the MSYS2 folder and give the following commands:

    • cd <PathToInstallationFolder> #for example: cd /c/User/Admin/Desktop
    • git clone https://github.com/ElucidataInc/ElMaven.git
    • ./run.sh
    • ./bin/El_Maven_0.x #for example: ./bin/El_Maven_0.2

El-MAVEN loads with two windows: one for logging the application status and another El-MAVEN application window for data analysis.

Ubuntu

  • Open the terminal and give the following commands to set up libraries and tool chains for El-MAVEN

    • sudo apt-get update
    • sudo apt-get install g++
    • sudo apt-get install qt5-qmake qtbase5-dev qtscript5-dev qtdeclarative5-dev libqt5webkit5-dev libsqlite3-dev libboost-all-dev lcov libnetcdf-dev
    • cd <PathToInstallationFolder> #for example: user@pc:~$ cd Desktop/
    • git clone https://github.com/ElucidataInc/ElMaven.git
    • ./run.sh
    • ./bin/El_Maven_0.x #for example: ./bin/El_Maven_0.2

El-MAVEN loads with two windows: one for logging the application status and another El-MAVEN application window for data analysis.

MacOS

  • Install Xcode from App store
  • Download and Install Qt5.6

This will give you the Qt5.6.2 dmg file. Using the dmg file install Qt under the directory /Users/Your_User_Name/

  • Using the terminal execute the following commands:

    • sudo xcodebuild -license accept
    • xcode-select --install
    • /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    • brew install boost brew install llvm@3.7 brew install netcdf
    • cd ~
    • touch .profile
    • echo "PATH=/Users/$USER/Qt5.6.2/5.6/clang_64/bin/:$PATH" > .profile
    • source .profile
    • mkdir ~/maven_repo
    • cd ~/maven_repo
    • git clone https://github.com/ElucidataInc/ElMaven.git
    • cd ElMaven
    • source ~/.profile
    • qmake CONFIG+=debug -o Makefile build.pro
    • make -j4

Switching Versions

Users can switch between versions once they have compiled El-MAVEN successfully on their system. Follow these steps to pull a specific release:

  • Choose the version you wish to install from the list of releases. (We recommend the version tagged “Latest release”. Pre-releases are not stable and should be avoided)

  • Find the version tag (v0.2.x, 0.1.x, etc) on the left of release notes.

  • Open your terminal and move to the installation folder

  • Give the following commands in the terminal:

    • cd ElMaven

    • ./uninstall.sh

    • git checkout develop

    • git pull

    • git checkout v0.x.y (Example: v0.1.5)

    • Build the new version using the following commands:

      • For Windows and Ubuntu

        • ./run.sh

      • For MacOS

        • source ~/.profile
        • qmake CONFIG+=debug -o Makefile build.pro
        • make -j4