Build¶
Contributors can build El-MAVEN on Windows, Ubuntu or Mac systems by following these instructions. Users are recommended to download the installers provided here.
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 for data analysis.
Ubuntu¶
Open the terminal and give the following commands to set up the 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 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 “Current Release”. Past 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.4.1)
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