Here are some thoughts for the grid and fields tutorial:

Grids tutorial

1. Basic information: domains, resolution, architectures, number types
2. First example: equally-spaced RectilinearGrid.
   • meaning of the keyword arguments and different options
   • emphasize explaining topology
   • emphasize explaining architecture: CPU, GPU, distributed
3. Second example: single column grid with vertical stretching via vector
4. Third example: two-dimensional grid (short)
5. Fourth example: channel grid with function-specified y and z
   • Explain how to use functions to build a grid
   • Intro to some helper functions: yspacing, ynodes, etc.
6. Fifth example: LatitudeLongitudeGrid with equal spacing
   • Explain different keyword args
   • Explain that only longitude can be periodic
7. Sixth example: LatitudeLongitudeGrid with stretched latitude

Q: should we show tripolar grid / other examples with OrthogonalSphericalShellGrid? (At the very least we should reference this.)

Fields tutorial

1. Explain the purpose of Field: data structure, plus infrastructure for building expression trees
2. Field basics
   • The staggered grid, Field locations
   • Field size + data, staggered nodes, staggered spacings
3. AbstractOperations and expression trees
   • The concept of a lazy operator
   • Arithmetic and derivatives
   • Difference between a Field and Operation
   • KernelFunctionOperation
   • what else?
4. Averaging, intergrals, and reduced fields

What else?

@navidcy @simone-silvestri

from oceananigans.jl.

1. purpose of Field: data structure, plus infrastructure for building expression trees

2. Field basics

   • The staggered grid, Field locations
   • Field size + data, staggered nodes, staggered spacings

3. AbstractOperations and expression trees

   • The concept of a lazy operator
   • Arithmetic and derivatives
   • Difference between a Field and Operation
   • KernelFunctionOperation
   • what else?

4. Averaging, intergrals, and reduced fields

What else?

@navidcy @simone-silvestri

Visualization always helps, so I recommend adding plots of various grid types (periodic, non-periodic, stretched, etc.) directly below the corresponding code snippets that generate them. Additionally, it would be nice to illustrate how to access the different components of Fields and the output of abstract operations with code snippets.

from oceananigans.jl.

I vote yes to including tripolar.

from oceananigans.jl.