[Eigen中文文档] 原始缓冲区接口:Map 类

简介: 本节解释了如何使用“原始”C/C++ 数组。这在各种情况下都很有用,特别是在将向量和矩阵从其他库“导入”到 Eigen 中时。

文档总目录

英文原文(Interfacing with raw buffers: the Map class)

本节解释了如何使用“原始”C/C++ 数组。这在各种情况下都很有用,特别是在将向量和矩阵从其他库“导入”到 Eigen 中时。

介绍

有时可能有一个预定义的数字数组,希望在 Eigen 中将其用作向量或矩阵。虽然可以通过复制数据实现,但最常见的情况是可能希望直接将此内存重新于 Eigen 类型,可以使用 Map 类很容易做到这一点。

Map类型与声明Map变量

Map 对象具有与其等效的 Eigen 定义类型:

Map<Matrix<typename Scalar, int RowsAtCompileTime, int ColsAtCompileTime> >

请注意,在这种默认情况下,Map 只需要一个模板参数。

要构造一个 Map 变量,需要另外两条信息:指向定义数组内存区域的指针、矩阵或向量所需形状大小。

例如,要定义一个在编译时确定大小的浮点矩阵,可以执行以下操作:

Map<MatrixXf> mf(pf,rows,columns);

其中 pf 是一个 float * ,指向内存数组。

固定大小的只读整数向量可以声明为:

Map<const Vector4i> mi(pi);

其中 pi 是一个 int *。在这种情况下,不必将大小传递给构造函数,因为它已经由 Matrix/Array 类型指定。

请注意,Map 没有默认构造函数;使用时必须传递一个指针来初始化对象。但也可以规避这一要求(请参阅下文更改map数组)。

Map 足够灵活以适应各种不同的数据表示。还有两个其他可选模板参数:

Map<typename MatrixType,
    int MapOptions,
    typename StrideType>

其中:

  • MapOptions: 指定指针是对齐的还是未对齐的。默认为未对齐。

  • StrideType: 允许使用 Stride 类为内存阵列指定自定义布局。

如下示例,指定数据数组为行优先格式:

// 代码索引 3-10-1-1
int array[8];
for(int i = 0; i < 8; ++i) array[i] = i;
cout << "Column-major:\n" << Map<Matrix<int,2,4> >(array) << endl;
cout << "Row-major:\n" << Map<Matrix<int,2,4,RowMajor> >(array) << endl;
cout << "Row-major using stride:\n" <<
  Map<Matrix<int,2,4>, Unaligned, Stride<1,4> >(array) << endl;

输出:

Column-major:
0 2 4 6
1 3 5 7
Row-major:
0 1 2 3
4 5 6 7
Row-major using stride:
0 1 2 3
4 5 6 7

然而,Stride 比这更灵活;有关详细信息,请参阅 MapStride 类的文档。

Map变量的使用

可以像使用任何其他 Eigen 类型一样使用 Map 对象:

// 代码索引 3-10-2-1
typedef Matrix<float,1,Dynamic> MatrixType;
typedef Map<MatrixType> MapType;
typedef Map<const MatrixType> MapTypeConst;   // a read-only map
const int n_dims = 5;

MatrixType m1(n_dims), m2(n_dims);
m1.setRandom();
m2.setRandom();
float *p = &m2(0);  // get the address storing the data for m2
MapType m2map(p,m2.size());   // m2map shares data with m2
MapTypeConst m2mapconst(p,m2.size());  // a read-only accessor for m2

cout << "m1: " << m1 << endl;
cout << "m2: " << m2 << endl;
cout << "Squared euclidean distance: " << (m1-m2).squaredNorm() << endl;
cout << "Squared euclidean distance, using map: " <<
  (m1-m2map).squaredNorm() << endl;
m2map(3) = 7;   // this will change m2, since they share the same array
cout << "Updated m2: " << m2 << endl;
cout << "m2 coefficient 2, constant accessor: " << m2mapconst(2) << endl;
/* m2mapconst(2) = 5; */   // this yields a compile-time error

输出:

m1:   0.68 -0.211  0.566  0.597  0.823
m2: -0.605  -0.33  0.536 -0.444  0.108
Squared euclidean distance: 3.26
Squared euclidean distance, using map: 3.26
Updated m2: -0.605  -0.33  0.536      7  0.108
m2 coefficient 2, constant accessor: 0.536

所有 Eigen 函数都可以接收 Map 对象,就像其他 Eigen 类型一样。但是,当编写自己的 Eigen 类型函数时,这不会自动发生,因为 Map 类型与其 Dense 等效类型不同。

