parameters: (m, axis=None, out=None)
docstring: r"""
      flip(m, axis=None, out=None)
  
      Reverse the order of elements in an array along the given axis.
  
      The shape of the array is preserved, but the elements are reordered.
  
      Parameters
      ----------
      m : ndarray or scalar
          Input array.
      axis : None or int or tuple of ints, optional
          Axis or axes along which to flip over. The default,
          axis=None, will flip over all of the axes of the input array.
          If axis is negative it counts from the last to the first axis.
  
          If axis is a tuple of ints, flipping is performed on all of the axes
          specified in the tuple.
      out : ndarray or scalar, optional
          Alternative output array in which to place the result. It must have
          the same shape and type as the expected output.
  
      Returns
      -------
      out : ndarray or scalar
          A view of `m` with the entries of axis reversed.  Since a view is
          returned, this operation is done in constant time.
  
      Examples
      --------
      >>> A = np.arange(8).reshape((2,2,2))
      >>> A
      array([[[0, 1],
              [2, 3]],
             [[4, 5],
              [6, 7]]])
      >>> np.flip(A, 0)
      array([[[4, 5],
              [6, 7]],
             [[0, 1],
              [2, 3]]])
      >>> np.flip(A, 1)
      array([[[2, 3],
              [0, 1]],
             [[6, 7],
              [4, 5]]])
      >>> np.flip(A)
      array([[[7, 6],
              [5, 4]],
             [[3, 2],
              [1, 0]]])
      >>> np.flip(A, (0, 2))
      array([[[5, 4],
              [7, 6]],
             [[1, 0],
              [3, 2]]])
docstring_summary: r"""
      flip(m, axis=None, out=None)
docstring_tokens: r flip ( m axis = None out = None )
function: def flip(m, axis=None, out=None):
      r"""
      flip(m, axis=None, out=None)
  
      Reverse the order of elements in an array along the given axis.
  
      The shape of the array is preserved, but the elements are reordered.
  
      Parameters
      ----------
      m : ndarray or scalar
          Input array.
      axis : None or int or tuple of ints, optional
          Axis or axes along which to flip over. The default,
          axis=None, will flip over all of the axes of the input array.
          If axis is negative it counts from the last to the first axis.
  
          If axis is a tuple of ints, flipping is performed on all of the axes
          specified in the tuple.
      out : ndarray or scalar, optional
          Alternative output array in which to place the result. It must have
          the same shape and type as the expected output.
  
      Returns
      -------
      out : ndarray or scalar
          A view of `m` with the entries of axis reversed.  Since a view is
          returned, this operation is done in constant time.
  
      Examples
      --------
      >>> A = np.arange(8).reshape((2,2,2))
      >>> A
      array([[[0, 1],
              [2, 3]],
             [[4, 5],
              [6, 7]]])
      >>> np.flip(A, 0)
      array([[[4, 5],
              [6, 7]],
             [[0, 1],
              [2, 3]]])
      >>> np.flip(A, 1)
      array([[[2, 3],
              [0, 1]],
             [[6, 7],
              [4, 5]]])
      >>> np.flip(A)
      array([[[7, 6],
              [5, 4]],
             [[3, 2],
              [1, 0]]])
      >>> np.flip(A, (0, 2))
      array([[[5, 4],
              [7, 6]],
             [[1, 0],
              [3, 2]]])
      """
      from ...numpy import ndarray
      if isinstance(m, numeric_types):
          return _np.flip(m, axis)
      elif isinstance(m, ndarray):
          return _api_internal.flip(m, axis, out)
      else:
          raise TypeError('type {} not supported'.format(str(type(m))))
function_tokens: def flip ( m , axis = None , out = None ) : from . . . numpy import ndarray if isinstance ( m , numeric_types ) : return _np . flip ( m , axis ) elif isinstance ( m , ndarray ) : return _api_internal . flip ( m , axis , out ) else : raise TypeError ( 'type {} not supported' . format ( str ( type ( m ) ) ) )