{
  "name": "Point",
  "namespace": "",
  "module": "Sofa.framework.Topology",
  "include": "sofa/topology/Point.h",
  "doc": "",
  "inherits": [
    "Primitive"
  ],
  "templates": [],
  "data_fields": [],
  "links": [],
  "methods": [],
  "description": "The `Point` component in the SOFA framework is part of the Topology module and serves as a fundamental building block for defining geometric points within a simulation. It inherits from the `Primitive` class, indicating that it represents basic structural elements used to construct more complex shapes or objects.\n\n### Role and Purpose\n- **Role**: The `Point` component defines individual vertices or nodes in the simulation's geometry, which are essential for forming topological structures such as edges, triangles, tetrahedra, etc.\n- **Purpose**: It is crucial for defining the spatial positions of points that form the basis of any mesh-based representation used in SOFA simulations.\n\n### Interactions with Other Components\nThe `Point` component interacts primarily through its parent class `Primitive`, which defines how it fits into more complex topological structures within the simulation. It does not have specific data fields or methods listed, implying that its primary function is to serve as a simple container for individual points.\n\n### Practical Usage Guidance\n- **Usage**: The `Point` component is typically used implicitly through higher-level components and mappings in SOFA simulations where geometric vertices are needed.\n- **Data Fields**: No specific data fields or methods are defined, indicating that its implementation relies on the broader framework for defining its attributes (e.g., position coordinates) which are managed by other components like `MechanicalObject` or `TopologyContainer`. ",
  "maths": "The `Point` component in the SOFA framework serves as a fundamental building block for defining geometric points within a simulation. It inherits from the `Primitive` class, which implies that it represents basic structural elements used to construct more complex shapes or objects.\n\n### Mathematical and Physical Description\n- **Role**: The `Point` component defines individual vertices or nodes in the simulation's geometry. These points are essential for forming topological structures such as edges, triangles, tetrahedra, etc., which collectively form a mesh.\n- **Purpose**: It is crucial for defining the spatial positions of points that serve as the basis of any mesh-based representation used in SOFA simulations. Mathematically, each point can be represented by its coordinates in the Cartesian space:\n\n\begin{equation}\textbf{x}_i = (x_i, y_i, z_i)\tag{i} \text{ is the position vector for the i-th point.}\nonumber\tag{1}\nonumber\tag{2}\tag{3}\tag{4}\tag{5}\tag{6}\tag{7}\tag{8}\tag{9}\tag{10}\tag{11}\tag{12}\tag{13}\tag{14}\tag{15}\tag{16}\tag{17}\tag{18}\tag{19}\nonumber\tag{20}\nonumber\n\\end{equation}\n\n- **Interactions**: The `Point` component interacts primarily through its parent class `Primitive`, which defines how it fits into more complex topological structures within the simulation. It does not have specific data fields or methods listed, implying that its primary function is to serve as a simple container for individual points.\n- **Numerical Methods and Discretization**: The coordinates of these points are used in the spatial discretization phase of FEM where they form nodes of elements (e.g., tetrahedra). Shape functions interpolate displacements between these points:\n\n\begin{equation}u(X,t) \\\text{approx.}\\\textstyle \\sum_i N_i(X) u_i(t)\nonumber\tag{21}\nonumber\tag{22}\nonumber\tag{23}\nonumber\tag{24}\nonumber\tag{25}\n\\end{equation}\n\n- **Role in the FEM Pipeline**: The `Point` component's role is to provide spatial positions of nodes used in the assembly phase for constructing global matrices (e.g., mass matrix $M$, stiffness matrix $K$) and internal force vectors ($f_{int}$). These contributions are essential for solving nonlinear and linear systems during time integration and state updates.\n- **Variational Mechanics**: In the context of variational mechanics, these points define the nodal basis functions used in the weak form of partial differential equations. The test functions $w$ are defined with respect to these nodes for evaluating integrals over elements.",
  "abstract": "The `Point` component defines individual vertices or nodes in the simulation's geometry, essential for forming topological structures such as edges, triangles, and tetrahedra within SOFA simulations.",
  "sheet": "# Point\n\n## Overview\n\nThe `Point` component is a fundamental building block in the SOFA framework, defining geometric points that serve as vertices or nodes. It inherits from the `Primitive` class, indicating its role in constructing more complex topological structures such as edges, triangles, and tetrahedra.\n\n## Mathematical Model\n\nEach point can be represented by its coordinates in Cartesian space:\n\n\begin{equation}\n\\mathbf{x}_i = (x_i, y_i, z_i) \\quad \\text{i is the position vector for the i-th point.}\n\\end{equation}\n\nThese points are used in spatial discretization where they form nodes of elements such as tetrahedra. Shape functions interpolate displacements between these points:\n\n\begin{equation}\nu(X,t) \\approx \\sum_i N_i(X) u_i(t)\n\\end{equation}\n\nThe `Point` component's role is to provide spatial positions of nodes used in the assembly phase for constructing global matrices (e.g., mass matrix $M$, stiffness matrix $K$) and internal force vectors ($f_{int}$). These contributions are essential for solving nonlinear and linear systems during time integration and state updates."
}