torch.Tensor.Tensor.arcsin_
Tensor.arcsin_(): thisIn-place inverse sine (arcsine).
Computes the inverse sine (arcsine) of each element in-place. The input must be in the range [-1, 1] for real-valued outputs. Element-wise: y = arcsin(x) where arcsin returns values in [-π/2, π/2].
Use Cases:
- Converting normalized outputs back to angles
- Trigonometric identity computations
- Inverse transformations in signal processing
- Neural network hidden layer activations with angular meaning
- Input range: Input values must be in [-1, 1] for real output.
- Output range: Output is in [-π/2, π/2] radians.
- In-place: Modifies tensor directly, more memory efficient.
- Alias: PyTorch calls this
asin_(), this is thearcsin_()alias.
Returns
this– This tensor, modified in-placeExamples
const x = torch.tensor([0, 0.5, 1]);
x.arcsin_(); // [0, π/6, π/2] ≈ [0, 0.524, 1.571]
// Recover angles from sine values
const sineValues = torch.tensor([0, 0.707, 1]);
const angles = sineValues.clone().arcsin_(); // In radians
// Input must be in [-1, 1]
const valid = torch.tensor([-1, -0.5, 0, 0.5, 1]);
valid.arcsin_(); // Works fine
// Out of range input produces NaN
const invalid = torch.tensor([2]);
invalid.arcsin_(); // Results in NaN