You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/getting_started/explanation_concepts.md
+33-2Lines changed: 33 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,6 +5,37 @@ kernelspec:
5
5
---
6
6
# Parcels concepts
7
7
8
-
The flexibility of Parcels enables a wide range of applications and the building of complex simulations. In order to help structure your code, this tutorial describes the structure that a Parcels script uses.
8
+
Parcels is a set of Python classes and methods to create particle tracking simulations. Here, we will explain the basic concepts defined by the most important classes and functions. This overview can be useful to start understanding the names for different components we use in Parcels, and to structure and make appropriate use of the code in a simulation script.
9
9
10
-
Code that uses Parcels is generally built up from four different components:
10
+
A Parcels simulation is generally built up from four different components:
11
+
1.[**FieldSet**](#1.-FieldSet). The input dataset of gridded fields (e.g. ocean current velocity, temperature) in which virtual particles are defined.
12
+
2.[**ParticleSet**](#2.-ParticleSet). The dataset of virtual particles. These always contain time, z, lat, and lon, for which initial values must be defined, and may contain other variables.
13
+
3.[**Kernels**](#3.-Kernels). Kernels perform some specific operation on the particles every time step (e.g. interpolate the temperature from the temperature field to the particle location).
14
+
4.[**Execute**](#4.-Execution). Execute the simulation. The core method which integrates the operations defined in Kernels for a given time and timestep, and writes output to a ParticleFile.
15
+
16
+
We discuss each component in more detail below and link to more detailed [how-to guides](../user_guide/index.md) and the full list of classes and methods in the [API reference](../reference.md). If you want to learn by doing, check out the [quickstart tutorial](./tutorial_quickstart.md) to start creating your first Parcels simulation.
17
+
18
+

19
+
20
+
## 1. FieldSet
21
+
22
+
Parcels provides a framework to simulate particles **within a set of fields**, such as flow velocities and temperature. To start a parcels simulation we must define this dataset with the `FieldSet` class.
23
+
24
+
The input dataset from which to create a `FieldSet` can be an `xarray.Dataset` with output from a hydrodynamic model or reanalysis.
25
+
26
+
### Grid
27
+
read more about [grids](../user_guide/explanations/explanation_grids.md)
28
+
29
+
### Interpolation
30
+
read more about [interpolation](../user_guide/explanations/explanation_interpolation.md)
31
+
32
+
## 2. ParticleSet
33
+
34
+
35
+
## 3. Kernels
36
+
read more about [Kernels](../user_guide/explanations/explanation_kernelloop.md)
0 commit comments