Release 4.1.0 (Master)

Table of Contents

• Release Summary
• Download
• System Requirements
• New Features
  • Taskflow Core
  • Utilities
• Bug Fixes
• Breaking Changes
• Documentation
• Miscellaneous Items

Taskflow 4.1.0 is the newest developing line to new features and improvements are actively introduced and supported. It is also where this documentation is generated. Many features are experimental and may change. While we strive for backward compatibility, breaking changes may occur when necessary to improve performance or simplify the software architecture.

Release Summary

Download

To download the newest version of Taskflow, please clone the master branch from Taskflow's GitHub.

System Requirements

To use Taskflow v4.1.0, you need a compiler that supports C++20:

• GNU C++ Compiler at least v11.0 with -std=c++20
• Clang C++ Compiler at least v12.0 with -std=c++20
• Microsoft Visual Studio at least v19.29 (VS 2019) with /std:c++20
• Apple Clang (Xcode) at least v13.0 with -std=c++20
• NVIDIA CUDA Toolkit and Compiler (nvcc) at least v12.0 with host compiler supporting C++20
• Intel oneAPI DPC++/C++ Compiler at least v2022.0 with -std=c++20

Attention

If your project does not support C++20, please use Taskflow v3.11.0, which can be downloaded here.

New Features

Taskflow Core

• added bulk cache update method in executor
• added more unit tests to test_notifiers.cpp
• added module support under taskflow/modules/
• added adopted module task to support composable tasking with move semantics
  • tf::Taskflow::adopt
  • tf::Task::adopt
• improved the dump format with proper indention
• improved the dump format of tf::Subflow with cluster-level edges
• optimized executor member variable data layout to reduce false sharing
  • aligned num_topologies to a cache line
  • aligned notifier to a cache line
• optimized tf::Executor::run(Taskflow&&)` with asynchronous tasking
  • removed satellite field from both taskflow and executor classes
• optimized the locking cost of topology
• refactored the codebase with C++20 concept to enhance readability
  • credit goest to the amazing Anthropic Claude

Utilities

• removed floor_log2 due to duplication with C++20 std::bit_width
• removed cpu_pause due to platform-dependent implementation

Bug Fixes

• fixed the scope bug in creating tf::Future<T> from std::future<T> (#761)

Breaking Changes

• renamed tf::IndexRange::discrete_domain to tf::IndexRange::unravel

Documentation

• switched to the native doxygen for C++20 support
• revised Cookbook
  • added video tutorials

Miscellaneous Items

If you are interested in collaborating with us on applying Taskflow to your projects, please feel free to reach out to Dr. Tsung-Wei Huang!