| .. role:: hidden |
| :class: hidden-section |
| |
| torch.nn |
| =================================== |
| |
| .. automodule:: torch.nn |
| .. currentmodule:: torch.nn |
| |
| Parameters |
| ---------- |
| |
| .. autoclass:: Parameter |
| :members: |
| |
| Containers |
| ---------------------------------- |
| |
| :hidden:`Module` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Module |
| :members: |
| |
| :hidden:`Sequential` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Sequential |
| :members: |
| |
| :hidden:`ModuleList` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: ModuleList |
| :members: |
| |
| :hidden:`ParameterList` |
| ~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: ParameterList |
| :members: |
| |
| Convolution Layers |
| ---------------------------------- |
| |
| :hidden:`Conv1d` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Conv1d |
| :members: |
| |
| :hidden:`Conv2d` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Conv2d |
| :members: |
| |
| :hidden:`Conv3d` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Conv3d |
| :members: |
| |
| :hidden:`ConvTranspose1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: ConvTranspose1d |
| :members: |
| |
| :hidden:`ConvTranspose2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| |
| .. autoclass:: ConvTranspose2d |
| :members: |
| |
| :hidden:`ConvTranspose3d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: ConvTranspose3d |
| :members: |
| |
| |
| Pooling Layers |
| ---------------------------------- |
| |
| :hidden:`MaxPool1d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MaxPool1d |
| :members: |
| |
| :hidden:`MaxPool2d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MaxPool2d |
| :members: |
| |
| :hidden:`MaxPool3d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MaxPool3d |
| :members: |
| |
| :hidden:`MaxUnpool1d` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MaxUnpool1d |
| :members: |
| |
| :hidden:`MaxUnpool2d` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MaxUnpool2d |
| :members: |
| |
| :hidden:`MaxUnpool3d` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MaxUnpool3d |
| :members: |
| |
| :hidden:`AvgPool1d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AvgPool1d |
| :members: |
| |
| :hidden:`AvgPool2d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AvgPool2d |
| :members: |
| |
| :hidden:`AvgPool3d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AvgPool3d |
| :members: |
| |
| :hidden:`FractionalMaxPool2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: FractionalMaxPool2d |
| :members: |
| |
| :hidden:`LPPool2d` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: LPPool2d |
| :members: |
| |
| :hidden:`AdaptiveMaxPool1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AdaptiveMaxPool1d |
| :members: |
| |
| :hidden:`AdaptiveMaxPool2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AdaptiveMaxPool2d |
| :members: |
| |
| :hidden:`AdaptiveAvgPool1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AdaptiveAvgPool1d |
| :members: |
| |
| :hidden:`AdaptiveAvgPool2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: AdaptiveAvgPool2d |
| :members: |
| |
| |
| Non-linear Activations |
| ---------------------------------- |
| |
| :hidden:`ReLU` |
| ~~~~~~~~~~~~~~ |
| |
| .. autoclass:: ReLU |
| :members: |
| |
| :hidden:`ReLU6` |
| ~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: ReLU6 |
| :members: |
| |
| :hidden:`ELU` |
| ~~~~~~~~~~~~~ |
| |
| .. autoclass:: ELU |
| :members: |
| |
| :hidden:`PReLU` |
| ~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: PReLU |
| :members: |
| |
| :hidden:`LeakyReLU` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: LeakyReLU |
| :members: |
| |
| :hidden:`Threshold` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Threshold |
| :members: |
| |
| :hidden:`Hardtanh` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Hardtanh |
| :members: |
| |
| :hidden:`Sigmoid` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Sigmoid |
| :members: |
| |
| :hidden:`Tanh` |
| ~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Tanh |
| :members: |
| |
| :hidden:`LogSigmoid` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: LogSigmoid |
| :members: |
| |
| :hidden:`Softplus` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Softplus |
| :members: |
| |
| :hidden:`Softshrink` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Softshrink |
| :members: |
| |
| :hidden:`Softsign` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Softsign |
| :members: |
| |
| :hidden:`Tanhshrink` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Tanhshrink |
| :members: |
| |
| :hidden:`Softmin` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Softmin |
| :members: |
| |
| :hidden:`Softmax` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Softmax |
| :members: |
| |
| :hidden:`LogSoftmax` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: LogSoftmax |
| :members: |
| |
| |
| Normalization layers |
| ---------------------------------- |
| |
| :hidden:`BatchNorm1d` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: BatchNorm1d |
| :members: |
| |
| :hidden:`BatchNorm2d` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: BatchNorm2d |
| :members: |
| |
| :hidden:`BatchNorm3d` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: BatchNorm3d |
| :members: |
| |
| :hidden:`InstanceNorm1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: InstanceNorm1d |
| :members: |
| |
| :hidden:`InstanceNorm2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: InstanceNorm2d |
| :members: |
| |
| :hidden:`InstanceNorm3d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: InstanceNorm3d |
| :members: |
| |
| Recurrent layers |
| ---------------------------------- |
| |
| :hidden:`RNN` |
| ~~~~~~~~~~~~~ |
| |
| .. autoclass:: RNN |
| :members: |
| |
| :hidden:`LSTM` |
| ~~~~~~~~~~~~~~ |
| |
| .. autoclass:: LSTM |
| :members: |
| |
| :hidden:`GRU` |
| ~~~~~~~~~~~~~ |
| |
| .. autoclass:: GRU |
| :members: |
| |
| :hidden:`RNNCell` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: RNNCell |
| :members: |
| |
| :hidden:`LSTMCell` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: LSTMCell |
| :members: |
| |
| :hidden:`GRUCell` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: GRUCell |
| :members: |
| |
| Linear layers |
| ---------------------------------- |
| |
| :hidden:`Linear` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Linear |
| :members: |
| |
| |
| Dropout layers |
| ---------------------------------- |
| |
| :hidden:`Dropout` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Dropout |
| :members: |
| |
| :hidden:`Dropout2d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Dropout2d |
| :members: |
| |
| :hidden:`Dropout3d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Dropout3d |
| :members: |
| |
| |
| Sparse layers |
| ---------------------------------- |
| |
| :hidden:`Embedding` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: Embedding |
| :members: |
| |
| Distance functions |
| ---------------------------------- |
| |
| :hidden:`PairwiseDistance` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: PairwiseDistance |
| :members: |
| |
| |
| Loss functions |
| ---------------------------------- |
| |
| :hidden:`L1Loss` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: L1Loss |
| :members: |
| |
| :hidden:`MSELoss` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MSELoss |
| :members: |
| |
| :hidden:`CrossEntropyLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: CrossEntropyLoss |
| :members: |
| |
| :hidden:`NLLLoss` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: NLLLoss |
| :members: |
| |
| :hidden:`NLLLoss2d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: NLLLoss2d |
| :members: |
| |
| :hidden:`KLDivLoss` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: KLDivLoss |
| :members: |
| |
| :hidden:`BCELoss` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: BCELoss |
| :members: |
| |
| :hidden:`MarginRankingLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MarginRankingLoss |
| :members: |
| |
| :hidden:`HingeEmbeddingLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: HingeEmbeddingLoss |
| :members: |
| |
| :hidden:`MultiLabelMarginLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MultiLabelMarginLoss |
| :members: |
| |
| :hidden:`SmoothL1Loss` |
| ~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: SmoothL1Loss |
| :members: |
| |
| :hidden:`SoftMarginLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: SoftMarginLoss |
| :members: |
| |
| :hidden:`MultiLabelSoftMarginLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MultiLabelSoftMarginLoss |
| :members: |
| |
| :hidden:`CosineEmbeddingLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: CosineEmbeddingLoss |
| :members: |
| |
| :hidden:`MultiMarginLoss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: MultiMarginLoss |
| :members: |
| |
| |
| Vision layers |
| ---------------- |
| |
| :hidden:`PixelShuffle` |
| ~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: PixelShuffle |
| :members: |
| |
| :hidden:`UpsamplingNearest2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: UpsamplingNearest2d |
| :members: |
| |
| :hidden:`UpsamplingBilinear2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: UpsamplingBilinear2d |
| :members: |
| |
| |
| Multi-GPU layers |
| ---------------- |
| |
| :hidden:`DataParallel` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autoclass:: DataParallel |
| :members: |
| |
| |
| Utilities |
| --------- |
| |
| :hidden:`clip_grad_norm` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: torch.nn.utils.clip_grad_norm |
| |
| |
| .. currentmodule:: torch.nn.utils.rnn |
| |
| :hidden:`PackedSequence` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: torch.nn.utils.rnn.PackedSequence |
| |
| |
| :hidden:`pack_padded_sequence` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: torch.nn.utils.rnn.pack_padded_sequence |
| |
| |
| :hidden:`pad_packed_sequence` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: torch.nn.utils.rnn.pad_packed_sequence |
| |
| |
| torch.nn.functional |
| =================== |
| |
| .. currentmodule:: torch.nn.functional |
| |
| Convolution functions |
| ---------------------------------- |
| |
| :hidden:`conv1d` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: conv1d |
| |
| :hidden:`conv2d` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: conv2d |
| |
| :hidden:`conv3d` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: conv3d |
| |
| :hidden:`conv_transpose1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: conv_transpose1d |
| |
| :hidden:`conv_transpose2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: conv_transpose2d |
| |
| :hidden:`conv_transpose3d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: conv_transpose3d |
| |
| Pooling functions |
| ---------------------------------- |
| |
| :hidden:`avg_pool1d` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: avg_pool1d |
| |
| :hidden:`avg_pool2d` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: avg_pool2d |
| |
| :hidden:`avg_pool3d` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: avg_pool3d |
| |
| :hidden:`max_pool1d` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: max_pool1d |
| |
| :hidden:`max_pool2d` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: max_pool2d |
| |
| :hidden:`max_pool3d` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: max_pool3d |
| |
| :hidden:`max_unpool1d` |
| ~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: max_unpool1d |
| |
| :hidden:`max_unpool2d` |
| ~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: max_unpool2d |
| |
| :hidden:`max_unpool3d` |
| ~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: max_unpool3d |
| |
| :hidden:`lp_pool2d` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: lp_pool2d |
| |
| :hidden:`adaptive_max_pool1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: adaptive_max_pool1d |
| |
| :hidden:`adaptive_max_pool2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: adaptive_max_pool2d |
| |
| :hidden:`adaptive_avg_pool1d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: adaptive_avg_pool1d |
| |
| :hidden:`adaptive_avg_pool2d` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: adaptive_avg_pool2d |
| |
| |
| Non-linear activation functions |
| ------------------------------- |
| |
| :hidden:`threshold` |
| ~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: threshold |
| |
| |
| :hidden:`relu` |
| ~~~~~~~~~~~~~~ |
| |
| .. autofunction:: relu |
| |
| :hidden:`hardtanh` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: hardtanh |
| |
| :hidden:`relu6` |
| ~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: relu6 |
| |
| :hidden:`elu` |
| ~~~~~~~~~~~~~ |
| |
| .. autofunction:: elu |
| |
| :hidden:`leaky_relu` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: leaky_relu |
| |
| :hidden:`prelu` |
| ~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: prelu |
| |
| :hidden:`rrelu` |
| ~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: rrelu |
| |
| :hidden:`logsigmoid` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: logsigmoid |
| |
| :hidden:`hardshrink` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: hardshrink |
| |
| :hidden:`tanhshrink` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: tanhshrink |
| |
| :hidden:`softsign` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: softsign |
| |
| :hidden:`softplus` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: softplus |
| |
| :hidden:`softmin` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: softmin |
| |
| :hidden:`softmax` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: softmax |
| |
| :hidden:`softshrink` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: softshrink |
| |
| :hidden:`log_softmax` |
| ~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: log_softmax |
| |
| :hidden:`tanh` |
| ~~~~~~~~~~~~~~ |
| |
| .. autofunction:: tanh |
| |
| :hidden:`sigmoid` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: sigmoid |
| |
| Normalization functions |
| ----------------------- |
| |
| :hidden:`batch_norm` |
| ~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: batch_norm |
| |
| Linear functions |
| ---------------- |
| |
| :hidden:`linear` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: linear |
| |
| Dropout functions |
| ----------------- |
| |
| :hidden:`dropout` |
| ~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: dropout |
| |
| Distance functions |
| ---------------------------------- |
| |
| :hidden:`pairwise_distance` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: pairwise_distance |
| |
| |
| Loss functions |
| -------------- |
| |
| :hidden:`nll_loss` |
| ~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: nll_loss |
| |
| |
| :hidden:`kl_div` |
| ~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: kl_div |
| |
| :hidden:`cross_entropy` |
| ~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: cross_entropy |
| |
| :hidden:`binary_cross_entropy` |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: binary_cross_entropy |
| |
| :hidden:`smooth_l1_loss` |
| ~~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: smooth_l1_loss |
| |
| Vision functions |
| ---------------- |
| |
| :hidden:`pixel_shuffle` |
| ~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: pixel_shuffle |
| |
| :hidden:`pad` |
| ~~~~~~~~~~~~~~~~~~~~~~~ |
| |
| .. autofunction:: pad |
| |
| torch.nn.init |
| ============= |
| |
| .. currentmodule:: torch.nn.init |
| .. autofunction:: calculate_gain |
| .. autofunction:: uniform |
| .. autofunction:: normal |
| .. autofunction:: constant |
| .. autofunction:: eye |
| .. autofunction:: dirac |
| .. autofunction:: xavier_uniform |
| .. autofunction:: xavier_normal |
| .. autofunction:: kaiming_uniform |
| .. autofunction:: kaiming_normal |
| .. autofunction:: orthogonal |
| .. autofunction:: sparse |