Full (constant)
Shippingarray_fullnumpy-style array filled with one constant value; shape rank picks the variant
Signature
Outputs
arrayArray— An array with every element equal to Fill value. Rank picks Vector / Matrix / Tensor.
Parameters
| Key | Type | Default | Notes |
|---|---|---|---|
shape | text | 3, 3 | Target shape as comma-separated dimensions (numpy-style): '5' → Vector, '3, 4' → Matrix, '2, 3, 4' → Tensor. The rank picks the output type. |
value | float | 0.0 | The constant every element is set to. |
unit | text | Optional physical unit. Applied only when the result is 1-D (a Vector); Matrix/Tensor results are dimensionless in the data model and drop it — re-attach downstream with Set Unit. |
Description
Full is numpy.full: a pure source that fills an array of the requested Shape with a single Fill value. Zeros and Ones are the special cases and ; Full generalizes them to any constant.
The shape rank picks the output variant (rank 1 → Vector, 2 → Matrix, ≥ 3 → Tensor), and the Unit attaches only on a 1-D result. Because the whole array shares one value, Full is the cheapest way to make a constant grid — an initial condition, an offset field, or a saturation ceiling to clip against.
Mathematics
Examples
A constant field
Set Shape = 4, 4 and Fill value = -1. The output is a 4×4 Matrix every entry of which is .
A saturation ceiling
Make a Shape = 256, Fill value = 5.0 vector to use as an upper clip bound aligned to a 256-sample buffer.
Applications
- A uniform initial condition or bias field for a simulation grid.
- A constant threshold / ceiling array aligned to a signal's length.
- Filling a placeholder to be partially overwritten downstream.
Neat
`Full` is the primitive: `Zeros`/`Ones` reuse its `array_factory::filled` implementation with the fill value hard-wired to 0.0/1.0.
Known issues
Unit kept only on rank-1 (Vector) results.
Element count capped at 100,000,000.