numpy.ma.max#

ma.max(obj, axis=None, out=None, fill_value=None, keepdims=<no value>)[source]#

沿著給定軸回傳最大值。

參數:
axisNone 或 int 或 int 元組,選用

要沿著操作的軸。預設情況下,axis 為 None,並使用展平的輸入。如果這是 int 元組,則會在多個軸上選取最大值,而不是像以前一樣在單個軸或所有軸上選取最大值。

outarray_like,選用

在其中放置結果的替代輸出陣列。必須與預期的輸出具有相同的形狀和緩衝區長度。

fill_value純量或 None,選用

用於填入遮罩值的值。如果為 None,則使用 maximum_fill_value() 的輸出。

keepdimsbool,選用

如果設定為 True,則縮減的軸將保留在結果中,作為大小為 1 的維度。使用此選項,結果將針對陣列正確廣播。

回傳值:
amaxarray_like

保存結果的新陣列。如果指定了 out,則回傳 out

參見

ma.maximum_fill_value

回傳給定資料類型的最大填充值。

範例

>>> import numpy.ma as ma
>>> x = [[-1., 2.5], [4., -2.], [3., 0.]]
>>> mask = [[0, 0], [1, 0], [1, 0]]
>>> masked_x = ma.masked_array(x, mask)
>>> masked_x
masked_array(
  data=[[-1.0, 2.5],
        [--, -2.0],
        [--, 0.0]],
  mask=[[False, False],
        [ True, False],
        [ True, False]],
  fill_value=1e+20)
>>> ma.max(masked_x)
2.5
>>> ma.max(masked_x, axis=0)
masked_array(data=[-1.0, 2.5],
             mask=[False, False],
       fill_value=1e+20)
>>> ma.max(masked_x, axis=1, keepdims=True)
masked_array(
  data=[[2.5],
        [-2.0],
        [0.0]],
  mask=[[False],
        [False],
        [False]],
  fill_value=1e+20)
>>> mask = [[1, 1], [1, 1], [1, 1]]
>>> masked_x = ma.masked_array(x, mask)
>>> ma.max(masked_x, axis=1)
masked_array(data=[--, --, --],
             mask=[ True,  True,  True],
       fill_value=1e+20,
            dtype=float64)