butiran

abm bc-input

· 3 mins read

Input and ouput design for abm bc is as follow.

inputs

  1. A wall that encircles the world, along with its size and resolution: the total size of the 2D grid and the cell granularity, defined in terms of the number of cells. ✓
  2. A bottomless cylindrical container for the mixture, simplified as two parallel walls separated by a specified width (in number of cells). ✓
  3. The cylinder should be able to move upward at a defined lifting speed. ✗
  4. Agents representing two or three components of the granular mixture. ✗
  5. A movement probability matrix for each agent, consisting of 9 directional probabilities: up, down, left, right, the four diagonals, and staying in place. ✗
  6. Component concentrations in the mixture, with a corresponding encoding scheme for each component. ✗
  7. The initial packing structure of agents inside the container: random fill, lattice arrangement, or layered distribution by component. ✗
  8. The simulation stop condition, such as when the container is fully lifted and all agents become stable. ✗
  9. Visualization parameters, including color mapping for each component, output resolution, and the rendering frame interval. ✗
  10. A random seed for reproducibility (optional, but useful for consistent experimental results and debugging). ✗

Above input specification and design is result of a discussion that refines initial idea 1.

todo

  • Add Read button to read data and draw the result on canvas. 1854 ✓

notes

  • Purpose of this note to design input elements and format for abm simulation of binary mixture in observing angle or repose (aor) as previously observed 2.
  • In order to assure that a JS file is loaded a script marker is added as suggested in a discussion 3, which is the first time to know about IIFE (Immediately Invoked Function Expression) 4.
  • This script marker is also implemented to previous JS 5, since it is used here, and also other JS 6.
  • This note is part of two other notes, which are 25d66 and 25f43 .
  • Add input title, format version, author, and date as suggested 7.
  • Rename it from “abm-aor 2-mix design” to “abm bc input” on 15-jun-2025.

refs

  1. GPT-4o, “Granular Material Simulation (ABM) for AOR: Input Specification & Design”, ChatGPT, 8 Jun 2025, url https://chatgpt.com/share/6844d2ee-7178-800a-a16b-6b22f36c368f [20250608]. ↩︎

  2. P. M. Widartiningsih, M. I. R. Putra, D. P. P. Aji, A. N. F. Rudiawan, S. Viridi, “Experimental investigation of pile characteristics of non-spherical particles mixtures: pile height and angle of repose”, Journal of Physics: Conference Series, vol 2243, no 1, p 01279, 2022, url http://doi.org/10.1088/1742-6596/2243/1/012079  ↩︎

  3. GPT-4o, “A Tiny Console Trick to Track JS Files in Hugo”, ChatGPT, 8 Jun 2025, url https://chatgpt.com/share/6844c09a-0490-800a-a2f8-5256c6133c76 [20250608]. ↩︎

  4. Gaurav Shrivastava, “IIFE (Immediately Invoked Function Expression)”, Medium, 20 Sep 2025, url https://medium.com/p/584fef2673b9 [20250608]. ↩︎

  5. Sparisoma Viridi, “js input from textarea”, butiran, 29 May 2025, url https://dudung.github.io/butiran/25e60/ . ↩︎

  6. Sparisoma Viridi, “js matrix to canvas”, butiran, 21 May 2025, url https://dudung.github.io/butiran/25e41/ . ↩︎

  7. GPT-4o, “ABM Input Format Feedback”, ChatGPT, 8 Jun 2025, url https://chatgpt.com/share/68456675-ea10-800a-9c5a-7a22fb445fdb [20250608]. ↩︎