Ising model as Perception-Action Loop

This project contains code that uses the JIDT library to run various information-theoretic computations. Please follow the instructions on JIDT home page to install the package. Some file paths in the code need to be customised based on your system setup.

Setup Instructions

Step 1: Clone the Repository

Clone this repository to your local machine:

git clone https://github.com/qianyangchen/isingmodelPALoop.git

Step 2: Install Dependencies

Ensure that you have the required Python packages installed. You can install them via pip:

pip install -r requirements.txt

Step 3: Create the Configuration File

In order to run the code properly, you will need to create a config.json file to specify local paths for the JIDT library and other resources.

Create a config.json file in the root directory of the project (where the Jupyter Notebook is located). The structure of the config.json file should look like this:

{
  "infodynamics_path": "/path/to/your/infodynamics-dist-1.6.1/demos/python",
  "jar_location": "/path/to/your/infodynamics-dist-1.6.1/infodynamics.jar"
}

Example config.json

If you have the JIDT library located in your home directory under /Users/username/, your config.json should look something like this:

{
  "infodynamics_path": "/Users/username/infodynamics-dist-1.6.1/demos/python",
  "jar_location": "/Users/username/infodynamics-dist-1.6.1/infodynamics.jar"
}

Step 4: Running the Jupyter Notebook

Once you have set up the config.json file, you can run the Jupyter Notebook as usual:

jupyter notebook

Ensure that the paths in your config.json file point to the correct locations where you have stored the necessary resources.

Troubleshooting

FileNotFoundError: If you encounter this error, double-check the paths in the config.json file. Ensure the infodynamics_path and jar_location point to the correct files and directories.

References and Acknowledgments

While developing this Ising model simulation, I referred to the following resources:

1. Luke Polson's YouTube Channel Notebook:

   • Python Metaphysics Series, Ising Model Simulation (Notebook). Available at: https://github.com/lukepolson/youtube_channel/blob/main/Python%20Metaphysics%20Series/vid14.ipynb

2. Rajesh Rinet's Blog:

   • Rajesh Rinet, Ising Model Simulation. Available at: https://rajeshrinet.github.io/blog/2014/ising-model/

3. NetLogo Ising Model:

   • Wilensky, U. (2003). NetLogo Ising model. Available at: http://ccl.northwestern.edu/netlogo/models/Ising. Center for Connected Learning and Computer-Based Modeling, Northwestern University, Evanston, IL.

I would like to acknowledge and give credit to these resources as they provided valuable insights and inspiration for the implementation of the Ising model simulation.

License

This project is licensed under the MIT License - see the LICENSE file for details.