Update procedure of installation on Mac OSX

README.md

@@ -65,7 +65,7 @@ They are:
 
 - SystemC 2.3.1 and TLM 2.0
 
-  The sources can be downloaded from http://accellera.org/downloads/standards/systemc.
+  The sources can be downloaded from [this](http://accellera.org/downloads/standards/systemc).
 
   For installation instructions see the installation notes file contained in
   the release package.
@@ -80,7 +80,7 @@ They are:
   $ sudo make install
   ```
 
-  For further information refer to http://qwt.sourceforge.net/
+  For further information refer to [this](http://qwt.sourceforge.net/)
 
 - python3.5
 
@@ -211,68 +211,123 @@ $ ./traceAnalyzer
 ```
 
 ### Building on OSX
+- Install XCode
+
+- Install SystemC manually in /opt:
+
+``` bash
+$ ./configure --prefix=/opt/systemc
+$ make
+$ sudo make install
+```
+
+- Install the required python 3 over macports:
 
-- Install SystemC in /opt (as usual with ./configure --prefix=/opt/systemc; make; make install;).
-- Install the required python over macports:
 ``` bash
 sudo port install python34
 ```
 
+or you can install manually using official package provided in [link](https://www.python.org/downloads/)
+
+**Note:** Official Python Package will be installed in 
+```
+/Library/Frameworks/Python.framework
+``` 
+
 - Install the QtCreator via macports:
+
 ``` bash
-sudo port install qt5-creator qt5
+$ sudo port install qt5-creator qt5
+```
+
+or you can install it using offical setup file from [link](https://www.qt.io/download-open-source/#section-2)
+
+**Note:** You have later setup PATH for Qt5 and its tool if you install QtCreator manually, e.g:
+
+``` bash
+# Setting PATH for Qt5 and its tools
+PATH="/Users/<username>/Qt5.7.0/5.7/clang_64/bin:${PATH}"
+export PATH
 ```
 
 - Install the QWT manually to /opt/qwt, then do:
-``` bash
-cd /Library/Frameworks
-sudo ln -s /opt/qwt-6.1.2/lib/qwt.framework/ .
-```
-- The boost library must be installed manually, since the macports version is not compatible with DRAMSys:
-
-In your “user-config.jam”, put this:
 
 ``` bash
-using clang : 11
+$ cd /Library/Frameworks
-    : "/usr/bin/clang++"
+$ sudo ln -s /opt/qwt-6.1.2/lib/qwt.framework/ .
-    : <cxxflags>"-std=c++11 -stdlib=libc++" <linkflags>"-stdlib=libc++""
+```
-    ;
+
+- The boost library can be installed manually or through homebrew:
+
+Manually: Install boost lib (filesystem & system) in /opt/boost
 
-```
-Then compile and install it:
 ``` bash
-./b2 toolset=clang-11
+$ ./bootstrap.sh --prefix=/opt/boost --with-libraries=filesystem,system
-sudo ./b2 install
+$ sudo ./b2 install
-``` 
-DRAMSys and Analyzer only runs if the following is configured in the project settings:
 ```
-DYLD_LIBRARY_PATH=/opt/boost/lib
+
-LIBQWT_HEADERS=/opt/local/include
+Homebrew: Install boost lib (all, which consumes large storage) in /usr/local/Cellar 
-LIBQWT_HOME=/opt/local/lib
+
-PYTHON_HEADERS=/opt/local/include
+``` bash
-PYTHON_HOME=/opt/local/lib
+$ sudo brew install boost
-SYSTEMC_TARGET_ARCH=macosx64
+```
-``` 
+
-For the trace analyzer the file /opt/local/Library/Frameworks/Python.framework/Versions/3.4/include/python3.4m/pyport.h has to be changed like this: https://trac.macports.org/attachment/ticket/44288/issue10910-workaround.txt
+
+- Export correct Environment Variables in your terminal's profile, e.g:
+
+``` bash
+# Setting for DRAMSys
+# SystemC home and target architecture
+export SYSTEMC_HOME=/opt/systemc
+export SYSTEMC_TARGET_ARCH=macosx64
+# DRAMSys libraries and headers
+export PYTHON_HOME=/Library/Frameworks/Python.framework/Versions/3.5/lib
+export PYTHON_HEADERS=/Library/Frameworks/Python.framework/Versions/3.5/Headers
+export LIBQWT_HOME=/opt/qwt-6.1.4/lib
+export LIBQWT_HEADERS=/opt/qwt-6.1.4/lib/qwt.framework/Headers
+export LIBBOOST_HOME=/opt/boost/lib
+export LIBBOOST_HEADERS=/opt/boost/include
+
+# Add Boost Lib into Dynamic Lib Path
+DYLD_LIBRARY_PATH="/opt/boost/lib:${DYLD_LIBRARY_PATH}"
+export DYLD_LIBRARY_PATH
+```
+
+-  For the trace analyzer the file:
+```
+/opt/local/Library/Frameworks/Python.framework/Versions/3.5/include/python3.4m/pyport.h 
+```
+has to be changed like [this](https://trac.macports.org/attachment/ticket/44288/issue10910-workaround.txt)
+
+- Install package [xerces](http://xerces.apache.org/mirrors.cgi) if your system does not have.
+
+- Type following command inside your dram.vp.system folder:
+
+``` bash
+$ mkdir build
+$ qmake ../DRAMSys/dram.vp.system.pro
+$ make -j<number_jobs>
+```
+
+Now you can try to run DramSys and traceAnalyzer App inside folder simulator and analyzer, respectively
 
 ### DRAMSys Thermal Simulation 
 
 The thermal simulation is performed by a **3D-ICE** [8] server accessed
 through the network. Therefore users interested in thermal simulation during
 their DRAMSys simulations need to make sure they have a 3D-ICE server up and
-running before starting. For more information about 3D-ICE visit the official
+running before starting. For more information about 3D-ICE visit the [official website](http://esl.epfl.ch/3D-ICE).
-website http://esl.epfl.ch/3D-ICE.
 
 #### Installing the lastest 3D-ICE version
 
-Download the lastest version. Make sure you got version 2.2.6 or greater:
+[Download](http://esl.epfl.ch/3d-ice/download.html) the lastest version. Make sure you got version 2.2.6 or greater:
 
 ``` bash
 $ wget http://esl.epfl.ch/files/content/sites/esl/files/3dice/releases/3d-ice-latest.zip
 $ tar -xvzf 3d-ice-latest.zip
 ```
 
-Install SuperLU dependencies:
+Install [SuperLU](http://crd-legacy.lbl.gov/~xiaoye/SuperLU/superlu_5.2.1.tar.gz) dependencies:
 
 ``` bash
 $ sudo apt-get install build-essential git bison flex libblas-dev