Differences between revisions 22 and 23
Revision 22 as of 2009-06-19 20:04:51
Size: 6759
Comment:
Revision 23 as of 2009-07-03 13:15:47
Size: 8102
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. They are available through standard package repositories. 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.
Line 5: Line 5:
= Availability = Depending on your distribution, the installation system is different:
Line 7: Line 7:
== On Debian GNU/Linux ==  * for the following distributions, please read section on the [[#newpackaging|new packaging system]]:
   * Debian "Squeeze", the current testing
   * Debian "Sid", the unstable version
   * Ubuntu "Karmic Koala", the coming release
 * for the following distributions, please read section on the [[#oldpackaging|old packaging system]]:
   * Debian "Lenny" 5.0, the current stable
   * Ubuntu "Jaunty Jackalope" 9.04
   * Ubuntu "Intrepid Ibex" 8.10
   * Ubuntu "Hardy Heron" 8.04
 * older distributions are not supported.
Line 9: Line 18:
Packages are available for Lenny (the stable distribution, version 5.0). They should also work on Squeeze (the testing distribution) and Sid (the unstable distribution). <<Anchor(newpackaging)>>
= New packaging system =
Line 11: Line 21:
The Etch (the old stable distribution, version 4.0) is not supported, since it does not provide Octave version 3. The Dynare package is now available in the most recent Debian and Ubuntu distributions, as an official package.
Line 13: Line 23:
Binaries are available for the i386 and amd64 architectures. See below for how to recompile the package if you use another architecture. The state of the package can be monitored on the [[http://packages.qa.debian.org/dynare|Debian Package Tracking System]].
Line 15: Line 25:
== On Ubuntu == == Installing the packages ==
Line 17: Line 27:
Packages are available for "Hardy Heron" (Ubuntu version 8.04), "Intrepid Ibex" (Ubuntu version 8.10) and "Jaunty Jackalope" (Ubuntu version 9.04). Older distributions are not supported. Without any special configuration, Dynare is available through you favorite package manager (apt-get, aptitude, synaptic).
Line 19: Line 29:
Binaries are available for the i386 and amd64 architectures. See below for how to recompile the package if you use another architecture. There are three packages which you may want to install:
Line 21: Line 31:
= Configuring your package manager to receive Dynare packages =  * {{{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. But 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 ==
Line 25: Line 61:
== Importing the cryptographic signing key == === Importing the cryptographic signing key ===
Line 40: Line 76:
== Adding the correct APT lines to your package sources == === Adding the correct APT lines to your package sources ===
Line 52: Line 88:
=== APT lines for Debian "Lenny" 5.0 === ==== APT lines for Debian "Lenny" 5.0 ====
Line 59: Line 95:
=== APT lines for Ubuntu "Hardy Heron" 8.04 === ==== APT lines for Ubuntu "Hardy Heron" 8.04 ====
Line 67: Line 103:
=== APT lines for Ubuntu "Intrepid Ibex" 8.10 === ==== APT lines for Ubuntu "Intrepid Ibex" 8.10 ====
Line 74: Line 110:
=== APT lines for Ubuntu "Jaunty Jackalope" 9.04 === ==== APT lines for Ubuntu "Jaunty Jackalope" 9.04 ====
Line 81: Line 117:
= Installing the packages = == Installing the packages ==
Line 86: Line 122:

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.
Line 95: Line 133:
  * in the DHelp system, in the "Science/Mathematics" section
  * in scroolkeeper (the online help system in Gnome and KDE), in the "Education/Mathematics" section
  * 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
Line 102: Line 140:
= Using Dynare = == Using Dynare ==
Line 120: Line 158:
= Compiling the package from source = == Compiling the package from source ==
Line 135: Line 173:

''Note'': if you want to become the official Dynare package builder for your favourite architecture, please contact Dynare authors and we will distribute your binaries.

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.

Depending on your distribution, the installation system is different:

  • for the following distributions, please read section on the new packaging system:

    • Debian "Squeeze", the current testing
    • Debian "Sid", the unstable version
    • Ubuntu "Karmic Koala", the coming release
  • for the following distributions, please read section on the old packaging system:

    • Debian "Lenny" 5.0, the current stable
    • Ubuntu "Jaunty Jackalope" 9.04
    • Ubuntu "Intrepid Ibex" 8.10
    • Ubuntu "Hardy Heron" 8.04
  • older distributions are not supported.

1. New packaging system

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

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

1.1. Installing the packages

Without any special configuration, Dynare is available through you favorite package manager (apt-get, aptitude, synaptic).

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

1.2. 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. But you may also want to type:

mark_as_command dynare

Then, launch Dynare with:

dynare filename.mod

2. Old packaging system

2.1. Configuring your package manager to receive Dynare packages

This should be done only before the first installation.

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

2.1.2. Adding the correct APT lines to your package sources

Then you need to give two "APT lines" to your package manager; these lines are given in the following subsections (depending 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 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

2.1.2.1. APT lines for Debian "Lenny" 5.0

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

2.1.2.2. APT lines for Ubuntu "Hardy Heron" 8.04

deb http://www.dynare.org/ubuntu hardy main contrib
deb-src http://www.dynare.org/ubuntu hardy main

2.1.2.3. APT lines for Ubuntu "Intrepid Ibex" 8.10

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

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

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

2.3. 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:

mark_as_command dynare

Then, launch Dynare with:

dynare filename.mod

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.

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

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