1 vin.modules.normalization

vin.modules.normalization

Normalization helper functions shared by VIN modules and training setup.

This module provides integer group-count resolution for GroupNorm-backed feature grids and candidate heads.

1.1 Functions

Name	Description
largest_divisor_leq	Return the largest divisor of `n` that is less than or equal to a cap.

1.1.1 largest_divisor_leq

vin.modules.normalization.largest_divisor_leq(n, max_divisor)

Return the largest divisor of n that is less than or equal to a cap.

torch.nn.GroupNorm requires num_groups to divide num_channels exactly. VIN configs often expose an upper-bound group count for tuning, so this helper maps that requested cap to the nearest valid divisor.

1.1.1.1 Parameters

Name	Type	Description	Default
n	int	Channel dimension that must be divided by the result.	required
max_divisor	int	Maximum permitted group count.	required

1.1.1.2 Returns

Name	Type	Description
	int	Largest valid group count, always at least `1`.

# vin.modules.normalization { #aria_nbv.vin.modules.normalization }

`vin.modules.normalization`

Normalization helper functions shared by VIN modules and training setup.

This module provides integer group-count resolution for GroupNorm-backed
feature grids and candidate heads.

## Functions

| Name | Description |
| --- | --- |
| [largest_divisor_leq](#aria_nbv.vin.modules.normalization.largest_divisor_leq) | Return the largest divisor of ``n`` that is less than or equal to a cap. |

### largest_divisor_leq { #aria_nbv.vin.modules.normalization.largest_divisor_leq }

```python
vin.modules.normalization.largest_divisor_leq(n, max_divisor)
```

Return the largest divisor of ``n`` that is less than or equal to a cap.

`torch.nn.GroupNorm` requires ``num_groups`` to divide ``num_channels``
exactly. VIN configs often expose an upper-bound group count for tuning, so
this helper maps that requested cap to the nearest valid divisor.

#### Parameters {.doc-section .doc-section-parameters}

| Name        | Type         | Description                                           | Default    |
|-------------|--------------|-------------------------------------------------------|------------|
| n           | [int](`int`) | Channel dimension that must be divided by the result. | _required_ |
| max_divisor | [int](`int`) | Maximum permitted group count.                        | _required_ |

#### Returns {.doc-section .doc-section-returns}

| Name   | Type         | Description                                       |
|--------|--------------|---------------------------------------------------|
|        | [int](`int`) | Largest valid group count, always at least ``1``. |