ones

Erstellen eines ausschließlich aus Einsen bestehenden Arrays

Syntax

X = ones

X = ones(n)

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

X = ones(sz)

X = ones(___,typename)

X = ones(___,like=p)

Beschreibung

X = ones gibt den Skalar 1 zurück.

X = ones(n) gibt eine nxn-Matrix aus Einsen zurück.

X = ones(sz1,...,szN) gibt ein sz1x...xszN-Array aus Einsen zurück, wobei sz1,...,szN die Größe der jeweiligen Dimension angibt. Beispielsweise gibt ones(2,3) eine 2x3-Matrix aus Einsen zurück.

X = ones(sz) gibt ein Array aus Einsen zurück, bei dem der Größenvektor sz size(X) definiert. Beispielsweise gibt ones([2,3]) eine 2x3-Matrix aus Einsen zurück.

X = ones(___,typename) gibt zudem den Datentyp (Klasse) von X für die vorherigen Syntaxen zurück. Beispielsweise gibt ones(5,"int8") eine 5x5-Matrix aus 8-Bit-Ganzzahlen zurück.

X = ones(___,like=p) gibt an, dass X denselben Datentyp, dieselbe dünne Besetzung und dieselbe Komplexität (reell oder komplex) wie die numerische Variable p aufweist.

Beispiele

Quadratisches Array aus Einsen

Erstellen Sie ein 4x4-Array aus Einsen.

X = ones(4)

X = 4×4

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

3-D-Array aus Einsen

Erstellen Sie ein 2x3x4-Array aus Einsen.

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

ans = 1×3

     2     3     4

Größe definiert durch bestehendes Array

Definieren Sie ein 3x2-Array A.

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

sz = 1×2

     3     2

Erstellen Sie ein Array aus Einsen, das dieselbe Größe wie A aufweist.

X = ones(sz)

X = 3×2

     1     1
     1     1
     1     1

Numerischer Nichtstandard-Datentyp

Erstellen Sie einen 1x3-Vektor aus Einsen, dessen Elemente vorzeichenlose 16-Bit-Ganzzahlen sind.

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

X = 1×3 uint16 row vector

   1   1   1

class(X)

ans = 
'uint16'

Komplexe Eins

Erstellen Sie eine skalare 1, die keine reellen Werte aufweist, sondern stattdessen komplex wie ein bestehendes Array ist.

Definieren Sie einen komplexen Vektor.

p = [1+2i 3i];

Erstellen Sie eine skalare 1, die genauso komplex ist wie p.

X = ones(like=p)

X = 
1.0000 + 0.0000i

Größe und numerischer Datentyp durch bestehendes Array definiert

Definieren Sie ein 2x3-Array vorzeichenloser 8-Bit-Ganzzahlen.

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

Erstellen Sie ein Array aus Einsen, das dieselbe Größe und denselben Datentyp wie p aufweist.

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

X = 2×3 uint8 matrix

   1   1   1
   1   1   1

class(X)

ans = 
'uint8'

Eingabeargumente

n — Größe der quadratischen Matrix

ganzzahliger Wert

Die Größe der quadratischen Matrix, angegeben als ganzzahliger Wert, definiert die Ausgabe als quadratische nxn-Matrix aus Einsen.

• Wenn n 0 ist, dann ist X eine leere Matrix.

• Wenn n negativ ist, wird der Wert wie 0 behandelt.

Datentypen: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Größe der jeweiligen Dimension

Zwei oder mehr Ganzzahlwerte

Die Größe der jeweiligen Dimension, angegeben als zwei oder mehr Ganzzahlwerte, definiert X als ein sz1x...xszN-Array.

• Wenn die Größe einer beliebigen Dimension 0 ist, dann ist X ein leeres Array.

• Wenn die Größe einer beliebigen Dimension negativ ist, wird der Wert wie 0 behandelt.

• Wenn nachgeordnete Dimensionen größer als 2 eine Größe von 1 aufweisen, umfasst die Ausgabe X diese Dimensionen nicht.

Datentypen: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Ausgabegröße

Zeilenvektor aus Ganzzahlwerten

Ausgabegröße, angegeben als Zeilenvektor aus Ganzzahlwerten. Jedes Element dieses Vektors gibt die Größe der entsprechenden Dimension an.

• Wenn die Größe einer beliebigen Dimension 0 ist, dann ist X ein leeres Array.

• Wenn die Größe einer beliebigen Dimension negativ ist, wird der Wert wie 0 behandelt.

• Wenn nachgeordnete Dimensionen größer als 2 eine Größe von 1 aufweisen, umfasst die Ausgabe X diese Dimensionen nicht.

