# soft_cross_entropy#

composer.loss.soft_cross_entropy(input, target, weight=None, size_average=None, ignore_index=- 100, reduce=None, reduction='mean')[source]#

Drop-in replacement for cross_entropy that handles class indices or one-hot labels.

Note

This function will be obsolete with this update.

Parameters
• input (Tensor) – $$(N, C)$$ where C = number of classes or $$(N, C, H, W)$$ in case of 2D Loss, or $$(N, C, d_1, d_2, ..., d_K)$$ where $$K \geq 1$$ in the case of K-dimensional loss. input is expected to contain unnormalized scores (often referred to as logits).

• target (Tensor) – If containing class indices, shape $$(N)$$ where each value is $$0 \leq \text{targets}[i] \leq C-1$$, or $$(N, d_1, d_2, ..., d_K)$$ with $$K \geq 1$$ in the case of K-dimensional loss. If containing class probabilities, same shape as the input.

• weight (Tensor, optional) – a manual rescaling weight given to each class. If given, has to be a Tensor of size C. Default: None.

• size_average (bool, optional) – Deprecated (see reduction). By default, the losses are averaged over each loss element in the batch. Note that for some losses, there multiple elements per sample. If the field size_average is set to False, the losses are instead summed for each minibatch. Ignored when reduce is False. Default: True

• ignore_index (int, optional) – Specifies a target value that is ignored and does not contribute to the input gradient. When size_average is True, the loss is averaged over non-ignored targets. Note that ignore_index is only applicable when the target contains class indices. Default: -100

• reduce (bool, optional) – Deprecated (see reduction). By default, the losses are averaged or summed over observations for each minibatch depending on size_average. When reduce is False, returns a loss per batch element instead and ignores size_average. Default: True

• reduction (str, optional) – Specifies the reduction to apply to the output: 'none' | 'mean' | 'sum'. 'none': no reduction will be applied, 'mean': the sum of the output will be divided by the number of elements in the output, 'sum': the output will be summed. Note: size_average and reduce are in the process of being deprecated, and in the meantime, specifying either of those two args will override reduction. Default: 'mean'