Skip to content

tdavidcl/Shamrock

 
 

Repository files navigation

badge1 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

Third-party :

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

Citing the code

bibtex Nasa ads arXiv

Documentation

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

Getting started

The whole getting started guide can be found here: Getting started

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

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

Getting in touch

Join us on any of the networks below or just by opening a discussion or issue in this repository.

Contributing

Shamrock accept contributions through github pull request :

  1. Code contributions via Pull request
  2. Documentation contributions via Pull request
  3. Issue report & feature requests via Github issues

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
DPC++ ROCM badge2
AdaptiveCPP OpenMP badge2
AdaptiveCPP ROCM badge2
AdaptiveCPP CUDA badge2
AdaptiveCPP SSCP badge2

Licensing

Shamrock is licensed under the CeCILL Free Software License Agreement v2.1. See License (french version) or License (english version) for more details.

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

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

About

Shamrock Astrophysics code. Temp doc website : https://tdavidcl.github.io/Shamrock/

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages

  • C++ 94.7%
  • Python 4.1%
  • CMake 1.2%