Differences between revisions 36 and 37
Revision 36 as of 2010-02-09 18:44:34
Size: 8683
Editor: vol75-4-82-225-32-85
Comment:
Revision 37 as of 2010-02-12 11:47:14
Size: 4756
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
Since Dynare 4.0.0, precompiled binaries packages and source packages are available for Debian and Ubuntu distributions of GNU/Linux. These packages work with both Octave and MATLAB. Precompiled binary packages of Dynare 4.1 are available for Debian and Ubuntu distributions of GNU/Linux. These packages work with both Octave and MATLAB.
Line 5: Line 5:
Depending on your distribution, the installation system is different: This page describes the installation of these packages.
Line 7: Line 7:
 * for the following distributions, please read section on the [[#newpackaging|new packaging system]]:
   * Debian "Squeeze", the testing version
   * Debian "Sid", the unstable version
   * Ubuntu "Karmic Koala" 9.10
   * Ubuntu "Lucid Lynx", the development version
 * for the following distributions, please read section on the [[#oldpackaging|old packaging system]]:
   * Debian "Lenny" 5.0, the stable version
   * Ubuntu "Karmic Koala" 9.10
   * Ubuntu "Jaunty Jackalope" 9.04
   * Ubuntu "Intrepid Ibex" 8.10
   * Ubuntu "Hardy Heron" 8.04
 * older distributions are not supported.
= Configuring your package manager to receive Dynare packages =
Line 20: Line 9:
<<Anchor(newpackaging)>>
= New packaging system =
This should be done only before the first installation.

Packages are available from two sources:
 * Official Debian and Ubuntu archives
 * Dynare repository

Depending on your version of Debian or Ubuntu, and the version of Dynare you want, you will want to choose one or the other of these two sources.

== From official Debian and Ubuntu archive ==
Line 35: Line 31:
If you want to use these sources, you don't need to do anything: they are already configured in your package manager.
Line 36: Line 33:
== Installing the packages == /!\ Under Debian, you may however need to select the "contrib" section in your package sources, in order to get MATLAB support.
Line 38: Line 35:
Without any special configuration, Dynare is available through you favorite package manager (apt-get, aptitude, synaptic). == From Dynare repository ==
Line 40: Line 37:
There are three packages which you may want to install: Status of the packages as of 2010-02-12:
Line 42: Line 39:
 * {{{dynare}}}: base package, containing a fully functional installation of Dynare for Octave under {{{/usr/share/dynare/matlab}}}
 * {{{dynare-matlab}}}: install this package if you are using MATLAB, in order to recompile the MEX files. You will be asked a few questions by your package manager (such as the location where you installed MATLAB)
 * {{{dynare-doc}}}: documentation (HTML and PDF manual, PDF userguide, example MOD files, ...). They are installed under {{{/usr/share/doc/dynare-doc/}}}. The manual and the userguide are also registered:
    * in the DHelp/DWWW system, in the "Science/Mathematics" section
    * in Rarian (the online help system in Gnome and KDE), in the "Education/Mathematics" section

== Using Dynare ==

If you are using MATLAB, you need to specify the correct path:
{{{
addpath /usr/share/dynare/matlab
}}}

If you are using Octave, you don't need to specify a path. On Octave 3.0 (but not 3.2), you may also want to type:
{{{
mark_as_command dynare
}}}

Then, launch Dynare with:
{{{
dynare filename.mod
}}}

<<Anchor(oldpackaging)>>
= Old packaging system =

== Configuring your package manager to receive Dynare packages ==

This should be done only before the first installation.
|| '''Distribution''' || '''Version of Dynare''' || '''Version of Octave used by the package''' || '''APT source line''' ||
|| Ubuntu "Intrepid Ibex" 8.10 || 4.1.0 || 3.0 || {{{deb http://www.dynare.org/ubuntu intrepid main contrib}}} ||
|| Ubuntu "Jaunty Jackalope" 9.04 || 4.1.0 || 3.0 || {{{deb http://www.dynare.org/ubuntu jaunty main contrib}}} ||
|| Ubuntu "Karmic Koala" 9.10 || 4.1.0 || 3.2 || {{{deb http://www.dynare.org/ubuntu karmic main contrib}}} ||
|| Debian "Lenny" 5.0 || 4.1.0 || 3.0 || {{{deb http://www.dynare.org/debian lenny main contrib}}} ||
Line 87: Line 60:
=== Adding the correct APT lines to your package sources === === Adding the correct APT line to your package sources ===
Line 89: Line 62:
Then you need to give two "APT lines" to your package manager; these lines are given in the following subsections (depending on your distribution). Then you need to give one "APT line" to your package manager; this line is given in the previous table, and depends on your distribution.
Line 95: Line 68:
   * you will be asked for an APT line: copy/paste the first APT line (which begins with "deb"), then click "Add Source"
   * repeat the process for the second APT line (which begins with "deb-src")

 * or manually, by editing your {{{/etc/apt/sources.list}}} with a text editor (as root), and adding the two apt lines
   * you will be asked for an APT line: copy/paste the APT line, then click "Add Source"
 * or manually, by editing your {{{/etc/apt/sources.list}}} with a text editor (as root), and adding the apt line
Line 99: Line 71:
==== APT lines for Debian "Lenny" 5.0 ==== = Installing the packages =
Line 101: Line 73:
There are three packages which you may want to install:

 * {{{dynare}}}: base package, containing a fully functional installation of Dynare for Octave under {{{/usr/share/dynare/matlab}}}
 * {{{dynare-matlab}}}: install this package if you are using MATLAB, in order to recompile the MEX files. You will be asked a few questions by your package manager (such as the location where you installed MATLAB)
 * {{{dynare-doc}}}: documentation (HTML and PDF manual, PDF userguide, example MOD files, ...). They are installed under {{{/usr/share/doc/dynare-doc/}}}. The manual and the userguide are also registered:
    * in the DHelp/DWWW system, in the "Science/Mathematics" section
    * in Rarian (the online help system in Gnome and KDE), in the "Education/Mathematics" section

= Using Dynare =

== Under MATLAB ==
You need to specify the correct path:
Line 102: Line 86:
deb http://www.dynare.org/debian lenny main contrib
deb-src http://www.dynare.org/debian lenny main
addpath /usr/share/dynare/matlab
Line 106: Line 89:
==== APT lines for Ubuntu "Hardy Heron" 8.04 ====
Then, launch Dynare with:
Line 109: Line 91:
deb http://www.dynare.org/ubuntu hardy main contrib
deb-src http://www.dynare.org/ubuntu hardy main
dynare filename.mod
Line 113: Line 94:
== Under Octave ==
Line 114: Line 96:
==== APT lines for Ubuntu "Intrepid Ibex" 8.10 ==== You don't need to add a path, it's automatically configured.
Line 116: Line 98:
{{{
deb http://www.dynare.org/ubuntu intrepid main contrib
deb-src http://www.dynare.org/ubuntu intrepid main
}}}

==== APT lines for Ubuntu "Jaunty Jackalope" 9.04 ====

{{{
deb http://www.dynare.org/ubuntu jaunty main contrib
deb-src http://www.dynare.org/ubuntu jaunty main
}}}

==== APT lines for Ubuntu "Karmic Koala" 9.10 ====

{{{
deb http://www.dynare.org/ubuntu karmic main contrib
deb-src http://www.dynare.org/ubuntu karmic main
}}}

== Installing the packages ==

Using your favorite package manager (apt-get, aptitude, synaptic), update your package list.

You should now see three new packages: {{{dynare}}}, {{{dynare-matlab7.4}}} and {{{dynare-matlab7.5}}}. The former is in the "Mathematics" section, the latter are in the "Mathematics (contrib)" section.

Note that pre-compiled binaries are available for the i386 and amd64 architectures. See below for how to recompile the package if you use another architecture.

The {{{dynare}}} package contains a fully functional installation of Dynare for both Octave and Matlab. The installation is made under {{{/usr/lib/dynare}}}. The package contains: the preprocessor, the M-files, and the optimized dynamic libraries for Octave.

Since the {{{dynare}}} package does not contain optimized dynamic libraires for Matlab, you should install one of the two {{{dynare-matlab*}}} for full performance under Matlab:
 * if you have Matlab 7.5 (R2007b) or 7.6 (R2008a), install the {{{dynare-matlab7.5}}} package
 * if you have Matlab 7.4 (R2007a), install the {{{dynare-matlab7.4}}} package
 * if your Matlab version is strictly older than 7.4 (R2007a), there is currently no binary package; we may provide one in the future. In the meantime, a workaround is explained in this [[http://www.cepremap.cnrs.fr/juillard/mambo/index.php?option=com_forum&Itemid=95&page=viewtopic&p=3377#3377|forum message]].

The packages also contain documentation (HTML and PDF manual, PDF userguide, and other documents). These are installed in {{{/usr/share/doc/dynare}}}. The manual and the userguide are also registered:
  * in the DHelp/DWWW system, in the "Science/Mathematics" section
  * in Rarian (the online help system in Gnome and KDE), in the "Education/Mathematics" section

For the moment, the packages don't contain any example MOD-file, but this should change in the near future.

Don't forget to regularly run your package manager to get the most recent version of Dynare.

== Using Dynare ==

You can run Dynare from Octave or Matlab, by adding the correct path at runtime:
{{{
addpath /usr/lib/dynare/matlab
}}}
Under Octave, you may also want to type:
On Octave 3.0 (but not 3.2), you may also want to type:
Line 173: Line 107:

Under Octave, it is possible to create a startup file which adds the correct path at every start. See DynareOctave on this topic and on other Octave-specific issues.

== Compiling the package from source ==

You can be interested in recompiling the packages, especially if binaries for your architecture are not available.

Download and unpack the source in the current directory by typing:
{{{
apt-src install dynare
}}}
(you may be asked the root password for installing packages necessary for the building process)

This should have created a {{{dynare-???}}} directory, where {{{???}}} is the current version number. Go into that directory, and type:
{{{
dpkg-buildpackage -b -uc
}}}
This should build the {{{dynare-???}}} package (in a {{{.deb}}} file), and also the {{{dynare-matlab7.4}}} (resp. {{{dynare-matlab7.5}}}) package if you have Matlab 7.4 (resp. 7.5) intalled under {{{/usr/local/matlab74}}} (resp. {{{/usr/local/matlab75}}}). You can tune the {{{debian/rules}}} file if your Matlab installation is located at another place.

Precompiled binary packages of Dynare 4.1 are available for Debian and Ubuntu distributions of GNU/Linux. These packages work with both Octave and MATLAB.

This page describes the installation of these packages.

1. Configuring your package manager to receive Dynare packages

This should be done only before the first installation.

Packages are available from two sources:

  • Official Debian and Ubuntu archives
  • Dynare repository

Depending on your version of Debian or Ubuntu, and the version of Dynare you want, you will want to choose one or the other of these two sources.

1.1. From official Debian and Ubuntu archive

The Dynare package is now available in the most recent Debian and Ubuntu distributions as an official package.

The status of the package can be monitored on the Debian Package Tracking System.

Status of the packages as of 2010-01-18:

Distribution

Version of Dynare

Version of Octave used by the package

Ubuntu "Karmic Koala" 9.10

4.0.3

3.0

Ubuntu "Lucid Lynx"

4.0.4

3.2

Debian "Squeeze"

4.0.4

3.2

Debian "Sid"

4.1.0

3.2

If you want to use these sources, you don't need to do anything: they are already configured in your package manager.

/!\ Under Debian, you may however need to select the "contrib" section in your package sources, in order to get MATLAB support.

1.2. From Dynare repository

Status of the packages as of 2010-02-12:

Distribution

Version of Dynare

Version of Octave used by the package

APT source line

Ubuntu "Intrepid Ibex" 8.10

4.1.0

3.0

deb http://www.dynare.org/ubuntu intrepid main contrib

Ubuntu "Jaunty Jackalope" 9.04

4.1.0

3.0

deb http://www.dynare.org/ubuntu jaunty main contrib

Ubuntu "Karmic Koala" 9.10

4.1.0

3.2

deb http://www.dynare.org/ubuntu karmic main contrib

Debian "Lenny" 5.0

4.1.0

3.0

deb http://www.dynare.org/debian lenny main contrib

1.2.1. Importing the cryptographic signing key

First, for security reasons, you should download the archive signing key, which is used to authenticate Dynare packages.

There are two ways of doing it:

  • via the graphical Synaptic package manager
    • first download http://www.dynare.org/dynare.public.key, and save it somewhere

    • then launch Synaptic, go to the "Settings" menu, and click on "Repositories"
    • go to "Authentication" tab, and click on "Import Key file"
    • select the dynare.public.key file that you have downloaded, and click OK

  • or manually, by typing the following in a command line (assuming you have installed wget):

sudo wget -O - http://www.dynare.org/dynare.public.key | sudo apt-key add -

1.2.2. Adding the correct APT line to your package sources

Then you need to give one "APT line" to your package manager; this line is given in the previous table, and depends on your distribution.

For adding them, you can either do it:

  • via the graphical Synaptic package manager:
    • go to the "Settings" menu, and click on "Repositories"
    • go to "Third-party software" tab and click on "Add"
    • you will be asked for an APT line: copy/paste the APT line, then click "Add Source"
  • or manually, by editing your /etc/apt/sources.list with a text editor (as root), and adding the apt line

2. Installing the packages

There are three packages which you may want to install:

  • dynare: base package, containing a fully functional installation of Dynare for Octave under /usr/share/dynare/matlab

  • dynare-matlab: install this package if you are using MATLAB, in order to recompile the MEX files. You will be asked a few questions by your package manager (such as the location where you installed MATLAB)

  • dynare-doc: documentation (HTML and PDF manual, PDF userguide, example MOD files, ...). They are installed under /usr/share/doc/dynare-doc/. The manual and the userguide are also registered:

    • in the DHelp/DWWW system, in the "Science/Mathematics" section
    • in Rarian (the online help system in Gnome and KDE), in the "Education/Mathematics" section

3. Using Dynare

3.1. Under MATLAB

You need to specify the correct path:

addpath /usr/share/dynare/matlab

Then, launch Dynare with:

dynare filename.mod

3.2. Under Octave

You don't need to add a path, it's automatically configured.

On Octave 3.0 (but not 3.2), you may also want to type:

mark_as_command dynare

Then, launch Dynare with:

dynare filename.mod

DynareWiki: InstallOnDebianOrUbuntu (last edited 2018-05-16 15:37:23 by SébastienVillemot)