2023-01-05 13:03:37 -06:00
|
|
|
[](https://github.com/AMDResearch/omniperf/actions/workflows/ubuntu-focal.yml)
|
2023-01-06 13:17:02 -06:00
|
|
|
[](https://github.com/AMDResearch/omniperf/actions/workflows/opensuse.yml)
|
2022-12-21 15:12:33 -06:00
|
|
|
[](https://amdresearch.github.io/omniperf/)
|
2022-12-12 14:33:25 -05:00
|
|
|
[](https://zenodo.org/badge/latestdoi/561919887)
|
2022-12-21 15:15:13 -06:00
|
|
|
|
2022-11-04 14:49:36 -05:00
|
|
|
|
|
|
|
|
# Omniperf
|
|
|
|
|
|
|
|
|
|
## General
|
|
|
|
|
Omniperf is a system performance profiling tool for machine
|
|
|
|
|
learning/HPC workloads running on AMD MI GPUs. The tool presently
|
|
|
|
|
targets usage on MI100 and MI200 accelerators.
|
|
|
|
|
|
|
|
|
|
* For more information on available features, installation steps, and
|
|
|
|
|
workload profiling and analysis, please refer to the online
|
|
|
|
|
[documentation](https://amdresearch.github.io/omniperf).
|
|
|
|
|
|
|
|
|
|
* Omniperf is an AMD open source research project and is not supported
|
|
|
|
|
as part of the ROCm software stack. We welcome contributions and
|
|
|
|
|
feedback from the community. Please see the
|
|
|
|
|
[CONTRIBUTING.md](CONTRIBUTING.md) file for additional details on our
|
|
|
|
|
contribution process.
|
|
|
|
|
|
|
|
|
|
* Licensing information can be found in the [LICENSE](LICENSE) file.
|
|
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
Omniperf follows a
|
|
|
|
|
[main-dev](https://nvie.com/posts/a-successful-git-branching-model/)
|
|
|
|
|
branching model. As a result, our latest stable release is shipped
|
|
|
|
|
from the `main` branch, while new features are developed in our
|
|
|
|
|
`dev` branch.
|
|
|
|
|
|
2023-02-22 09:10:44 -06:00
|
|
|
Users may checkout `dev` to preview upcoming features.
|
2022-11-04 14:49:36 -05:00
|
|
|
|
2022-11-11 16:53:03 -06:00
|
|
|
## How to Cite
|
|
|
|
|
|
2022-12-12 14:33:25 -05:00
|
|
|
This software can be cited using a Zenodo
|
|
|
|
|
[DOI](https://doi.org/10.5281/zenodo.7314631) reference. A BibTex
|
2022-12-12 15:55:49 -06:00
|
|
|
style reference is provided below for convenience:
|
|
|
|
|
|
|
|
|
|
```
|
2023-05-31 10:31:39 -05:00
|
|
|
@software{xiaomin_lu_2022_7314631
|
2022-12-12 15:55:49 -06:00
|
|
|
author = {Xiaomin Lu and
|
|
|
|
|
Cole Ramos and
|
|
|
|
|
Fei Zheng and
|
|
|
|
|
Karl W. Schulz and
|
2023-02-22 11:10:55 -06:00
|
|
|
Jose Santos and
|
2023-05-31 10:31:39 -05:00
|
|
|
Keith Lowery and
|
2023-08-17 10:39:05 -05:00
|
|
|
Nicholas Curtis and
|
2023-05-31 10:31:39 -05:00
|
|
|
Cristian Di Pietrantonio},
|
2023-08-17 10:39:05 -05:00
|
|
|
title = {AMDResearch/omniperf: v1.0.9 (17 Aug 2023)},
|
|
|
|
|
month = aug,
|
2023-02-22 11:10:55 -06:00
|
|
|
year = 2023,
|
2022-12-12 15:55:49 -06:00
|
|
|
publisher = {Zenodo},
|
2023-08-17 10:39:05 -05:00
|
|
|
version = {v1.0.9},
|
2022-12-13 16:01:59 -06:00
|
|
|
doi = {10.5281/zenodo.7314631},
|
|
|
|
|
url = {https://doi.org/10.5281/zenodo.7314631}
|
2022-12-12 15:55:49 -06:00
|
|
|
}
|
|
|
|
|
```
|
2022-12-12 14:33:25 -05:00
|
|
|
|
