https://github.com/shamrock-code/shamrock

The Shamrock Framework, an open-source, multi-GPU hydrodynamics framework for astrophysics. Scales seamlessly from laptops to exascale supercomputers, supporting SPH, AMR, and more.
https://github.com/shamrock-code/shamrock

adaptivecpp amr astrophysics fluid-dynamics fluid-simulation-engine mpi multi-gpu oneapi phantom ramses sph sycl zeus

Last synced: 3 months ago
JSON representation

The Shamrock Framework, an open-source, multi-GPU hydrodynamics framework for astrophysics. Scales seamlessly from laptops to exascale supercomputers, supporting SPH, AMR, and more.

• Host: GitHub
• URL: https://github.com/shamrock-code/shamrock
• Owner: Shamrock-code
• License: cecill-2.1
• Created: 2022-04-05T15:36:05.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2025-10-12T14:23:56.000Z (3 months ago)
• Last Synced: 2025-10-20T07:41:25.576Z (3 months ago)
• Topics: adaptivecpp, amr, astrophysics, fluid-dynamics, fluid-simulation-engine, mpi, multi-gpu, oneapi, phantom, ramses, sph, sycl, zeus
• Language: C++
• Homepage: https://shamrock-code.github.io
• Size: 15.1 MB
• Stars: 44
• Watchers: 5
• Forks: 16
• Open Issues: 152
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Citation: CITATION.bib

Awesome Lists containing this project

README

          


![badge1](https://github.com/Shamrock-code/Shamrock/actions/workflows/on_push_main.yml/badge.svg?branch=main) [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)

# The Shamrock code

Shamrock is a general purpose HPC hydrodynamics simulation code focused on astrophysical contexts.

The whole code is **C++17** by default, and all accelerated parts are done using **SYCL**,

which can be directly compiled directly to native **CUDA**, **ROCM**, **OpenMP**, **OpenCL** and much more.

Shamrock also supports multiple GPUs and Heterogeneous clusters using **MPI**.

This code aims to be **Modern**, **Modular**, **Fast**, **Portable**.

## Packaging

[![Packaging status](https://repology.org/badge/vertical-allrepos/shamrock.svg)](https://repology.org/project/shamrock/versions)

### Third-party :

- Shamrock docker : `docker run -it --platform=linux/amd64 ghcr.io/shamrock-code/shamrock:latest-oneapi`

## Citing the code

[![bibtex](https://img.shields.io/badge/bibtex-file-green.svg)](./CITATION.bib)

[![Nasa ads](https://img.shields.io/badge/nasa_ADS-2025MNRAS.539....1D-blue.svg)](https://ui.adsabs.harvard.edu/abs/2025MNRAS.539....1D)

[![arXiv](https://img.shields.io/badge/arXiv-2503.09713-b31b1b.svg)](https://arxiv.org/abs/2503.09713)

# Documentation

We provide both a book like documentation and the more classic doxygen style for more details about the sources

 - The documentation is available here: [Shamrock documentation](https://shamrock-code.github.io/Shamrock/mkdocs/index.html)

# Getting started

The whole getting started guide can be found here: [Getting started](https://shamrock-code.github.io/Shamrock/mkdocs/usermanual/quickstart/)

Note that a convenient way to pull the Shamrock repo is the following command to also pull the submodules:

```bash

git clone --recurse-submodules https://github.com/Shamrock-code/Shamrock.git

```

## Getting in touch

Join us on [Discord](https://discord.gg/Q69s5buyr5), or [Slack](https://shamrock-code.slack.com)! Alternatively, open a discussion or issue in this repository.

## Contributing

Shamrock accept contributions through github pull request :

1. Code contributions via [Pull request](https://github.com/Shamrock-code/Shamrock/compare)

2. Documentation contributions via [Pull request](https://github.com/Shamrock-code/Shamrock/compare)

3. Issue report & feature requests via [Github issues](https://github.com/Shamrock-code/Shamrock/issues/new/choose)

If you want to contribute please fork the code and submit your pull requests from your fork.

## Compiler support

Compiler config | Support

---|---

DPC++ CUDA | ![badge2](https://badgen.net/static/DPC++%2FCUDA/yes/green)

DPC++ ROCM | ![badge2](https://badgen.net/static/DPC++%2FHIP:ROCM/yes/green)

AdaptiveCPP OpenMP | ![badge2](https://badgen.net/static/ACPP%2FOpenMP/yes/green)

AdaptiveCPP ROCM | ![badge2](https://badgen.net/static/ACPP%2FROCM/yes/green)

AdaptiveCPP CUDA | ![badge2](https://badgen.net/static/ACPP%2FCUDA/yes/green)

AdaptiveCPP SSCP | ![badge2](https://badgen.net/static/ACPP%2FSSCP/yes/green)

# Licensing

Shamrock is licensed under the `CeCILL Free Software License Agreement v2.1`. See [License (french version)](./LICENSE) or [License (english version)](./LICENSE.en) for more details.

Copyright 2021-2025 Timothée David--Cléris

SPDX-License-Identifier: CeCILL Free Software License Agreement v2.1