The list of operating systems explicitly supported by this build mechanism is:
Operating system: macOS High Sierra 10.13.6; Steps to Reproduce. I gather you've configured SourceTree to use a system-installed Git, which might explain why it. I’m seeing extremely high CPU usage (up to 115% according to Activity Monitor) using Sourcetree 3 Beta (198) on macOS High Sierra (10.13.6). This happens even when there are no Sourctree windows open.
- Ubuntu 20.04 LTS (using the system Python 3)
- Ubuntu 18.04 LTS (using the system Python or Python 3)
- Ubuntu 16.04 LTS (using the system Python or Python 3)
- macOS 10.13.x -- 10.14.x (High Sierra and Mojave) (using Python 2 or Python 3)
- Fedora 30 (Using Python 3)
The general organization of the build is that a set of libraries is expectedto be on the user's system, typically as installed by the system's packagemanager. In the case of macOS, we assume the use of Homebrew (see below).On Linux systems, Python packages are assumed to have been installed using thesystem's package manager. On macOS, Python packages are assumed to have beeninstalled using the package's
setup.py
script, as is done by pip
.Installing the required packages for Ubuntu 20.04 LTS, 18.04 LTS and Ubuntu 16.04 LTS
We assume that you will be building and installing both CHEF and Synergia,so these instructions provide unified instructions.
For Ubuntu 16.04 LTS (but not later),you need to install a more modern
CMake
than that which isavailable from the system's package manager. A binary installation can be installeddirectly from the cmake.org web site. At the time of this writing (10 Nov 2020)the current version is cmake v3.18.4; newer versions are expected to work.The following instructions will download and install this version:Sourcetree For High Sierra Windows
The
cmake
executable (and others) will be put into ${HOME}/bin
, which must appearon {PATH}
; add this directory if necessary.The following list of commands will install the libraries, headers, and Python modulesrequired for building and using CHEF, using Python 2.
For Python 2 (deprecated), install the following:
To build using Python 3, install these packages:
Installing the required packages for macOS 'Mojave' and 'Catalina'
Building CHEF requires installation of Apple's development environment, Xcode,or at least the Xcode command-line tools.Xcode is available, free of charge, from the Apple's App Store.We recommend keeping your Xcode installation up-to-date.Installing Xcode requires an Apple ID,which is also available free of charge.After installing Xcode,the Xcode command-line tools can be installed by running:
If you already have the command-line tools installed, this will result in a harmless error message:
The following list of commands will install the libraries, headers, and Python modulesrequired for building and using CHEF.We rely upon Homebrew's python, which is newer than that shipped by Apple.Homebrew is available at brew.sh.
We strongly recommend keeping your Homebrew installation up-to-dateby regularly using both
brew update
and brew upgrade
.To be able to run some of tests for Synergia, you will also need some Pythonmodules that are not part of the standard Python library, nor are availablethrough Homebrew. We recommend making use of a virtual environment for thisinstallation. You can create the virtual environment in any directory thatis convenient; you will need to retain this directory so that you can activatethe virtual environment whenever you want to use any Synergia python script(such as the Synergia tests) that use these modules.
In whatever directory you want to create the virtual environment, usethe following commands:
Sourcetree For High Sierra Free
Whenever you want to have access to these modules, you must sourcethe activate script:
Installing the required packages for Fedora 30
The following command will install the libraries, headers, and Python modulesrequired for building and using
CHEF
, using Python 3.Building and installing CHEF
These instructions assume that you have already installed the required packagesfor your operating system, as described above.
- Create a top-level working directoryThis is the directory into which you will clone the source (for both CHEF and Synergia)and build the software. Note this is distinct from the directory into which you willinstall the resulting build.Define the environment variable SYNERGIA_TOP_DIR to point to this directory.
- Obtain the source code Phase one pro.The CHEF code is in a git repository, and can be obtained byNote that this branch is the only one currently supporting this CMake build.
- Create the build directoryWe use an out-of-source build to prevent accidental pollution of thesource code repository, and to simplify having multiple builds (e.g. debug and release)of the same source code.
- Generate makefilesSpecial note for Fedora 30: The Fedora 30 installation of MPI is only active in your environment after being 'loaded' by the
modules
system.The command to load the require module is:You must do this in every new shell in which you wish to use CHEF or Synergia.End note.You must decide where to want to install the CHEF software you build.Define the environment variableCHEF_INSTALL_DIR
appropriately;make sure the named directory exists.In the example below, we defineCHEF_INSTALL_DIR
so that CHEF is installedunder the user's home directory.If you are building on Fedora 30, please note the extracmake
argument that is required to help find the FFTW3 MPI libraries. - Build the codeThe makefiles generated by CMake support parallel builds.We find setting the level of parallelism (the argument of
-j
, 4 in the example below)to be equal to the number of cores on your computergenerally works well. - Test the codeThe CTest system supported by CMake can support parallel tests.It is expected that all provided tests will pass;if any test does not pass on your system,please file an issue.
- Install the codeOnly install the code if all tests have passed.The libraries, headers, and python modules will be installed in
CHEF_INSTALL_DIR
,as defined above.
Sourcetree For High Sierra
When you are done, you may also want to build Synergia2.See Synergia build instructions.
Sourcetree For High Sierra Download
Updated