scipy.spatial.distance.

is_valid_y#

scipy.spatial.distance.is_valid_y(y, warning=False, throw=False, name=None)[Quellcode]#

Gibt True zurück, wenn das Eingabearray eine gültige kondensierte Distanzmatrix ist.

Kondensierte Distanzmatrizen müssen 1-dimensionale Numpy-Arrays sein. Ihre Länge muss ein Binomialkoeffizient \({n \choose 2}\) für eine positive ganze Zahl n sein.

Parameter:
yarray_like

Die kondensierte Distanzmatrix.

warningbool, optional

Löst eine Warnung aus, wenn die übergebene Variable keine gültige kondensierte Distanzmatrix ist. Die Warnmeldung erklärt, warum die Distanzmatrix nicht gültig ist. name wird verwendet, wenn auf die fehlerhafte Variable verwiesen wird.

throwbool, optional

Wirft eine Ausnahme, wenn die übergebene Variable keine gültige kondensierte Distanzmatrix ist.

namestr, optional

Wird verwendet, wenn in der Warn- oder Fehlermeldung auf die fehlerhafte Variable verwiesen wird.

Rückgabe:
bool

True, wenn das Eingabearray eine gültige kondensierte Distanzmatrix ist, sonst False.

Beispiele

>>> from scipy.spatial.distance import is_valid_y

Dieser Vektor ist eine gültige kondensierte Distanzmatrix. Die Länge ist 6, was n = 4 entspricht, da 4*(4 - 1)/2 gleich 6 ist.

>>> v = [1.0, 1.2, 1.0, 0.5, 1.3, 0.9]
>>> is_valid_y(v)
True

Ein Eingabevektor mit der Länge, sagen wir, 7 ist keine gültige kondensierte Distanzmatrix.

>>> is_valid_y([1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7])
False