Differences between revisions 2 and 36 (spanning 34 versions)

This page documents the installation of the Dynare on Mac OS X. If you have any troubles, please contact <houtan AT SPAMFREE dynare DOT org>

Install Dynare (Stable)

Dynare for Matlab

Download the appropriate Dynare package for your version of Mac OS X from the Dynare website
Install Dynare by double-clicking on the package and following the installation instructions.
1. If you get a warning saying that the package cannot be opened "because it is from an unidentified developer," open the folder containing the package, right-click on it, select "Open" from the menu that pops up, and select "Open" from the dialog box that pops up.
The default installation folder is /Applications/Dynare/<<version>>, where <<version>> is one of 4.2.0, 4.2.1, 4.2.2, etc.

Dynare for Octave (Stable)

Install Homebrew by following the directions on their site
Tap Homebrew-Science
1. brew tap homebrew/science
Look at the available installation options by typing brew info dynare at the terminal prompt
Install Dynare, passing the options you require for your setup
1. E.g., to install Dynare with support for Octave and Matlab 2014b and avoid testing the compiled files, you would type the following at the command prompt:
2. brew install dynare --with-matlab=/Applications/MATLAB_R2014b.app --with-matlab-version=8.4 --without-check
3. NB: We encourage you to always pass the --without-check option
The default installation folder is ls /usr/local/Cellar/dynare/<<version>>, where <<version>> is one of 4.2.0, 4.2.1, 4.2.2, etc.

Install Dynare (Unstable)

Via the snapshot (Provides Matlab mex files)

Follow the instructions above using the latest Dynare snapshot for macOS

Via Homebrew (provides Matlab and Octave mex files)

Install Homebrew by following the directions on their site
Tap Homebrew-Science
1. brew tap homebrew/science
Look at the available installation options by typing brew info dynare at the terminal prompt
Install Dynare, passing the options you require for your setup
1. E.g., to install Dynare with support for Octave and Matlab 2014b and avoid testing the compiled files, you would type the following at the command prompt:
2. brew install dynare --HEAD --with-matlab=/Applications/MATLAB_R2014b.app --with-matlab-version=8.4 --without-check
3. NB: We encourage you to always pass the --without-check option
The default installation folder is ls /usr/local/Cellar/dynare/<<version>>, where <<version>> is one of 4.2.0, 4.2.1, 4.2.2, etc.

Setup Matlab/Octave to use Dynare

Dynare (stable) on Mac OS X 10.6 or higher

MATLAB Setup

Add /Applications/Dynare/<<version>>/matlab/ to your Matlab path. You can do this either using the addpath command to add it just for this session or using the menu option File->Set Path... to add it across Matlab sessions.

Octave Setup

Having installed Octave via Homebrew, open Octave by typing octave at the terminal prompt.
At the Octave prompt, type: addpath /usr/local/opt/dynare/lib/dynare/matlab

Dynare 4.3.3 - 4.4.2 on Mac OS X 10.6 or higher

MATLAB Setup

Add /Applications/Dynare/<<version>>/matlab/ to your Matlab path. You can do this either using the addpath command to add it just for this session or using the menu option File->Set Path... to add it across Matlab sessions.

Octave Setup

Install Octave 3.6.4 via Homebrew (which requires XCode) by following the instructions in the "Simple Installation Instructions" subsection of the "Homebrew" section of this site.
Before executing MOD files, you need to execute the following command at Octave prompt:
```
addpath /Applications/Dynare/<<version>>/matlab
```

Dynare 4.2.2 - 4.3.2 on Mac OS X 10.6 or higher

MATLAB Setup

Add /Applications/Dynare/<<version>>/matlab/ to your Matlab path. You can do this either using the addpath command to add it just for this session or using the menu option File->Set Path... to add it across Matlab sessions.

Octave Setup for OS X 10.6 and 10.7 (not available under 10.8)

