Skip to content

Commit 97c7102

Browse files
Incorporate feedback and conclusion
1 parent 311389c commit 97c7102

File tree

1 file changed

+35
-10
lines changed

1 file changed

+35
-10
lines changed

gsoc-2020/executors.md

Lines changed: 35 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,26 +5,51 @@ short: GSoC 2020 Executors
55
permalink: /gsoc-2020/executors/
66
---
77

8-
Executors have been a long-standing proposal under discussion and review by the C++ Standard Committee. The earliest proposal dates back to 2012 and was initially proposed by Google based on some concepts that were being used internally by them. Since then, the design has gone through multiple iterations and has evolved into something completely different, but the fundamental has remained the same: to provide a mechanism to have control over the execution of a function.
8+
Executors have been a long-standing proposal under discussion and review by the C++ Standard Committee. The earliest proposal dates back to 2012 and was initially proposed by Google based on some concepts that were being used internally by them. Since then, the design has gone through multiple iterations and has evolved into something completely different, but the fundamental has remained the same: provide a mechanism to have control over the execution of a function.
99
A fascinating analogy was provided in one of the early design documents by Christopher Kohlhoff: "An executor is to function execution as an allocator is to allocation."
1010

11-
This post is in no way a technical document describing executors or their implementation in PCL. For that, there are numerous proposals (over 30!) that can be found [here](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2020/p0443r13.html). For details regarding PCL's implementation, you can read the design document or go through the Code API.
11+
This post is in no way a technical document describing executors or their implementation in PCL. For that, there are numerous proposals (over 30!) that can be found [here](http://wg21.link/P0443R13). For details regarding PCL's implementation, you can read the [design document](https://pcl.readthedocs.io/projects/tutorials/en/master/executor_design.html) or go through the Code API.
1212

13-
To summarize, executors aim to allow programmers to control the where and how functions are executed. In PCL, there was a need for a standardized way to run algorithms on facilities like OpenMP, SIMD & CUDA while also supporting any future facilities like thread pools. All of this pointed to executors. Though, only a limited and specific set of features were needed in PCL since asynchronous implementations are not available. Another factor that influenced a simpler design is that most PCL users would not care about having fine-grained control over the execution of an algorithm. At the most, they would need to control on which facility the algorithm runs.
14-
These influenced the design to be a simple yet offer all the customizations a user could need.
13+
To summarize, executors aim to allow programmers to control the where and how functions are executed. In PCL, there was a need for a standardized way to run algorithms on facilities like OpenMP, SIMD & CUDA while also supporting any future facilities like thread pools. All of this pointed to executors. In PCL, only a limited and specific set of features were needed as there were no plans to add asynchronous operations and task parallelism support to the library in the near future. Another factor that influenced a simpler design is that most PCL users would not care about having fine-grained control over the execution of an algorithm. At the most, they would need to control on which facility the algorithm runs. These factors influenced the design to be simple yet offer all the customizations a user could need.
1514

16-
The design chosen was a template-based design which offered advantages such as no runtime overhead, errors related to usage and properties of executors are caught during compilation. Finally, it offered more flexibility in terms of being able to evolve the design rapidly based on feedback without breaking code existing executor compatible code. Extra effort was put into trying to follow the proposal as closely as possible to minimize refactoring within PCL so that when it is finally accepted into the standard library, it can be used in PCL as is.
17-
This posed a challenge, going deep into template metaprogramming, especially to a person like me who had to search what metaprogramming is and being surprised that such a concept and was Turing complete nevertheless! Since then, I have come a long way and am more comfortable with template metaprogramming and find it a playful challenge to be able to apply this technique in places people generally might not think of using it. (Looking forward to the metaclasses proposal in C++ now).
15+
The design chosen was a template-based design which offered advantages such as no runtime overhead and offers static checks related to usage and properties of executors. Finally, it provided more flexibility in terms of being able to evolve the design rapidly based on feedback, without breaking code existing executor compatible code. Extra effort was put into trying to follow the proposal as closely as possible while minimizing refactoring within PCL, so that when it is finally accepted into the standard library, it can be used in PCL as is.
1816

19-
The second challenge that I faced was reading through the relevant proposals and trying to interpret their meaning. The proposal uses quite a technical language, which is not easy to understand if you are not familiar with it. Since each proposal builds on the previous ones with new ideas being introduced and features being removed, this involved spending considerable time going through all the relevant proposals. This took multiple iterations of reading and trying to make sense of the concepts mentioned as the documents were the primary source of understanding and some discussions and videos. A lot of concepts I was not well versed with were used, so I spend a considerable amount of time in the browser searching stuff (no wonder my Chrome screen time was off the roof).
17+
Going deep into template metaprogramming posed a challenge, especially to a person like me who had to search what metaprogramming is. I was surprised to discover that not only metaprogramming "is a thing", but it is also Turing complete! Since then, I have come a long way and I am more comfortable with template metaprogramming. I find it a playful challenge to be able to apply this technique in places people generally might not think of using it. (Looking forward to the metaclasses proposal in C++ now). The second challenge faced was reading through the relevant proposals and trying to interpret their meaning. The proposals use very particular style of technical writing, which is not easy to understand if you are not familiar with it. Since each proposal builds on the previous ones, with new ideas being introduced and features being removed, going through them consumed considerable time. It took multiple iterations of reading while trying to make sense of the concepts mentioned, using the documents as the primary information source and complementing them with discussions and videos. I was not well versed with a lot of the concepts used, so I spend a considerable amount of time looking them up.
2018

21-
This altered my goals quite a bit from my original proposal, where I had envisioned spending a notable amount of time adding support for other facilities and integrating executors into various algorithms. I had not expected so much time in the design phase for executors. There were many discussions, ideas, and design iterations with my mentors as executors could be fundamental to how PCL handled execution internally. So it was essential to get the fundamentals right and not come up with something that would have to be scrapped or redesigned from the ground up after a short amount of time. Therefore, the timeline had to be modified, and more time was spent on the design of executors themselves in PCL.
19+
This altered quite a bit my original proposal's goals, where I had envisioned spending a notable amount of time adding support for other facilities and integrating executors into various algorithms. I did not expected to spend so much time in the design phase for executors. There were many discussions, ideas and design iterations with my mentors, such as how executors could be fundamental to the way PCL handled execution internally. So it was essential to get the foundations right and not come up with something that would have been scrapped or redesigned from the ground up after a short amount of time. Therefore, the timeline had to be modified, and more time was spent on the design of executors themselves in PCL.
2220

2321
You can see the development cycle in the [unified-executors](https://github.com/shrijitsingh99/unified-executors/) repo.
2422

2523
The PR's related to executors in PCL are:
26-
[#4369](https://github.com/PointCloudLibrary/pcl/pull/4369)
27-
[#4370](https://github.com/PointCloudLibrary/pcl/pull/4370)
24+
[#4369](https://github.com/PointCloudLibrary/pcl/pull/4369),
25+
[#4370](https://github.com/PointCloudLibrary/pcl/pull/4370),
2826
[#4371](https://github.com/PointCloudLibrary/pcl/pull/4371)
2927

28+
As part of my GSoC, I also worked on improving CI infrastructure
29+
and refactoring parts of the codebase for easier integration with
30+
executors.
31+
**CI:** [#4131](https://github.com/PointCloudLibrary/pcl/pull/4131),
32+
[#4130](https://github.com/PointCloudLibrary/pcl/pull/4130),
33+
[#4101](https://github.com/PointCloudLibrary/pcl/pull/4101)
34+
| Pre-GSOC [#3886](https://github.com/PointCloudLibrary/pcl/pull/3886),
35+
[#3795](https://github.com/PointCloudLibrary/pcl/pull/3795),
36+
[#3789](https://github.com/PointCloudLibrary/pcl/pull/3789),
37+
[#3783](https://github.com/PointCloudLibrary/pcl/pull/3783),
38+
[#3745](https://github.com/PointCloudLibrary/pcl/pull/3745),
39+
[#4131](https://github.com/PointCloudLibrary/pcl/pull/4131)
40+
41+
**Refactoring (In Progress):** [#4287](https://github.com/PointCloudLibrary/pcl/pull/4287)
42+
[#4281](https://github.com/PointCloudLibrary/pcl/pull/4281),
43+
[#4279](https://github.com/PointCloudLibrary/pcl/pull/4279),
44+
[#4628](https://github.com/PointCloudLibrary/pcl/pull/4268)
45+
46+
47+
This project has been a great learning experience. There was a learning curve, but I was able to go deep into the C++ language itself and become familiar with some handy tools and libraries that I would not have come across on my own under normal circumstances. All the hours I put into GSoC have definitely been worth it. This is, in large part, to the fantastic mentors I had. The amount of hours they themselves have put into this project in reviewing my code, helping build prototypes of features, teaching various language tricks and concepts, and in general, just guiding me throughout the project has helped make this experience worthwhile in itself.
48+
49+
Kudos to my mentors @kunaltyagi and @SergioRAgostinho.
50+
Shoutouts to @aPonza and @larshg for doing a fabulous job mentoring other projects as well.
51+
52+
53+
54+
3055

0 commit comments

Comments
 (0)