> For the complete documentation index, see [llms.txt](https://codalin.gitbook.io/nodalin-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codalin.gitbook.io/nodalin-docs/nodes-reference/tools/field.md). # Field


	Converts any figure into a spatial data field that other nodes can read from. Connect a shape as the input and plug the Field's output into a numeric property — the value each shape receives will depend on where it sits in space relative to the field.

{% hint style="success" %} Think of Field as a "value map" stretched across the canvas. Bright areas of the input shape produce the **max** value; dark or transparent areas produce the **min** value. Every shape that samples the field gets a different value based on its position. {% endhint %} **Two modes depending on where you connect it:** * **Connected to a shape property** (e.g. radius, x, rotation) — each shape in an instancing group samples the field at its own position on the canvas, so every instance gets a unique value. This is the main use case. * **Connected with a Point node on the `sample` input** — the field is read at that single fixed point and outputs one number, which you can route anywhere a number is accepted.

Property name	Description	Compatible datatype
input	The figure to use as the field source. Its luminance (brightness) defines the field values across the canvas.	figure
min	The value output when the field reads 0 (dark / transparent area). In pixels for size and position; degrees for rotation.	number
max	The value output when the field reads 1 (bright area). In pixels for size and position; degrees for rotation.	number
sample	Optional. Override the sampling point with a Point node. When connected, the Field outputs a single number instead of a per-instance spatial value.	point

### Example Projects [Know Your Flow Fields](https://app.nodalin.xyz/u/nodalin/know-your-flow-fields-6e85bb)\ Simple boilerplate setup to work with a Field node

[Field - Sampling Point](https://app.nodalin.xyz/u/nodalin/field-sampling-point-012d46)\ This example demonstrates how we can use a Point node to define the sampling coordinates for a Field. \ \ [2.5D Field Wave](https://app.nodalin.xyz/u/nodalin/25d-field-wave-92b5a6)\ The Field node is used to drive the zoom property of a 3D Rotate node, amongst the entire group of instances. {% hint style="info" %} Notice that in the examples above, the Signal node is on bypass to hide it from the final rendering — you may turn its visibility on by selecting

Signal and click on the

toggle. {% endhint %}