---

Apache MXNet - Python API Symbol

---

在本章中，我们将了解 MXNet 中称为 Symbol 的接口。

Mxnet.ndarray

Apache MXNet 的 Symbol API 是一个用于符号编程的接口。 Symbol API 具有以下使用功能 −

• 计算图

• 减少内存使用

• 使用前函数优化

下面给出的示例展示了如何使用 MXNet 的 Symbol API −

创建一个简单的表达式

使用常规 Python 列表中的一维和二维"数组"创建 NDArray −

import mxnet as mx
# 使用 mx.sym.variable 创建两个占位符，即 x 和 y
x = mx.sym.Variable('x')
y = mx.sym.Variable('y')
# 此处的符号使用加号"+"运算符构造。
z = x + y

输出

您将看到以下输出 −

<Symbol _plus0>

示例

(x, y, z)

输出

输出如下所示 −

(<Symbol x>, <Symbol y>, <Symbol _plus0>)

现在让我们详细讨论一下 MXNet 的 ndarray API 的类、函数和参数。

类

下表包含 MXNet 的 Symbol API 类 −

函数及其参数

以下是 mxnet.Symbol API 中涵盖的一些重要函数及其参数 −

实施示例

在下面的示例中，我们将使用函数 power()，它将返回以基数元素为底，以 exp 元素为幂的元素结果：

import mxnet as mx
mx.sym.power(3, 5)

输出

您将看到以下输出 −

243

示例

x = mx.sym.Variable('x')
y = mx.sym.Variable('y')
z = mx.sym.power(x, 3)
z.eval(x=mx.nd.array([1,2]))[0].asnumpy()

输出

这将产生以下输出 −

array([1., 8.], dtype=float32)

示例

z = mx.sym.power(4, y)
z.eval(y=mx.nd.array([2,3]))[0].asnumpy()

输出

执行上述代码时，您应该看到以下输出 −

array([16., 64.], dtype=float32)

示例

z = mx.sym.power(x, y)
z.eval(x=mx.nd.array([4,5]), y=mx.nd.array([2,3]))[0].asnumpy()

输出

输出如下 −

array([ 16., 125.], dtype=float32)

在下面给出的示例中，我们将使用函数 SoftmaxActivation() （或 softmax()），该函数将应用于输入并用于内部层。

input_data = mx.nd.array([[2., 0.9, -0.5, 4., 8.], [4., -.7, 9., 2., 0.9]])
soft_max_act = mx.nd.softmax(input_data)
print (soft_max_act.asnumpy())

输出

您将看到以下输出 −

[[2.4258138e-03 8.0748333e-04 1.9912292e-04 1.7924475e-02 9.7864312e-01]
[6.6843745e-03 6.0796250e-05 9.9204916e-01 9.0463174e-04 3.0112563e-04]]

symbol.contrib

Contrib NDArray API 在 symbol.contrib 包中定义。它通常为新功能提供许多有用的实验性 API。此 API 是社区可以试用新功能的地方。功能贡献者也会得到反馈。

函数及其参数

以下是 mxnet.symbol.contrib API 中涵盖的一些重要函数及其参数 −

实施示例

在下面的示例中，我们将使用函数 rand_zipfian 从近似 Zipfian 分布中抽取随机样本 −

import mxnet as mx
true_cls = mx.sym.Variable('true_cls')
samples, exp_count_true, exp_count_sample = mx.sym.contrib.rand_zipfian(true_cls, 5, 6)
samples.eval(true_cls=mx.nd.array([3]))[0].asnumpy()

输出

您将看到以下输出 −

array([4, 0, 2, 1, 5], dtype=int64)

示例

exp_count_true.eval(true_cls=mx.nd.array([3]))[0].asnumpy()

输出

输出如下 −

array([0.57336551])

示例

exp_count_sample.eval(true_cls=mx.nd.array([3]))[0].asnumpy()

输出

您将看到以下输出 −

array([1.78103594, 0.46847373, 1.04183923, 0.57336551, 1.04183923])

在下面的例子中，我们将使用函数 while_loop 来运行 while 循环，用于用户定义的计算和循环条件 −

cond = lambda i, s: i <= 7
func = lambda i, s: ([i + s], [i + 1, s + i])
loop_vars = (mx.sym.var('i'), mx.sym.var('s'))
outputs, states = mx.sym.contrib.while_loop(cond, func, loop_vars, max_iterations=10)
print(outputs)

输出

输出如下所示:

[<Symbol _while_loop0>]

示例

Print(States)

输出

这将产生以下输出 −

[<Symbol _while_loop0>, <Symbol _while_loop0>]

在下面的例子中，我们将使用函数 index_copy 将 new_tensor 的元素复制到 old_tensor 中。

