Skip to content

Downloading the DREAM.3D Source Code

Jump to bottom
joeykleingers edited this page Jul 11, 2017 · 9 revisions

Prerequisites

These prerequisites need to be completed before the source code for DREAM.3D is downloaded.

If you have already fulfilled all of these prerequisites, skip to the Downloading the Source Code section.

Install Git

Git needs to be installed on your system to be able to clone repositories from Github.

To install Git, please visit the Git website.

Downloading the Source Code

DREAM.3D is publicly available on Github, and can be downloaded using Git. The user is strongly encouraged to use a GUI based Git tool such as SourceTree in order to manage cloning all four (4) source archives.

Mac OS X

  1. Make a new directory called Workspace in your home directory. The Workspace directory's path should be /Users/[YOUR-HOME-DIRECTORY]/Workspace.

  2. Open Terminal at /Applications/Utilities/Terminal.app.

  3. Navigate to your Workspace directory at /Users/[YOUR-HOME-DIRECTORY]/Workspace.

  4. Use git to clone the DREAM.3D repository to your Workspace directory:

    git clone -b develop https://www.github.com/bluequartzsoftware/DREAM3D

    Clone 3 other repositories to your Workspace directory that are required to build DREAM.3D:

    git clone -b develop https://www.github.com/bluequartzsoftware/CMP git clone -b develop https://www.github.com/bluequartzsoftware/SIMPL git clone -b develop https://www.github.com/bluequartzsoftware/SIMPLView

    All 4 of these repositories should be cloned/downloaded into the Workspace folder so that the final paths to all 4 repositories look like the following:

    /Users/[YOUR-HOME-DIRECTORY]/Workspace/DREAM3D

    /Users/[YOUR-HOME-DIRECTORY]/Workspace/CMP

    /Users/[YOUR-HOME-DIRECTORY]/Workspace/SIMPL

    /Users/[YOUR-HOME-DIRECTORY]/Workspace/SIMPLView

Windows 8.1/10

  1. Make a new directory called Workspace in your user directory. The Workspace directory's path should be C:\Users\[YOUR-USER-DIRECTORY]\Workspace.

  2. Open the git-bash application that was installed when you downloaded and installed Git.

  3. Navigate to your Workspace directory at C:\Users\[YOUR-USER-DIRECTORY]\Workspace.

  4. Use git to clone the DREAM.3D repository to your Workspace directory:

    git clone -b develop https://www.github.com/bluequartzsoftware/DREAM3D

    Clone 3 other repositories to your Workspace directory that are required to build DREAM.3D:

    git clone -b develop https://www.github.com/bluequartzsoftware/CMP git clone -b develop https://www.github.com/bluequartzsoftware/SIMPL git clone -b develop https://www.github.com/bluequartzsoftware/SIMPLView

    All 4 of these repositories should be cloned/downloaded into the Workspace folder so that the final paths to all 4 repositories look like the following:

    C:\Users\[YOUR-USER-DIRECTORY]\Workspace\DREAM3D

    C:\Users\[YOUR-USER-DIRECTORY]\Workspace\CMP

    C:\Users\[YOUR-USER-DIRECTORY]\Workspace\SIMPL

    C:\Users\[YOUR-USER-DIRECTORY]\Workspace\SIMPLView

Linux

  1. Make a new directory called Workspace in your home directory. The Workspace directory's path should be /home/[YOUR-HOME-DIRECTORY]/Workspace.

  2. Open the Terminal program.

  3. Navigate to your Workspace directory at /home/[YOUR-HOME-DIRECTORY]/Workspace.

  4. Use git to clone the DREAM.3D repository to your Workspace directory:

    git clone -b develop https://www.github.com/bluequartzsoftware/DREAM3D

    Clone 3 other repositories to your Workspace directory that are required to build DREAM.3D:

    git clone -b develop https://www.github.com/bluequartzsoftware/CMP git clone -b develop https://www.github.com/bluequartzsoftware/SIMPL git clone -b develop https://www.github.com/bluequartzsoftware/SIMPLView

    All 4 of these repositories should be cloned/downloaded into the Workspace folder so that the final paths to all 4 repositories look like the following:

    /home/[YOUR-HOME-DIRECTORY]/Workspace/DREAM3D

    /home/[YOUR-HOME-DIRECTORY]/Workspace/CMP

    /home/[YOUR-HOME-DIRECTORY]/Workspace/SIMPL

    /home/[YOUR-HOME-DIRECTORY]/Workspace/SIMPLView

Next Page: Configuring and Building DREAM.3D (Windows).

Next Page: Configuring and Building DREAM.3D (OS X).

Next Page: Configuring and Building DREAM.3D (Linux).

Previous Page: Making an SDK (Windows).

Previous Page: Making an SDK (OS X).

Previous Page: Making an SDK (Linux).

Clone this wiki locally