Differences between revisions 1 and 36 (spanning 35 versions)
Revision 1 as of 2010-01-06 17:01:05
Size: 2363
Comment:
Revision 36 as of 2017-06-08 07:48:23
Size: 7699
Comment:
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
== Installing the Dynare 4.1.0 Package on Mac OS X 10.5 or higher ==
 1. Download and run the appropriate Dynare Package for your system; OS X v10.5 should download the 32-bit package while OS X v10.6 are free to choose between the 32-bit and the 64-bit packages (unless you will be using Dynare with Octave, which only supports 32-bit).
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)>>

= 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]]
Line 7: Line 11:
   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 8: Line 14:
=== Matlab Setup ===
 1. Once installation is complete, open Matlab. Go to {{{File->Set Path...}}} and add the full path to the {{{DYNARE-4.1.0/}}} installation folder. If you have followed the standard installation (i.e., not changed the default installation location), this will be {{{/Applications/DYNARE-4.1.0}}}.
 1. Within the installation folder, navigate to {{{mex/sources}}}. In the standard installation, this will be {{{/Applications/DYNARE-4.1.0/mex/sources}}}.
 1. At the Matlab prompt, run
 {{{
>> build_matlab
 }}}
 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-4.1.0/matlab}}}.
== 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.

<<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.
Line 18: Line 50:
 1. 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. 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
 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:
 {{{
addpath /Applications/Dynare/<<version>>/matlab
 }}}

== 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 25: Line 83:
 }}} NB: Regardless of your OS X version, you must use 32-bit Dynare instead of 64-bit Dynare with Octave, as it does not yet provide 64-bit support.  }}}
 1. Before executing MOD files, you need to execute the following command at Octave prompt:
 {{{
addpath /Applications/Dynare/<<version>>/matlab
 }}}
Line 27: Line 89:
=== Documentation ===
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]].
== Dynare 4.2.0 or 4.2.1 on Mac OS X 10.5 or 10.6 ==
----
=== MATLAB Setup ===

 1. 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.
 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.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}"
 }}}
 1. 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 [[http://www.dynare.org/DynareWiki/UserGuide|here]].

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

  1. Download the appropriate Dynare package for your version of Mac OS X from the Dynare website

  2. 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.
  3. 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)

  1. Install Homebrew by following the directions on their site

  2. Tap Homebrew-Science

    1. brew tap homebrew/science

  3. Look at the available installation options by typing brew info dynare at the terminal prompt

  4. 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

  5. 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)

  1. Follow the instructions above using the latest Dynare snapshot for macOS

Via Homebrew (provides Matlab and Octave mex files)

  1. Install Homebrew by following the directions on their site

  2. Tap Homebrew-Science

    1. brew tap homebrew/science

  3. Look at the available installation options by typing brew info dynare at the terminal prompt

  4. 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

  5. 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.

  2. 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 this site.

  2. 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

  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 Octave Mac OS X binary and add /Applications/Octave.app/Contents/Resources/bin to your search path.

  2. 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}"
  3. 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

  1. 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.

  2. 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>>
  3. At the Matlab prompt, run
    >> build_dynare
  4. 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 Octave Mac OS X binary and add /Applications/Octave.app/Contents/Resources/bin to your search path.

  2. 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}"
  3. 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.

DynareWiki: InstallOnMacOSX (last edited 2018-02-13 15:38:18 by HoutanBastani)