From a054b4ee2763dad9304ec99cc3acc05db8925e6f Mon Sep 17 00:00:00 2001 From: Jitse Niesen Date: Wed, 20 Feb 2013 13:44:40 +0000 Subject: Be more explicit about user-defined functions in Map tutorial. See discussion on mailing list on 18 + 19 Feb 2013. --- doc/TutorialMapClass.dox | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'doc/TutorialMapClass.dox') diff --git a/doc/TutorialMapClass.dox b/doc/TutorialMapClass.dox index a5c20f1bf..f8fb0fd2f 100644 --- a/doc/TutorialMapClass.dox +++ b/doc/TutorialMapClass.dox @@ -3,17 +3,17 @@ namespace Eigen { /** \eigenManualPage TutorialMapClass Interfacing with raw buffers: the Map class This page explains how to work with "raw" C/C++ arrays. -This can be useful in a variety of contexts, particularly when "importing" vectors and matrices from other libraries into Eigen. +This can be useful in a variety of contexts, particularly when "importing" vectors and matrices from other libraries into %Eigen. \eigenAutoToc \section TutorialMapIntroduction Introduction -Occasionally you may have a pre-defined array of numbers that you want to use within Eigen as a vector or matrix. While one option is to make a copy of the data, most commonly you probably want to re-use this memory as an Eigen type. Fortunately, this is very easy with the Map class. +Occasionally you may have a pre-defined array of numbers that you want to use within %Eigen as a vector or matrix. While one option is to make a copy of the data, most commonly you probably want to re-use this memory as an %Eigen type. Fortunately, this is very easy with the Map class. \section TutorialMapTypes Map types and declaring Map variables -A Map object has a type defined by its Eigen equivalent: +A Map object has a type defined by its %Eigen equivalent: \code Map > \endcode @@ -49,7 +49,7 @@ However, Stride is even more flexible than this; for details, see the documentat \section TutorialMapUsing Using Map variables -You can use a Map object just like any other Eigen type: +You can use a Map object just like any other %Eigen type: @@ -57,7 +57,7 @@ You can use a Map object just like any other Eigen type:
Example:Output:
\verbinclude Tutorial_Map_using.out
-However, when writing functions taking Eigen types, it is important to realize that a Map type is \em not identical to its Dense equivalent. See \ref TopicFunctionTakingEigenTypesMultiarguments for details. +All %Eigen functions are written to accept Map objects just like other %Eigen types. However, when writing your own functions taking %Eigen types, this does \em not happen automatically: a Map type is not identical to its Dense equivalent. See \ref TopicFunctionTakingEigenTypes for details. \section TutorialMapPlacementNew Changing the mapped array -- cgit v1.2.3