sign

Vorzeichenfunktion (Signumfunktion)

Syntax

sign(x)

Beschreibung

Y = sign(x) gibt ein Array Y mit derselben Größe wie x zurück, wobei jedes Element von Y einen der folgenden Werte aufweist:

• 1, wenn das entsprechende Element von x größer als 0 ist.

• 0, wenn das entsprechende Element von x gleich 0 ist.

• -1, wenn das entsprechende Element von x kleiner als 0 ist.

• x./abs(x), wenn x komplex ist.

Beispiele

Ermitteln der Vorzeichenfunktion

Ermitteln Sie die Vorzeichenfunktion einer Zahl.

sign(2)

ans = 
1

Ermitteln Sie die Vorzeichenfunktion der Werte eines Vektors.

V = [-11 0 1.5 Inf NaN];
sign(V)

ans = 1×5

    -1     0     1     1   NaN

Ermitteln Sie die Vorzeichenfunktion der Werte einer Matrix.

M = magic(3) - 5;
sign(M)

ans = 3×3

     1    -1     1
    -1     0     1
    -1     1    -1

Ermitteln Sie die Vorzeichenfunktion einer komplexen Zahl.

z = 4 - 3*i;
sign(z)

ans = 
0.8000 - 0.6000i

Plotten der Vorzeichenfunktion

Plotten Sie die Vorzeichenfunktion und zeigen Sie ihr Verhalten beim Nulldurchgang. Verwenden Sie eps zur Darstellung von Werten knapp über und unter 0.

x = [-5 -eps(1) 0 eps(1) 5];
y = sign(x);
plot(x,y)
ylim([-2 2])
grid on

Plotten der Real- und Imaginärteile einer Vorzeichenfunktion

Plotten Sie die Real- und Imaginärteile der Vorzeichenfunktion im Bereich $$-3<x<-3$$ und $$-3<y<3$$.

Erstellen Sie zunächst mithilfe von meshgrid ein Netz von Werten für -3 < x < 3 und -3 < y < 3. Erstellen Sie dann mithilfe von z = x + 1i*y aus diesen Werten komplexe Zahlen.

v = -3:0.1:3;
[x, y] = meshgrid(v);
z = x + 1i*y;

Plotten Sie die Real- und Imaginärteile der Vorzeichenfunktion von z.

s = sign(z);
re = real(s);
im = imag(s);

Plotten Sie die Real- und Imaginärteile.

surf(x,y,re)
title('Real part of sign function')
xlabel('x')
ylabel('y')

figure(2)
surf(x,y,im)
title('Imaginary part of sign function')
xlabel('x')
ylabel('y')

Eingabeargumente

x — Eingabe

Skalar | Vektor | Matrix | mehrdimensionales Array

Eingabe, angegeben als Skalar, Vektor, Matrix oder mehrdimensionales Array.

Wenn ein Element von x NaN ist, gibt sign im entsprechenden Element der Ausgabe NaN zurück.

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

Erweiterte Fähigkeiten

Tall Arrays

Rechnen mit Arrays, die mehr Zeilen haben, als in den Speicher passen.

Die Funktion sign bietet vollständige Unterstützung für Tall-Arrays. Weitere Informationen finden Sie unter Tall-Arrays.

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

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

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.

Die Funktion sign 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 sign bietet vollständige Unterstützung für Grafikkarten-Arrays. Zum Ausführen der Funktion auf einer Grafikkarte geben Sie die Eingabedaten als gpuArray (Parallel Computing Toolbox) an. 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™.

Die Funktion sign bietet vollständige Unterstützung für verteilte Arrays. Weitere Informationen finden Sie unter Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt vor R2006a

Siehe auch

abs | conj | imag | real