Package: drlinfluids
DRLinFluidsDRLinFluids is a flexible and scalable package to utilize Deep Reinforcement Learning in the field of Computational Fluid Dynamics (CFD).Note: This package is still in development. The API is not stable yet. We invite all users to discuss further and ask for help directly on GitHub, through the issue system, and we commit to helping develop a community around the DRLinFluids framework by providing in-depth documentation and help to new users.The package is developed under Ubuntu 20.04 LTS and OpenFOAM 8.Table of contentsIntroductionInstallationHow to citeCore development team and contributorsContributingLicenseIntroductionReinforcement learning is a field of machine learning. It studies by interacting with the environment. It emphasizes how to make corresponding behavior in a specific environment in order to maximize the expected benefits. However, for reinforcement learning, it is necessary to define a specific interaction environment for specific problems, which is rather cumbersome and takes up a lot of time of researchers in related fields, and delays the research speed of researchers in reinforcement learning and fluid cross field. For this purpose, a reinforcement learning platform based on open source computational fluid dynamics software OpenFOAM is proposed, which is DRLinFluids. The platform has the characteristics of automation, quickness and simplicity, and can quickly call reinforcement learning for different research problems.Different from TensorFlow, PyTorch and other general machine learning frameworks, this platform takes OpenFOAM as an interactive environment, and further developsa general CFD reinforcement learning package.OpenFOAM(for "Open-source Field Operation And Manipulation") is a C++ toolbox for the development of customized numerical solvers, and pre-/post-processing utilities for the solution of continuum mechanics problems, most prominently including computational fluid dynamics (CFD). In fact, due to the versatility of OpenFOAM, in addition to computational fluid dynamics problems, it can also deal with any ODE or PDE problems. Users can create their own solver for practical application by setting the control equations and boundary conditions of specific problems. This also gives DRLinFluids a wider usage.InstallationFrom PyPIpipinstalldrlinfluidsFrom Source codegit clone https://github.com/venturi123/DRLinFluids.git
pip3 install -e drlinfluidsExamplesPlease see/examplesdirectory for quick start.Besides, we also build an additional repositoryDRLinFluids-examplesfor quick understanding and testing, and the user-friendly DRLinFluids package will be uploaded on this page in the near future.How to citePlease cite the framework as follows if you use it in your publications:Qiulei Wang (王秋垒), Lei Yan (严雷), Gang Hu (胡钢), Chao Li (李朝), Yiqing Xiao (肖仪清), Hao Xiong (熊昊), Jean Rabault, and Bernd R. Noack , "DRLinFluids: An open-source Python platform of coupling deep reinforcement learning and OpenFOAM", Physics of Fluids 34, 081801 (2022) https://doi.org/10.1063/5.0103113For more formats, please seehttps://aip.scitation.org/action/showCitFormats?type=show&doi=10.1063%2F5.0103113.Core development team and contributorsDRLinFluids is currently developed and maintained byAIWE Lab, HITSZQiulei WangLei YanGang HuJean RabaultBernd NoackContributingInterested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.We invite all users to further discuss and ask for help directly on Github, through the issue system, and we commit to helping develop a community around the DRLinFluids framework by providing in-depth documentation and help to new users.LicenseDRLinFluidsis licensed under the terms of the Apache License 2.0 license.