Download and install version 3.4.0 of the Octave Mac OS X binary and add /Applications/Octave.app/Contents/Resources/bin to your search path.
If you are going to use the use_dll or k_order_perturbation options, add the following lines to the /Applications/Octave.app/Contents/Resources/bin/mkoctfile-3.4.0 file after the set -e statement at the top of the file
```
CFLAGS="-arch i386 ${CFLAGS}"
FFLAGS="-arch i386 ${FFLAGS}"
CPPFLAGS="-arch i386 ${CPPFLAGS}"
CXXFLAGS="-arch i386 ${CXXFLAGS}"
LDFLAGS="-arch i386 ${LDFLAGS}"
```
Before executing MOD files, you need to execute the following command at Octave prompt:
```
addpath /Applications/Dynare/<<version>>/matlab
```

Dynare 4.2.0 or 4.2.1 on Mac OS X 10.5 or 10.6

MATLAB Setup

Install XCode 3.2 or later, which can either be installed from the internet or from the installation discs that came with your Mac. This installs the necessary gcc compilers required by build_dynare.m in step 3.
In Matlab, change directory to the root folder of the Dynare installation directory. In the standard installation, you need to do:
```
>> cd /Applications/Dynare/<<version>>
```
At the Matlab prompt, run
```
>> build_dynare
```
Once this has finished running, go to File->Set Path... and add the path to the matlab/ subfolder under the installation folder. In the standard installation, this will be /Applications/Dynare/<<version>>/matlab. Save the changes before closing the window.

Octave Setup

Download and install version 3.2.3 of the Octave Mac OS X binary and add /Applications/Octave.app/Contents/Resources/bin to your search path.
If you are going to use the use_dll or k_order_perturbation options, add the following lines to the /Applications/Octave.app/Contents/Resources/bin/mkoctfile-3.2.3 file after the set -e statement at the top of the file
```
CFLAGS="-arch i386 ${CFLAGS}"
FFLAGS="-arch i386 ${FFLAGS}"
CPPFLAGS="-arch i386 ${CPPFLAGS}"
CXXFLAGS="-arch i386 ${CXXFLAGS}"
LDFLAGS="-arch i386 ${LDFLAGS}"
```
Before excuting MOD files, you need to execute the following command at Octave prompt:
```
addpath /Applications/Dynare/<<version>>/matlab
```

Documentation

Documentation can be found in the doc/ folder under the installation directory (the default is /Applications/Dynare/<<version>>/doc). The User Guide (located by default in /Applications/Dynare/<<version>>/doc/userguide/UserGuide.pdf) is a particularly helpful starting place. Errata for the User Guide can be found here.

-  ⇤ ← Revision 2 as of 2010-01-18 14:02:12 → 
  Size: 2171
  Editor: SébastienVillemot
  Comment:
+   ← Revision 36 as of 2017-06-08 07:48:23 → ⇥
  Size: 7699
  Editor: HoutanBastani
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 4:
-This page documents the installation of the Dynare 4.1.0 Package on Mac OS X 10.5 or higher.
+This page documents the installation of the Dynare on Mac OS X. If you have any troubles, please contact <<MailTo(houtan AT SPAMFREE dynare DOT org)>>
 Line 6:
