标准安装的Python中用列表(list)保存一组值，可以用来当作数组使用， 不过由于列表的元素可以是任何对象，因此列表中所保存的是对象的指针。 这样为了保存一个简单的 [1,2,3] ，需要有3个指针和三个整数对象。 对于数值运算来说这种结构显然比较浪费内存和CPU计算时间。

此外Python还提供了一个 array 模块，array 对象和列表不同，它直接保存数值， 和C语言的一维数组比较类似。但是由于它不支持多维，也没有各种运算函数，因此也不适合做数值运算。

NumPy的诞生弥补了这些不足，NumPy提供了两种基本的对象: ndarray (N-dimensional array object)和 ufunc (universal function object)。 ndarray (下文统一称之为数组)是存储单一数据类型的多维数组，而 ufunc 则是能够对数组进行处理的函数。

函数库的导入与数组创建

函数库的导入

完成安装 NumPy 之后，就可以在脚本中载入 NumPy 模块了， 然后输出 NumPy 的版本号验证安装结果：

习惯上，大多数人都会使用 np 作为别名来载入 NumPy 模块：

在这里介绍的内容会遵循上面的习惯用法。

在阅读本章的过程中，请不要忘记了IPython提供的內建帮助工具 ? 以及使用制表符自动补全的功能。

例如，要查看 numpy 模块中的所有内容（属性和方法），可以输入：

In [3]: np.<TAB>

如果想查看 numpy 的內建文档，可以输入：

In [4]: np?

首先需要创建数组才能对其进行其它操作。 可以通过给 array 函数传递Python的序列对象创建数组：

如果传递的是多层嵌套的序列，将创建多维数组(下例中的变量 c )：

数组的形状（Shape）

数组的大小可以通过其 shape 属性获得:

数组 a 的 shape 属性只有一个元素，因此它是一维数组。

数组 c 的 shape 属性有两个元素，因此它是二维数组，其中第0轴的长度为 3 ，第1轴的长度为 4 。

还可以通过修改数组的 shape 属性，在保持数组元素个数不变的情况下，改变数组每个轴的长度。 下面的例子将数组 c 的 shape 改为 (4,3) 。

注意从 (3,4) 改为 (4,3) 并不是对数组进行转置，而只是改变每个轴的大小，数组元素在内存中的位置并没有改变：

在对 shape 赋值，若某个轴的元素为 -1 时， 将根据数组元素的个数自动计算此轴的长度。

因此下面的程序将数组 c 的 shape 变成了 (2,6) :

使用数组的 reshape 方法，可以创建一个改变了尺寸的新数组，原数组的 shape 保持不变:

数组 a 和 d 其实共享数据存储内存区域， 因此修改其中任意一个数组的元素都会同时修改另外一个数组的内容。

将数组a的第一个元素改为100：

注意数组d中的2也被改变了：

数组的类型

数组的元素类型可以通过 dtype 属性获得。 上面例子中的参数序列的元素都是整数，因此创建的数组的元素类型也是整数，并且是 32bit 的长整型。 可以通过 dtype 参数在创建时指定元素类型:

注意上面的 dtype 参数，在较旧版本的 NumPy 中可能需要使用 np.float / np.complex 。 但在新版本中这种用法已经被弃用了。

AttributeError: module 'numpy' has no attribute 'float'. np.float was a deprecated alias for the builtin float. To avoid this error in existing code, use float by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use np.float64 here. The aliases was originally deprecated in NumPy 1.20; for more details and guidance see the original release note at:

AttributeError: module 'numpy' has no attribute 'complex'. np.complex was a deprecated alias for the builtin complex. To avoid this error in existing code, use complex by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use np.complex128 here. The aliases was originally deprecated in NumPy 1.20; for more details and guidance see the original release note at:

https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations

创建数组的函数

上面的例子都是先创建一个Python序列，然后通过 array 函数将其转换为数组，这样做显然效率不高。 因此NumPy提供了很多专门用来创建数组的函数。下面的每个函数都有一些关键字参数，具体用法请查看函数说明。

• arange() 函数类似于 Python的 range() 函数，通过指定开始值、终值和步长来创建一维数组，注意数组不包括终值:

