Browse Source

document how one can request for dummy task duration estimations

Samuel Thibault 14 years ago
parent
commit
37f43d44c3
1 changed files with 9 additions and 0 deletions
  1. 9 0
      doc/starpu.texi

+ 9 - 0
doc/starpu.texi

@@ -1296,6 +1296,15 @@ The same can be done for task power consumption estimation, by setting the
 now, the application has to give to the power consumption performance model
 now, the application has to give to the power consumption performance model
 a name which is different from the execution time performance model.
 a name which is different from the execution time performance model.
 
 
+The application can request time estimations from the StarPU performance
+models by filling a task structure as usual without actually submitting
+it. The data handles can be created by calling @code{starpu_data_register}
+functions with a @code{NULL} pointer (and need to be unregistered as usual)
+and the desired data sizes. The @code{starpu_task_expected_length} and
+@code{starpu_task_expected_power} functions can then be called to get an
+estimation of the task duration on a given arch. @code{starpu_task_destroy}
+needs to be called to destroy the dummy task afterwards.
+
 @node Theoretical lower bound on execution time
 @node Theoretical lower bound on execution time
 @section Theoretical lower bound on execution time
 @section Theoretical lower bound on execution time