Git Product home page Git Product logo

nekrs's Introduction

nekRS


Build Status License

nekRS is an open-source Navier Stokes solver based on the spectral element method targeting modern processors and accelerators. The code uses the CEED software products OCCA and libParanumal.

Capabilities:

  • Incompressible and low Mach-number Navier-Stokes + scalar transport
  • CG-SEM using curvilinear conformal hexaheadral elements
  • 2nd order semi-implicit time integration + operator integration factor splitting
  • MPI+X hybrid parallelism supporting CPU, CUDA, HIP and OPENCL
  • Interface to Nek5000
  • Conjugate fluid-solid heat transfer
  • LES and RANS turbulence models
  • VisIt & Paraview support for data analysis and visualization

Note, the code is an early prototype so it's very likely that you run into undiscovered issues. Moreover it's evolving quickly so things might change from one version to another without being backward compatible.

Build Instructions

Requirements:

  • POSIX compilant OS
  • GNU compiler collection version 6.2 or later
  • MPI-3.1 or later
  • CMake version 3.11 or later
  • Login shell bash or zsh

Download the latest release tarball

wget https://github.com/Nek5000/nekRS/releases/download/v20.1/nekRS-v20.1.tar.gz 
tar -zxf nekRS-v20.1.tar.gz 

or clone our GitHub repository:

git clone https://github.com/Nek5000/nekRS.git

To build and install the code just run:

./makenrs

Build settings can be customized in the script.

Setting the Enviroment

Assuming you run bash and your install directory is $HOME/.local/nekrs, add the following line to your $HOME/.bash_profile:

export NEKRS_HOME=$HOME/.local/nekrs
PATH=${NEKRS_HOME}/bin:${PATH}

then type source $HOME/.bash_profile in the current terminal window.

Run Example

cd $NEKRS_HOME/examples/ethier
nrsmpi ethier 2 # run on two MPI ranks

Contributing

Our project is hosted on GitHub and everbody is welcome to become a part of it. If you are planning a large contribution, we encourage you to discuss the concept here on GitHub and interact with us frequently to ensure that your effort is well-directed.

Troubleshooting

If you run into problems compiling, installing, or running nekRS, please send a message to the User's Group mailing list. Please sign up to post your questions, concerns or suggestions.

Reporting Bugs

nekRS is hosted on GitHub and all bugs are reported and tracked through the Issues feature on GitHub. If you are having trouble installing the code or getting your model to run properly, you should first send a message to the User's Group mailing list.

License

nekRS is released under the BSD 3-clause license (see LICENSE file). All new contributions must be made under the BSD 3-clause license.

Acknowledgment

This research was supported by the Exascale Computing Project (17-SC-20-SC), a joint project of the U.S. Department of Energy’s Office of Science and National Nuclear Security Administration, responsible for delivering a capable exascale ecosystem, including software, applications, and hardware technology, to support the nation’s exascale computing imperative.

nekrs's People

Contributors

alikarakus avatar luspi avatar malachitimothyphillips avatar nchristensen avatar pwang234 avatar ronrahaman avatar stgeke avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.