]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Improve documentation of a BatchOptimizer function 10063/head
authorJean-Paul Pelteret <jppelteret@gmail.com>
Thu, 7 May 2020 17:19:16 +0000 (19:19 +0200)
committerJean-Paul Pelteret <jppelteret@gmail.com>
Thu, 7 May 2020 17:19:16 +0000 (19:19 +0200)
include/deal.II/differentiation/sd/symengine_optimizer.h

index e9e12dfa5ff7399a98976edc25881e60498880e5..2899f20a89fd85b0552c51ba8eab8846fe41ea83 100644 (file)
@@ -1834,6 +1834,18 @@ namespace Differentiation
        *
        * These values were computed by substituting a @p substitution_values map
        * during substitute() call.
+       *
+       * @note In contrast to the other variants of this function, the order of
+       * the returned entries is an internal implementation detail, and cannot
+       * be guarenteed under all conditions. The entries in the returned vector
+       * are, in general, identical to the order in which the dependent
+       * expressions are originally registered. However, when registering
+       * tensors and symmetric tensors of expressions, these are "unrolled"
+       * and their components are individually registered. If it is necessary to
+       * control the order in which results appear in the returned vector, then
+       * the register_function() method that takes a Tensor or a SymmetricTensor
+       * as an argument should be avoided. Instead, the individual entries of
+       * these types of data should be registered one by one.
        */
       const std::vector<ReturnType> &
       evaluate() const;

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.