本文来自机器之心

参与：一鸣、Jamin

NumPy 无疑是很多机器学习研究者和开发者的「白月光」。如此优秀的项目，没有中文版怎么行？近日，机器之心发现 NumPy 官方早在去年就已出了一个中文版网站，涵盖 NumPy 的一切。

在 Github 上一度蝉联最流行的机器学习和数据科学包 NumPy，已经有了非常之系统的中文文档，回想起当初细啃 NumPy 之时，不少人不得不徘徊于各大搜索引擎及平台反复查找，找到的文档也许还很不系统。现在，如果有什么和 NumPy 的问题，只需要浏览这份官方中文文档就足够了。它足够的系统、全面且亲民。亲民到什么程度呢？网站还独一份的配备了「防脱发指南」。

NumPy 是什么？它是大名鼎鼎的，使用 Python 进行科学计算的基础软件包，是 Python 生态系统中数据分析、机器学习、科学计算的主力军，极大简化了向量与矩阵的操作处理。除了计算外，它还包括了：

• 功能强大的 N 维数组对象。

• 精密广播功能函数。

• 集成 C/C+和 Fortran 代码的工具。

• 强大的线性代数、傅立叶变换和随机数功能

此次中文文档还强调了它两大特性：Ndarray 以及切片和索引，这两部分所涉及的功能在日常操作中是十分常见的。

• Ndarray：一系列同类型数据的集合，以 0 下标为开始进行集合中元素的索引。ndarray 对象是用于存放同类型元素的多维数组。ndarray 中的每个元素在内存中都有相同存储大小的区域。

• 切片和索引：ndarray 对象的内容可以通过索引或切片来访问和修改，与 Python 中 list 的切片操作一样。ndarray 数组可以基于 0 - n 的下标进行索引，切片对象可以通过内置的 slice 函数，并设置 start, stop 及 step 参数进行，从原数组中切割出一个新数组。

官网地址：https://www.NumPy.org.cn

这个官方中文项目内容繁多，文章数量庞大。机器之心在这里节选了一些亮点内容，供读者参考。

教程、文档应有尽有，中文版强调和深度学习联系

从原理开始，中文版增加理论介绍板块

这个开源的官方中文版教程可以说是非常全面了。它从最基本的理解 NumPy 开始，教程层层推进，直到让用户掌握进阶的使用方法。

从内容来看，中文版不仅仅是官方英文版本的翻译，还额外增加了「文章」这一栏目。该栏目提供了对 NumPy 背后的矩阵运算原理的详细解释，使得使用者「知其然，也知其所以然」。这是英文版教程中没有的。

以下为这一部分的目录，从这里可以看到，这部分内容主要介绍 NumPy 的基本理论，以及涉及到其应用的理论部分，如数据分析、神经网络实现，以及在其他代码库中的接口等。

基础篇

• 理解 NumPy

• NumPy 简单入门教程

• Python NumPy 教程

• 创建 NumPy 数组的不同方式

• NumPy 中的矩阵和向量

进阶篇

• NumPy 数据分析练习

• NumPy 神经网络

• 使用 NumPy 进行数组编程

• NumPy 实现k均值聚类算法

• NumPy 实现DNC、RNN和LSTM神经网络算法

其他篇

• OpenCV中的图像的基本操作

• MinPy：MXNet后端的NumPy接口

我们截取了这些文章的部分内容，可以看到，这里不仅仅会讲 NumPy 所实现的功能，还提供了原理的图解。

对于多维数组的直观讲解（部分），可以看出官方提供了很好的理论解释和图示。

注意和深度学习的联系

另一方面，NumPy 中文版教程注意到了深度学习近来的发展趋势，因此推出了结合 NumPy 和百度飞桨框架的深度学习教程。可以说，NumPy 不仅仅只是科学计算工具了，而是深度学习社区的重要组成部分。

如下为这一部分的内容，可以看到，神经网络相关的所有内容，包括原理和相关实现都涵盖到了。在这部分还有一个 7 日的深度学习入门课程，供小白用户参考。

深度学习基础教程

• 前言

• 线性回归

• 数字识别

• 图像分类

• 词向量

• 个性化推荐

• 情感分析

• 语义角色标注

• 机器翻译

• 生成对抗网络

七日入门深度学习（正在更新）

• Day 1：初识深度学习

• Day 1：如何快速入门深度学习？

• Day 2：图像识别基础与实战

• Day 3：目标检测基础与实践（一）

• Day 3：目标检测实战-RCNN算法讲解

• Day 3：目标检测实战-YOLOv3检测物体

以如下代码为例，这是一个线性回归神经网络构建的代码部分。可以看到，代码使用 NumPy 进行加载和预处理，并使用飞桨构建数据分批等的相关函数。

feature_names = ['CRIM', 'ZN', 'INDUS', 'CHAS', 'NOX', 'RM', 'AGE', 'DIS', 'RAD', 'TAX','PTRATIO', 'B', 'LSTAT', 'convert'
]
feature_num = len(feature_names)
data = np.fromfile(filename, sep=' ') # 从文件中读取原始数据
data = data.reshape(data.shape[0] // feature_num, feature_num)
maximums, minimums, avgs = data.max(axis=0), data.min(axis=0), data.sum(axis=0)/data.shape[0]for i in six.moves.range(feature_num-1):data[:, i] = (data[:, i] - avgs[i]) / (maximums[i] - minimums[i]) # six.moves可以兼容python2和python3ratio = 0.8 # 训练集和验证集的划分比例
offset = int(data.shape[0]*ratio)
train_data = data[:offset]
test_data = data[offset:]def reader_creator(train_data):  def reader():  for d in train_data:  yield d[:-1], d[-1:]  return readertrain_reader = paddle.batch(paddle.reader.shuffle(reader_creator(train_data), buf_size=500),batch_size=BATCH_SIZE)test_reader = paddle.batch(paddle.reader.shuffle(reader_creator(test_data), buf_size=500),batch_size=BATCH_SIZE)

用户文档和参考手册：覆盖 NumPy 的一切

当然，最核心的部分当然是 NumPy 本身的文档了。中文版中对用户的使用文档和 NumPy 所有 API 都进行了翻译和整理工作，基本上用户需要的内容都可以在这里找到。

用户文档目录如下，这里还贴心地提供了和「竞品」Matlab 的比较，以及 NumPy 在 C 语言下的 API 使用方法。

• NumPy 介绍

• 快速入门教程

• NumPy 基础知识

• 其他杂项

• 与 Matlab 比较

• 从源代码构建

• 使用 NumPy 的 C-API

从这里可以看到，官方中文版真的是诚意满满。不仅提供原始文档的翻译，还加上了包括深度学习教程、其他来源的功能+原理解读材料。对于刚上手 NumPy 的人来说，这就是最佳的学习教程。不管是自学也好，还是用于开发也好，都是极好的。

其他资源及文档

如果读到这里你还不过瘾？没关系，官网还有相关配套的文章及视频，让你多样化地保持新鲜感：

另外，独有一份的防脱发指南让你入坑之时再无后顾之忧：

面向开发者还单独有一份开发者指南，这是一份详细的操作清单，如何合理的配置及使用开发环境等一系列问题都已被包含在内。

• NumPy 行为准则

• Git 教程

• 设置和使用您的开发环境

• 开发流程

• NumPy 基准测试

• NumPy C 风格指南

• 发布一个版本

• NumPy 治理

NumPy 的用户数量庞大，开发者社区也非常繁荣。从包括 PyTorch、NumPy 等开源工具陆续推出中文版文档来看，中文世界在机器学习领域受到了更大的关注。

完）