Installation
=============

Prerequisites
--------------

- **MATLAB R2023b or newer.** RISE uses ``dictionary`` /
  ``configureDictionary`` containers and the ``arguments`` block
  syntax with both name-value and positional validators.
- **A copy of the modern RISE toolbox.** Access to the modern
  branch is reserved for active contributors and event
  participants -- contact the author for the current download.

Bootstrap
----------

Unpack the toolbox into a known folder ``<RISE_ROOT>``. In MATLAB::

    run('<RISE_ROOT>/rise_startup.m')

You should see the RISE banner. ``rise_startup`` adds the toolbox
folders to the path, probes for ``pdflatex`` (PDF reporting is
optional), and caches the toolbox root for downstream calls.

To unload the toolbox::

    rise_exit

Smoke test
-----------

After ``rise_startup``::

    m = dsge_model('mymodel.rs');
    m = solve(m);
    print_solution(m);

If the model parses, the symbolic derivatives compute, and the
solution prints, you are ready for the *First model* chapter.

Optional tooling
-----------------

- ``pdflatex`` (MiKTeX on Windows, MacTeX on macOS) -- enables PDF
  reporting via ``rise_report``. RISE warns and disables PDF
  reporting if it is missing; this is not an error.
- ``sphinx-build`` + ``sphinxcontrib-bibtex`` + a TeX distribution --
  required only to rebuild this documentation locally.