Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/openfluid/ropenfluid

R package for OpenFLUID
https://github.com/openfluid/ropenfluid

analysis modelling openfluid r simulation

Last synced: 3 months ago
JSON representation

R package for OpenFLUID

Awesome Lists containing this project

README

        

[![R check build](https://github.com/OpenFLUID/ropenfluid/actions/workflows/CI.yaml/badge.svg)](https://github.com/OpenFLUID/ropenfluid/actions/workflows/CI.yaml)

# Overview

This package allows to load, parameterize, run and analyze OpenFLUID simulations
from the GNU R environment

The ROpenFLUID license is available in the [package/LICENSE](package/LICENSE) file

This package uses the following R packages:
- Runit (for tests only)
- roxygen2 (during package development only, not for installation or usage)

# Source code

Package heavily relies on binding facilities provided by the OpenFLUID Framework.
See `openfluid/utils/Binding.hpp` and related headers in the [OpenFLUID source code](https://github.com/OpenFLUID/openfluid).

The R part of the code is written following the [Tidyverse coding style](https://style.tidyverse.org/), with the following exceptions:

* line length is not stricly limited to 80 characters and can be extended to 120 characters if needed
* case style of functions names is not restricted to the recommended snake case

# Development and Build

The ROpenFLUID package requires for building process:

* The OpenFLUID framework
* The R development framework
* The CMake build tools family, version 3.1 or higher
* The GCC compiler version 5.3 or higher (for C++14 compatibility)

The build/doc commands are launched using the CMake tool in script mode. In this mode,
configuration variables passed on the command line must be placed before the `-P ` argument.

Each following command produces results in a build directory.
The default name for this directory is `_build` and is located at the root of the ROpenFLUID sources.
To override this default build directory, you can set a custom absolute path through the `BUILD_PATH` variable of the CMake command (e.g. `cmake -DBUILD_PATH=/path/to/build/dir -P check.cmake`)

On Windows platforms, the commands below have to be run in an MSYS2 terminal, using the mingw64 toolchain.
See the `msys2-mingw64-env.sh.tpl` file for configuration of the build environment.

## Checking ROpenFLUID package

This will run the R checking process for the package:
```
cmake -P check.cmake
```

The CRAN mode can be enabled to apply the CRAN submission requirements during the checking process:
```
cmake -DAS_CRAN_MODE=ON -P check.cmake
```

## Building ROpenFLUID package

This will create the package:
```
cmake -P build.cmake
```

## Generating HTML doc for ROpenFLUID package

```
cmake -P htmldoc.cmake
```