From bd43adb9268e2eed3ddb3970f8f0cee8d30c41bc Mon Sep 17 00:00:00 2001 From: sebastien Date: Fri, 6 Nov 2009 19:06:00 +0000 Subject: [PATCH] * 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 --- doc/manual.xml | 3 +-- doc/userguide/UserGuide.tex | 9 +++++---- doc/userguide/ch-inst.tex | 31 +++++++++++-------------------- license.txt | 2 +- 4 files changed, 18 insertions(+), 27 deletions(-) diff --git a/doc/manual.xml b/doc/manual.xml index 1f9737258..3eaf70f3d 100644 --- a/doc/manual.xml +++ b/doc/manual.xml @@ -135,7 +135,6 @@ After installation, Dynare can be used in any directory on your computer. It is You can have several versions of Dynare coexisting (for example in c:\dynare), as long as you correctly adjust your path settings (see ). -Note that no installer is currently avaible for Windows on 64 bits platforms. For the time being, please follow the instructions given in if you have such a system. On Debian GNU/Linux and Ubuntu @@ -207,7 +206,7 @@ you can put it in a file called .octaverc in your home dire You should be very careful about the content of you MATLAB or Octave path. You can display its content by simply typing path in the command window. -The path should normally contain system directories of MATLAB or Octave, and the matlab 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 mex/2007a, mex/2007b, mex/2009a-64bit and mex/octave subdirectories, depending on your installation. +The path should normally contain system directories of MATLAB or Octave, and some subdirectories of your Dynare installation. You have to manually add the matlab 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. 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. diff --git a/doc/userguide/UserGuide.tex b/doc/userguide/UserGuide.tex index a7466336d..207dbe7ec 100644 --- a/doc/userguide/UserGuide.tex +++ b/doc/userguide/UserGuide.tex @@ -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 Stˇphane 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 Sˇbastien 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.\\ diff --git a/doc/userguide/ch-inst.tex b/doc/userguide/ch-inst.tex index 92ca7443b..5ff5c2519 100644 --- a/doc/userguide/ch-inst.tex +++ b/doc/userguide/ch-inst.tex @@ -1,33 +1,24 @@ \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. + +This User Guide will exclusively \textbf{focus on Dynare version 4.0 and later}. + +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{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}}. \\ +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. \\ +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{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} +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. - +\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. diff --git a/license.txt b/license.txt index 93e87ea3e..272ec65ac 100644 --- a/license.txt +++ b/license.txt @@ -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