Beispiel: sz = [2 3 4] definiert X als 2x3x4-Array.

Datentypen: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Ausgabeklasse

"double" (Standardeinstellung) | "single" | "logical" | "int8" | "uint8" | ...

Ausgabeklasse, angegeben als "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" oder "uint64".

p — Prototyp

Variable

Prototyp, angegeben als Variable.

Datentypen: double | single | logical | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Unterstützung komplexer Zahlen: Ja

Ausgabeargumente

X — Array aus Einsen

Skalar | Vektor | Matrix | mehrdimensionales Array

Array aus Einsen, zurückgegeben als Skalar, Vektor, Matrix oder mehrdimensionales Array.

Erweiterte Fähigkeiten

C/C++ Codegenerierung

Generieren Sie C und C++ Code mit MATLAB® Coder™.

Hinweise zur Verwendung und Einschränkungen:

• Die Dimensionen müssen reelle nichtnegative Ganzzahlen sein. Leere Dimensionen werden nicht unterstützt.

GPU-Codegenerierung

Generieren von CUDA® Code für NVIDIA® Grafikprozessoren mit dem GPU Coder™.

Hinweise zur Verwendung und Einschränkungen:

Siehe die Verwendungshinweise und Einschränkungen im Abschnitt zur C/C++ Codegenerierung. Dieselben Einschränkungen gelten für die Grafikkarten-Codegenerierung.

HDL-Codegenerierung

Generieren von VHDL, Verilog und SystemVerilog Code für FPGA- und ASIC-Designs mit HDL Coder™.

Die Dimensionen müssen reelle nichtnegative Ganzzahlen sein.

Thread-Based Environment

Führen Sie mithilfe von MATLAB® backgroundPool den Code im Hintergrund aus oder machen Sie den Code mit der Parallel Computing Toolbox™ ThreadPool schneller.

Diese Funktion bietet vollständige Unterstützung für thread-basierte Umgebungen. Weitere Informationen finden Sie unter Run MATLAB Functions in Thread-Based Environment.

GPU-Arrays

Schnellere Codeausführung durch Ausführen auf einer Grafikkarte (GPU) mit der Parallel Computing Toolbox™.

Die Funktion ones unterstützt GPU-Array-Eingaben mit folgenden Verwendungshinweisen und Einschränkungen:

• Sie können typename als 'gpuArray' angeben. Wenn Sie typename als 'gpuArray' angeben, ist der standardmäßig zugrunde liegende Typ des Arrays double.

  Zum Erstellen eines Grafikkarten-Arrays mit dem zugrunde liegenden Typ datatype geben Sie den zugrunde liegenden Typ als zusätzliches Argument vor typename an. Beispielsweise erstellt X = ones(3,datatype,'gpuArray') ein 3x3-Grafikkarten-Array aus Einsen mit dem zugrunde liegenden Typ datatype.

  Sie können den zugrunde liegenden Typ datatype als eine der folgenden Optionen angeben:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• Sie können auch die numerische Variable p als gpuArray angeben.

  Wenn Sie p als gpuArray angeben, ist der zugrunde liegende Typ des zurückgegebenen Arrays identisch mit p.

Weitere Informationen finden Sie unter Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Verteilte Arrays

Partitionieren von großen Arrays über den kombinierten Speicher Ihres Clusters mit Parallel Computing Toolbox™.

Hinweise zur Verwendung und Einschränkungen:

• Sie können typename als 'codistributed' oder 'distributed' angeben. Wenn Sie typename als 'codistributed' oder 'distributed' angeben, ist der standardmäßig zugrunde liegende Typ des zurückgegebenen Arrays double.

  Zum Erstellen eines verteilten oder mitverteilten Arrays mit dem zugrunde liegenden Typ datatype geben Sie den zugrunde liegenden Typ als zusätzliches Argument vor typename an. Beispielsweise erstellt X = ones(3,datatype,'distributed') eine verteilte 3x3-Matrix aus Einsen mit dem zugrunde liegenden Typ datatype.

  Sie können den zugrunde liegenden Typ datatype als eine der folgenden Optionen angeben:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• Sie können auch p als mitverteiltes (codistributed) oder verteiltes (distributed) Array angeben.

  Wenn Sie p als mitverteiltes (codistributed) oder verteiltes (distributed) Array angeben, ist der zugrunde liegende Typ des zurückgegebenen Arrays identisch mit p.

• Weitere mitverteilte (codistributed) Syntaxen finden Sie unter ones (codistributed) (Parallel Computing Toolbox).

Weitere Informationen finden Sie unter Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt vor R2006a

Siehe auch

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

Themen

• Class Support for Array-Creation Functions
• Vorabzuordnung