[Numpy-svn] r5623 - trunk/numpy/lib
numpy-svn@scip...
numpy-svn@scip...
Thu Aug 7 23:58:34 CDT 2008
Author: jarrod.millman
Date: 2008-08-07 23:58:32 -0500 (Thu, 07 Aug 2008)
New Revision: 5623
Modified:
trunk/numpy/lib/function_base.py
Log:
breaking API for median
Modified: trunk/numpy/lib/function_base.py
===================================================================
--- trunk/numpy/lib/function_base.py 2008-08-08 04:33:45 UTC (rev 5622)
+++ trunk/numpy/lib/function_base.py 2008-08-08 04:58:32 UTC (rev 5623)
@@ -2459,22 +2459,19 @@
b.sort(0)
return b
-def median(a, axis=0, out=None, overwrite_input=False):
+def median(a, axis=None, out=None, overwrite_input=False):
"""
Compute the median along the specified axis.
- Returns the median of the array elements. The median is taken
- over the first axis of the array by default, otherwise over
- the specified axis.
+ Returns the median of the array elements.
Parameters
----------
a : array_like
Input array or object that can be converted to an array.
- axis : {int, None}, optional
- Axis along which the medians are computed. The default is to
- compute the median along the first dimension. If `axis` is
- set to None, return the median of the flattened array.
+ axis : {None, int}, optional
+ Axis along which the medians are computed. The default (axis=None) is to
+ compute the median along a flattened version of the array.
out : ndarray, optional
Alternative output array in which to place the result. It must
have the same shape and buffer length as the expected output,
@@ -2515,14 +2512,14 @@
array([[10, 7, 4],
[ 3, 2, 1]])
>>> np.median(a)
- array([ 6.5, 4.5, 2.5])
- >>> np.median(a, axis=None)
3.5
+ >>> np.median(a, axis=0)
+ array([ 6.5, 4.5, 2.5])
>>> np.median(a, axis=1)
array([ 7., 2.])
- >>> m = np.median(a)
+ >>> m = np.median(a, axis=0)
>>> out = np.zeros_like(m)
- >>> np.median(a, out=m)
+ >>> np.median(a, axis=0, out=m)
array([ 6.5, 4.5, 2.5])
>>> m
array([ 6.5, 4.5, 2.5])
More information about the Numpy-svn
mailing list