ones

创建全一数组

全页折叠

语法

X = ones

X = ones(n)

X = ones(sz1,...,szN)

X = ones(sz)

X = ones(___,typename)

X = ones(___,like=p)

说明

X = ones 返回标量 1。

X = ones(n) 返回一个 n×n 的全 1 矩阵。

示例

X = ones(sz1,...,szN) 返回一个 sz1×...×szN 全一数组，其中 sz1,...,szN 指示每个维度的大小。例如，ones(2,3) 返回 2×3 全一数组。

示例

X = ones(sz) 返回一个全一数组，其中大小向量 sz 定义 size(X)。例如，ones([2,3]) 返回 2×3 全一数组。

示例

X = ones(___,typename) 在上述语法的基础上进一步指定 X 的数据类型（类）。例如，ones(5,"int8") 返回 8 位整数组成的 5×5 矩阵。

示例

X = ones(___,like=p) 指定 X 具有与数值变量 p 相同的数据类型、稀疏性和复/实性（实数或复数）。

示例

全部折叠

全一方阵

打开实时脚本

创建一个 4×4 全一数组。

X = ones(4)

X = 4×4

     1     1     1     1
     1     1     1     1
     1     1     1     1
     1     1     1     1

全一三维数组

打开实时脚本

创建一个 2×3×4 全一数组。

X = ones(2,3,4);
size(X)

ans = 1×3

     2     3     4

现有数组定义的大小

打开实时脚本

定义一个 3×2 数组 A。

A = [1 4 ; 2 5 ; 3 6];
sz = size(A)

sz = 1×2

     3     2

创建一个大小与 A 相同的全一数组。

X = ones(sz)

非默认的数值数据类型

打开实时脚本

创建一个由 1 组成的 1×3 向量，其元素为 16 位无符号整数。

X = ones(1,3,"uint16")

X = 1×3 uint16 row vector

   1   1   1

class(X)

ans = 
'uint16'

复数 1

打开实时脚本

创建一个非实数值而是与现有数组类似的复数的标量 1。

定义一个复数向量。

p = [1+2i 3i];

创建一个是类如 p 的复数的标量 1。

X = ones(like=p)

X = 
1.0000 + 0.0000i

现有数组定义的大小和数值数据类型

打开实时脚本

定义一个由 8 位无符号整数组成的 2×3 数组。

p = uint8([1 3 5; 2 4 6]);

创建一个与 p 具有相同大小和数据类型的全一数组。

X = ones(size(p),like=p)

X = 2×3 uint8 matrix

   1   1   1
   1   1   1

class(X)

ans = 
'uint8'

输入参数

全部折叠

`n` — 方阵的大小
整数值

方阵的大小，指定为整数值，将输出定义为一个方阵（即 n×n 的全 1 矩阵）。

如果 n 为 0，则 X 为一个空矩阵。
如果 n 为负数，则将其视为 0。

`sz1,...,szN` — 每个维度的大小
两个或以上的整数值

每个维度的大小，指定为两个或以上的整数值，将 X 定义为 sz1×...×szN 数组。

如果任一维度的大小为 0，则 X 为空数组。
如果任何维度的大小为负值，则其将被视为 0。
如果大于 2 的任何尾部维度的大小为 1，则输出 X 将不包括这些维度。

`sz` — 输出大小
由整数值组成的行向量

输出大小，指定为由整数组成的行向量。此向量的每个元素指示对应维度的大小。

如果任一维度的大小为 0，则 X 为空数组。
如果任何维度的大小为负值，则其将被视为 0。
如果大于 2 的任何尾部维度的大小为 1，则输出 X 将不包括这些维度。

示例: sz = [2 3 4] 将 X 定义为 2×3×4 数组。

`typename` — 输出类
`"double"` (默认) | `"single"` | `"logical"` | `"int8"` | `"uint8"` | ...

输出类，指定为 "double"、"single"、"logical"、"int8"、"uint8"、"int16"、"uint16"、"int32"、"uint32"、"int64" 或 "uint64"。

`p` — 原型
变量

原型，指定为变量。

输出参量

全部折叠

`X` — 全一数组
标量 | 向量 | 矩阵 | 多维数组

全一数组，以标量、向量、矩阵或多维数组形式返回。

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

维度必须为非负实整数。不支持空维度。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

用法说明和限制：

请参阅“C/C++ 代码生成”部分中的用法说明和限制。同样的用法说明和限制也适用于 GPU 代码生成。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

维度必须为非负实整数。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

ones 函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

ones 函数支持 GPU 数组输入，但有以下用法说明和限制：

您可以将 typename 指定为 'gpuArray'。如果将 typename 指定为 'gpuArray'，则数组的默认基础类型是 double。
要创建基础类型 datatype 的 GPU 数组，请在 typename 之前将该基础类型指定为附加参量。例如，X = ones(3,datatype,'gpuArray') 创建一个由底层类型为 datatype 的 3×3 全一 GPU 数组。
您可以将基础类型 datatype 指定为以下选项之一：
- 'double'
- 'single'
- 'logical'
- 'int8'
- 'uint8'
- 'int16'
- 'uint16'
- 'int32'
- 'uint32'
- 'int64'
- 'uint64'
您也可以将数值变量 p 指定为 gpuArray。
如果将 p 指定为 gpuArray，则返回的数组的基础类型与 p 相同。

有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

ones 函数支持分布式数组输入，但有以下用法说明和限制：

您可以将 typename 指定为 'codistributed' 或 'distributed'。如果将 typename 指定为 'codistributed' 或 'distributed'，则返回的数组的默认基础类型为 double。
要创建基础类型 datatype 的分布式或共存分布式数组，请在 typename 之前将该基础类型指定为附加参量。例如，X = ones(3,datatype,'distributed') 创建一个由基础类型 datatype 的 1 组成的 3×3 分布式矩阵。
您可以将基础类型 datatype 指定为以下选项之一：
- 'double'
- 'single'
- 'logical'
- 'int8'
- 'uint8'
- 'int16'
- 'uint16'
- 'int32'
- 'uint32'
- 'int64'
- 'uint64'
您也可以将 p 指定为 codistributed 或 distributed 数组。
如果将 p 指定为 codistributed 或 distributed 数组，则返回的数组的基础类型与 p 相同。
有关其他 codistributed 语法，请参阅 ones (codistributed) (Parallel Computing Toolbox)。

有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

另请参阅

ones

语法

说明

示例

全一方阵

全一三维数组

现有数组定义的大小

非默认的数值数据类型

复数 1

现有数组定义的大小和数值数据类型

输入参数

n — 方阵的大小 整数值

sz1,...,szN — 每个维度的大小 两个或以上的整数值

sz — 输出大小 由整数值组成的行向量

typename — 输出类 "double" (默认) | "single" | "logical" | "int8" | "uint8" | ...

p — 原型 变量

输出参量

X — 全一数组 标量 | 向量 | 矩阵 | 多维数组

扩展功能

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

另请参阅

主题

`n` — 方阵的大小
整数值

`sz1,...,szN` — 每个维度的大小
两个或以上的整数值

`sz` — 输出大小
由整数值组成的行向量

`typename` — 输出类
`"double"` (默认) | `"single"` | `"logical"` | `"int8"` | `"uint8"` | ...

`p` — 原型
变量

`X` — 全一数组
标量 | 向量 | 矩阵 | 多维数组

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。