## Task/goal: generate a grid family with Solar

### User prerequisite: basic knowledge of Solar grid generation process

Steps to be performed:

1. generate a suitable coarse grid
   1. initialize the basic source field with the help of the ASM
   2. adapt the initial source field to your particular needs, due to e.g. different gridding guidelines than implemented in the ASM
   3. generate a grid using the higher limit for first cell height and expansion ratio
2. scale sources from coarse to medium and fine
   1. use the available Python program (scaleSolaSources.py) and set the scaling factor for each step (coarse->medium, medium->fine) according to the dimensionality:
      - 2D: inverse of the root of the target volumetric scaling, e.g. 1/sqrt(2)=1/1.41421=0.70711
      - 3D: inverse of the 3rd root of the target volumetric scaling, e.g. 1/sqrt(3)=1/1.44225=0.69336
   2. generate the surface grids for medium and fine levels and assure the commonality of the three surface grids
   3. nearfield parameters (1st cell height and expansion ratio) need to be scaled for achieving the same theoretical nearfield layer thickness as for the coarse grid
   4. generate medium and fine volume grids
3. in case the grid generation was successful, finish here, otherwise:
   1. check the (most probably) fine grid for errors and fix the source field manually, until the successful generation of a volume grid
   2. scale the source field similarly to (2a) from fine to medium and coarse with scaling factor > 1:
      - 2D: root of the target volumetric scaling, e.g. sqrt(2)=1.41421
      - 3D: 3rd root of the target volumetric scaling, e.g. sqrt(3)=1.44225 [[c]] finish the grid family by generating medium and coarse grids