econ-ark / HARK

Heterogenous Agents Resources & toolKit
Apache License 2.0
336 stars 199 forks source link

standalone model configuration file with model, approximation, solution, and simulation parameters #1463

Open sbenthall opened 5 months ago

sbenthall commented 5 months ago

The goal of this PR is to implement a working example of a HARK configuration file, in Python, as per #857. (Note the ticket originates from 2020).

Such a configuration should include information:

While this is functionality that's similar to the HARK 0.x models, this PR aims to implement model configuration subject to several constraints:

This work is informed by work in late 2023 on the HARK 2.0 model specification language.

Some tricky parts remaining to implement include:

sbenthall commented 5 months ago

This PR builds on #1427 which should be merged first.

sbenthall commented 1 week ago

This is now ready for review again.

Since it is mainly about notation, not functionality, there are no new tests to be added. A next step is to implement a solver that uses the algorithm in #1438 on the multi-stage problem defined here, with the given approximations.

The API for this solution algorithm is going to be the main constraint on what the workflow syntax looks like.

I'll be happy to write up some documentation for this, but it probably should get eyeballs and an OK from somebody else on the team, before expending effort on those docs.