Welcome to Kamayan

A kamayan is a Filipino cultural practice where a feast is shared communally, spread on top of a table, with diners eating with their hands, unhindered by the formalities often associated with western dining etiquette. The kamayan here aims to follow in that tradition as a hydrodynamics code, easing the combination of novel numerical methods with multi-physics applications.

The code is built on the Parthenon Adaptive Mesh Refinement(AMR) framework for performance portability.

Quick Start

Kamayan uses uv to manage python dependencies used for tooling. Independently any dependencies for parthenon must be built externally, e.g., hdf5 & mpi. A quick start to getting kamayan and building the code can be done with

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/acreyes/kamayan.git
cd kamayan
git submodule update --init --recursive
mkdir build && cd build
uv run cmake ..
uv run cmake --build . -j4
mpirun -np 4 isentropic_vortex -i ../src/problems/isentropic_vortex.in