ones

Créer un tableau avec uniquement des uns

Syntaxe

X = ones

X = ones(n)

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

X = ones(sz)

X = ones(___,typename)

X = ones(___,like=p)

Description

X = ones renvoie le scalaire 1.

X = ones(n) renvoie une matrice de uns de dimension n x n.

X = ones(sz1,...,szN) renvoie un tableau de uns de dimension sz1 x … x szN où sz1,...,szN indique la taille de chaque dimension. Par exemple, ones(2,3) renvoie un tableau de uns de 2 x 3.

X = ones(sz) renvoie un tableau de uns où le vecteur de taille sz définit size(X). Par exemple, ones([2,3]) renvoie un tableau de uns de 2 x 3.

X = ones(___,typename) spécifie également le type de données (la classe) de X pour n’importe laquelle des syntaxes précédentes. Par exemple, ones(5,"int8") renvoie une matrice 5 x 5 de nombres entiers de 8 bits.

X = ones(___,like=p) spécifie que X a les mêmes type de données, parcimonie et complexité (réelle ou complexe) que la variable numérique p.

Exemples

Tableau carré de uns

Créez un tableau de uns de dimension 4 x 4.

X = ones(4)

X = 4×4

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

Tableau 3D de uns

Créez un tableau de uns de dimension 2 x 3 x 4.

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

ans = 1×3

     2     3     4

Taille définie par le tableau existant

Définissez un tableau A de dimension 3 x 2.

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

sz = 1×2

     3     2

Créez un tableau de uns de la même taille que A.

X = ones(sz)

X = 3×2

     1     1
     1     1
     1     1

Type de données numérique autre que celui par défaut

Créez un vecteur de uns de dimension 1 x 3 dont les éléments sont des nombres entiers non signés de 16 bits.

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

X = 1×3 uint16 row vector

   1   1   1

class(X)

ans = 
'uint16'

Un complexe

Créez un scalaire 1 qui n’est pas une valeur réelle mais qui est complexe comme un tableau existant.

Définissez un vecteur complexe.

p = [1+2i 3i];

Créez un scalaire 1 complexe comme p.

X = ones(like=p)

X = 
1.0000 + 0.0000i

Taille et type de données numérique définis par un tableau existant

Définissez un tableau 2 x 3 de nombres entiers non signés de 8 bits.

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

Créez un tableau de uns de la même taille et du même type de données que p.

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

X = 2×3 uint8 matrix

   1   1   1
   1   1   1

class(X)

ans = 
'uint8'

Arguments d'entrée

n — Taille de la matrice carrée

valeur entière

Taille de la matrice carrée, spécifiée sous forme d’une valeur entière. Définit la sortie comme une matrice carrée de uns de dimension n x n.

• Si n est égal à 0, alors X est une matrice vide.

• Si n est négatif, il est traité comme 0.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Taille de chaque dimension

deux valeurs entières ou plus

Taille de chaque dimension, spécifiée sous forme de deux valeurs entières ou plus. Définit X comme un tableau de dimension sz1 x … x szN.

• Si la taille d’une dimension est égale à 0, alors X est un tableau vide.

• Si la taille d’une dimension est négative, elle est traitée comme une taille égale à 0.

• Si les dimensions suivantes supérieures à 2 sont de taille 1, la sortie X ne les inclut pas.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Taille de la sortie

vecteur ligne de valeurs entières

Taille de la sortie, spécifiée sous forme d’un vecteur ligne de valeurs entières. Chaque élément de ce vecteur indique la taille de la dimension correspondante.

• Si la taille d’une dimension est égale à 0, alors X est un tableau vide.

• Si la taille d’une dimension est négative, elle est traitée comme une taille égale à 0.

• Si les dimensions suivantes supérieures à 2 sont de taille 1, la sortie X ne les inclut pas.

Exemple : sz = [2 3 4] définit X comme un tableau de dimension 2 x 3 x 4.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Classe en sortie

"double" (par défaut) | "single" | "logical" | "int8" | "uint8" | ...

Classe en sortie, spécifiée comme "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" ou "uint64".

p — Prototype

variable

Prototype, spécifié sous forme de variable.

Types de données : double | single | logical | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Support des nombres complexes : Oui

Arguments de sortie

X — Tableau de uns

scalaire | vecteur | matrice | tableau multidimensionnel

Tableau de uns, renvoyé sous forme de scalaire, de vecteur, de matrice ou de tableau multidimensionnel.

Capacités étendues

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• Les dimensions doivent être des nombres entiers réels non négatifs. Les dimensions vides ne sont pas supportées.

Génération de code GPU

Générez du code CUDA® pour les GPU NVIDIA® avec GPU Coder™.

Notes d’usage et limitations :

Consultez les notes d’usage et limitations à la section « Génération de code C/C++ ». Les mêmes limitations s’appliquent à la génération de code GPU.

Génération de code HDL

Générez du code VHDL, Verilog et SystemVerilog pour les designs FPGA et ASIC avec HLD Coder™.

Les dimensions doivent être des nombres entiers réels non négatifs.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction ones supporte les GPU arrays avec les notes d’usage et limitations suivantes :

• Vous pouvez spécifier typename en tant que 'gpuArray'. Si vous spécifiez typename en tant que 'gpuArray', le type sous-jacent par défaut du tableau est double.

  Pour créer un GPU array dont le type sous-jacent est datatype, spécifiez le type sous-jacent en tant qu’argument supplémentaire avant typename. Par exemple, X = ones(3,datatype,'gpuArray') crée un GPU array de uns de dimension 3 x 3 dont le type sous-jacent est datatype.

  Vous pouvez spécifier le datatype de type sous-jacent selon les options suivantes :

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• Vous pouvez également spécifier la variable numérique p en tant que gpuArray.

  Si vous spécifiez p en tant que gpuArray, le type sous-jacent du tableau renvoyé est le même que p.

Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

Notes d’usage et limitations :

• Vous pouvez spécifier typename en tant que 'codistributed' ou 'distributed'. Si vous spécifiez typename en tant que 'codistributed' ou 'distributed', le type sous-jacent par défaut du tableau retourné est double.

  Pour créer un tableau distribué (distributed array) ou codistribué (codistributed array) avec le type sous-jacent datatype, spécifiez le type sous-jacent en tant qu’argument supplémentaire avant typename. Par exemple, X = ones(3,datatype,'distributed') crée une matrice distribuée de uns de dimension 3 x 3 avec le type sous-jacent datatype.

  Vous pouvez spécifier le datatype de type sous-jacent selon les options suivantes :

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• Vous pouvez également spécifier p en tant que tableau codistributed ou distributed.

  Si vous spécifiez p en tant que tableau codistributed ou distributed, le type sous-jacent du tableau renvoyé est le même que p.

• Pour voir d’autres syntaxes codistributed, consultez ones (codistributed) (Parallel Computing Toolbox).

Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

Voir aussi

eye | zeros | rand | randn | createArray | complex | false | size

Rubriques

• Class Support for Array-Creation Functions
• Préallocation