> For the complete documentation index, see [llms.txt](https://token-engineering-balancer.gitbook.io/balancer-simulations/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://token-engineering-balancer.gitbook.io/balancer-simulations/balancer-simulations/v10nboverview.md).

# Model Overview

Balancer AMM Models and Simulations are built with [**cadCAD**](https://cadcad.org/), an open-source Python package for designing, testing, and validating complex systems. In case you haven't used cadCAD yet, we highly recommend taking this [beginner course](https://www.cadcad.education/) and become familiar with cadCAD.

In Balancer Simulations V1.0 we demonstrate how **real-world transactions** can be routed through the Balancer Simulations model. Moreover, we add **external price feeds** to showcase how various data sources can be combined for a **most realistic simulation scenario**, while the **prototyping effort** for new Balancer Pool designs is **minimized** using a Python model.\
\
Additionally, we've used real-world transaction data to [verify if the model is producing accurate and credible results](https://token-engineering-balancer.gitbook.io/balancer-simulations/additional-code-and-instructions/balancer-the-python-edition/model-verification-and-limitations).

 We are following the[ cadCAD System Model standard](https://github.com/cadCAD-org/cadCAD/tree/master/documentation), with

* *State Variables* to describe the mathematical "state" of the pool
* *State Update Functions*, changing the state variables in discrete events according to on-chain transactions and price updates
* *Policy Functions*, defining the rules of the system, in our case mapping transactions   to the right method in the model to update the state
* *Partial State Update Blocks*, which are sets of state updates and policy functions

![](/files/-MUrmmW9yGEcz_XJp2H3)

Simulations in V1.0 allows to combine four components:

A) **on-chain transaction data** of a Balancer pool you'd like to analyze, formatted as a series of actions in json format.

{% content-ref url="/pages/-MRwyE1liSHZEqeLq0TJ" %}
[Adding On-chain Transaction Data and USD Prices](/balancer-simulations/additional-code-and-instructions/onchaintransactions.md)
{% endcontent-ref %}

B) external **price data**, to add information on token prices **in USD** and analyse arbitrage opportunities, or metrics like Total Value Locked (TVL)

{% content-ref url="/pages/-MRwyE1liSHZEqeLq0TJ" %}
[Adding On-chain Transaction Data and USD Prices](/balancer-simulations/additional-code-and-instructions/onchaintransactions.md)
{% endcontent-ref %}

C) the general **model of a Balancer Pool V1**

{% content-ref url="/pages/-MRx-Il6eWZQ2rV4b\_r-" %}
[Balancer: the Python edition](/balancer-simulations/additional-code-and-instructions/balancer-the-python-edition.md)
{% endcontent-ref %}

D) and a **Jupyter Notebook** to tie together all elements, to customize simulations, plot charts and draw conclusions

{% content-ref url="/pages/-MRwxRsTSi3xuI8-oUZz" %}
[Pool Exploration](/balancer-simulations/balancer-simulations/pool-exploration.md)
{% endcontent-ref %}