iamax 0.0.0.post2

IAM-AX in Python

IAM-AX is a metamodel for designing, generating, inspecting and running computable general-equilibrium models. It generates the code of integrated or non-integrated CGE models from i) structured socio-economic, technical or physical data and ii) standalone analytical equations written in Python, in a form close to what one would expect from a rigorous analytical model description.

Sewn on ImaCLIM — IMpact Assessment of CLIMate policies — whether in static or recursive settings, IAM-AX is not merely another implementation environment for applied general-equilibrium modelling. Its ambition is to define a common architecture for building, reading, testing, comparing, executing and maintaining models.

IAM-AX is also a response to the social role of models. Complex applied models often inform public reasoning, policy assessment and long-term scenarios, yet their complexity can make them difficult to inspect, scrutinize or transmit. This opacity is usually not intentional; it is the cumulative effect of accumulated code, implicit conventions, technical debt and fragmented workflows. IAM-AX addresses this risk by making the constitutive elements of a modelling exercise easier to expose, inspect, criticize, compare, reproduce and understand.

This is why IAM-AX seeks to push modelling transparency as far as possible. Its purpose is to prevent the elements of a modelling exercise — data, unknowns, behavioural assumptions, functional interactions, generated equations, numerical resolution and results — from being scattered across opaque code, tacit practices or undocumented conventions. By bringing these elements back to a level of explicitness and simplicity that makes opacity difficult to sustain, IAM-AX directly addresses the black-box syndrome often associated with complex applied models.

This ambition matters all the more in a context of widespread distrust toward technical and scientific discourse. IAM-AX treats readability, traceability and communicability not as optional documentation tasks, but as core design constraints. In doing so, it attempts to make modelling work more open to review, transmission and contestation.

In that sense, IAM-AX is both a model reader and a model generator. Like a reader able to interpret many discs written in the same format, IAM-AX can interpret many models as long as they follow its common grammar. It then generates explicit, readable Python code corresponding to the model it has interpreted. A model is no longer only a bespoke codebase. It becomes an object that can be read, inspected, compared and maintained according to shared rules.

The documentation is available online.