<ahref="#TheProjectMantra">What Taskflow Does Differently</a>
</li>
</ul>
</div>
<divclass="textblock"><p>Writing parallel programs is hard. Getting them right, efficient, and maintainable is even harder. Taskflow exists to close that gap - to let C++ developers express sophisticated parallel workloads using a clean task-parallel graph description language.</p>
<p>For decades, software performance improved almost for free. Every processor generation brought faster clock speeds, more transistors, and deeper instruction-level parallelism. A program written in 1995 ran measurably faster on 2005 hardware without changing a single line of code.</p>
<p>That era ended. Clock frequencies plateaued around 2004 as chip designers hit the <em>power</em><em>wall</em> — the point at which adding more transistors simply generated more heat than the chip could dissipate. The industry's answer was to put multiple independent cores on a single die, giving birth to the multicore era.</p>
<divclass="image">
<imgsrc="era_multicore.jpg" alt="" width="60%"/>
</div>
<p>The sweeping visualization above (courtesy of Prof. Mark Horowitz and his group) captures this transition clearly: performance scaling has shifted from single-core frequency improvements to parallelism across many cores. Today, every laptop, phone, server, and embedded device ships with multiple cores. The implication for software developers is unavoidable — <em>if</em><em>your</em><em>program</em><em>does</em><em>not</em><em>run</em><em>in</em><em>parallel</em>, <em>it</em><em>is</em><em>leaving</em><em>performance</em><em>on</em><em>the</em><em>table</em>.</p>
<p>Multicore CPUs were only the beginning. Driven by the explosive growth of artificial intelligence, scientific simulation, and data analytics, modern systems now combine CPUs, GPUs, TPUs, FPGAs, and domain-specific ASICs — each offering different throughputs, latencies, memory hierarchies, and programming models.</p>
<p>Exploiting this hardware diversity is one of the most difficult problems in systems programming. A developer who wants to run a neural network inference must orchestrate data movement from host memory to device memory, launch GPU kernels with the right grid geometry, synchronise CPU and GPU execution at the right points, and do all of this without introducing unnecessary stalls or data races — all while keeping the CPU cores busy in the meantime. Miss any of these concerns and either correctness or performance suffers.</p>
<p>Parallel programming is hard. Parallel programming across heterogeneous devices is a different order of difficulty.</p>
<p>The first tool most developers reach for is <em>loop-level</em><em>parallelism:</em> partition the iterations of a loop into blocks and run the blocks concurrently.</p>
<p>Loop parallelism is easy to reason about and well-supported by OpenMP, Intel TBB, and the C++ parallel algorithms library. For regular, independent workloads, such as matrix multiplication, image filters, and element-wise array operations, it delivers excellent results. But real applications are rarely that simple. Consider a program with four computational stages where stage A must complete before stages B and C can begin, and stage D cannot start until both B and C have finished, a diamond-shaped dependency as shown below:</p>
<divclass="dotgraph">
<iframescrolling="no" frameborder="0" src="dot_simple.svg" width="323" height="131"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div>
<p>There is no natural way to express this with a parallel-for loop. The dependencies cut across loop boundaries. A developer forced to implement this with raw threads must manually coordinate joins, futures, or condition variables, producing code that obscures the actual parallel structure:</p>
<divclass="fragment"><divclass="line"><spanclass="comment">// -- Raw std::thread: a diamond A -> {B, C} -> D ---------------------------</span></div>
</div><!-- fragment --><p>The join-points expose the structure, but only because this example is tiny. In a real program with dozens of stages, mixed data and control dependencies, and dynamic subgraphs, the synchronisation logic quickly becomes the dominant concern — error-prone, hard to test, and painful to modify. The root problem is that the parallelism is real and the dependencies are real, but the code has no first-class way to represent either. Thread joins and mutexes are <em>mechanisms</em>, not <em>descriptions</em>.</p>
<p>The right abstraction is a <em>task</em><em>dependency</em><em>graph</em>. Each node is a unit of work; each edge is a dependency. The runtime takes the graph and schedules tasks on available cores, respecting all dependencies, without the developer needing to think about threads, joins, or synchronisation points.</p>
<divclass="dotgraph">
<iframescrolling="no" frameborder="0" src="dot_task-level-parallelism.svg" width="295" height="347"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div>
<p>Task-based parallelism is not a new idea — it has been validated by the research community and embedded in standards such as OpenMP tasks, Intel TBB flow graphs, and C++ executors. What has been missing is a library that makes task graphs as easy to write as sequential code, works across both CPU and heterogeneous devices, and scales to real-world application complexity.</p>
<h1><aclass="anchor" id="TheProjectMantra"></a>
What Taskflow Does Differently</h1>
<p>Taskflow gives developers a concise, expressive API for building and executing task dependency graphs in C++. The same diamond example that required manual thread management above becomes self-documenting with Taskflow:</p>
<divclass="fragment"><divclass="line"><spanclass="comment">// -- Taskflow: the same diamond, expressed as a graph ----------------------</span></div>
<divclass="line">A.<aclass="code hl_function" href="classtf_1_1Task.html#a8c78c453295a553c1c016e4062da8588">precede</a>(B, C); <spanclass="comment">// B and C run after A</span></div>
<divclass="line">D.<aclass="code hl_function" href="classtf_1_1Task.html#a331b1b726555072e7c7d10941257f664">succeed</a>(B, C); <spanclass="comment">// D runs after both B and C</span></div>
<divclass="ttc" id="aclasstf_1_1Executor_html"><divclass="ttname"><ahref="classtf_1_1Executor.html">tf::Executor</a></div><divclass="ttdoc">class to create an executor</div><divclass="ttdef"><b>Definition</b> executor.hpp:62</div></div>
<divclass="ttc" id="aclasstf_1_1Executor_html_a519777f5783981d534e9e53b99712069"><divclass="ttname"><ahref="classtf_1_1Executor.html#a519777f5783981d534e9e53b99712069">tf::Executor::run</a></div><divclass="ttdeci">tf::Future< void > run(Taskflow &taskflow)</div><divclass="ttdoc">runs a taskflow once</div></div>
<divclass="ttc" id="aclasstf_1_1FlowBuilder_html_a4d52a7fe2814b264846a2085e931652c"><divclass="ttname"><ahref="classtf_1_1FlowBuilder.html#a4d52a7fe2814b264846a2085e931652c">tf::FlowBuilder::emplace</a></div><divclass="ttdeci">Task emplace(C &&callable)</div><divclass="ttdoc">creates a static task</div><divclass="ttdef"><b>Definition</b> flow_builder.hpp:1781</div></div>
<divclass="ttc" id="aclasstf_1_1Task_html_a331b1b726555072e7c7d10941257f664"><divclass="ttname"><ahref="classtf_1_1Task.html#a331b1b726555072e7c7d10941257f664">tf::Task::succeed</a></div><divclass="ttdeci">Task & succeed(Ts &&... tasks)</div><divclass="ttdoc">adds precedence links from other tasks to this</div><divclass="ttdef"><b>Definition</b> task.hpp:1313</div></div>
<divclass="ttc" id="aclasstf_1_1Task_html_a8c78c453295a553c1c016e4062da8588"><divclass="ttname"><ahref="classtf_1_1Task.html#a8c78c453295a553c1c016e4062da8588">tf::Task::precede</a></div><divclass="ttdeci">Task & precede(Ts &&... tasks)</div><divclass="ttdoc">adds precedence links from this to other tasks</div><divclass="ttdef"><b>Definition</b> task.hpp:1305</div></div>
<divclass="ttc" id="aclasstf_1_1Taskflow_html"><divclass="ttname"><ahref="classtf_1_1Taskflow.html">tf::Taskflow</a></div><divclass="ttdoc">class to create a taskflow object</div><divclass="ttdef"><b>Definition</b> taskflow.hpp:64</div></div>
</div><!-- fragment --><p>The dependency structure is explicit and readable. There are no join calls, no mutexes, no condition variables. The executor handles scheduling across all available cores automatically. Adding a new stage, changing a dependency, or reusing the graph requires changing only the parts of the code that actually changed.</p>
<p>This is the design philosophy behind Taskflow:</p>
<ul>
<li><b>Expressiveness</b> — complex parallel patterns should be easy to write </li>
<li><b>Readability</b> — code should communicate its parallel structure, not hide it </li>
<li><b>Transparency</b> — the runtime should be predictable and observable</li>
</ul>
<p>In a nutshell, code written with Taskflow explains itself. Developers focus on algorithms and decomposition strategies, not on low-level synchronisation mechanics. Taskflow scales from simple parallel loops to large heterogeneous pipelines, and does so with a programming model that stays consistent across both. </p>
</div></div><!-- contents -->
</div><!-- PageDoc -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.13.1-->
<!-- start footer part -->
<divid="nav-path" class="navpath"><!-- id is needed for treeview function! -->