pynare 0.1.5

run DYNARE from python and access its workspace

This is a slim Python API to Dynare. It runs the *.mod file, displays the resulting output, and then provides access to the Dynare workspace. It works with both, Matlab and Octave.

For fellow linux users (and probably mac users as well), this also provides a script to execute Dynare from comand line.

• Source: https://github.com/gboehl/pynare

• Documentation: https://pynare.readthedocs.io/en/latest/

• Bug tracker: https://github.com/gboehl/pynare/issues

NOTE: This is at a very early stage and not well-tested (and not tested at all on Windows). Comments via the bug tracker are very welcome.

Motivation

The declared goal of this project is to provide access to Dynare without having to learn and use Matlab / Octave. This reflects the acknowledgement that the translation of the Dynare codebase to a more efficient open source alternative is a major effort which may take a while. Meanwhile, pynare encourages young researchers to focus on modern open source languages and, as the whole interface is pure Python, still allows them to use Dynare without Matlab.

Usage

Package import and running a modfile:

from pynare import pynare
modfile = '/path/to/greatmodel.mod'
mod = pynare(modfile)

This will give you the usual info about how the Blanchard-Kahn conditions are messed up. Then access the attributes:

mod.workspace                   # will give you the matlab workspace
print(mod.workspace['beta'])    # it contains all the parameters
>>> 0.995                       # likely to be the case

I also added the oo_ Dynare-object, which contains a lot of usefull stuff. Note that you could have also accessed it via mod.workspace['oo_'].

mod.oo_.keys()              # it is a dict, so browse it via `keys()`
irfs = mod.oo_['irfs']      # for instance get your impulse response functions (it's again a dict). Maybe plot them?

Just evoking pynare from the comand prompt/shell is as simple as

pynare modelpath/crazy.mod

Installation via pip

Installation is as simply as running (Windows user from the Anaconda Prompt):

pip install pynare

Of course, installing Dynare remains your responibility.

If you care for the bleeding edge developing version (which, at this stage, is recommended), the handy way is to install via the git-command. If you hav not yet installed git, Windows users get it here: https://git-scm.com/download/win (Linux users just use the repo of their distro). Then:

pip install git+https://github.com/gboehl/pynare