my TraCR (no more ovni version) prototype

.github/workflows/master-test-workflow.yml

@@ -42,7 +42,7 @@ jobs:
 
       - name: Dry-run compilation
         shell: bash
-        run: source /home/hicr/.bashrc && meson setup --wipe build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,lpf,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=false && meson compile -C build
+        run: source /home/hicr/.bashrc && meson setup --wipe build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,lpf,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=true && meson compile -C build
 
       - name: Running tests and creating coverage report
         shell: bash
@@ -51,7 +51,7 @@ jobs:
         run: |
           echo "Running Tests..."
           source /home/hicr/.bashrc
-          meson setup build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=false
+          meson setup build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=true
           meson compile -C build
           meson test -C build
           echo "Creating coverage report..."

.github/workflows/pr-development-workflow.yml

@@ -231,15 +231,15 @@ jobs:
           docker run --name taskr --shm-size=1024M --privileged -v $PWD:/home/hicr/taskr -w /home/hicr/taskr -td ${{ env.DOCKERIMAGE }}:${{ inputs.arch }}-latest bash
 
       - name: Dry-run compilation
-        run: docker exec -u hicr taskr bash -c "meson setup build -Dbuildtype=debug -Db_coverage=true  -DdistributedEngines=mpi,lpf,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=false && meson compile -C build"
+        run: docker exec -u hicr taskr bash -c "meson setup build -Dbuildtype=debug -Db_coverage=true  -DdistributedEngines=mpi,lpf,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=true && meson compile -C build"
 
       - name: Compile
         run: docker exec -u hicr taskr bash -c "meson compile -C build"
 
       - name: Running tests and creating coverage report
         run: |
           echo "Running Tests..."
-          docker exec -u hicr taskr bash -c "meson setup build -Dbuildtype=debug -Db_coverage=true  -DdistributedEngines=mpi,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=false && meson compile -C build && meson test -C build"
+          docker exec -u hicr taskr bash -c "meson setup build -Dbuildtype=debug -Db_coverage=true  -DdistributedEngines=mpi,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=true && meson compile -C build && meson test -C build"
           echo "Creating coverage report..."
           docker exec -u hicr taskr bash -c "ninja -C build coverage"
           docker stop taskr
@@ -271,15 +271,15 @@ jobs:
           submodules: 'true'
 
       - name: Dry-run compilation
-        run: source /home/hicr/.bashrc && meson setup build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,lpf,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=false && meson compile -C build
+        run: source /home/hicr/.bashrc && meson setup build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,lpf,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=true && meson compile -C build
 
       - name: Running tests and creating coverage report
         shell: bash
         env:
           LD_PRELOAD: /usr/local/lib/libnosv.so
         run: |
           source /home/hicr/.bashrc
-          meson setup build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=false
+          meson setup build -Dbuildtype=debug -Db_coverage=true -DdistributedEngines=mpi,none -DbuildTests=true -DbuildExamples=true -DcompileWarningsAsErrors=true -DexecutionStateType=nosv,boost -DprocessingUnitType=nosv,pthreads -DbuildPyTaskR=true -DbuildInstrumentation=true
           meson compile -C build
           meson test -C build
           echo "Creating coverage report..."

.gitignore

@@ -5,4 +5,5 @@ build
 atlas_*.sh
 **/matrix/
 **/__pycache__/
-**/ovni/
+**/ovni/
+**/tracr/

README.md

@@ -11,6 +11,25 @@ ___________              __   __________
 
 TaskR is a lightweight dependency-driven tasking runtime system based entirely on function calls to the [HiCR API](https://github.com/Algebraic-Programming/HiCR)
 
+## Instrumentation (TraCR)
+
+TaskR can trace its runtime behavior (task execution, polling, worker suspension) with [TraCR](https://github.com/Algebraic-Programming/TraCR):
+
+```bash
+meson setup build -DbuildInstrumentation=true ...
+```
+
+An instrumented run writes a `tracr/` folder into the working directory. Convert it with the `tracr_process` tool (built alongside TaskR) into the format of your choice:
+
+```bash
+# Perfetto (open in https://ui.perfetto.dev), Paraver, or a terminal dump
+./build/extern/tracr/postprocessing/tracr_process tracr/ perfetto
+```
+
+Each worker appears as its own named track with `executing` (annotated with the task id), `polling`, `suspended`, `resumed` and `finished` states.
+
+Note: tracing requires workers pinned to their own OS thread, i.e. the `pthreads` processing unit backend. With other backends (e.g. nOS-V), instrumentation automatically stays off.
+
 ## License
 
 Copyright 2025 Huawei Technologies Co., Ltd.

examples/matmul/python/matmul.cpp

@@ -19,21 +19,13 @@
 
 #include <taskr/taskr.hpp>
 
-#ifdef ENABLE_INSTRUMENTATION
-  #include <tracr.hpp>
-#endif
-
 #define mytype float
 
 /**
  * Compute mmm
  */
 void matmul(taskr::Task *)
 {
-#ifdef ENABLE_INSTRUMENTATION
-  INSTRUMENTATION_VMARKER_SET(MARK_COLOR_RED);
-#endif
-
   const size_t N = 200;
 
   // Allocate memory
@@ -64,10 +56,6 @@ void matmul(taskr::Task *)
   free((mytype *)A);
   free((mytype *)B);
   free((mytype *)C);
-
-#ifdef ENABLE_INSTRUMENTATION
-  INSTRUMENTATION_VMARKER_RESET();
-#endif
 }
 
 PYBIND11_MODULE(cpp_matmul, m)