Repository: incubator-systemml Updated Branches: refs/heads/master 199562313 -> 1d45690c7
[SYSTEMML-773] Added assumptions with SYSTEMML to README. Project: http://git-wip-us.apache.org/repos/asf/incubator-systemml/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-systemml/commit/1d45690c Tree: http://git-wip-us.apache.org/repos/asf/incubator-systemml/tree/1d45690c Diff: http://git-wip-us.apache.org/repos/asf/incubator-systemml/diff/1d45690c Branch: refs/heads/master Commit: 1d45690c7aa203db5e7a88c4c046920a836fd627 Parents: 1995623 Author: MadisonJMyers <[email protected]> Authored: Tue Jun 28 08:56:51 2016 -0700 Committer: Mike Dusenberry <[email protected]> Committed: Tue Jun 28 10:05:20 2016 -0700 ---------------------------------------------------------------------- README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 67 insertions(+), 3 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-systemml/blob/1d45690c/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index e78cd9a..31bed64 100644 --- a/README.md +++ b/README.md @@ -67,8 +67,73 @@ using rule-based and cost-based optimization techniques. The optimizer automatic execution plans ranging from in-memory, single-node execution, to distributed computations on Spark or Hadoop. This ensures both efficiency and scalability. Automatic optimization reduces or eliminates the need to hand-tune distributed runtime execution plans and system configurations. +* * * - +## SystemML Assumptions + +Before you get started on SystemML, make sure that your environment is set up and ready to go. + + 1. **If youâre on a mac, youâll want to install homebrew (http://brew.sh) if you havenât already.** + + *Copy and paste the following into your terminal.* + + ``` + /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" + ``` + 2. **Now install Java (need Java 8).** + ``` + brew tap caskroom/cask + brew install Caskroom/cask/java + ``` + + 3. **Now install everything else you need** + + *In order to install something on homebrew all you need to do is type "brew install" followed by what you want to install. See below.* + + **Install Spark 1.6** + ``` + brew install apache-spark + ``` + **Install python** + ``` + brew install python + ``` + **Install jupyter and matplotlib and numpy.** + ``` + pip install jupyter matplotlib numpy + ``` + 4. **Now you can install SystemML.** + + Go to http://systemml.apache.org/download.html and click on the systemml-0.10.0-incubating zip (should be 2nd). + + *The next step is optional, but it will make your life a lot easier.* + + 5. **Set `SPARK_HOME and SYSTEMML_HOME` on your bash profile.** + + *First, use vim to create/edit your bash profile. Not sure what vim is? Check https://www.linux.com/learn/vim-101-beginners-guide-vim.* + + *We are going to insert our file where Spark and SystemML is stored into our bash profile. This will make it easier to access. **Type the following to open your bash profile using vim:*** + ``` + vim .bash_profile + ``` + **Now you are in vim. First, type âiâ for insert.** + ``` + i + ``` + **Now insert Spark and SystemML.** Note: /Documents is where I saved my Spark and SystemML. Be sure that your file path is accurate. + + ``` + export SPARK_HOME=/Users/stc/Documents/spark-1.5.1-bin-hadoop2.6 + + export SYSTEMML_HOME=/Users/stc/Documents/systemml-0.10.0-incubating + ``` + **Now type :wq to write the file and quit.** + ``` + :wq + ``` + *Make sure to open a new tab in terminal so that you make sure the changes have been made.* + +**Congrats! You can now run SystemML!** * * * ## Building SystemML @@ -103,7 +168,7 @@ If required, please install the following packages in R: ## Importing SystemML into IDE -This section describe how to import SystemML source code into an IDE. +This section describe how to import SystemML source code into an IDE. ### Import SystemML Project to Eclipse @@ -381,4 +446,3 @@ For convenience, we can encapsulate our DML invocations in a single script: In this example, we've seen a small part of the capabilities of SystemML. For more detailed information, please consult the [Apache SystemML (incubating)](http://systemml.apache.org/) website and the [SystemML Documentation](http://apache.github.io/incubator-systemml/) website on GitHub. -
