📖 Reference guide

Fields

Fields play a central role in the Helion library.

Fields

Field: sample(u, ,v, target)
 │
 ├─ VectorField: sample(positionVector, target)
 │
 ├─ Surface
 │   ├─ ParametricSurface
 │   │   └─ MultivariateFunctionSurface
 │   │
 │   ├─ ComplexSurface
 │   ├─ DiscreteFieldSurface
 │   └─ ComplexSurface
 │
 ├─ ScalarFieldOnSurface
 │   ├─ HeightScalarField
 │   ├─ MeanCurvatureField
 │   ├─ GaussianCurvatureField
 ├─ ...
 │
 └─ DiscreteScalarField

MVC:

Simulation
    updates solver
Solver
    updates field
SurfaceView
    samples field

numerics/
├── solvers/
│   ├── JacobiSolver
│   ├── GaussSeidelSolver
│   ├── MultigridSolver
│   └── FiniteDifferenceWaveSolver
│
├── operators/
│   ├── Laplacian2D
│   ├── Gradient2D
│   └── Divergence2D
│
├── boundaryconditions/
│   ├── Dirichlet
│   ├── Neumann
│   └── Periodic

SurfaceView
    ↓
Surface.sample()
    ↓
ScalarField.scalarValueAt()

const field = new ScalarGridField(...);

const solver = new WaveEquationSolver({
    field,
    boundaryCondition: BoundaryCondition.Dirichlet
});

simulation.onClockTick((_, dt) => solver.step(dt));

Introduction

In jouw architectuur (zoals je die nu gebruikt)

Je hebt 3 lagen:

1. Physics layer Dipole, Particle, VectorField

→ puur fysica in meters (of SI units)

2. Simulation layer Simulation

→ tijd, substeps, integratie

❗ hoort NIETS te weten over visual scale

3. Render layer ThreeJsRenderer._world ArrowField2 Sphere etc.

→ mapping physics → visuals

Getting started

📊 My first simulation

TODO

The physics layer

The simulation layer

The rendering layer

Surfaces

Surface
↓
ScalarField (ruwe waarde)
↓
NormalizedScalarField (altijd [0,1])
↓
ColorMapper (blind voor fysica)
↓
View (alleen rendering)

/**
* Scalar field on a surface.
* │
* ├── MeanCurvatureField
* ├── GaussianCurvatureField
* ├── PrincipalCurvatureField
* ├── GeodesicDistanceField
* ├── UserDefinedField
  */
  export class SurfaceScalarField

User interaction