Parameter Array

Updated: 15 Jun 2026

Method #

This node takes a Float Array as an input, and uses it to set the values of other nodes inside of Notch as defined by a .json file. The JSON file must be imported as a resource into your project.

The Parameter Array node can be connected to any other Notch node by connecting it’s output to the Parameter Value Array input of the node you want to control.

To reveal this pin on your target node, hold Ctrl and double click on the node.

Practically, there are two main uses/advantages to using this node:

• Setting multiple parameters on one node with one connection. This allows you to have much simpler node graphs, and work quicker when setting up many similar properties. This is really useful when you are setting up many instances of a similar control system.

• Receiving many parameters from an external tool or another software and applying them in many places in your project with less node graph connections.

Setup #

This node can receive a float array from several sources:

• Float Array
• OSC Float Array
• CSV Float Array
• Values To Float Array

These will provide an array of floats, which will then be used to set the values of your custom parameters node. How the parameters are set will be defined by the JSON file that you select in the node’s properties.

Specifications of the JSON file that is applied in the Parameter Array node #

The JSON file is responsible for mapping the values of the incoming float array to the node that it is connected to (via the Parameter Value Array input). The JSON file must be composed in this manner:

• The file contains all of the parameters inside of a single root object key, “parameters”
• Within this sits an array of parameter objects, each of which can contain the following fields:

  Field	Type	Description
  name	String	Human-readable label for the parameter. This must match the property name as it is displayed inside of the node’s property editor.
  index	Integer	Zero-based position/ID that determines which element of the input array will be mapped to the associated parameter.
  scale	Float	Multiplier applied to the parameter’s value
  offset	Float	Value added after scaling

JSON Example - Setting values on a lighting node #

The JSON file will allow you to define the name and index of the parameter, and apply a scale and an offset to the numerical value that are coming in via the array. When you connect this node to the Parameter Value Array input of another node, the properties that have names that match the names in your json file will be set to the float value at the specified index in the float array.

Here is an example json file that could be used to map the parameters of a light:

{
  "parameters": [
    {
      "name": "Brightness",
      "index": 0,
      "scale": 1,
      "offset": 0
    },
    {
      "name": "Position X",
      "index": 1
    },
    {
      "name": "Rotation Heading",
      "index": 2,
      "scale": 1,
      "offset": 45
    },
    {
      "name": "Scattering Intensity",
      "index": 3
    },
    {
      "name": "Colour R",
      "index": 4
    },
    {
      "name": "Colour G",
      "index": 5
    },
    {
      "name": "Colour B",
      "index": 6
    }
  ]
}

When fed with a 6 value Float Array, the properties of the light will be set to values of the float array at the indices defined in the JSON. This allows you to set many properties in this light at a time with just one connection.

When fed by an OSC Float Array you can quickly scale this up to control many lights from an external software with just one OSC address.

The Parameter Array node has an offset parameter and a maximum size, which can be used to split arrays up, or to access only part of an array. This can be useful for receiving large amounts of data from one source. In the example above, by using Parameter Array nodes with different offsets, you can take control of several lights with just one array of floats.

Parameters

Inputs