• linspace 函数通过指定开始值、终值和元素个数来创建一维数组， 可以通过 endpoint 关键字指定是否包括终值，缺省设置是包括终值:

• logspace 函数和 linspace 类似，不过它创建等比数列， 下面的例子产生1(10⁰)到100(10²)、有20个元素的等比数列:

此外，使用 frombuffer , fromstring , fromfile 等函数可以从字节序列创建数组， 下面以 fromstring 为例：

Python的字符串实际上是字节序列，每个字符占一个字节，因此如果从字符串 s 创建一个 8bit 的整数数组的话， 所得到的数组正好就是字符串中每个字符的 ASCII 编码:

如果从字符串 s 创建 16bit 的整数数组，那么两个相邻的字节就表示一个整数， 把字节98和字节97当作一个16位的整数，它的值就是 98*256+97 = 25185 。 可以看出内存中是以 little endian (低位字节在前)方式保存数据的。

如果把整个字符串转换为一个64位的双精度浮点数数组，那么它的值是：

显然这个例子没有什么意义，但是可以想象如果我们用C语言的二进制方式写了一组 double 类型的数值到某个文件中， 那们可以从此文件读取相应的数据，并通过 fromstring 函数将其转换为 float64 类型的数组。 我们可以写一个Python的函数，它将数组下标转换为数组中对应的值，然后使用此函数创建数组:

fromfunction 函数的第一个参数为计算每个数组元素的函数，第二个参数为数组的大小 (shape) ， 因为它支持多维数组，所以第二个参数必须是一个序列，本例中用 (10,) 创建一个10元素的一维数组。 下面的例子创建一个二维数组表示九九乘法表，输出的数组a中的每个元素 a[i, j] 都等于 func2(i, j) :

存取元素

数组元素的存取方法和Python的标准方法相同:

用整数作为下标可以获取数组中的某个元素。

用范围作为下标获取数组的一个切片，包括 a[3] 不包括 a[5] ：

省略开始下标，表示从 a[0] 开始：

下标可以使用负数，表示从数组后往前数：

下标还可以用来修改元素的值：

范围中的第三个参数表示步长，2表示隔一个元素取一个元素 ：

省略范围的开始下标和结束下标，步长为-1，整个数组头尾颠倒：

步长为负数时,开始下标必须大于结束下标：

和Python的列表序列不同，通过下标范围获取的新的数组是原始数组的一个视图。 它与原始数组共享同一块数据空间:

通过下标范围产生一个新的数组b,b和a共享同一块数据空间：

将b的第2个元素修改为-10：

a的第5个元素也被修改为10：

除了使用下标范围存取元素之外，NumPy 还提供了两种存取元素的高级方法。

使用整数序列

当使用整数序列对数组元素进行存取时，将使用整数序列中的每个元素作为下标，整数序列可以是列表或者数组。 使用整数序列作为下标获得的数组不和原始数组共享数据空间。

获取x中的下标为3, 3, 1, 8的4个元素，组成一个新的数组。

下标可以是负数

由于b和x不共享数据空间，因此x中的值并没有改变

整数序列下标也可以用来修改元素的值

使用布尔数组

当使用布尔数组b作为下标存取数组x中的元素时，将收集数组x中所有在数组b中对应下标为 True 的元素。 使用布尔数组作为下标获得的数组不和原始数组共享数据空间，注意这种方式只对应于布尔数组，不能使用布尔列表。

布尔数组中下标为0,2的元素为 True ，因此获取x中下标为0,2的元素

如果是布尔列表，则把 True 当作1， False 当作0，按照整数序列方式获取x中的元素

布尔数组的长度不够时,不够的部分都当作 False

布尔数组下标也可以用来修改元素：

布尔数组一般不是手工产生，而是使用布尔运算的 ufunc 函数产生，关于 ufunc 函数请参照 ufunc 运算一节。

产生一个长度为10，元素值为 0-1 的随机数的数组：

数组x中的每个元素和0.5进行大小比较，得到一个布尔数组， True表示x中对应的值大于0.5：

