scipy.ndimage.

zoom#

scipy.ndimage.zoom(input, zoom, output=None, order=3, mode='constant', cval=0.0, prefilter=True, *, grid_mode=False)[Quelle]#

Ein Array zoomen.

Das Array wird mittels Spline-Interpolation der angeforderten Ordnung gezoomt.

Parameter:

inputarray_like

Das Eingabearray.

zoomfloat oder Sequenz

Der Zoomfaktor entlang der Achsen. Wenn es sich um einen Float-Wert handelt, ist zoom für jede Achse gleich. Wenn es sich um eine Sequenz handelt, sollte zoom einen Wert für jede Achse enthalten.

outputarray oder dtype, optional

Das Array, in das die Ausgabe platziert werden soll, oder der Datentyp des zurückgegebenen Arrays. Standardmäßig wird ein Array mit demselben Datentyp wie input erstellt.

orderint, optional

Die Ordnung der Spline-Interpolation, Standard ist 3. Die Ordnung muss im Bereich 0-5 liegen.

mode{‘reflect’, ‘grid-mirror’, ‘constant’, ‘grid-constant’, ‘nearest’, ‘mirror’, ‘grid-wrap’, ‘wrap’}, optional

Der Parameter mode bestimmt, wie das Eingabearray über seine Grenzen hinaus erweitert wird. Standard ist ‘constant’. Das Verhalten für jeden gültigen Wert ist wie folgt (weitere Plots und Details zu Randmodi)

‘reflect’ (d c b a | a b c d | d c b a): Die Eingabe wird erweitert, indem über den Rand des letzten Pixels gespiegelt wird. Dieser Modus wird auch manchmal als halb-Sample-symmetrisch bezeichnet.
‘grid-mirror’: Dies ist ein Synonym für ‘reflect’.
‘constant’ (k k k k | a b c d | k k k k): Die Eingabe wird erweitert, indem alle Werte außerhalb des Rands mit demselben konstanten Wert gefüllt werden, der durch den Parameter cval definiert ist. Außerhalb der Grenzen der Eingabe wird keine Interpolation durchgeführt.
‘grid-constant’ (k k k k | a b c d | k k k k): Die Eingabe wird erweitert, indem alle Werte außerhalb des Rands mit demselben konstanten Wert gefüllt werden, der durch den Parameter cval definiert ist. Die Interpolation erfolgt auch für Abtastpunkte außerhalb des Umfangs der Eingabe.
‘nearest’ (a a a a | a b c d | d d d d): Die Eingabe wird erweitert, indem das letzte Pixel wiederholt wird.
‘mirror’ (d c b | a b c d | c b a): Die Eingabe wird erweitert, indem über die Mitte des letzten Pixels gespiegelt wird. Dieser Modus wird auch manchmal als ganz-Sample-symmetrisch bezeichnet.
‘grid-wrap’ (a b c d | a b c d | a b c d): Die Eingabe wird erweitert, indem zum gegenüberliegenden Rand umgebrochen wird.
‘wrap’ (d b c d | a b c d | b c a b): Die Eingabe wird durch Umwickeln zum gegenüberliegenden Rand erweitert, jedoch so, dass der letzte und der erste Punkt genau übereinanderliegen. In diesem Fall ist nicht eindeutig definiert, welcher Abtastpunkt am Überlappungspunkt gewählt wird.

cvalskalar, optional

Wert, mit dem die Ränder der Eingabe gefüllt werden, wenn mode ‘constant’ ist. Standard ist 0.0.

prefilterbool, optional

Bestimmt, ob das Eingabearray vor der Interpolation mit spline_filter vorfiltert wird. Der Standardwert ist True, was ein temporäres Array mit float64 gefilterten Werten erstellt, wenn order > 1. Wenn dieser Wert auf False gesetzt wird, ist die Ausgabe leicht unscharf, wenn order > 1, es sei denn, die Eingabe wird vorfiltert, d.h. sie ist das Ergebnis des Aufrufs von spline_filter auf die ursprüngliche Eingabe.

grid_modebool, optional

Wenn False, wird der Abstand von den Mittelpunkten der Pixel gezoomt. Andernfalls wird der Abstand unter Einbeziehung der vollen Pixel-Erstreckung verwendet. Zum Beispiel wird ein 1D-Signal der Länge 5 als Länge 4 betrachtet, wenn grid_mode False ist, aber als Länge 5, wenn grid_mode True ist. Sehen Sie sich die folgende visuelle Veranschaulichung an

| pixel 1 | pixel 2 | pixel 3 | pixel 4 | pixel 5 |
     |<-------------------------------------->|
                        vs.
|<----------------------------------------------->|

Der Startpunkt des Pfeils im obigen Diagramm entspricht der Koordinatenlage 0 in jedem Modus.

Rückgabe:

zoomndarray: Die gezoomte Eingabe.

Hinweise

Bei komplexwertigen Eingaben zoomt diese Funktion die reellen und imaginären Komponenten unabhängig voneinander.

Hinzugefügt in Version 1.6.0: Unterstützung für komplexe Werte hinzugefügt.

Beispiele

>>> from scipy import ndimage, datasets
>>> import matplotlib.pyplot as plt

>>> fig = plt.figure()
>>> ax1 = fig.add_subplot(121)  # left side
>>> ax2 = fig.add_subplot(122)  # right side
>>> ascent = datasets.ascent()
>>> result = ndimage.zoom(ascent, 3.0)
>>> ax1.imshow(ascent, vmin=0, vmax=255)
>>> ax2.imshow(result, vmin=0, vmax=255)
>>> plt.show()

../../_images/scipy-ndimage-zoom-1_00_00.png

>>> print(ascent.shape)
(512, 512)

>>> print(result.shape)
(1536, 1536)