Changeset f7838fc

Timestamp:

Jan 2, 2019, 11:07:16 PM (5 years ago)

Author:

Paul Brossier <piem@piem.org>

Branches:

feature/cnn_org, feature/crepe_org

Children:

2fec649

Parents:

1343aca

Message:

[tensor] add some documentation

File:

• src/ai/tensor.h (modified) (1 diff)

src/ai/tensor.h

@@ -49 +49 @@
 } aubio_tensor_t;
 
+/** create a new tensor
+
+  \param ndim   number of dimensions
+  \param shape  array of dimensions
+
+  \return new ::aubio_tensor_t
+
+*/
 aubio_tensor_t *new_aubio_tensor(uint_t ndim, uint_t *shape);
 
+/** destroy a tensor
+
+  \param c  tensor to destroy
+
+*/
 void del_aubio_tensor(aubio_tensor_t *c);
 
+/** view tensor as a vector
+
+  \param c  tensor to view as ::fvec_t
+  \param o  pointer to use to store view
+
+  \return 0 on success, non-zero otherwise
+
+*/
 uint_t aubio_tensor_as_fvec(aubio_tensor_t *c, fvec_t *o);
+
+/** view vector as a tensor
+
+  \param o  ::fvec_t to view as a tensor
+  \param c  pointer to use to store view
+
+  \return 0 on success, non-zero otherwise
+
+*/
 uint_t aubio_fvec_as_tensor(fvec_t *o, aubio_tensor_t *c);
 
+/** view tensor as a matrix
+
+  \param c  tensor to view as ::fmat_t
+  \param o  pointer to use to store view
+
+  \return 0 on success, non-zero otherwise
+
+*/
 uint_t aubio_tensor_as_fmat(aubio_tensor_t *c, fmat_t *o);
+
+/** view matrix as a tensor
+
+  \param o  ::fmat_t to view as a tensor
+  \param c  pointer to use to store view
+
+  \return 0 on success, non-zero otherwise
+
+*/
 uint_t aubio_fmat_as_tensor(fmat_t *o, aubio_tensor_t *c);
 
+/** view i-th row of tensor t as a tensor
+
+  \param t tensor to get maximum from
+  \param i index of row to retrieve
+  \param st subtensor to fill in
+
+  \return 0 on success, non-zero otherwise
+*/
 uint_t aubio_tensor_get_subtensor(aubio_tensor_t *t, uint_t i,
         aubio_tensor_t *st);
 
+/** find the maximum value of a tensor
+
+  \param t tensor to get maximum from
+
+  \return maximum value of all elements in tensor
+*/
 smpl_t aubio_tensor_max(aubio_tensor_t *t);
 
+/** check if sizes of 2 tensor match
+
+  \param t  first tensor to check size with
+  \param s  second tensor to check size with
+
+  \return 1 if tensors have the same size, 0 otherwise
+*/
 uint_t aubio_tensor_have_same_size(aubio_tensor_t *t, aubio_tensor_t *s);
 
+/** print the content of a tensor
+
+  \param t  tensor to print
+
+ */
 void aubio_tensor_print(aubio_tensor_t *t);
 
+/** get a string representing the dimensions of this tensor
+
+  \param t  tensor to get shape string from
+
+  \return string of characters containing the dimensions of t
+*/
 const char_t *aubio_tensor_get_shape_string(aubio_tensor_t *t);