import mxnet as mx
a = mx.nd.zeros((6,3))
b = mx.nd.array([[1,2,3],[4,5,6],[7,8,9]])
index = mx.nd.array([0,4,2])
mx.nd.contrib.index_copy(a, index, b)

输出

执行上述代码时，您应该看到以下输出 −

[[1. 2. 3.]
[0. 0. 0.]
[7. 8. 9.]
[0. 0. 0.]
[4. 5. 6.]
[0. 0. 0.]]
<NDArray 6x3 @cpu(0)>

symbol.image

图像符号 API 在 symbol.image 包中定义。顾名思义，它通常用于图像及其特征。

函数及其参数

以下是 mxnet.symbol.image API 中涵盖的一些重要函数及其参数 −

实现示例

在下面的示例中，我们将使用函数 to_tensor 将形状为 (H x W x C) 或 (N x H x W x C) 且值在 [0, 255] 范围内的图像 NDArray 转换为形状为 (C x H x W) 或 (N x C x H x W) 且值在 [0, 1] 范围内的张量 NDArray。

import numpy as np

img = mx.sym.random.uniform(0, 255, (4, 2, 3)).astype(dtype=np.uint8)

mx.sym.image.to_tensor(img)

输出

输出如下所示 −

<Symbol to_tensor4>

示例

img = mx.sym.random.uniform(0, 255, (2, 4, 2, 3)).astype(dtype=np.uint8)

mx.sym.image.to_tensor(img)

输出

输出如下:

<Symbol to_tensor5>

在下面的例子中，我们将使用函数 normalize() 来规范化形状为 (C x H x W) 或 (N x C x H x W) 的张量，其值为 平均值 和 标准差 (SD)。

img = mx.sym.random.uniform(0, 1, (3, 4, 2))

mx.sym.image.normalize(img, mean=(0, 1, 2), std=(3, 2, 1))

输出

下面给出了代码的输出 −

<Symbol normalize0>

示例

img = mx.sym.random.uniform(0, 1, (2, 3, 4, 2))

mx.sym.image.normalize(img, mean=(0, 1, 2), std=(3, 2, 1))

输出

输出如下所示 −

<Symbol normalize1>

symbol.random

随机符号 API 在 symbol.random 包中定义。顾名思义，它是 MXNet 的随机分布生成器 Symbol API。

函数及其参数

以下是 mxnet.symbol.random API 中涵盖的一些重要函数及其参数 −

实施示例

在下面的示例中，我们将使用 shuffle() 函数随机打乱元素顺序。它将沿着第一个轴打乱数组顺序。

data = mx.nd.array([[0, 1, 2], [3, 4, 5], [6, 7, 8],[9,10,11]])
x = mx.sym.Variable('x')
y = mx.sym.random.shuffle(x)
y.eval(x=data)

输出

您将看到以下输出:

[
[[ 9. 10. 11.]
[ 0. 1. 2.]
[ 6. 7. 8.]
[ 3. 4. 5.]]
<NDArray 4x3 @cpu(0)>]

示例

y.eval(x=data)

输出

执行上述代码时，您应该看到以下输出 −

[
[[ 6. 7. 8.]
[ 0. 1. 2.]
[ 3. 4. 5.]
[ 9. 10. 11.]]
<NDArray 4x3 @cpu(0)>]

在下面的例子中，我们将从广义负二项分布中抽取随机样本。为此将使用函数 generalized_negative_binomial()。

mx.sym.random.generalized_negative_binomial(10, 0.1)

输出

输出概要 −

<Symbol _random_generalized_negative_binomial0>

symbol.sparse

稀疏符号 API 在 mxnet.symbol.sparse 包中定义。顾名思义，它提供稀疏神经网络图和 CPU 上的自动微分。

函数及其参数

以下是 mxnet.symbol.sparse API 涵盖的一些重要函数（包括符号创建例程、符号操作例程、数学函数、三角函数、双曲函数、归约函数、舍入、幂、神经网络）及其参数 −

实施示例

在下面的示例中，我们将使用 ElementWiseSum() 函数随机打乱元素。它将整数索引映射到向量表示，即词嵌入。

input_dim = 4
output_dim = 5

示例

/* Here every row in weight matrix y represents a word. So, y = (w0,w1,w2,w3)
y = [[ 0., 1., 2., 3., 4.],
[ 5., 6., 7., 8., 9.],
[ 10., 11., 12., 13., 14.],
[ 15., 16., 17., 18., 19.]]
/* Here input array x represents n-grams(2-gram). So, x = [(w1,w3), (w0,w2)]
x = [[ 1., 3.],
[ 0., 2.]]
/* Now, Mapped input x to its vector representation y.
Embedding(x, y, 4, 5) = [[[ 5., 6., 7., 8., 9.],
[ 15., 16., 17., 18., 19.]],
[[ 0., 1., 2., 3., 4.],
[ 10., 11., 12., 13., 14.]]]

---