使用 x>0.5 返回的布尔数组收集x中的元素，因此得到的结果是 x 中所有大于 0.5 的元素的数组：

多维数组

多维数组的存取和一维数组类似，因为多维数组有多个轴，因此它的下标需要用多个值来表示， NumPy 采用组元 (tuple) 作为数组的下标。 如图2.1所示，a为一个 6x6 的数组，图中用颜色区分了各个下标以及其对应的选择区域。

组元不需要圆括号

虽然我们经常在Python中用圆括号将组元括起来,但是其实组元的语法定义只需要用逗号隔开即可， 例如 x,y=y,x 就是用组元交换变量值的一个例子。

图 2.1 - 使用数组切片语法访问多维数组中的元素

如何创建这个数组

你也许会对如何创建a这样的数组感到好奇，数组a实际上是一个加法表，纵轴的值为0, 10, 20, 30, 40, 50； 横轴的值为0, 1, 2, 3, 4, 5。纵轴的每个元素都和横轴的每个元素求和，就得到图中所示的数组a。 你可以用下面的语句创建它，至于其原理我们将在后面的章节进行讨论:

多维数组同样也可以使用整数序列和布尔数组进行存取。

图 2.2 - 使用整数序列和布尔数组访问多维数组中的元素

• a[(0,1,2,3,4),(1,2,3,4,5)] : 用于存取数组的下标和仍然是一个有两个元素的组元， 组元中的每个元素都是整数序列,分别对应数组的第0轴和第1轴。
• 从两个序列的对应位置取出两个整数组成下标: a[0,1], a[1,2], ..., a[4,5]。
• a[3:, [0, 2, 5]] : 下标中的第0轴是一个范围,它选取第3行之后的所有行；第1轴是整数序列，它选取第0, 2, 5三列。
• a[mask, 2] : 下标的第0轴是一个布尔数组，它选取第0,2,5行；第1轴是一个整数,选取第2列。

结构数组

在C语言中我们可以通过 struct 关键字定义结构类型，结构中的字段占据连续的内存空间, 每个结构体占用的内存大小都相同，因此可以很容易地定义结构数组。 和C语言一样，在NumPy中也很容易对这种结构数组进行操作。只要 NumPy 中的结构定义和C语言中的定义相同, NumPy 就可以很方便地读取C语言的结构数组的二进制数据，转换为 NumPy 的结构数组。 假设我们需要定义一个结构数组,它的每个元素都有name, age和weight字段。 在NumPy中可以如下定义:

我们先创建一个 dtype 对象 persontype ，通过其字典参数描述结构类型的各个字段。 字典有两个关键字：names,formats。每个关键字对应的值都是一个列表。 names定义结构中的每个字段名，而formats则定义每个字段的类型:

• S32 : 32个字节的字符串类型,由于结构中的每个元素的大小必须固定，因此需要指定字符串的长度
• i : 32bit 的整数类型，相当于 np.int32
• f : 32bit 的单精度浮点数类型，相当于np.float32

然后我们调用 array 函数创建数组,通过关键字参数 dtype=persontype , 指定所创建的数组的元素类型为结构 persontype 。 运行上面程序之后，我们可以在IPython中执行如下的语句查看数组a的元素类型

这里我们看到了另外一种描述结构类型的方法: 一个包含多个组元的列表， 其中形如 (字段名, 类型描述) 的组元描述了结构中的每个字段。 类型描述前面为我们添加了 |, >, < 等字符，这些字符用来描述字段值的字节顺序:

• | : 忽视字节顺序
• < : 低位字节在前
• > : 高位字节在前

结构数组的存取方式和一般数组相同，通过下标能够取得其中的元素， 注意元素的值看上去像是组元，实际上它是一个结构:

a[0] 是一个结构元素，它和数组a共享内存数据，因此可以通过修改它的字段，改变原始数组中的对应字段：

"Li" 结构像字典一样可以通过字符串下标获取其对应的字段值：

我们不但可以获得结构元素的某个字段，还可以直接获得结构数组的字段，它返回的是原始数组的视图， 因此可以通过修改 b[0] 改变 a[0][''age''] ：

或者 a["age"]

