58 Stars
Updated Last
1 Year Ago
Started In
August 2015

codecov Stable documentation

Mimi - Integrated Assessment Modeling Framework

Mimi is a Julia package that provides a component model for integrated assessment models, as described in detail on the Mimi Framework Homepage. The Documentation includes information on the installation and use of this package, step-by-step tutorials, how-to guides, and technical reference. The development team closely monitors the Mimi Framework forum and we suggest this as a starting place for any questions users may have.

Also, note that if at any point julia-related issues with workflows, environments, and/or package versioning become frustrating, please do not hesitate to reach out via the forum. This can be a hurdle to learn at first, but taking a moment to get it right early will save you a lot of time down the road. We are more than happy to help you, and are getting together some standardized resources in the meantime.



The newest model on our platform, MimiGIVE is a fully open source model featured in the recent Nature publication Comprehensive evidence implies a higher social cost of CO2 and recent EPA work.


Check out the new MimiSSPs.jl component, pulling in various SSP and RCP data sources into a component to streamline running Mimi models as forced by the SSPs and RCPs.


We recently tagged and released a feature release revamping the API surrounding parameters, please see https://www.mimiframework.org/Mimi.jl/dev/howto/howto_5/ and https://www.mimiframework.org/Mimi.jl/dev/howto/howto_9/.


We have written up a repository and accompanying notebook here to demonstrate the steps to couple together two models, specifically in this case replacing (most of) the FUND model's climate module with the FAIR model.


We officially tagged and released Mimi v1.0.0, which has some new features, documentation, and quite a bit of internals work as well. Since this is a major version change, there are some breaking changes that may require you to update your code. We have done the updates for the existing models in the Mimi registry (FUND, DICE, etc.), and will release new major versions of those today as well, so if you are using the latest version of Mimi and the latest version of the packages, all should run smoothly.

Please view the how to guide here: https://www.mimiframework.org/Mimi.jl/stable/howto/howto_7/ for a run-down of how you should update your own code.

In addition please do not hesitate to ask any questions on the forum, we are working hard to keep this transition smooth.

Contributions and Questions

You can interact with the Mimi development team via issues and pull requests here on github, and in the Mimi Framework forum. Contributions to Mimi are also most welcome, and please get in touch with David Anthoff if you want to be involved in any way with this effort.


This work is partially supported by the National Science Foundation through the Network for Sustainable Climate Risk Management (SCRiM) under NSF cooperative agreement GEO-1240507.