Skip to content

Commit

Permalink
add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Benedikt Moritz Maurer committed Oct 5, 2024
1 parent 2e66976 commit 64401bf
Show file tree
Hide file tree
Showing 3 changed files with 56 additions and 2 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ jobs:

- name: Install dependencies
run: sudo apt-get update && sudo apt-get install -y
g++ cmake libyaml-cpp-dev catch2 libeigen3-dev doxygen libhdf5-dev
g++ cmake libyaml-cpp-dev catch2 libeigen3-dev doxygen libhdf5-dev boost

- name: Create build directory
run: mkdir build
Expand Down
54 changes: 54 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
This is flash, a super fast BSE solver.

# Install:
To build **Flash** with debug flags, release flags and the documentation type in the root directory
```bash
make
```
You can seperately build **Flash** with debug flags, release flags or the documentation seperately by typing, respectively
```bash
make debug
make release
make documentation
```
If you wish to make build the documentation, make sure that doxygen is installed.

## Run unit tests:
Run all tests:
```
make test
```
Run debug or release build tests
```bash
make test-debug
make test-release
```

## Lint and auto-format the code:
To run first **clang-tidy** and then **clang-format** for all files, type
```bash
make linter

```
To run **clang-tidy** or then**clang-format**, type, respectively
```bash
make clang-tidy
make clang-format
```

## Requirements:
For building:
- CMake >
- Eigen
- HDF5
- cpp-yaml
- catch2
- boost
For the documentation
- doxygen
For linting and auto formatting:
- clang-tidy
- clang-format



Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ flash::types::DVector readDoubleVectorHDF5(const std::string &filename, const st
} // namespace data_processing
} // namespace flash

#endif // FLASH_READ_H
#endif // FLASH_READ_H

0 comments on commit 64401bf

Please sign in to comment.