more notes in sim framework demo notebook