
    \foldertitle{setup}{Installing IRIS}{setup/Contents}

	\paragraph{Requirements}

\begin{itemize}
\itemsep1pt\parskip0pt\parsep0pt
\item
  Matlab R2010a or later.
\end{itemize}

\paragraph{Optional components}

\subparagraph{Optimization Toolbox}

The Optimization Toolbox is needed to compute the steady state of
non-linear models, and to run estimation.

\subparagraph{LaTeX}

LaTeX is a free typesetting system used to produce PDF reports in IRIS.
We recommend MiKTeX, available from \texttt{www.miktex.org}.

\paragraph{Components distributed with
IRIS}

\subparagraph{X13-ARIMA-SEATS (formerly X12-ARIMA,
X11-ARIMA)}

Courtesy of the U.S. Census Bureau, the X13-ARIMA-SEATS (formerly
X12-ARIMA) program is now incoporated in, and distributed with IRIS. No
extra installation or setup is needed.

\subparagraph{Symbolic/automatic
differentiator}

IRIS is now equipped with its own symbolic/automatic differentiator,
Sydney. There is no need to install the Symbolic Math Toolbox.

\paragraph{Installing IRIS}

\subparagraph{Step 1}

Download the latest IRIS zip archive, \texttt{IRIS\_Tbx\_YYYYMMDD.zip},
from the download area at \texttt{www.iris-toolbox.com}, and save it in
a temporary location on your disk.

\subparagraph{Step 2}

Unzip the archive into a folder on your hard drive, e.g.
\texttt{C:\textbackslash{}IRIS\_Tbx}. We will call this directory the
IRIS root folder.

Installing IRIS on a network drive may cause some minor problems,
especially on MS Windows systems; check out
\texttt{help changeNotification} in Matlab.

\subparagraph{Step 3}

After installing a new version of IRIS, we recommend that you remove all
older versions of IRIS from the Matlab search path, and restart Matlab.

\subparagraph{Getting started}

Each time you want to start working with IRIS, run the following line

\begin{verbatim}
>> addpath C:\IRIS_Tbx; irisstartup
\end{verbatim}

where \texttt{C:\textbackslash{}IRIS\_Tbx} needs to be, obviously,
replaced with the proper IRIS root folder chosen in Step 2 above.

Alternatively, you can put the IRIS root folder permanently on the
Matlab seatch path (using the menu File - Set Path), and only run the
\texttt{irisstartup} command at the beginning of each IRIS session.

See also the section on \href{config/Contents}{Starting and quitting
IRIS}.

\paragraph{Syntax highlighting}

You can get the model files (i.e.~the files that describe the model
equations, variables, parameters) syntax-highlighted. Syntax
highlighting improves enormously the readability of the files. It helps
you understand the model better, and discover typos and mistakes more
quickly.

Add any number of extensions you want to use for model files (such as
\texttt{'mod'}, \texttt{'model'}, etc.) to the Matlab editor. Open the
menu File - Preferences, and click on the Editor/Debugger - Language tab
(make sure `Matlab' is selected at the top as the Language). Use the Add
button in the File extensions panel to associate any number of new
extensions with the editor. Re-start the editor. The IRIS model files
will be syntax highligted from that moment on.