通过调用 a.tostring 或者 a.tofile 方法，可以直接输出数组a的二进制形式：

利用下面的C语言程序可以将 test.bin 文件中的数据读取出来。

内存对齐

C语言的结构体为了内存寻址方便，会自动的添加一些填充用的字节，这叫做内存对齐。 例如，如果把下面的 name[32] 改为 name[30] 的话， 由于内存对齐问题，在 name 和 age 中间会填补两个字节,最终的结构体大小不会改变。 因此如果 NumPy 中的所配置的内存大小不符合C语言的对齐规范的话，将会出现数据错位。 为了解决这个问题，在创建 dtype 对象时，可以传递参数 align=True ， 这样 NumPy 的结构数组的内存对齐和C语言的结构体就一致了。

#include <stdio.h>

struct person
{
    char name[32];
    int age;
    float weight;
};
struct person p[2];
void main ()
{
FILE *fp;
int i;
fp=fopen("test.bin","rb");
fread(p, sizeof(struct person), 2, fp);
fclose(fp);
for(i=0;i<2;i++)
printf("%s %d %f\n", p[i].name, p[i].age, p[i].weight);
getchar();
}
np.dtype([('f1', [('f2', np.int16)])])

当某个字段类型为数组时，用组元的第三个参数表示， 下面描述的 f1 字段是一个 shape 为 (2,3) 的双精度浮点数组:

np.dtype([('f0', 'i4'), ('f1', 'f8', (2, 3))])
dtype([('f0', '<i4'), ('f1', '<f8', (2, 3))])

用下面的字典参数也可以定义结构类型，字典的关键字为结构中字段名，值为字段的类型描述， 但是由于字典的关键字是没有顺序的，因此字段的顺序需要在类型描述中给出，类型描述是一个组元， 它的第二个值给出字段的字节为单位的偏移量，例如 age 字段的偏移量为25个字节:

np.dtype({'surname':('S25',0),'age':(np.uint8,25)})
dtype([('surname', '|S25'), ('age', '|u1')])

内存结构

下面让我们来看看 ndarray 数组对象是如何在内存中储存的。 如图2.3所示，关于数组的描述信息保存在一个数据结构中，这个结构引用两个对象： 一个用于保存数据的存储区域和一个用于描述元素类型的 dtype 对象。

图 2.3 - ndarray 数组对象在内存中的储存方式

数据存储区域保存着数组中所有元素的二进制数据，dtype 对象则知道如何将元素的二进制数据转换为可用的值。 数组的维数、大小等信息都保存在 ndarray 数组对象的数据结构中。图中显示的是如下数组的内存结构:

strides 中保存的是当每个轴的下标增加1时,数据存储区中的指针所增加的字节数。 例如图中的 strides 为12,4,即第0轴的下标增加1时，数据的地址增加12个字节： 即 a[1,0] 的地址比 a[0,0] 的地址要高12个字节，正好是3个单精度浮点数的总字节数； 第1轴下标增加1时，数据的地址增加4个字节，正好是单精度浮点数的字节数。 如果 strides 中的数值正好和对应轴所占据的字节数相同的话，那么数据在内存中是连续存储的。 然而数据并不一定都是连续储存的，前面介绍过通过下标范围得到新的数组是原始数组的视图， 即它和原始视图共享数据存储区域：

由于数组 b 和数组 a 共享数据存储区，而 b 中的第 0 轴和第 1 轴都是数组 a 中隔一个元素取一个， 因此数组 b 的 strides 变成了24,8，正好都是数组a的两倍。 对照前面的图很容易看出数据0和2的地址相差8个字节，而0和6的地址相差24个字节。

元素在数据存储区中的排列格式有两种：C语言格式和Fortan语言格式。 在C语言中，多维数组的第0轴是最上位的，即第0轴的下标增加1时，元素的地址增加的字节数最多； 而Fortan语言的多维数组的第0轴是最下位的，即第0轴的下标增加1时，地址只增加一个元素的字节数。 在NumPy中，元素在内存中的排列缺省是以C语言格式存储的， 如果你希望改为Fortan格式的话，只需要给数组传递 order=''F'' 参数: