kou commented on code in PR #45160:
URL: https://github.com/apache/arrow/pull/45160#discussion_r1902258321
##########
docs/source/python/api/tables.rst:
##########
@@ -59,7 +59,92 @@ Dataframe Interchange Protocol
Tensors
-------
+PyArrow supports both dense and sparse tensors. Dense tensors store all data
values explicitly, while sparse tensors represent only the non-zero elements
and their locations, making them efficient for storage and computation.
+
+Dense Tensors
+-------------
+
.. autosummary::
:toctree: ../generated/
Tensor
+
+Sparse Tensors
+--------------
+
+PyArrow supports the following sparse tensor formats:
+
+.. autosummary::
+ :toctree: ../generated/
+
+ SparseCOOTensor
+ SparseCSRMatrix
+ SparseCSCMatrix
+ SparseCSFTensor
+
+### SparseCOOTensor
Review Comment:
Could you use `"""..."?
BTW, we may should split tensor documentations to a separated file to avoid
too deep section...
##########
docs/source/python/api/tables.rst:
##########
@@ -59,7 +59,92 @@ Dataframe Interchange Protocol
Tensors
-------
+PyArrow supports both dense and sparse tensors. Dense tensors store all data
values explicitly, while sparse tensors represent only the non-zero elements
and their locations, making them efficient for storage and computation.
+
+Dense Tensors
+-------------
Review Comment:
Could you use `^^^...`?
See also:
https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#sections
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
