Utilities

MN_utils_curve_resample

Inputs

Name Type Description Default
Geometry Geometry None
Offset Float 2.3
Length Float 0.36
Field Float Float 0.0
Field Int Int None
Field Vec Vector [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Geometry Geometry None
Position Vector [0.0, 0.0, 0.0]
Tangent Vector [0.0, 0.0, 0.0]
Normal Vector [0.0, 0.0, 0.0]
Field Float Float 0.0
Field Int Int None
Field Vec Vector [0.0, 0.0, 0.0]

Attribute Remap

Sample an attribute from the mesh and remap from the minimum to the maximum to the specified values

Remap the range of values of the attribute on from the target atoms, to the range from min to max

Inputs

Name Type Description Default
Sample Geometry The geometry to calculate the field overall min and max values None
Attribute String The attribute name to summarise and them remap b_factor
Value Min Float The minimum for the remapped values 0.0
Value Max Float The maxiumum for the remapped values 1.0

Outputs

Name Type Description Default
Value Float The remapped attribute values 0.0

Field Remap

Sample a field from the mesh and remap from the minimum to the maximum to the specified values

Maps the range of values of the attribute on from the target atoms, to the range from min to max

Inputs

Name Type Description Default
Sample Geometry The geometry to calculate the field overall min and max values None
Field Float The field to summarise and remap 0.0
Value Min Float The new minimum value of the field 0.0
Value Max Float The new maximum value of the field 1.0

Outputs

Name Type Description Default
Value Float The remapped values between the new min and max 0.0

Between Integer

Test if an integer is between (and including) the upper and lower bounds

Inputs

Name Type Description Default
Value Int The value to test if it exists within the bounds None
Lower Int The lower bounds for the test None
Upper Int The upper bounds for the test None

Outputs

Name Type Description Default
Boolean Bool Whether the input Value is between (and including) the lower and upper bounds False

Between Float

Test if a float is between the upper and lower bounds

Inputs

Name Type Description Default
Value Float The value to test if it is between the lower and upper bounds 0.0
Lower Float Test if the Value is greater than or equal to this 0.0
Upper Float Test if the Value is less than or equal to this 0.0

Outputs

Name Type Description Default
Boolean Bool Whether the input Value is between (and including) the lower and upper bounds False

Between Vector

Test if a vector is element-wise between the upper and lower bounds.

Inputs

Name Type Description Default
Value Vector The value to test element-wise [0.0, 0.0, 0.0]
Lower Vector The lower bounds (including) for the comparison [0.0, 0.0, 0.0]
Upper Vector The upper bounds (including) for the comparison [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Boolean Bool If the value is between (and including) the lower the upper bounds False

Vector from Point

Calculate the vector from the current point’s position to the input vector

Inputs

Name Type Description Default
Position Vector Position of the current point Position
Vector Vector Vector that is the target [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Vector Vector Vector from the current point’s position to the given vector [0.0, 0.0, 0.0]
Normalized Vector Normalized output vector [0.0, 0.0, 0.0]
Length Float Length of the output vector 0.0

Mix Position

Mix the current point’s Position with the input vector. A convenience wrapper around a Mix Vector using Position as the first attribute

Inputs

Name Type Description Default
Position Vector The position vector to mix from Position
Factor Float The amount to mix between the Position (0) and the input vector B (1) 0.5
B Vector The vector to mix to [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Result Vector The resulting mixed vector, based on the factor [0.0, 0.0, 0.0]

Fractionate Float

Test if a vector is element-wise between the upper and lower bounds.

Inputs

Name Type Description Default
Value Float The value to fractionate 0.0

Outputs

Name Type Description Default
Fraction Float Fractional component of the value, between 0 and 1 0.0
Floor Int The floor of the value; the integer rounded down None
Ceiling Int The ceiling of the value, the integer rounded up None

Rotation from ZYZ

Combine a rotation defined as ZYZ common in electron tomography

Inputs

Name Type Description Default
Phi Float First rotation around the Z axis 0.0
Theta Float Second rotation around the Y axis 0.0
Psi Float Third rotation around the Z axis 0.0

Outputs

Name Type Description Default
Rotation Rotation The combined Rotation <Euler (x=0.0000, y=0.0000, z=0.0000), order='XYZ'>

Transform Scale

Scale the components of a transform individually with between 0 and their value

Inputs

Name Type Description Default
Transform Matrix The Transform to split and scale None
Translation Float Mix the Translation component of the transform with 0 1.0
Rotation Float Mix the Rotation component of the transform with 0 1.0
Scale Float Mix the Scale component of the transform with 0 1.0

Outputs

Name Type Description Default
Transform Matrix The scaled Transform None

Transform Relative

The transform to get from B to A, relative to the CB axis

Inputs

Name Type Description Default
A Vector The final position [0.0, 0.0, 0.0]
B Vector The position moving from [0.0, 0.0, 0.0]
C Vector The position defining the axis of CB [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Transform Matrix The Transform to move from B to A, relative to the axis of C to B None

Transform Mix

Mix between two transforms, controlling the translation, rotation and scale independently

Mix between two transformations

Inputs

Name Type Description Default
A Matrix Transform A to mix from at 0.0 None
B Matrix Transform B which will be mixed to at 1.0 None
Translation Float Amount to mix the Translation between A and B 0.5
Rotation Float Amount to mix the Rotation between A and B 0.5
Scale Float Amount to mix the Scale between A and B 0.5

Outputs

Name Type Description Default
Transform Matrix The final mixed Transform None

Transform Local

Apply the transform after first moving to world origin, then returning to original position

Inputs

Name Type Description Default
Origin Vector Vector that defines the local space origin, defaults to Position Position
Transform Matrix Transform to apply in local space None

Outputs

Name Type Description Default
Transform Matrix The final transform None

Transform Local Axis

Create a transform that is rotation around an axis in local space, with local space defined by the origin point which defaults to Position

Create a transform around an axis in local space defined by the Origin point

Inputs

Name Type Description Default
Origin Vector The vector defining the local space. Defaults to Position Position
Axis Vector The axis to rotate around [0.0, 0.0, 1.0]
Angle Float Amount to rotate around the axis 0.0

Outputs

Name Type Description Default
Transform Matrix The Transform around the axis None

Transform Accumulate

Accumulate transforms on the domain if selected

Inputs

Name Type Description Default
Domain Menu Domain on which to accumulate transforms Point
Selected Bool Selected transforms are included in the accumulation, non-selected transforms become identity matrices True
Transform Matrix Transform field to accumulate None
Group ID Int Transform field is accumulated individually for each Group ID None

Outputs

Name Type Description Default
Transform Matrix The accumulating Transform field None

Transform Accumulate Point

Accumulate transforms on a domain, applying these transforms to the Position

Accumulate transforms on the point domain

Inputs

Name Type Description Default
Domain Menu Domain on which to accumulate the transforms Point
Selected Bool Include the transform in the final accumlation True
Vector Vector Point to transform, defaults to Position Position
Transform Matrix Transform field to accumulate None
Group ID Int Transform field is accumulated individually for each Group ID None

Outputs

Name Type Description Default
Vector Vector Transformed vector [0.0, 0.0, 0.0]

Centroid

Calculate the centroid point for the selection for each group in the Group ID. The centroid is the average position of all points in each Group ID. If a selection is given, then only the selected points contribute towards the overall centroid calculation, but the result is still available on the other points in the Group ID

Inputs

Name Type Description Default
Position Vector The Position vector to use for the centroid calculation Position
Selection Bool Selected points contribute to the computation of the centroid, unselected points do not contribute but still return the centroid for their Group ID True
Group ID Int Compute the centroid on for each unique Group ID None

Outputs

Name Type Description Default
Centroid Vector The computed average vector for each Group ID [0.0, 0.0, 0.0]

Vector Angle

Compute the angle in radians between two vectors.

The angle between two vectors, in radians

Inputs

Name Type Description Default
A Vector The first vector for angle calculation [0.0, 0.0, 0.0]
B Vector The second vector for the angle calculation [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Angle Float The angle between the two vectors in radians 0.0
A×B Vector Axis around which the angle rotates (cross product of A and B) [0.0, 0.0, 0.0]

Dihedral Angle

Computes the angle between two vectors, AB & CD around around the axis of BC. The first vector AB is treated as the “12 O’clock” up position, looking down the axis towards C, with angles being return in the range of (-Pi, Pi). Clockwise angles are positive and anti-clockwise angles are negative.

Inputs

Name Type Description Default
A Vector First vector for the calculation, which draws a line to B [0.0, 0.0, 0.0]
B Vector Second vector for the calculation, which receives a line from A and draws a line to C [0.0, 0.0, 0.0]
C Vector Third vector for the calculation, which receives a line from B and draws a line to D [0.0, 0.0, 0.0]
D Vector Last vector for the calculation, which is the end point of the line from D [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Angle Float The angle between the vectors AB and CD, when made perpendicular to BC. 0.0
BA⟂(BC) Vector The vector BA when made perpendicular to the axis BC [0.0, 0.0, 0.0]
CD⟂(BC) Vector The Vector CD when makde perpendicular to the axis BC [0.0, 0.0, 0.0]
BC Vector The axis vector BC [0.0, 0.0, 0.0]

3 Point Angle

Calculate the angle between 3 different points. These points are selected based on their index in the point domain, with Index B being the centre of the calculation.

In the video example, the same calculation that is occurring internally inside of the MN_topo_edge_angle node, is being handled explicity by this node. If the Index is being used as Index B then the current point that is being evaluated is the centre of the angle calculation. If this value is changed, then the point at the corresponding index is used, which results in a smaller angle in the example video.

Inputs

Name Type Description Default
Index A Int First of the points for the angle calculation None
Index B Int The middle point for the angle calculation None
Index C Int Last of the points for the angle calculation None

Outputs

Name Type Description Default
Angle Float Angle between the points around Index B in radians 0.0

2 Point Angle

Calculate the angle that two points make, relative to the current point being evaluated. Points are selected based on their index, with the centre of the angle calculation being the current point’s position. Equivalent to using 3-Point angle and using Index as the Index B.

In the example video, the angle calculation is similar to that of the 3-Point Angle node, but the middle point is always the current point.

Inputs

Name Type Description Default
Position Vector The Position vectors to use for the angle calculation Position
Index A Int First end point for the angle calculation around the current point None
Index B Int The Index for the middle point in the angle calculation, defaulting to the current point Index
Index C Int Last end point for the angle calculation around the current point None

Outputs

Name Type Description Default
Angle Float Angle of the line A -> Self -> C in radians 0.0

Point Distance

Calculate the distance and the vector between the evaluating point and the point selected via the Index.

In the example video, each point is calculating a vector and a distance between itself and the indexed point. When the Point Mask node is used, this index is then on a per-group basis, so each point in the group points to just the group’s corresponding point.

Inputs

Name Type Description Default
Index Int Index for the selected point to measure to None

Outputs

Name Type Description Default
Vector Vector Vector from the current point to the indexed point [0.0, 0.0, 0.0]
Distance Float Distance from the current point to the indexed point 0.0