有关详细信息,请参阅编写以特征类型为参数的函数

更改map数组

可以在声明后使用 C++ placement new 语法更改 Map 对象的数组。

// 代码索引 3-10-3-1
int data[] = {
   1,2,3,4,5,6,7,8,9};
Map<RowVectorXi> v(data,4);
cout << "The mapped vector v is: " << v << "\n";
new (&v) Map<RowVectorXi>(data+4,5);
cout << "Now v is: " << v << "\n";

输出:

The mapped vector v is: 1 2 3 4
Now v is: 5 6 7 8 9

不管表面如何,这并没有调用内存分配器,因为语法指定了存储结果的位置。

这种语法可以在不知道映射数组在内存中的位置的情况下声明一个 Map 对象:

Map<Matrix3f> A(NULL);  // don't try to use this matrix yet!
VectorXf b(n_matrices);
for (int i = 0; i < n_matrices; i++)
{
   
  new (&A) Map<Matrix3f>(get_matrix_pointer(i));
  b(i) = A.trace();
}

关于C++ placement new 语法:

C++ placement new 语法形式不同于普通的new操作。例如,普通的new操作使用如下语句A* p=new A;申请空间,而 placement new 操作则使用如下语句A* p=new (ptr)A;申请空间,其中ptr是指定的内存首地址。

相关文章
|
15天前
|
存储 Java API
详细解析HashMap、TreeMap、LinkedHashMap等实现类,帮助您更好地理解和应用Java Map。
【10月更文挑战第19天】深入剖析Java Map:不仅是高效存储键值对的数据结构,更是展现设计艺术的典范。本文从基本概念、设计艺术和使用技巧三个方面,详细解析HashMap、TreeMap、LinkedHashMap等实现类,帮助您更好地理解和应用Java Map。
35 3
|
15天前
|
存储 Java 开发者
Java中的Map接口提供了一种优雅的方式来管理数据结构,使代码更加清晰、高效
【10月更文挑战第19天】在软件开发中,随着项目复杂度的增加,数据结构的组织和管理变得至关重要。Java中的Map接口提供了一种优雅的方式来管理数据结构,使代码更加清晰、高效。本文通过在线购物平台的案例,展示了Map在商品管理、用户管理和订单管理中的具体应用,帮助开发者告别混乱,提升代码质量。
24 1
|
3月前
|
Java
【Java集合类面试二十二】、Map和Set有什么区别?
该CSDN博客文章讨论了Map和Set的区别,但提供的内容摘要并未直接解释这两种集合类型的差异。通常,Map是一种键值对集合,提供通过键快速检索值的能力,而Set是一个不允许重复元素的集合。
|
3月前
|
JavaScript 前端开发
Vue 系类之 this.tabledatas.map 无效
这篇文章讲述了在Vue项目中使用`this.tabledatas.map`处理接口返回的数组数据时遇到的问题,原因是由于取错了后端返回的数据集合字段值,导致`.map`方法无效,通过检查和修正数据取值解决了问题。
Vue 系类之 this.tabledatas.map 无效
|
3月前
|
算法 Java 索引
【Java集合类面试四】、 描述一下Map put的过程
这篇文章详细描述了HashMap中put操作的过程,包括首次扩容、计算索引、插入数据以及链表转红黑树和可能的再次扩容。
【Java集合类面试四】、 描述一下Map put的过程
|
3月前
|
安全 Java
【Java集合类面试五】、 如何得到一个线程安全的Map?
如何得到一个线程安全的Map的方法包括:使用Collections工具类将Map包装为线程安全,使用java.util.concurrent包下的ConcurrentHashMap,以及不推荐使用性能较差的Hashtable。
|
3月前
|
安全 Java
【Java集合类面试三】、Map接口有哪些实现类?
这篇文章介绍了Java中Map接口的几种常用实现类:HashMap、LinkedHashMap、TreeMap和ConcurrentHashMap,以及它们适用的不同场景和线程安全性。
|
5月前
|
存储 算法 Java
滚雪球学Java(65):深入理解Java中的Map接口:实现原理剖析
【6月更文挑战第19天】🏆本文收录于「滚雪球学Java」专栏,专业攻坚指数级提升,希望能够助你一臂之力,帮你早日登顶实现财富自由🚀;同时,欢迎大家关注&&收藏&&订阅!持续更新中,up!up!up!!
42 3
滚雪球学Java(65):深入理解Java中的Map接口:实现原理剖析
|
5月前
|
存储 编译器 C++
|
5月前
|
程序员
Map.Entry 类使用简介
Map.Entry 类使用简介
45 1