dem-examples

DEM simulation codes providing some examples

https://github.com/shobuzako-kensuke/dem-examples

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 5 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.5%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

DEM simulation codes providing some examples

Basic Info
  • Host: GitHub
  • Owner: shobuzako-kensuke
  • License: mit
  • Language: Fortran
  • Default Branch: main
  • Size: 24.4 KB
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 2
Created 7 months ago · Last pushed 7 months ago
Metadata Files
Readme Changelog License Citation

README.md

DEM-Examples

DOI

日本語版はこちら

This open-source code provides Discrete Element Method (DEM) simulations, including the following examples:

  • Granular Column Collapse (2D)
  • Cylinder Lift (2D)

|Granular Column Collapse | Cylinder Lift | |:---:|:---:| |granular_column_collapse|cylinder_lift|

[!TIP] For DEM study, BasictheoryDEM.pdf might be a helpful resource.

⚙️ Requirements

This code is written in Fortran (for DEM calculations) and Python (for visualization).

| Category | Requirement | Notes | |:---|:---|:---| |Operating System |Unix-like environment | Tested on Windows Subsystem for Linux (WSL)| |Compiler | Intel Fortran / gfortran| Tested with ifx (default) and gfortran |Build Tool | make | For building Fortran files| |Visualization | Python | Tested with Python 3.12.0 and requires matplotlib| |Movie Generation| ffmpeg | Required for Python scripts to generate movies|

[!TIP] If ffmpeg is not installed, run sudo apt install ffmpeg .

🖥️ Usage

  1. Navigate to the simulation directory (e.g., dem_code/granular_column_collapse_2D/source_code/)
  2. Run make to build the Fortran programs.
  3. Run ./start_calculation to start the simulation.
  4. After the simulation finishes, run python main.py to generate figures.

[!NOTE] Each problem statement is described in the README.md in its directory.

🧑‍💻 Citation

Shobuzako, K. (2025). DEM-Examples (Version 1.1.0) [Computer software].
Zenodo. https://doi.org/10.5281/zenodo.16356866

🤝 Contributing

Contributions are welcome!
If you would like to improve the code, report a bug, or add a new feature, feel free to submit a pull request.

🪪 License

This project is licensed under the MIT License .

Owner

  • Name: Shobuzako Kensuke
  • Login: shobuzako-kensuke
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Shobuzako"
  given-names: "Kensuke"
  orcid: "https://orcid.org/0009-0000-4453-5398"
title: "DEM-Examples"
version: 1.1.0
doi: 10.5281/zenodo.16356866
date-released: 2025-07-28
url: "https://doi.org/10.5281/zenodo.16356866"

GitHub Events

Total
  • Create event: 2
  • Issues event: 2
  • Release event: 2
  • Watch event: 5
  • Push event: 26
  • Pull request event: 13
Last Year
  • Create event: 2
  • Issues event: 2
  • Release event: 2
  • Watch event: 5
  • Push event: 26
  • Pull request event: 13