Skip to content

Commit 0e1d05f

Browse files
authored
Update same name file (#4818) (#4865)
* Update release_note_cn.md * Update release_note_en.md * Update release_note_en.md * Update release_note_cn.md * Update release_note_cn.md * Update release_note_en.md * fix api docs bug * update AlexNet docs
1 parent f3fdde0 commit 0e1d05f

File tree

5 files changed

+73
-83
lines changed

5 files changed

+73
-83
lines changed
Lines changed: 10 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,29 @@
1-
.. _cn_api_paddle_vision_models_alexnet:
1+
.. _cn_api_paddle_vision_models_AlexNet:
22

3-
alexnet
3+
AlexNet
44
-------------------------------
55

6-
.. py:function:: paddle.vision.models.alexnet(pretrained=False, **kwargs)
6+
.. py:function:: paddle.vision.models.AlexNet(num_classes=1000)
77
8-
AlexNet模型,来自论文 `"ImageNet Classification with Deep Convolutional Neural Networks" <https://papers.nips.cc/paper/2012/file/c399862d3b9d6b76c8436e924a68c45b-Paper.pdf>`_ 。
8+
AlexNet模型,来自论文 `"ImageNet Classification with Deep Convolutional Neural Networks" <https://papers.nips.cc/paper/2012/file/c399862d3b9d6b76c8436e924a68c45b-Paper.pdf>`_ 。
99

1010
参数
1111
:::::::::
12-
- **pretrained** (bool,可选) - 是否加载在imagenet数据集上的预训练权重。默认值:False
12+
- **num_classes** (int, 可选) - 最后一个全连接层输出的维度。默认值:1000
1313

1414
返回
1515
:::::::::
16-
alexnet模型,Layer的实例。
16+
AlexNet模型,Layer的实例。
1717

1818
代码示例
1919
:::::::::
20-
.. code-block:: python
2120

21+
.. code-block:: python
22+
2223
import paddle
23-
from paddle.vision.models import alexnet
24-
24+
from paddle.vision.models import AlexNet
2525
# build model
26-
model = alexnet()
27-
28-
# build model and load imagenet pretrained weight
29-
# model = alexnet(pretrained=True)
30-
26+
model = AlexNet()
3127
x = paddle.rand([1, 3, 224, 224])
3228
out = model(x)
33-
3429
print(out.shape)
Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
1-
.. _cn_api_paddle_vision_models_googlenet:
1+
.. _cn_api_paddle_vision_models_GoogLeNet:
22

3-
googlenet
3+
GoogLeNet
44
-------------------------------
55

6-
.. py:function:: paddle.vision.models.googlenet(pretrained=False, **kwargs)
6+
.. py:function:: paddle.vision.models.GoogLeNet(num_classes=1000, with_pool=True)
77
8-
GoogLeNet(Inception v1)模型,来自论文 `"Going Deeper with Convolutions" <https://arxiv.org/pdf/1409.4842.pdf>`_ 。
8+
GoogLeNet(Inception v1)模型,来自论文 `"Going Deeper with Convolutions" <https://arxiv.org/pdf/1409.4842.pdf>`_ 。
99

1010
参数
1111
:::::::::
12-
- **pretrained** (bool,可选) - 是否加载在imagenet数据集上的预训练权重。默认值:False。
12+
- **num_classes** (int, 可选) - 最后一个全连接层输出的维度。如果该值小于0,则不定义最后一个全连接层。默认值:1000。
13+
- **with_pool** (bool,可选) - 是否定义最后一个全连接层之前的池化层。默认值:True。
1314

1415
返回
1516
:::::::::
@@ -18,17 +19,14 @@ GoogLeNet模型,Layer的实例。
1819
代码示例
1920
:::::::::
2021
.. code-block:: python
21-
22+
2223
import paddle
23-
from paddle.vision.models import googlenet
24-
24+
from paddle.vision.models import GoogLeNet
25+
2526
# build model
26-
model = googlenet()
27-
28-
# build model and load imagenet pretrained weight
29-
# model = googlenet(pretrained=True)
30-
27+
model = GoogLeNet()
28+
3129
x = paddle.rand([1, 3, 224, 224])
3230
out, out1, out2 = model(x)
33-
31+
3432
print(out.shape)
Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,43 @@
1-
.. _cn_api_vision_transforms_pad:
1+
.. _cn_api_vision_transforms_Pad:
22

3-
pad
3+
Pad
44
-------------------------------
55

6-
.. py:function:: paddle.vision.transforms.pad(img, padding, fill=0, padding_mode='constant')
6+
.. py:class:: paddle.vision.transforms.Pad(padding, fill=0, padding_mode='constant', keys=None)
77
88
使用特定的模式和值来对输入图像进行填充。
99

1010
参数
1111
:::::::::
1212

13-
- img (PIL.Image|np.ndarray) - 被填充的图像。
1413
- padding (int|list|tuple) - 在图像边界上进行填充的范围。如果提供的是单个int值,则该值用于填充图像所有边;如果提供的是长度为2的元组/列表,则分别为图像左/右和顶部/底部进行填充;如果提供的是长度为4的元组/列表,则按照左,上,右和下的顺序为图像填充。
15-
- fill (int|tuple) - 用于填充的像素值。仅当padding_mode为constant时参数值有效。 默认值:0。 如果参数值是一个长度为3的元组,则会分别用于填充R,G,B通道。
14+
- fill (int|list|tuple) - 用于填充的像素值。仅当padding_mode为constant时参数值有效。 默认值:0。 如果参数值是一个长度为3的元组,则会分别用于填充R,G,B通道。
1615
- padding_mode (string) - 填充模式。支持: constant, edge, reflect 或 symmetric。 默认值:constant。 ``constant`` 表示使用常量值进行填充,该值由fill参数指定。``edge`` 表示使用图像边缘像素值进行填充。``reflect`` 表示使用原图像的镜像值进行填充(不使用边缘上的值);比如:使用该模式对 ``[1, 2, 3, 4]`` 的两端分别填充2个值,结果是 ``[3, 2, 1, 2, 3, 4, 3, 2]``。``symmetric`` 表示使用原图像的镜像值进行填充(使用边缘上的值);比如:使用该模式对 ``[1, 2, 3, 4]`` 的两端分别填充2个值,结果是 ``[2, 1, 1, 2, 3, 4, 4, 3]``。
16+
- keys (list[str]|tuple[str], optional) - 与 ``BaseTransform`` 定义一致。默认值: None。
17+
18+
形状
19+
:::::::::
20+
21+
- img (PIL.Image|np.ndarray|Paddle.Tensor) - 输入的图像数据,数据格式为'HWC'。
22+
- output (PIL.Image|np.ndarray|Paddle.Tensor) - 返回填充后的图像数据。
1723

1824
返回
1925
:::::::::
2026

21-
``PIL.Image 或 numpy.ndarray``,填充后的图像
27+
计算 ``Pad`` 的可调用对象
2228

2329
代码示例
2430
:::::::::
25-
26-
.. code-block:: python
2731

32+
.. code-block:: python
33+
2834
import numpy as np
2935
from PIL import Image
30-
from paddle.vision.transforms import functional as F
31-
32-
fake_img = (np.random.rand(256, 300, 3) * 255.).astype('uint8')
36+
from paddle.vision.transforms import Pad
3337
34-
fake_img = Image.fromarray(fake_img)
38+
transform = Pad(2)
3539
36-
padded_img = F.pad(fake_img, padding=1)
37-
print(padded_img.size)
40+
fake_img = Image.fromarray((np.random.rand(224, 224, 3) * 255.).astype(np.uint8))
3841
39-
padded_img = F.pad(fake_img, padding=(2, 1))
40-
print(padded_img.size)
42+
fake_img = transform(fake_img)
43+
print(fake_img.size)
Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
1-
.. _cn_api_vision_transforms_resize:
1+
.. _cn_api_vision_transforms_Resize:
22

3-
resize
3+
Resize
44
-------------------------------
55

6-
.. py:function:: paddle.vision.transforms.resize(img, size, interpolation='bilinear')
6+
.. py:class:: paddle.vision.transforms.Resize(size, interpolation='bilinear', keys=None)
77
88
将输入数据调整为指定大小。
99

1010
参数
1111
:::::::::
1212

13-
- img (numpy.ndarray|PIL.Image) - 输入数据,可以是(H, W, C)形状的图像或遮罩。
14-
- size (int|tuple) - 输出图像大小。如果size是一个序列,例如(h,w),输出大小将与此匹配。如果size为int,图像的较小边缘将与此数字匹配,即如果 height > width,则图像将重新缩放为(size * height / width, size)。
13+
- size (int|list|tuple) - 输出图像大小。如果size是一个序列,例如(h,w),输出大小将与此匹配。如果size为int,图像的较小边缘将与此数字匹配,即如果 height > width,则图像将重新缩放为(size * height / width, size)。
1514
- interpolation (int|str, optional) - 插值的方法,默认值: 'bilinear'。
1615
- 当使用 ``pil`` 作为后端时, 支持的插值方法如下
1716
+ "nearest": Image.NEAREST,
@@ -26,30 +25,32 @@ resize
2625
+ "area": cv2.INTER_AREA,
2726
+ "bicubic": cv2.INTER_CUBIC,
2827
+ "lanczos": cv2.INTER_LANCZOS4。
28+
29+
- keys (list[str]|tuple[str], optional) - 与 ``BaseTransform`` 定义一致。默认值: None。
30+
31+
形状
32+
:::::::::
33+
34+
- img (PIL.Image|np.ndarray|Paddle.Tensor) - 输入的图像数据,数据格式为'HWC'。
35+
- output (PIL.Image|np.ndarray|Paddle.Tensor) - 返回调整大小后的图像数据。
2936

3037
返回
3138
:::::::::
3239

33-
``PIL.Image 或 numpy.ndarray``,调整大小后的图像数据
40+
计算 ``Resize`` 的可调用对象
3441

3542
代码示例
3643
:::::::::
3744

3845
.. code-block:: python
39-
46+
4047
import numpy as np
4148
from PIL import Image
42-
from paddle.vision.transforms import functional as F
43-
44-
fake_img = (np.random.rand(256, 300, 3) * 255.).astype('uint8')
49+
from paddle.vision.transforms import Resize
4550
46-
fake_img = Image.fromarray(fake_img)
51+
transform = Resize(size=224)
4752
48-
converted_img = F.resize(fake_img, 224)
49-
print(converted_img.size)
50-
# (262, 224)
53+
fake_img = Image.fromarray((np.random.rand(100, 120, 3) * 255.).astype(np.uint8))
5154
52-
converted_img = F.resize(fake_img, (200, 150))
53-
print(converted_img.size)
54-
# (150, 200)
55-
55+
fake_img = transform(fake_img)
56+
print(fake_img.size)
Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,25 @@
11
.. _cn_api_vision_transforms_normalize:
22

3-
Normalize
3+
normalize
44
-------------------------------
55

6-
.. py:class:: paddle.vision.transforms.Normalize(mean=0.0, std=1.0, data_format='CHW', to_rgb=False, keys=None)
6+
.. py:function:: paddle.vision.transforms.normalize(img, mean, std, data_format='CHW', to_rgb=False)
77
8-
用均值和标准差归一化输入数据。给定n个通道的均值(M1,...,Mn)和方差(S1,..,Sn),Normalize会在每个通道归一化输入数据。output[channel] = (input[channel] - mean[channel]) / std[channel]
8+
用均值和标准差归一化输入数据。
99

1010
参数
1111
:::::::::
1212

13+
- img (PIL.Image|np.array|paddle.Tensor) - 用于归一化的数据。
1314
- mean (list|tuple) - 用于每个通道归一化的均值。
1415
- std (list|tuple) - 用于每个通道归一化的标准差值。
1516
- data_format (str, optional): 数据的格式,必须为 'HWC' 或 'CHW'。 默认值: 'CHW'。
1617
- to_rgb (bool, optional) - 是否转换为 ``rgb`` 的格式。默认值:False。
1718

18-
形状
19-
:::::::::
20-
21-
- img (PIL.Image|np.ndarray|paddle.Tensor) - 输入的图像数据,数据格式为'HWC'。
22-
- output (PIL.Image|np.ndarray|Paddle.Tensor) - 返回归一化后的图像数据。
23-
2419
返回
2520
:::::::::
2621

27-
计算 ``Normalize`` 的可调用对象
22+
``numpy array 或 paddle.Tensor``,归一化后的图像
2823

2924
代码示例
3025
:::::::::
@@ -33,17 +28,15 @@ Normalize
3328
3429
import numpy as np
3530
from PIL import Image
36-
from paddle.vision.transforms import Normalize
31+
from paddle.vision.transforms import functional as F
32+
33+
fake_img = (np.random.rand(256, 300, 3) * 255.).astype('uint8')
3734
38-
normalize = Normalize(mean=[127.5, 127.5, 127.5],
39-
std=[127.5, 127.5, 127.5],
40-
data_format='HWC')
35+
fake_img = Image.fromarray(fake_img)
4136
42-
fake_img = Image.fromarray((np.random.rand(300, 320, 3) * 255.).astype(np.uint8))
37+
mean = [127.5, 127.5, 127.5]
38+
std = [127.5, 127.5, 127.5]
4339
44-
fake_img = normalize(fake_img)
45-
print(fake_img.shape)
46-
# (300, 320, 3)
47-
print(fake_img.max(), fake_img.min())
40+
normalized_img = F.normalize(fake_img, mean, std, data_format='HWC')
41+
print(normalized_img.max(), normalized_img.min())
4842
# 0.99215686 -1.0
49-

0 commit comments

Comments
 (0)