Commit bd43adb9 authored by sebastien's avatar sebastien
Browse files

* userguide: updated list of Dynare contributors and installation section

* reference manual: updated installation section


git-svn-id: https://www.dynare.org/svn/dynare/trunk@3136 ac1d8469-bf42-47a9-8791-bf33cf982152
parent ab8b4f37
......@@ -135,7 +135,6 @@ After installation, Dynare can be used in any directory on your computer. It is
<para>You can have several versions of Dynare coexisting (for example in <filename>c:\dynare</filename>), as long as you correctly adjust your path settings (see <xref linkend="path_warning" />).</para>
<para>Note that no installer is currently avaible for <trademark class="registered">Windows</trademark> on 64 bits platforms. For the time being, please follow the instructions given in <xref linkend="install_other_systems"/> if you have such a system.</para>
</sect2>
<sect2><title>On Debian GNU/Linux and Ubuntu</title>
......@@ -207,7 +206,7 @@ you can put it in a file called <filename>.octaverc</filename> in your home dire
<para>You should be very careful about the content of you <trademark class="registered">MATLAB</trademark> or Octave path. You can display its content by simply typing <command>path</command> in the command window.</para>
<para>The path should normally contain system directories of <trademark class="registered">MATLAB</trademark> or Octave, and the <filename>matlab</filename> subdirectory of your Dynare installation. It should not contain any other Dynare-related directory, from another Dynare version of from the version you are using. However, note that Dynare will automatically add one (and only one) of the <filename>mex/2007a</filename>, <filename>mex/2007b</filename>, <filename>mex/2009a-64bit</filename> and <filename>mex/octave</filename> subdirectories, depending on your installation.</para>
<para>The path should normally contain system directories of <trademark class="registered">MATLAB</trademark> or Octave, and some subdirectories of your Dynare installation. You have to manually add the <filename>matlab</filename> subdirectory, and Dynare will automatically add a few other subdirectories at runtime (depending on your configuration). You must verify that there is no directory coming from another version of Dynare than the one you are planning to use.</para>
<para>You have to be aware that adding other directories to your path can potentially create problems, if some of your M-files have the same names than Dynare files. Your files would then override Dynare files, and make Dynare unusable.</para>
</sect2>
......
......@@ -40,7 +40,7 @@ pdftex}
\title{Dynare v4 - User Guide \\Public beta version}
\author{\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ Tommaso Mancini Griffoli\\ tommaso.mancini@stanfordalumni.org}
\date{This draft: March 2007}
\date{This draft: November 2009}
\maketitle
......@@ -50,7 +50,7 @@ pdftex}
~\vfill
Copyright 2007-2008 Tommaso Mancini Griffoli
Copyright 2007-2009 Tommaso Mancini Griffoli
\bigskip
......@@ -79,14 +79,15 @@ Dynare was originally developed by Michel Juillard in Paris, France. Currently,
\begin{itemize}
\item Stphane Adjemian (stephane.adjemian``AT''ens.fr)
\item Houtan Bastani
\item Michel Juillard (michel.juillard``AT''ens.fr)
\item Ferhat Mihoubi (ferhat.mihoubi``AT''univ-evry.fr)
\item Ondra Kamenik (ondra.kamenik``AT''volny.cz)
\item George Perendia
\item Marco Ratto (marco.ratto``AT''jrc.it)
\item Sbastien Villemot (sebastien.villemot``AT''ens.fr)
\end{itemize}
Several parts of Dynare use or have strongly benefitted from publicly available programs by F. Collard, L. Ingber, P. Klein, S. Sakata, F. Schorfheide, C. Sims, P. Soederlind and R. Wouters. \\
Several parts of Dynare use or have strongly benefited from publicly available programs by G. Anderson, F. Collard, L. Ingber, O. Kamenik, P. Klein, S. Sakata, F. Schorfheide, C. Sims, P. Soederlind and R. Wouters.
Finally, the development of Dynare could not have come such a long ways withough an active community of users who continually pose questions, report bugs and suggest new features. The help of this community is gratefully acknowledged.\\
......
\chapter{Installing Dynare} \label{ch:inst}
\section{Dynare versions}
Three versions of Dynare exist: one for \textbf{Matlab}, one for \textbf{Scilab} and one for \textbf{Gauss}. The first benefits from ongoing development and is the most popular. Development of the Scilab version stopped after Dynare version 3.02 and that for Gauss after Dynare version 1.2. \\
This User Guide will exclusively \textbf{focus on the Matlab version of Dynare}. For the installation procedure for the Scilab or Gauss versions of the program, please see the \href{http://www.cepremap.cnrs.fr/juillard/mambo/index.php?option=com_content&task=view&id=51&Itemid=84}{Reference Manual}. Note, though, that the Dynare syntax remains mostly unchanged across the Matlab, Scilab or Gauss versions, for those features common to the three versions. \\
The current version of Dynare (4.1) runs on both \href{http://www.mathworks.com/products/matlab/}{\textbf{MATLAB}} and \href{http://www.octave.org}{\textbf{GNU Octave}}.
You may also be interested by another version of Dynare, developed in parallel: \textbf{Dynare++}. This is a standalone C++ version of Dynare specialized in computing k-order approximations of dynamic stochastic general equilibrium models. See the \href{http://www.cepremap.cnrs.fr/juillard/mambo/index.php?option=com_content&task=view&id=53&Itemid=86}{Dynare++ webpage} for more information.
There used to be versions of Dynare for \textbf{Scilab} and \textbf{Gauss}. Development of the Scilab version stopped after Dynare version 3.02 and that for Gauss after Dynare version 1.2.
\section{System requirements}
Dynare can run on Windows, as well as Unix-like operating systems, such as any Linux distribution, Solaris and, of course, Mac OS X. If you have questions about the support of a particular platform, feel free to write directly to Michel Juillard (michel.juillard"AT"ens.fr) or visit the \href{http://www.dynare.org/phpBB3}{\textbf{Dynare forums}}. \\
This User Guide will exclusively \textbf{focus on Dynare version 4.0 and later}.
To run Dynare, it is recommended to allocate at least 256MB of RAM to the platform running Dynare, although 512MB is preferred. Depending on the type of computations required, like the very processor intensive Metropolis Hastings algorithm, you may need up to 1GB of RAM to obtain acceptable computational times. \\
You may also be interested by another program, \textbf{Dynare++}, which is a standalone C++ program specialized in computing k-order approximations of dynamic stochastic general equilibrium models. Note that Dynare++ is distributed along with Dynare since version 4.1. See the \href{http://www.cepremap.cnrs.fr/juillard/mambo/index.php?option=com_content&task=view&id=53&Itemid=86}{Dynare++ webpage} for more information.
\section{Installing Dynare}
\subsection{Installing on Windows}
The following assumes you have Matlab version 6.5.1 or later installed on your Windows system.\footnote{As of writing this Guide, Dynare is being developed on Matlab version 7. Nonetheless, great care is taken not to introduce features that would not work with reasonably recent versions of Matlab. However, Dynare requires at least the Matlab feature set of version 6.5.1, released September 22, 2003.} ** The current way to install Dynare version 4 may not yet be on par with the procedure described below. If a discrepancy exists, please follow downloading and installation instructions on the Dynare website. \begin{enumerate}
\item Download the latest stable version of Dynare for Matlab (Windows) from the \href{http://www.dynare.org}{Dynare website}.
\item You will now have on your computer a .zip file which you should unzip. This will create a folder called, by default, Dynare and its version number, for example: Dynare\_v4.x (where $x$ stands for any subsequent upgrades).
\item This directory contains several sub-directories, among which (i) matlab, (ii) doc and (iii) examples.
\item Place the Dynare folder (Dynare\_v4.x in our example) in the c: directory and note that location. The easiest is probably to put it in the root of c: as in c:/dynare\_v4.x.
\item Start Matlab and use the menu File/Set-Path to add the path to the Dynare
matlab subdirectory. Following our example, this would correspond to
c:/dynare\_v4.x/matlab
\item Save these changes in Matlab and you're ready to go.
\end{enumerate}
\section{System requirements}
Dynare can run on Microsoft Windows, as well as Unix-like operating systems, in particular GNU/Linux and Mac OS X. If you have questions about the support of a particular platform, please ask your question on \href{http://www.dynare.org/phpBB3}{\textbf{Dynare forums}}.
To run Dynare, it is recommended to allocate at least 256MB of RAM to the platform running Dynare, although 512MB is preferred. Depending on the type of computations required, like the very processor intensive Metropolis Hastings algorithm, you may need up to 1GB of RAM to obtain acceptable computational times.
\section{Matlab particularities}
\section{Installing Dynare}
A question often comes up: what special Matlab toolboxes are necessary to run Dynare? In fact, no additional toolbox is necessary for running most of Dynare, except maybe for optimal simple rules (see chapter \ref{ch:ramsey}), but even then remedies exist (see the \href{http://www.dynare.org/phpBB3}{Dynare forums} for discussions on this, or to ask your particular question). But if you do have the `optimization toolbox' installed, you will have additional options for solving for the steady state (solve\_algo option) and for searching for the posterior mode (mode\_compute option), both of which are defined later.
Please refer to the section entitled ``Installation and configuration'' in the Dynare reference manual.
\section{MATLAB particularities}
A question often comes up: what special MATLAB toolboxes are necessary to run Dynare? In fact, no additional toolbox is necessary for running most of Dynare, except maybe for optimal simple rules (see chapter \ref{ch:ramsey}), but even then remedies exist (see the \href{http://www.dynare.org/phpBB3}{Dynare forums} for discussions on this, or to ask your particular question). But if you do have the `optimization toolbox' installed, you will have additional options for solving for the steady state (solve\_algo option) and for searching for the posterior mode (mode\_compute option), both of which are defined later.
......@@ -57,7 +57,7 @@ License: GFDL-1.3+
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
Files: doc/userguide/*.tex, doc/userguide/*.bib, doc/userguide/*.pdf
Copyright: 2007-2008, Tommaso Mancini Griffoli
Copyright: 2007-2009, Tommaso Mancini Griffoli
License: GFDL-1.3+
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment