Known Issues

Non-square Grids

There are currently issues with running non-square grids in the HJB loop. Non-square grids appear to function properly with the macro_model.options.ignore_HJB_loop option set to True.

Python Environments

The visualization application, built on dash and flask, may not work in environments such as Google Colab or Jupyter Notebooks. If you run python yourfile.py from a command prompt (the Anaconda Prompt if you are using the Anaconda environment), then the visualization should work and open a local port in your browser (see this page).

Speed

Two-dimensional problems with large grids tend to take a long time to converge, even with parallelization. Performance improvmeents to the package are planned for future releases; however, with the current release it is suggested that two-dimensional problems be run on high-performance computing clusters with access to many CPU. It is also suggested to reduce the grid size and increase the error tolerances for test runs, then to run a large grid size with low error tolerances when test runs are stable and behave as expected. Using the least_squares solver option rather than newton-raphson may also improve performance.