Felino: Extension of an open-source phase-field framework to geomaterial fracture
Felino: Extension of an open-source phase-field framework to geomaterial fracture - Published in JOSS (2026)
Science Score: 87.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
○codemeta.json file
-
○.zenodo.json file
-
✓DOI references
Found 1 DOI reference(s) in JOSS metadata -
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Repository
MOOSE-based phase-field fracture application for fatigue analysis and geomaterials with tension–compression asymmetry and reproducible benchmarks.
Basic Info
- Host: GitHub
- Owner: DanielChou0916
- License: lgpl-2.1
- Language: SWIG
- Default Branch: main
- Homepage: https://danielchou0916.github.io/felino.github.io/#
- Size: 28.1 MB
Statistics
- Stars: 6
- Watchers: 2
- Forks: 3
- Open Issues: 0
- Releases: 1
Metadata Files
README.md
Felino
Felino is an open-source phase-field fracture framework built on the MOOSE framework.
This repository provides an extension for geomaterial fracture modeling, supporting asymmetric tensile/compressive behavior.
🚀 Installation Guide
The following instructions assume you are using Ubuntu (or WSL with Ubuntu).
Felino is built on top of the MOOSE framework. The instruction in this page includes installation of MOOSE and Felino.
And it is presented with the Assumption that the number of cpu on user's device is 4.
1️⃣ Install Miniforge (Lightweight Conda)
bash
curl -L -O https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh
bash Miniforge3-Linux-x86_64.sh -b -p ~/miniforge
2️⃣ Setup Conda and Restart Shell
bash
export PATH=$HOME/miniforge/bin:$PATH
conda init --all
exit
⚠️ Close and reopen your terminal after running exit.
3️⃣ Update Conda and Add MOOSE Channel
bash
conda update --all --yes
conda config --add channels https://conda.software.inl.gov/public
4️⃣ Create and Activate MOOSE Environment
bash
conda create -n moose moose-dev=2025.07.22=mpich
conda activate moose
5️⃣ Clone and Checkout MOOSE
bash
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/idaholab/moose.git
cd moose
git checkout master
6️⃣ Build and Test MOOSE
bash
cd ~/projects/moose/test
make -j 4
./run_tests -j 4
✅ If you see All tests passed, MOOSE installation is successful.
🐾 Felino Installation
After MOOSE is installed, build Felino:
bash
cd ~/projects
git clone https://github.com/DanielChou0916/felino.git
cd felino
make -j 4
▶️ Running a Test
bash
cd ~/projects/felino
chmod +x felino_test.sh
./felino_test.sh
When you see [Felino] (='v'=) Installation test PASSED., the test has run successfully.
▶️ Running a Tutorial for v1.0.2 Geomaterial Analysis
📌 This example demonstrates the new geomaterial fracture models added in v1.0.2.
bash
cd ~/projects/felino
mpiexec -n 4 ./felino-opt -i tutorials/tur4_uniaxial_compression/Ce/Ce_disp.i
🔄 Updating Felino
bash
cd ~/projects/felino
git pull
make clean
make -j 4
📖 Documentation & Tutorials
📌 Official website: Felino Website
📌 Tutorials and benchmark examples are provided under the tutorials/ folder.
JOSS Publication
Felino: Extension of an open-source phase-field framework to geomaterial fracture
Authors
Georgia Institute of Technology, United States
Editor
Anjali Sandip
Tags
Finite Element Analysis Phase Field Fracture Mechanics GeomaterialsGitHub Events
Total
- Fork event: 3
- Issues event: 4
- Watch event: 4
- Issue comment event: 1
- Push event: 41
- Public event: 1
- Create event: 1
Last Year
- Fork event: 3
- Issues event: 4
- Watch event: 4
- Issue comment event: 1
- Push event: 41
- Public event: 1
- Create event: 1
Issues and Pull Requests
Last synced: 4 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0