> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nodi3d.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart
> This tutorial explains the basic usage of Nodi through an example of creating an attractor.
This example demonstrates a grid of spheres that change in size based on their distance from an input point.\
Here is the link to the final example: [https://app.nodi3d.com/?example=Attractor](https://app.nodi3d.com/?example=Attractor)
## Add a Sphere Node
To add a node, double-click on the node canvas or press the Tab key to open the node search menu.\
You can browse through the node categories to find the desired node. Alternatively, you can type the node name into the search bar to add it.
In the node search bar, type `Sphere` to display the `Sphere` node as a suggestion. Click on it to add it.
## Check the Node Information
When you click on a node placed on the node canvas, the information of the selected node is displayed in the Node Inspector.
In the Inspector, you can configure the properties of the node and check the data output by the node.
The `Sphere` node has properties representing its center position and radius. By editing these properties in the Inspector, you can adjust the shape generated by the Sphere node.
Each node has input parameters and output parameters. By connecting the output of one node to the input of another, you can create data flows and perform modeling.
This structure, composed of nodes that hold data and edges that connect the nodes, is called a **node graph**.
You can check what type of data a node's input expects and what data is available from its output by hovering your mouse over the input or output sections.
## Create a Data Flow
Try connecting a node that outputs a numerical value to the Sphere node to parametrically change the radius of the sphere.
Add a `Number Slider` to the node canvas and connect it to the `Sphere` node.\
You can create an edge between nodes by clicking on the input/output section of a node and dragging it to the desired connection point.
With the Number Slider's output connected to the radius input of the Sphere node, you can observe the sphere's size change as you adjust the output value in the Number Slider's Inspector.
This achieves the simplest form of parametric modeling!
### How to Disconnect Nodes
To disconnect an edge between nodes, right-click on the input or output connected by the edge and select **Disconnect** from the menu.
Alternatively, you can hold the **\[Ctrl or Command]** key and left-drag to activate a drawing tool for quickly cutting multiple edges at once.
## Move a Sphere
By connecting the output of the `Sphere` node to a `Move` node, you can change the position of the sphere.
The `Move` node accepts geometry data to be moved and a vector representing the translation offset. This vector data can also be modified directly in the Inspector.
At this point, you may notice that two spheres are displayed.\
This happens because the geometry output from the original `Sphere` node and the geometry moved by the `Move` node are both being displayed.
If you want to hide certain geometry, you can turn off the visibility setting of the node that outputs that geometry.
## Arrange Spheres in a Grid
Add a `Square Grid` node to the node canvas.\
The `Square Grid` node allows you to create a grid with square cells by specifying its size and the number of divisions in the x and y directions.
The `Square Grid` outputs rectangle curves representing each cell and the positional data of the grid's vertices. This vertex information can be viewed in the Inspector.
By connecting the position data output of the `Square Grid`, which represents its vertices, to the translation vector input of the `Move` node, you can arrange spheres in a grid pattern.
## Create an Attractor
An **attractor** is an object that influences other objects based on spatial relationships, such as distance.\
In following sections, we will create an attractor that changes the size of spheres based on their distance from the attractor.
First, create the attractor's position data using a `Construct Point` node.
Next, calculate the distance between the vertex coordinates output from the Square Grid and the attractor's position using a `Distance` node.
To change the size of the geometry arranged on the grid via the `Move` node, use a `Scale` node. The `Scale` node takes the following inputs:
* Geometry to scale
* Center point for scaling
* Scale factor
Connect the output of the `Move` node to the geometry input of the Scale node,\
and the output of the `Square Grid` to the center position input.
[https://github.com/user-attachments/assets/8adb6512-37cb-4f1e-8c19-50ac482adcac](https://github.com/user-attachments/assets/8adb6512-37cb-4f1e-8c19-50ac482adcac)
Finally, connect the output of the `Distance` node to the scale factor input of the `Scale` node. This completes a node graph where the sphere sizes change based on their distance from the attractor's position.
However, directly inputting the `Distance` values into the scale factor would result in values that are too large. To address this, use a `Division` node to scale down the `Distance` values before connecting them to the `Scale` node.
## Adjust the Attractor's Position to Be Relative to the Grid
In the current setup, you can edit the attractor's position by adjusting the XY properties of the `Construct Point` node. However, the attractor's position is not relative to the grid size, so when the grid size changes, the attractor's position becomes misaligned.
For example, if the grid size spans **X: 0 to 10** and **Y: 0 to 10**, and the attractor is positioned at **(5, 5)**, it will be perfectly centered on the grid.
However, if the grid size doubles along both the X and Y axes(**0 to 20**), the attractor's position remains at **(5, 5)**, which is no longer the center of the grid.
This misalignment occurs because the attractor's position is defined in absolute terms rather than being relative to the grid's size.
To make the attractor's position relative to the grid size, first modify the setup to output the grid's size as a variable from a separate node.
The grid size is determined by two inputs of the `Square Grid` node:
* The input that sets the size of each cell.
* The inputs that set the number of cells along the X and Y axes.
Edit the node graph so that these inputs are influenced by values output from `Number` nodes.
The grid size is calculated as **"cell size × number of cells"**.
To represent this, connect the outputs of the two **Number** nodes to a **Multiply** node.
The attractor's position will be determined using an `MDSlider` node.
The `MDSlider` node provides a UI for editing 2D values. The values edited in the Inspector always range from **0.0 to 1.0**. The actual output from the MDSlider is calculated based on the configured numerical range using the formula:
`output = (max - min) * t + min`
where `t` is the value in the range of **0.0 to 1.0**.
By connecting the previously calculated grid size values as inputs to the `MDSlider`, the coordinates output from the `MDSlider` will always fall within the range of **(0.0 to grid size)**.
Finally, connect the output of the `MDSlider` to the input of the `Distance` node. This ensures that the attractor's position is determined relative to the grid size.
## It's Complete!
Now you have learned the basics of using Nodi.\
By exploring \[\[other examples|Examples]], you can discover the functionalities of various nodes and how to utilize them effectively.
Regarding this attractor example, note that the sphere's size and the scaling factor based on the attractor's distance are not yet relative to the grid. However, the attractor example available from the application has these aspects adjusted to be relative. Feel free to check it out if you're interested!
[https://app.nodi3d.com/?example=Attractor](https://app.nodi3d.com/?example=Attractor)