This repository provides the supporting material for the "unfolding tutorial" within the IIT wiki. It is intended to help you understand what is happening "under the hood" in the process for isolating complexes and unfolding $\Phi$-structures within the integrated information theory (IIT). The tutorial is based on jupyter notebooks implementing functionality from Pyphi, but intentionally going into the details of the computational steps typically carried out behind the scenes. Keep in mind that the tutorial is best viewed as a part of the IIT wiki as a whole. Also, if you are not interested in coding yourself, you can see screencasts of the tutorial content in the relevant pages of the wiki.

For those of you interested in learning more, we strongly encourage you to head over to our wiki, read the academic papers (for example starting here), get acquainted with the latest version of pyphi (see documentation and examples for getting started here), browse other resources online (for example here, here or here), or get in touch with us. However, be aware that a lot of the resources online are already outdated because the theory is still in development! And take a look at the our lab website (the Center for Sleep and Consciousness) for an update of the latest changes to the theory.

To get started working with this tutorial on your own, please open your terminal and:

1. make sure you have anaconda and git installed with a fresh base environment
2. in your terminal navigate to a folder where you would like to add the tutorial files
3. clone this repository with git clone https://github.com/bjorneju/IIT_wiki_tutorial.git
4. step into the folder using cd IIT_wiki_tutorial
5. create a new environment using conda env create -f environment.yml (this step takes some time)
6. activate your environment using conda activate iit_tutorial
7. open a jupyter lab session, and open the adress associated with the jupyter lab session in your browser (i.e. http://localhost:8892/)
8. and browse the notebooks!

Hope you enjoy the experience!