Doc update

1 files changed, 369 insertions, 14 deletions

diff --git a/doc/source/reference/routines.ma.rst b/doc/source/reference/routines.ma.rst
index 425abf112..ce3f14e42 100644
--- a/doc/source/reference/routines.ma.rst
+++ b/doc/source/reference/routines.ma.rst
@@ -5,48 +5,403 @@ Masked array operations
 
 .. currentmodule:: numpy
 
+
+Constants
+=========
+
+.. autosummary::
+   :toctree: generated/
+   
+   ma.masked
+   ma.nomask
+   
+   ma.MaskType
+
+
 Creation
---------
+========
+
+From existing data
+~~~~~~~~~~~~~~~~~~
 
 .. autosummary::
    :toctree: generated/
 
    ma.masked_array
+   ma.array
+   ma.copy
+   ma.frombuffer
+   ma.fromfunction
+
+   ma.MaskedArray.copy
 
-Converting to ndarray
----------------------
+
+Ones and zeros
+~~~~~~~~~~~~~~
 
 .. autosummary::
    :toctree: generated/
+   
+   ma.empty
+   ma.empty_like
+   ma.masked_all
+   ma.masked_all_like
+   ma.ones
+   ma.zeros
 
-   ma.filled
-   ma.common_fill_value
-   ma.default_fill_value
-   ma.masked_array.get_fill_value
-   ma.maximum_fill_value
-   ma.minimum_fill_value
+
+_____
 
 Inspecting the array
---------------------
+====================
 
 .. autosummary::
    :toctree: generated/
 
+   ma.all
+   ma.any
+   ma.count
+   ma.count_masked
    ma.getmask
    ma.getmaskarray
    ma.getdata
-   ma.count_masked
+   ma.nonzero
+   ma.shape
+   ma.size
+   
+   ma.MaskedArray.data
+   ma.MaskedArray.mask
+   ma.MaskedArray.recordmask
+   
+   ma.MaskedArray.all
+   ma.MaskedArray.any
+   ma.MaskedArray.count
+   ma.MaskedArray.nonzero
+   ma.shape
+   ma.size
+
+
+_____
+
+Manipulating a MaskedArray
+==========================
+
+Changing the shape
+~~~~~~~~~~~~~~~~~~
+
+.. autosummary::
+   :toctree: generated/
+   
+   ma.ravel
+   ma.reshape
+   ma.resize
+
+   ma.MaskedArray.flatten
+   ma.MaskedArray.ravel
+   ma.MaskedArray.reshape
+   ma.MaskedArray.resize
+
+
+Modifying axes
+~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+   
+   ma.swapaxes
+   ma.transpose
+   
+   ma.MaskedArray.swapaxes
+   ma.MaskedArray.transpose
+
+
+Changing the number of dimensions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+   
+   ma.atleast_1d
+   ma.atleast_2d
+   ma.atleast_3d
+   ma.expand_dims
+   ma.squeeze
 
-Modifying the mask
-------------------
+   ma.MaskedArray.squeeze
+   
+   ma.column_stack
+   ma.concatenate
+   ma.dstack
+   ma.hstack
+   ma.hsplit
+   ma.mr_
+   ma.row_stack
+   ma.vstack
 
+
+Joining arrays
+~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.column_stack 
+   ma.concatenate 
+   ma.dstack 
+   ma.hstack 
+   ma.vstack
+
+
+_____
+
+Operations on masks
+===================
+
+Creating a mask
+~~~~~~~~~~~~~~~
 .. autosummary::
    :toctree: generated/
 
    ma.make_mask
+   ma.make_mask_none
+   ma.mask_or
+   ma.make_mask_descr
+
+
+Accessing a mask
+~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.getmask
+   ma.getmaskarray
+   ma.masked_array.mask
+
+
+Finding masked data
+~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.flatnotmasked_contiguous
+   ma.flatnotmasked_edges
+   ma.notmasked_contiguous
+   ma.notmasked_edges
+
+
+Modifying a mask
+~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
    ma.mask_cols
    ma.mask_or
    ma.mask_rowcols
    ma.mask_rows
    ma.harden_mask
