Skip to main content

Map (node)

Performs a set of instructions on each item in a list

Holly Conrad Smith avatar
Written by Holly Conrad Smith
Updated over 2 weeks ago

Map is the most basic looping function node. Performs a set of instructions on each item in a list

Inputs

Name

Abbreviation

Type

Access

Description

List

L

Any

List

The list to map over

Return Value

R

Any

Item

The item to return in the current loop

Outputs

Name

Abbreviation

Type

Access

Description

Result

R

Any

List

The result of the map

Value

V

Any

Item

The value of the map

Index

I

Number

Item

The index of the map

How-to

  1. Feed in a list

    Lists have 2 or more items contained within the list object.

    (If you do not have a list, map is unnecessary - just feed the single geometry directly into the function)

  2. Start the loop

    Create your set of instructions as you typically would for a single object.

    Feed the V output into your function.

  3. End the loop

    Feed the output of the function into the R input.

  4. The output of the Map is a list of items that have had your function applied.

Example:

Assigning a Usage to geometries created with subdivide lots.

Here, the list passes into the Map node.

The “value” is each list item.

Each list item has the Usage applied

Then, the result is passed back into the Map node

Finally, the node re-compiles the list to include the resulting geometries.

Did this answer your question?