Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/stellar-group/hpx

The C++ Standard Library for Parallelism and Concurrency
https://github.com/stellar-group/hpx

c-plus-plus concurrency cpp17 cross-platform distributed parallelism

Last synced: about 1 month ago
JSON representation

The C++ Standard Library for Parallelism and Concurrency

Awesome Lists containing this project

README 

        
..

    Copyright (c) 2007-2022 Louisiana State University



    SPDX-License-Identifier: BSL-1.0

    Distributed under the Boost Software License, Version 1.0. (See accompanying

    file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)



|circleci_status| |codacy_quality| |codacy_coverage| |OpenSSF| |CFF| |JOSS| |zenodo_doi|



Documentation: `latest

`_,

`development (master)

`_



|hpx_logo|



------



HPX is a C++ Standard Library for Concurrency and Parallelism. It implements all

of the corresponding facilities as defined by the C++ Standard. Additionally, in

HPX we implement functionalities proposed as part of the ongoing C++

standardization process. We also extend the C++ Standard APIs to the distributed

case.



The goal of HPX is to create a high quality, freely available, open source

implementation of a new programming model for conventional systems, such as

classic Linux based Beowulf clusters or multi-socket highly parallel SMP nodes.

At the same time, we want to have a very modular and well designed runtime

system architecture which would allow us to port our implementation onto new

computer system architectures. We want to use real-world applications to drive

the development of the runtime system, coining out required functionalities and

converging onto a stable API which will provide a smooth migration path for

developers.



The API exposed by HPX is not only modeled after the interfaces defined by the

C++11/14/17/20 ISO standard, it also adheres to the programming guidelines used

by the Boost collection of C++ libraries. We aim to improve the scalability of

today's applications and to expose new levels of parallelism which are necessary

to take advantage of the exascale systems of the future.



What's so special about HPX?

============================



* HPX exposes a uniform, standards-oriented API for ease of programming parallel

  and distributed applications.

* It enables programmers to write fully asynchronous code using hundreds of

  millions of threads.

* HPX provides unified syntax and semantics for local and remote operations.

* HPX makes concurrency manageable with dataflow and future based

  synchronization.

* It implements a rich set of runtime services supporting a broad range of use

  cases.

* HPX exposes a uniform, flexible, and extendable performance counter framework

  which can enable runtime adaptivity

* It is designed to solve problems conventionally considered to be

  scaling-impaired.

* HPX has been designed and developed for systems of any scale, from hand-held

  devices to very large scale systems.

* It is the first fully functional implementation of the ParalleX execution

  model.

* HPX is published under a liberal open-source license and has an open, active,

  and thriving developer community.



Governance

==========



The HPX project is a meritocratic, consensus-based community project. Anyone

with an interest in the project can join the community, contribute to the

project design and participate in the decision making process.

`This document `_ describes

how that participation takes place and how to set about earning merit within

the project community.



Documentation

=============



If you plan to use HPX we suggest to start with the latest released version

which can be downloaded `here `_.



To quickly get started with HPX on most Linux distributions you can read the

quick start guide `here

`_.

Detailed instructions on building and installing HPX on various platforms can be

found `here

`_.

The full documentation for the latest release of HPX can always be found `here

`_.



If you would like to work with the cutting edge version of this repository

(``master`` branch) the documentation can be found `here

`_.

We strongly recommend that you follow the current health status of the master

branch by looking at our `continuous integration results website

`_. While we try to keep the

master branch stable and usable, sometimes new bugs trick their way into the

code base. The `CircleCI `_

continuous integration service additionally tracks the current build status for

the master branch: |circleci_status|.



We use `Codacy `_ to assess the code quality of this

project: |codacy_quality|. For our coverage analysis, we also rely on

Codacy to present the results: |codacy_coverage|.



If you can't find what you are looking for in the documentation or you suspect

you've found a bug in HPX we very much encourage and appreciate any issue

reports through the `issue tracker for this Github project

`_.



If you have any questions feel free to ask it over at `StackOverflow

`_ and tag the question with `hpx

`_.



For a full list of support options please see our `Support page

`_.



Code of conduct

===============



We have adopted a `code of conduct

`_

for this project. Please refer to this document if you would like to know more

about the expectations for members of our community, with regard to how they

will behave toward each other.



Please find the project's gpg key, which is used to sign HPX releases

`here

`_.



Citing

======



In publications, please use our paper in The Journal of Open Source

Software as the main citation for HPX: |JOSS|. For referring

to the latest release of HPX please use: |zenodo_doi|.



Acknowledgements

================



We have used a free open-source license of `PVS-Studio, a static analyzer for C++ code

`_

to check our code base.



Past and current funding and support for HPX is listed `here

`_



.. |circleci_status| image:: https://circleci.com/gh/STEllAR-GROUP/hpx/tree/master.svg?style=svg

     :target: https://circleci.com/gh/STEllAR-GROUP/hpx/tree/master

     :alt: HPX master branch build status



.. |zenodo_doi| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.598202.svg

     :target: https://doi.org/10.5281/zenodo.598202

     :alt: Latest software release of HPX



.. |codacy_quality| image:: https://app.codacy.com/project/badge/Grade/0b8cd5a874914edaba67ce3bb711e688

     :target: https://app.codacy.com/gh/STEllAR-GROUP/hpx/dashboard

     :alt: HPX Code Quality Assessment



.. |codacy_coverage| image:: https://app.codacy.com/project/badge/Coverage/0b8cd5a874914edaba67ce3bb711e688    

     :target: https://app.codacy.com/gh/STEllAR-GROUP/hpx/coverage/dashboard

     :alt: HPX coverage report



.. |JOSS| image:: https://joss.theoj.org/papers/022e5917b95517dff20cd3742ab95eca/status.svg

    :target: https://joss.theoj.org/papers/022e5917b95517dff20cd3742ab95eca

    :alt: JOSS Paper about HPX



.. |CFF| image:: https://github.com/STEllAR-GROUP/hpx/actions/workflows/cff-validator.yml/badge.svg

    :target: https://github.com/STEllAR-GROUP/hpx/actions/workflows/cff-validator.yml

    :alt: Citations file for HPX



.. |OpenSSF| image:: https://bestpractices.coreinfrastructure.org/projects/6093/badge

    :target: https://bestpractices.coreinfrastructure.org/projects/6093

    :alt: OpenSSF Best Practices



.. |hpx_logo| image:: http://hpx.stellar-group.org/files/hpx_logo_white.png

    :target: http://hpx.stellar-group.org/

    :alt: HPX Logo