# Distribute Matrices¶

## Description¶

This node creates a list of matrices that represent the locations of object distributed someway in space. They can be distributed in a line, grid, circle or based on a custom distribution. ## Options And Inputs¶

• Linear - This option distribute matrices along the x-axis centered at the world.
• Size - This option lets you define the size of the line.
• Amount - Number of matrices.
• Size - Size of the line.
• Step - This option lets you define the distance between each two consecutive matrices.
• Amount - Number of matrices.
• Distance - Distance between each two consecutive matrices.
• Grid - This option distribute matrices on a 3D lattice centered on the world with positive z-locations.
• Size - This option lets you define the side length of the lattice.
• X Division - Number of matrices in x-axis.
• Y Division - Number of matrices in y-axis.
• Z Division - Number of matrices in z-axis.
• Width - The width of the lattice.
• Length - The length of the lattice.
• Height - The height of the lattice.
• Step - This option lets you define the distance between every two object in all axis.
• X Division - Number of matrices in x-axis.
• Y Division - Number of matrices in y-axis.
• Z Division - Number of matrices in z-axis.
• X Distance - Distance between each two consecutive matrices along x-axis.
• Y Distance - Distance between each two consecutive matrices along y-axis.
• Z Distance - Distance between each two consecutive matrices along z-axis.
• Circle - This option lets you distribute object around a circle centered at the world.
• Amount - The number of matrices around the circle.
• Segment - A ratio that describe the completeness of the circle, where `1` means a a complete circle and `0` means no circle.
• Vertices - This option lets you distribute objects based on a vector list that define their location and another vector list that defines their orientation.
• Vertices - A vector list that represents the locations of the matrices.
• Normals - A vector list that represents the orientation of the matrices.
• Note that both lists have to have the same length and the number of output matrices will be equal to the length of the lists.

## Outputs¶

• Matrices - The output matrices. 