-   ma.ids
+   ma.soften_mask
+   
+   ma.MaskedArray.harden_mask
+   ma.MaskedArray.soften_mask
+   ma.MaskedArray.shrink_mask
+   ma.MaskedArray.unshare_mask
+
+
+_____
+
+Conversion operations
+======================
+
+> to a masked array
+~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.asarray
+   ma.asanyarray
+   ma.fix_invalid
+   ma.masked_equal
+   ma.masked_greater
+   ma.masked_greater_equal
+   ma.masked_inside
+   ma.masked_invalid
+   ma.masked_less
+   ma.masked_less_equal
+   ma.masked_not_equal
+   ma.masked_object
+   ma.masked_outside
+   ma.masked_values
+   ma.masked_where
+
+
+> to a ndarray
+~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.compress_cols
+   ma.compress_rowcols
+   ma.compress_rows
+   ma.compressed
+   ma.filled
+   
+   ma.MaskedArray.compressed
+   ma.MaskedArray.filled
+
+
+> to another object
+~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+   
+   ma.MaskedArray.tofile
+   ma.MaskedArray.tolist
+   ma.MaskedArray.torecords
+   ma.MaskedArray.tostring
+
+
+Pickling and unpickling
+~~~~~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+   
+   ma.dump
+   ma.dumps
+   ma.load
+   ma.loads
+
+
+Filling a masked array
+~~~~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.common_fill_value
+   ma.default_fill_value
+   ma.maximum_fill_value
+   ma.maximum_fill_value
+   ma.set_fill_value
+   
+   ma.MaskedArray.get_fill_value
+   ma.MaskedArray.set_fill_value
+   ma.MaskedArray.fill_value
+
+
+_____
+
+Masked arrays arithmetics
+=========================
+
+Arithmetics
+~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+   
+   ma.anom
+   ma.anomalies
+   ma.average
+   ma.conjugate
+   ma.corrcoef
+   ma.cov
+   ma.cumsum
+   ma.cumprod
+   ma.mean
+   ma.median
+   ma.power
+   ma.prod
+   ma.std
+   ma.sum
+   ma.var
+   
+   ma.MaskedArray.anom
+   ma.MaskedArray.cumprod
+   ma.MaskedArray.cumsum
+   ma.MaskedArray.mean
+   ma.MaskedArray.prod
+   ma.MaskedArray.std
+   ma.MaskedArray.sum
+   ma.MaskedArray.var
+
+
+Minimum/maximum
+~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.argmax
+   ma.argmin
+   ma.max
+   ma.min
+   ma.ptp
+
+   ma.MaskedArray.argmax
+   ma.MaskedArray.argmin
+   ma.MaskedArray.max
+   ma.MaskedArray.min
+   ma.MaskedArray.ptp
+
+
+Sorting
+~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.argsort
+   ma.sort
+   ma.MaskedArray.argsort
+   ma.MaskedArray.sort
+
+
+Algebra
+~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.diag
+   ma.dot
+   ma.identity
+   ma.inner
+   ma.innerproduct
+   ma.outer
+   ma.outerproduct
+   ma.trace
+   ma.transpose
+
+   ma.MaskedArray.trace
+   ma.MaskedArray.transpose
+
+
+Polynomial fit
+~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+   
+   ma.vander
+   ma.polyfit
+
+
+Clipping and rounding
+~~~~~~~~~~~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.around
+   ma.clip
+   ma.round
+
+   ma.MaskedArray.clip
+   ma.MaskedArray.round
+
+
+Miscellanea
+~~~~~~~~~~~
+.. autosummary::
+   :toctree: generated/
+
+   ma.allequal
+   ma.allclose
+   ma.apply_along_axis
+   ma.arange
+   ma.choose
+   ma.ediff1d
+   ma.indices
+   ma.where
+
+