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

https://github.com/ornl/riopa.jl

Proxy app for input/output pattern generation in the Exascale Computing Project using Julia
https://github.com/ornl/riopa.jl

performance-modeling-and-analysis

Last synced: 2 months ago
JSON representation

Proxy app for input/output pattern generation in the Exascale Computing Project using Julia

Awesome Lists containing this project

README

        

[![Documentation Status](https://readthedocs.org/projects/riopajl/badge/?version=latest)](https://riopajl.readthedocs.io/en/latest/?badge=latest)

# RIOPA.jl

Reproducible Input Ouput (I/O) Pattern Application (RIOPA).
Proxy app for I/O generation using Julia funded by the U.S. Department of Energy
Exascale Computing Project.

Requires:
- [Julia](https://julialang.org/downloads/) v1.6 or later

## Getting started
It's helpful to set the following environment variables:

- `JULIA_MPI_PATH=`
- `JULIA_MPI_BINARY=system`
- `JULIA_HDF5_PATH=` (may be necessary in order to use
HDF5 in parallel see [HDF5.jl docs](https://juliaio.github.io/HDF5.jl/stable/#Setting-up-Parallel-HDF5))

In addition, if `mpiexec` is not the proper run command for your system, set the
environment variable `JULIA_MPI_EXEC` to the desired run command (such as `srun`
or `jsrun`). See the MPI package
[configuration](https://juliaparallel.github.io/MPI.jl/stable/configuration/)
page for more options if necessary.

From top-level RIOPA directory run
```
julia --project[=.]
```
```
julia> ]
(RIOPA) pkg> instantiate
(RIOPA) pkg> build
(RIOPA) pkg>
```

### Test Suite
```
julia --project ./test/runtests.jl
```

### Minimal Functionality ("hello") Mode
```
julia --project riopa.jl [(-c | --config) ] hello
```
Using the default configuration:
```bash
julia --project riopa.jl hello
```
or in parallel:
```
mpirun -n 4 julia --project riopa.jl hello
```

### Generate a Configuration File
```
julia --project riopa.jl [(-c | --config) ] generate-config
```
If no filename is given, the generated file will be given a generic name.