DotTorch.Core 9.0.16

• net8.0

  • No dependencies.

• net9.0

  • No dependencies.

## Release Notes for DotTorch.Core 9.0.16

### Languages / Языки / 语言 / Sprachen

- [English](#english)
- [Русский](#русский)
- [中文](#中文)
- [Deutsch](#deutsch)

---

### English

This release introduces significant improvements in tensor shape manipulation, slicing, and broadcasting with enhanced autograd support.

**Key features:**
- Reshape/View with automatic dimension inference using `-1`.
- Explicit tensor broadcasting via `BroadcastToShape`.
- Flexible slicing API: slice by axis, multiple axes, or explicit indices.
- Improved autograd tracking with correct `GradNode` propagation.
- Backend-agnostic design preserving device, dtype, and gradient requirements.

**Usage examples:**

```csharp
// Reshape with automatic dimension inference
var x = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {4});
var y = x.Reshape(2, -1); // shape: [2, 2]

// Broadcast tensor
var a = Tensor.FromArray(new float[] {1, 2}, new[] {2});
var b = a.BroadcastToShape(new[] {2, 2});

// Slice by axis
var c = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {2, 2});
var d = c.Slice((0, 1, 1)); // slice along axis 0, start=1, length=1

// Slice by indices, returns scalar tensor
var e = c.Slice(1, 0); // returns scalar tensor with value 3
````

---

### Русский

В этом релизе реализованы важные улучшения в работе с формой тензоров, их срезами и трансляцией, с улучшенной поддержкой автодифференцирования.

**Основные изменения:**

* `Reshape`/`View` с автоматическим вычислением размера измерения при `-1`.
* Явное расширение (broadcast) тензоров через `BroadcastToShape`.
* Гибкий API для срезов: по оси, по нескольким осям, по индексам.
* Улучшенное отслеживание градиентов (`GradNode`) при операциях.
* Независимость от бекенда с сохранением устройства, типа и необходимости градиента.

**Примеры использования:**

```csharp
// Reshape с автоматическим выводом измерения
var x = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {4});
var y = x.Reshape(2, -1); // форма: [2, 2]

// Трансляция тензора
var a = Tensor.FromArray(new float[] {1, 2}, new[] {2});
var b = a.BroadcastToShape(new[] {2, 2});

// Срез по оси
var c = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {2, 2});
var d = c.Slice((0, 1, 1)); // срез по оси 0, старт=1, длина=1

// Срез по индексам, возвращает скалярный тензор
var e = c.Slice(1, 0); // возвращает скаляр со значением 3
```

---

### Deutsch

Dieses Release bringt bedeutende Verbesserungen bei der Formmanipulation von Tensoren, dem Slicing und Broadcasting mit erweiterter Unterstützung für Autograd.

**Wichtigste Neuerungen:**

* `Reshape`/`View` mit automatischer Dimensionsberechnung bei `-1`.
* Explizites Broadcasting von Tensoren via `BroadcastToShape`.
* Flexibles Slicing-API: Slice nach Achse, mehreren Achsen oder Indizes.
* Verbesserte Gradientenverfolgung (`GradNode`).
* Backend-unabhängiges Design mit Erhalt von Gerät, Datentyp und Gradientenanforderung.

**Beispiel:**

```csharp
// Reshape mit automatischer Dimensionsinferenz
var x = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {4});
var y = x.Reshape(2, -1); // Form: [2, 2]

// Tensor broadcasten
var a = Tensor.FromArray(new float[] {1, 2}, new[] {2});
var b = a.BroadcastToShape(new[] {2, 2});

// Slice nach Achse
var c = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {2, 2});
var d = c.Slice((0, 1, 1)); // Slice an Achse 0, Start=1, Länge=1

// Slice nach Indizes, gibt Skalar zurück
var e = c.Slice(1, 0); // gibt Skalar mit Wert 3 zurück
```

---

### 中文

本次发布对张量形状操作、切片及广播功能进行了重大改进，增强了自动求导（autograd）支持。

**主要更新内容：**

* 支持在 `Reshape`/`View` 中使用 `-1` 自动推断维度大小。
* 通过 `BroadcastToShape` 明确广播张量形状。
* 灵活的切片API：支持按轴、多个轴或索引切片。
* 改进了梯度跟踪机制（`GradNode`）。
* 保持后端无关，确保设备、数据类型及梯度需求一致。

**示例代码：**

```csharp
// 使用自动推断维度的重塑
var x = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {4});
var y = x.Reshape(2, -1); // 形状: [2, 2]

// 张量广播
var a = Tensor.FromArray(new float[] {1, 2}, new[] {2});
var b = a.BroadcastToShape(new[] {2, 2});

// 按轴切片
var c = Tensor.FromArray(new float[] {1, 2, 3, 4}, new[] {2, 2});
var d = c.Slice((0, 1, 1)); // 轴0上，从位置1开始，长度1的切片

// 按索引切片，返回标量张量
var e = c.Slice(1, 0); // 返回值为3的标量张量
```