Learning from Examples » Flip Coins

We study dynamic control flow of non-determinism using conditional tasking. Non-deterministic control flow is a fundamental building block in many optimization and simulation algorithms that rely on stochastic convergence rules or probabilistic pruning.

Problem Formulation

We have a fair binary coin and want to simulate its tosses. We flip the coin for five times. Apparently, the probability for the result to be all heads is 1/32. It is equivalently to say the expected number we need to toss for obtaining five heads is 32.

G a 1/2 (H) b 1/4 (HH) a->b c 1/8 (HHH) b->c d 1/16 (HHHH) c->d e 1/32 (HHHHH) d->e

Probabilistic Conditions

We use condition tasks to simulate the five coin tosses. We create five condition tasks each returning a random binary number. If the return is zero (head toss), the execution moves to the next condition task; or it (tail toss) goes back to the first condition task to start over the simulation.

#include <taskflow/taskflow.hpp>

int main() {

  tf::Taskflow taskflow;
  tf::Executor executor;
  
  size_t rounds = 10000;
  size_t tosses = 0; 
  size_t total_tosses = 0; 
  double average_tosses = 0.0; 
  
  tf::Task A = taskflow.emplace([&](){ tosses = 0; })
                       .name("init"); 
  
  tf::Task B = taskflow.emplace([&](){ ++tosses; return std::rand()%2; })
                       .name("flip-coin-1");
  tf::Task C = taskflow.emplace([&](){ return std::rand()%2; })
                       .name("flip-coin-2");
  tf::Task D = taskflow.emplace([&](){ return std::rand()%2; })
                       .name("flip-coin-3");
  tf::Task E = taskflow.emplace([&](){ return std::rand()%2; })
                       .name("flip-coin-4");
  tf::Task F = taskflow.emplace([&](){ return std::rand()%2; })
                       .name("flip-coin-5");
  
  // reach the target; record the number of tosses 
  tf::Task G = taskflow.emplace([&](){ total_tosses += tosses; })
                       .name("stop");
  
  A.precede(B);
  
  // five probabilistic conditions
  B.precede(C, B);
  C.precede(D, B);
  D.precede(E, B);
  E.precede(F, B);
  F.precede(G, B);
  
  // repeat the flip-coin simulation by rounds times
  executor.run_n(taskflow, rounds).wait();
  
  // calculate the expected number of tosses
  average_tosses = total_tosses / (double)rounds;
  
  assert(std::fabs(average_tosses-32.0)<1.0);
  
  return 0;
}

Running the taskflow by a fair number of times, the average tosses we have is close to 32. The taskflow diagram is depicted below.

Taskflow p0x7fa9a4803e30 init p0x7fa9a4803f50 flip-coin-1 p0x7fa9a4803e30->p0x7fa9a4803f50 p0x7fa9a4803f50->p0x7fa9a4803f50 1 p0x7fa9a4804070 flip-coin-2 p0x7fa9a4803f50->p0x7fa9a4804070 0 p0x7fa9a4804070->p0x7fa9a4803f50 1 p0x7fa9a4804190 flip-coin-3 p0x7fa9a4804070->p0x7fa9a4804190 0 p0x7fa9a4804190->p0x7fa9a4803f50 1 p0x7fa9a48042b0 flip-coin-4 p0x7fa9a4804190->p0x7fa9a48042b0 0 p0x7fa9a48042b0->p0x7fa9a4803f50 1 p0x7fa9a48043d0 flip-coin-5 p0x7fa9a48042b0->p0x7fa9a48043d0 0 p0x7fa9a48043d0->p0x7fa9a4803f50 1 p0x7fa9a48044f0 stop p0x7fa9a48043d0->p0x7fa9a48044f0 0

Although the execution of this taskflow is non-deterministic, its control flow can expand to a tree of tasks based on our scheduling rule for conditional tasking (see Conditional Tasking). Each path from the root to a leaf represents a result of five heads, and none of them can overlap at the same time (no task race). You must follow the same rule when creating a probabilistic framework using conditional tasking.

Ternary Coins

We can extend the binary coin example to a ternary case. Each condition task has one successor going back to the beginning and two successors moving to the next task. The expected number of tosses to reach five identical results is 3*3*3*3*3 = 243.

tf::Task A = taskflow.emplace( [&](){ tosses = 0; } )
                     .name("init"); 

// start over the flip again
tf::Task B = taskflow.emplace([&](){ ++tosses; return std::rand()%3; })
                     .name("flip-coin-1");
tf::Task C = taskflow.emplace([&](){ return std::rand()%3; })
                     .name("flip-coin-2");
tf::Task D = taskflow.emplace([&](){ return std::rand()%3; })
                     .name("flip-coin-3");
tf::Task E = taskflow.emplace([&](){ return std::rand()%3; })
                     .name("flip-coin-4");
tf::Task F = taskflow.emplace([&](){ return std::rand()%3; })
                     .name("flip-coin-5");

// reach the target; record the number of tosses 
tf::Task G = taskflow.emplace([&](){ total_tosses += tosses; })
                     .name("stop");

A.precede(B);

// five probabilistic conditions
B.precede(C, B, B);
C.precede(D, B, B);
D.precede(E, B, B);
E.precede(F, B, B);
F.precede(G, B, B);

// repeat the flip-coin simulation by rounds times
executor.run_n(taskflow, rounds).wait();

// calculate the expected number of tosses
average_tosses = total_tosses / (double)rounds;

assert(std::fabs(average_tosses-243.0)<1.0);
Taskflow p0x7fca00803e30 init p0x7fca00803f50 flip-coin-1 p0x7fca00803e30->p0x7fca00803f50 p0x7fca00803f50->p0x7fca00803f50 1 p0x7fca00803f50->p0x7fca00803f50 2 p0x7fca00804070 flip-coin-2 p0x7fca00803f50->p0x7fca00804070 0 p0x7fca00804070->p0x7fca00803f50 1 p0x7fca00804070->p0x7fca00803f50 2 p0x7fca00804190 flip-coin-3 p0x7fca00804070->p0x7fca00804190 0 p0x7fca00804190->p0x7fca00803f50 1 p0x7fca00804190->p0x7fca00803f50 2 p0x7fca008042b0 flip-coin-4 p0x7fca00804190->p0x7fca008042b0 0 p0x7fca008042b0->p0x7fca00803f50 1 p0x7fca008042b0->p0x7fca00803f50 2 p0x7fca008043d0 flip-coin-5 p0x7fca008042b0->p0x7fca008043d0 0 p0x7fca008043d0->p0x7fca00803f50 1 p0x7fca008043d0->p0x7fca00803f50 2 p0x7fca008044f0 stop p0x7fca008043d0->p0x7fca008044f0 0

Similarly, we can extend the probabilistic condition to any degree.