nn.functional.nll_loss¶

lucid.nn.functional.nll_loss(input_: Tensor, target: Tensor, weight: Tensor | None = None, reduction: Literal['mean', 'sum'] | None = 'mean') → Tensor¶

The nll_loss function computes the negative log-likelihood loss for multi-class classification tasks.

Function Signature¶

def nll_loss(
    input_: Tensor,
    target: Tensor,
    weight: Tensor | None = None,
    reduction: _ReductionType | None = "mean",
) -> Tensor

Parameters¶

input_ (Tensor):
The input tensor of shape (N, C), where N is the batch size and C is the number of classes.
target (Tensor):
The target tensor of shape (N,) containing class indices in the range [0, C-1].
weight (Tensor | None, optional):
A manual rescaling weight tensor of shape (C,). Default: None.
reduction (str | None, optional):
Specifies the reduction to apply: ‘mean’, ‘sum’, or ‘none’. Default: ‘mean’.

Returns¶

Tensor:
The computed NLL loss as a scalar or tensor, depending on the reduction method.

Examples¶

>>> import lucid.nn.functional as F
>>> input_ = Tensor([[2.0, 1.0, 0.1]])
>>> target = Tensor([0])
>>> loss = F.nll_loss(input_, target)
>>> print(loss)
Tensor(...)  # Scalar loss value