Adding example of a simple master/slave distributed application

[hkaiser]

The purpose of this example is to demonstrate how HPX actions can be used to build a simple master-slave application. The master (locality 0) assigns work to the slaves (all other localities). Note that if this application is run on one locality only it uses the same locality for the master and the slave functionalities.

The slaves receive a message that encodes how many sub-tasks of a certain type they should spawn locally.

[StellarBot]

Performance test report

HPX Performance

Comparison

BENCHMARK	FORK_JOIN_EXECUTOR	PARALLEL_EXECUTOR	SCHEDULER_EXECUTOR
For Each	(=)	+	(=)

Info

Property	Before	After
HPX Commit	d5655f8	5841457
HPX Datetime	2022-05-31T12:57:29+00:00	2023-01-13T12:55:02+00:00
Datetime	2022-05-31T15:13:01.357969+02:00	2023-01-13T14:07:46.731764+01:00
Compiler	/apps/daint/SSL/HPX/packages/llvm-11.0.0/bin/clang++ 11.0.0	/apps/daint/SSL/HPX/packages/llvm-11.0.0/bin/clang++ 11.0.0
Envfile
Clustername	daint	daint
Hostname	nid01193	nid00456

Comparison

BENCHMARK	NO-EXECUTOR
Future Overhead - Create Thread Hierarchical - Latch	++

Info

Property	Before	After
HPX Commit	d5655f8	5841457
HPX Datetime	2022-05-31T12:57:29+00:00	2023-01-13T12:55:02+00:00
Datetime	2022-05-31T15:13:18.026239+02:00	2023-01-13T14:08:02.815739+01:00
Compiler	/apps/daint/SSL/HPX/packages/llvm-11.0.0/bin/clang++ 11.0.0	/apps/daint/SSL/HPX/packages/llvm-11.0.0/bin/clang++ 11.0.0
Envfile
Clustername	daint	daint
Hostname	nid01193	nid00456

Comparison

BENCHMARK	FORK_JOIN_EXECUTOR_DEFAULT_FORK_JOIN_POLICY_ALLOCATOR	PARALLEL_EXECUTOR_DEFAULT_PARALLEL_POLICY_ALLOCATOR	SCHEDULER_EXECUTOR_DEFAULT_SCHEDULER_EXECUTOR_ALLOCATOR
Stream Benchmark - Add	(=)	(=)	(=)
Stream Benchmark - Scale	(=)	++	(=)
Stream Benchmark - Triad	(=)	++	-
Stream Benchmark - Copy	(=)	++	(=)

Info

Property	Before	After
HPX Commit	71d8dbe	5841457
HPX Datetime	2021-11-10T19:14:21+00:00	2023-01-13T12:55:02+00:00
Datetime	2021-11-10T20:28:18.266961+01:00	2023-01-13T14:08:17.840304+01:00
Compiler	/apps/daint/SSL/HPX/packages/llvm-11.0.0/bin/clang++ 11.0.0	/apps/daint/SSL/HPX/packages/llvm-11.0.0/bin/clang++ 11.0.0
Envfile
Clustername	daint	daint
Hostname	nid00120	nid00456

Explanation of Symbols

Symbol	MEANING
=	No performance change (confidence interval within ±1%)
(=)	Probably no performance change (confidence interval within ±2%)
(+)/(-)	Very small performance improvement/degradation (≤1%)
+/-	Small performance improvement/degradation (≤5%)
++/--	Large performance improvement/degradation (≤10%)
+++/---	Very large performance improvement/degradation (>10%)
?	Probably no change, but quite large uncertainty (confidence interval with ±5%)
??	Unclear result, very large uncertainty (±10%)
???	Something unexpected…

[StellarBot]

Performance test report

HPX Performance

Comparison

BENCHMARK	FORK_JOIN_EXECUTOR	PARALLEL_EXECUTOR	SCHEDULER_EXECUTOR
For Each	(=)	=	=

Info

Property	Before	After
HPX Datetime	2023-01-12T23:07:58+00:00	2023-01-14T14:45:35+00:00
HPX Commit	eb604d5	8222fd5
Datetime	2023-01-13T04:10:15.951027-06:00	2023-01-14T08:54:45.704820-06:00
Hostname	medusa08.rostam.cct.lsu.edu	medusa08.rostam.cct.lsu.edu
Envfile
Clustername	rostam	rostam
Compiler	/opt/apps/llvm/13.0.1/bin/clang++ 13.0.1	/opt/apps/llvm/13.0.1/bin/clang++ 13.0.1

Comparison

BENCHMARK	NO-EXECUTOR
Future Overhead - Create Thread Hierarchical - Latch	+

Info

Property	Before	After
HPX Datetime	2023-01-12T23:07:58+00:00	2023-01-14T14:45:35+00:00
HPX Commit	eb604d5	8222fd5
Datetime	2023-01-13T04:10:31.068958-06:00	2023-01-14T08:55:00.868620-06:00
Hostname	medusa08.rostam.cct.lsu.edu	medusa08.rostam.cct.lsu.edu
Envfile
Clustername	rostam	rostam
Compiler	/opt/apps/llvm/13.0.1/bin/clang++ 13.0.1	/opt/apps/llvm/13.0.1/bin/clang++ 13.0.1

Comparison

BENCHMARK	FORK_JOIN_EXECUTOR_DEFAULT_FORK_JOIN_POLICY_ALLOCATOR	PARALLEL_EXECUTOR_DEFAULT_PARALLEL_POLICY_ALLOCATOR	SCHEDULER_EXECUTOR_DEFAULT_SCHEDULER_EXECUTOR_ALLOCATOR
Stream Benchmark - Add	-	-	+++
Stream Benchmark - Scale	(=)	(=)	(=)
Stream Benchmark - Triad	(=)	-	+++
Stream Benchmark - Copy	+	(=)	(=)

Info

Property	Before	After
HPX Datetime	2023-01-12T23:07:58+00:00	2023-01-14T14:45:35+00:00
HPX Commit	eb604d5	8222fd5
Datetime	2023-01-13T04:10:46.398919-06:00	2023-01-14T08:55:16.048748-06:00
Hostname	medusa08.rostam.cct.lsu.edu	medusa08.rostam.cct.lsu.edu
Envfile
Clustername	rostam	rostam
Compiler	/opt/apps/llvm/13.0.1/bin/clang++ 13.0.1	/opt/apps/llvm/13.0.1/bin/clang++ 13.0.1

Explanation of Symbols

Symbol	MEANING
=	No performance change (confidence interval within ±1%)
(=)	Probably no performance change (confidence interval within ±2%)
(+)/(-)	Very small performance improvement/degradation (≤1%)
+/-	Small performance improvement/degradation (≤5%)
++/--	Large performance improvement/degradation (≤10%)
+++/---	Very large performance improvement/degradation (>10%)
?	Probably no change, but quite large uncertainty (confidence interval with ±5%)
??	Unclear result, very large uncertainty (±10%)
???	Something unexpected…

[hkaiser]

bors merge

[bors]

Build succeeded:

• Bors