-= First steps =
 1. Download the Dynare package for Mac OS X from [[http://www.dynare.org/download/dynare-4.1/mac|Dynare website]]
 1. Install Dynare by double-clicking on the package and following the installation instructions
 1. The default installation folder is {{{/Applications/Dynare/4.1.0}}}, but you can modify it
+= Install Dynare (Stable) =
------
== Dynare for Matlab ==
 1. Download the appropriate Dynare package for your version of Mac OS X from the [[http://www.dynare.org/download/dynare-stable|Dynare website]]
 1. Install Dynare by double-clicking on the package and following the installation instructions.
   1. If you get a warning saying that the package cannot be opened "because it is from an unidentified developer," open the folder containing the package, right-click on it, select "Open" from the menu that pops up, and select "Open" from the dialog box that pops up.
 1. The default installation folder is {{{/Applications/Dynare/<<version>>}}}, where {{{<<version>>}}} is one of {{{4.2.0, 4.2.1, 4.2.2}}}, etc.
-Line 11:
+Line 14:
-= MATLAB Setup =
+== Dynare for Octave (Stable) ==
 1. Install [[http://brew.sh/|Homebrew]] by following the directions on their site
 1. Tap [[https://github.com/Homebrew/homebrew-science|Homebrew-Science]]
   1. {{{brew tap homebrew/science}}}
 1. Look at the available installation options by typing {{{brew info dynare}}} at the terminal prompt
 1. Install Dynare, passing the options you require for your setup
   1. E.g., to install Dynare with support for Octave and Matlab 2014b and avoid testing the compiled files, you would type the following at the command prompt:
   1. {{{brew install dynare --with-matlab=/Applications/MATLAB_R2014b.app --with-matlab-version=8.4 --without-check}}}
   1. NB: We encourage you to always pass the {{{--without-check}}} option
 1. The default installation folder is {{{ls /usr/local/Cellar/dynare/<<version>>}}}, where {{{<<version>>}}} is one of {{{4.2.0, 4.2.1, 4.2.2}}}, etc.
-Line 13:
+Line 25:
-. Change directory to the {{{src/mex/sources}}} folder of the installation directory. In the standard installation, you need to do:
+<<Anchor(UnstableOSX)>>
= Install Dynare (Unstable) =
------
== Via the snapshot (Provides Matlab mex files) ==
 1. Follow the instructions above using the [[http://www.dynare.org/snapshot/macosx/dynare-latest-osx.zip|latest Dynare snapshot for macOS]]
== Via Homebrew (provides Matlab and Octave mex files) ==
 1. Install [[http://brew.sh/|Homebrew]] by following the directions on their site
 1. Tap [[https://github.com/Homebrew/homebrew-science|Homebrew-Science]]
   1. {{{brew tap homebrew/science}}}
 1. Look at the available installation options by typing {{{brew info dynare}}} at the terminal prompt
 1. Install Dynare, passing the options you require for your setup
   1. E.g., to install Dynare with support for Octave and Matlab 2014b and avoid testing the compiled files, you would type the following at the command prompt:
   1. {{{brew install dynare --HEAD --with-matlab=/Applications/MATLAB_R2014b.app --with-matlab-version=8.4 --without-check}}}
   1. NB: We encourage you to always pass the {{{--without-check}}} option
 1. The default installation folder is {{{ls /usr/local/Cellar/dynare/<<version>>}}}, where {{{<<version>>}}} is one of {{{4.2.0, 4.2.1, 4.2.2}}}, etc.

= Setup Matlab/Octave to use Dynare =
------
== Dynare (stable) on Mac OS X 10.6 or higher ==
----
=== MATLAB Setup ===

 1. Add {{{/Applications/Dynare/<<version>>/matlab/}}} to your Matlab path. You can do this either using the {{{addpath}}} command to add it just for this session or using the menu option {{{File->Set Path...}}} to add it across Matlab sessions.

=== Octave Setup ===

 1. Having installed Octave via Homebrew, open Octave by typing {{{octave}}} at the terminal prompt.
 1. At the Octave prompt, type: {{{addpath /usr/local/opt/dynare/lib/dynare/matlab}}}

== Dynare 4.3.3 - 4.4.2 on Mac OS X 10.6 or higher ==
----
=== MATLAB Setup ===

 1. Add {{{/Applications/Dynare/<<version>>/matlab/}}} to your Matlab path. You can do this either using the {{{addpath}}} command to add it just for this session or using the menu option {{{File->Set Path...}}} to add it across Matlab sessions.

=== Octave Setup ===
 1. Install Octave 3.6.4 via Homebrew (which requires XCode) by following the instructions in the "Simple Installation Instructions" subsection of the "Homebrew" section of [[http://wiki.octave.org/Octave_for_MacOS_X#Simple_Installation_Instructions_3|this site]].
 1. Before executing MOD files, you need to execute the following command at Octave prompt:
-Line 15:
+Line 64:
->> cd /Applications/Dynare/4.1.0/src/mex/sources
+addpath /Applications/Dynare/<<version>>/matlab
-Line 17:
+Line 66:
-. At the MATLAB prompt, run
+== Dynare 4.2.2 - 4.3.2 on Mac OS X 10.6 or higher ==
----
=== MATLAB Setup ===

 1. Add {{{/Applications/Dynare/<<version>>/matlab/}}} to your Matlab path. You can do this either using the {{{addpath}}} command to add it just for this session or using the menu option {{{File->Set Path...}}} to add it across Matlab sessions.

=== Octave Setup for OS X 10.6 and 10.7 (not available under 10.8) ===

 1. Download and install version 3.4.0 of the [[http://sourceforge.net/projects/octave/files/Octave%20MacOSX%20Binary|Octave Mac OS X binary]] and add {{{/Applications/Octave.app/Contents/Resources/bin}}} to your search path.
 1. If you are going to use the {{{use_dll}}} or {{{k_order_perturbation}}} options, add the following lines to the {{{/Applications/Octave.app/Contents/Resources/bin/mkoctfile-3.4.0}}} file after the {{{set -e}}} statement at the top of the file
-Line 19:
+Line 78:
->> build_matlab
+CFLAGS="-arch i386 ${CFLAGS}"
FFLAGS="-arch i386 ${FFLAGS}"
CPPFLAGS="-arch i386 ${CPPFLAGS}"
CXXFLAGS="-arch i386 ${CXXFLAGS}"
LDFLAGS="-arch i386 ${LDFLAGS}"
-Line 21:
+Line 84:
-. Once this has finished running, go to {{{File->Set Path...}}} and add the path to the {{{matlab/}}} subfolder under the installation folder. In the standard installation, this will be {{{/Applications/Dynare/4.1.0/matlab}}}.
+. Before executing MOD files, you need to execute the following command at Octave prompt:
 {{{
addpath /Applications/Dynare/<<version>>/matlab
 }}}
-Line 23:
+Line 89:
-= Octave Setup =
+== Dynare 4.2.0 or 4.2.1 on Mac OS X 10.5 or 10.6 ==
----
=== MATLAB Setup ===
-Line 25:
+Line 93:
-. Download and install the latest [[http://sourceforge.net/projects/octave/files/Octave%20MacOSX%20Binary|Octave Mac OS X binary]] and add {{{/Applications/Octave.app/Contents/Resources/bin}}} to your search path.
+. Install XCode 3.2 or later, which can either be installed from the internet or from the installation discs that came with your Mac. This installs the necessary gcc compilers required by {{{build_dynare.m}}} in step 3.
 1. In Matlab, change directory to the root folder of the Dynare installation directory. In the standard installation, you need to do:
 {{{
>> cd /Applications/Dynare/<<version>>
 }}}
 1. At the Matlab prompt, run
 {{{
>> build_dynare
 }}}
 1. Once this has finished running, go to {{{File->Set Path...}}} and add the path to the {{{matlab/}}} subfolder under the installation folder. In the standard installation, this will be {{{/Applications/Dynare/<<version>>/matlab}}}. Save the changes before closing the window.

=== Octave Setup ===

 1. Download and install version 3.2.3 of the [[http://sourceforge.net/projects/octave/files/Octave%20MacOSX%20Binary|Octave Mac OS X binary]] and add {{{/Applications/Octave.app/Contents/Resources/bin}}} to your search path.
-Line 36:
+Line 117:
-addpath /Applications/Dynare/4.1.0/matlab
+addpath /Applications/Dynare/<<version>>/matlab
-Line 39:
+Line 120:
-= Documentation =
+== Documentation ==
-Line 41:
+Line 122:
-Documentation can be found in the {{{doc/}}} folder under the installation directory (the default is {{{/Applications/Dynare/4.1.0/doc}}}). The User Guide (located by default in {{{/Applications/Dynare/4.1.0/doc/userguide/UserGuide.pdf}}}) is a particularly helpful starting place. Errata for the User Guide can be found [[http://www.dynare.org/DynareWiki/UserGuide|here]].
+Documentation can be found in the {{{doc/}}} folder under the installation directory (the default is {{{/Applications/Dynare/<<version>>/doc}}}). The User Guide (located by default in {{{/Applications/Dynare/<<version>>/doc/userguide/UserGuide.pdf}}}) is a particularly helpful starting place. Errata for the User Guide can be found [[http://www.dynare.org/DynareWiki/UserGuide|here]].