Skip to content

Latest commit

 

History

History
71 lines (44 loc) · 1.93 KB

README.md

File metadata and controls

71 lines (44 loc) · 1.93 KB
Raw

Serial Abelian Sandpile Simulation

This project implements a serial Abelian Sandpile simulation in Java, organized with a Makefile to facilitate compiling and running the program.

Project Structure

  • Source Directory: src/serialAbelianSandpile
  • Binary Directory: bin/serialAbelianSandpile

The Makefile automates the compilation of .java source files located in the src/serialAbelianSandpile directory, storing the resulting .class files in the bin/serialAbelianSandpile directory.

Files

  • AbelianSandpileThread.java: Defines threads used in the simulation.
  • AutomatonSimulation.java: The main class, which initiates and runs the sandpile simulation.
  • Grid.java: Manages the grid data structure and operations for the simulation.

Usage

Requirements

  • Java Development Kit (JDK)
  • A command-line interface (CLI) such as Terminal or Command Prompt.

Compilation

To compile the project, navigate to the directory containing the Makefile and run:

make

This command will:

  1. Create the bin/serialAbelianSandpile directory if it doesn't exist.
  2. Compile all .java files in the src/serialAbelianSandpile directory, storing the .class files in bin/serialAbelianSandpile.

Running the Program

Once compiled, you can run the simulation with:

make run

This will execute the main class, serialAbelianSandpile.AutomatonSimulation, with default arguments specified in the Makefile:

  • Input: input/2000_by_2000_All_1.csv
  • Output: output/c.png

To override the default input and output files, specify ARGS:

make run ARGS="path/to/input.csv path/to/output.png"

Cleaning Up

To remove all compiled files, run:

make clean

Customization

  • Changing Arguments: Update the ARGS variable in the Makefile to specify different default input/output files if needed.

License

This project is licensed under the MIT License.