pydata · hameerabbasi · May 15, 2018 · May 9, 2018 · May 9, 2018 · May 13, 2018
diff --git a/docs/construct.rst b/docs/construct.rst
@@ -14,12 +14,12 @@ matrix:
 
 .. code-block:: python
 
-   import sparse
+   >>> import sparse
 
-   coords = [[0, 1, 2, 3, 4],
-             [0, 1, 2, 3, 4]]
-   data = [10, 20, 30, 40, 50]
-   s = sparse.COO(coords, data)
+   >>> coords = [[0, 1, 2, 3, 4],
+   ...           [0, 1, 2, 3, 4]]
+   >>> data = [10, 20, 30, 40, 50]
+   >>> s = sparse.COO(coords, data, shape=(5, 5))
 
    >>> s.todense()
    array([[10,  0,  0,  0,  0],
@@ -28,13 +28,25 @@ matrix:
           [ 0,  0,  0, 40,  0],
           [ 0,  0,  0,  0, 50]])
 
-
 In general :code:`coords` should be a :code:`(ndim, nnz)` shaped
 array. Each row of :code:`coords` contains one dimension of the
 desired sparse array, and each column contains the index
 corresponding to that nonzero element. :code:`data` contains
 the nonzero elements of the array corresponding to the indices
-in :code:`coords`. Its shape should be :code:`(nnz,)`
+in :code:`coords`. Its shape should be :code:`(nnz,)`.
+
+If ``data`` is the same across all the coordinates, it can be passed
+in as a scalar. For example, the following produces the :math:`4 \times 4`
+identity matrix:
+
+.. code-block:: python
+
+   >>> import sparse
+
+   >>> coords = [[0, 1, 2, 3],
+   ...           [0, 1, 2, 3]]
+   >>> data = 1
+   >>> s = sparse.COO(coords, data, shape=(4, 4))
 
 You can, and should, pass in :obj:`numpy.ndarray` objects for
 :code:`coords` and :code:`data`.

diff --git a/docs/generated/sparse.COO.asformat.rst b/docs/generated/sparse.COO.asformat.rst
@@ -0,0 +1,6 @@
+COO.asformat
+============
+
+.. currentmodule:: sparse
+
+.. automethod:: COO.asformat
diff --git a/docs/generated/sparse.COO.from_iter.rst b/docs/generated/sparse.COO.from_iter.rst
@@ -0,0 +1,6 @@
+COO.from\_iter
+==============
+
+.. currentmodule:: sparse
+
+.. automethod:: COO.from_iter
diff --git a/docs/generated/sparse.COO.rst b/docs/generated/sparse.COO.rst
@@ -24,6 +24,7 @@ COO
    .. autosummary::
       :toctree:
 
+      COO.from_iter
       COO.from_numpy
       COO.from_scipy_sparse
 
@@ -48,6 +49,7 @@ COO
    .. autosummary::
       :toctree:
 
+      COO.asformat
       COO.todense
       COO.maybe_densify
       COO.to_scipy_sparse

diff --git a/docs/generated/sparse.DOK.asformat.rst b/docs/generated/sparse.DOK.asformat.rst
@@ -0,0 +1,6 @@
+DOK.asformat
+============
+
+.. currentmodule:: sparse
+
+.. automethod:: DOK.asformat
diff --git a/docs/generated/sparse.DOK.rst b/docs/generated/sparse.DOK.rst
@@ -31,6 +31,8 @@ DOK
    .. rubric:: Methods
    .. autosummary::
       :toctree:
+
+      DOK.asformat
 
       DOK.from_coo
 

diff --git a/docs/generated/sparse.SparseArray.asformat.rst b/docs/generated/sparse.SparseArray.asformat.rst
@@ -0,0 +1,6 @@
+SparseArray.asformat
+====================
+
+.. currentmodule:: sparse
+
+.. automethod:: SparseArray.asformat
diff --git a/docs/generated/sparse.SparseArray.rst b/docs/generated/sparse.SparseArray.rst
@@ -14,3 +14,9 @@ SparseArray
       SparseArray.nnz
       SparseArray.size
 
+   .. rubric:: Methods
+   .. autosummary::
+      :toctree:
+
+      SparseArray.asformat
+
diff --git a/docs/generated/sparse.as_coo.rst b/docs/generated/sparse.as_coo.rst
@@ -0,0 +1,6 @@
+as\_coo
+=======
+
+.. currentmodule:: sparse
+
+.. autofunction:: as_coo
diff --git a/docs/generated/sparse.rst b/docs/generated/sparse.rst
@@ -23,6 +23,8 @@ API
 .. autosummary::
     :toctree:
 
+    as_coo
+
     concatenate
 
     dot

diff --git a/sparse/coo/__init__.py b/sparse/coo/__init__.py
@@ -1,4 +1,4 @@
-from .core import COO
+from .core import COO, as_coo
 from .umath import elemwise
 from .common import tensordot, dot, concatenate, stack, triu, tril, where, \
     nansum, nanprod, nanmin, nanmax, nanreduce