Layout file

  1. Documentation
  2. Run
  3. Layout file
Interface
Fig.1 Example for interface between blocks.

When performing a multi-block simulation, some information has to communicate between adjacent blocks. For this process, a setup file is provide called layout.md in the system/mesh/layout folder. This file contains information about the adjacent blocks and physical boundary conditions. All the non-negative numbers in this file represent the interface boundary condition, and negative numbers represent the physical boundary conditions. For each block/process a row of information is written:

  1. Block number
  2. Grid file name in the system/mesh/gridfile/ directory
  3. Boundary condition file name in the system/mesh/bc/ directory
  4. Boundary condition at Imin face.
  5. Boundary condition at Imax face.
  6. Boundary condition at Jmin face.
  7. Boundary condition at Jmax face.
  8. Boundary condition at Kmin face.
  9. Boundary condition at Kmax face.
Interface
Fig.2 Each block has six faces and hence six boundary conditions to set.

So for four blocks the layout file looks like following. 

 ## BLOCK LAYOUT FILE
 ## ==========================
 ## NUMBER OF PROCESSES
 4
 ## NUMBER OF ENTRIES PER PROCESS
 9
 ## PROCESS_NO GRID BC_FILE IMIN IMAX JMIN JMAX KMIN KMAX
 ## ===================================
 ## PROCESS 0
 00  grid_00.txt  bc_00.md  -005  0001  -005  0002  -006  -006
 ## PROCESS 1
 01  grid_01.txt  bc_01.md  0000  -005  -005  0003  -006  -006
 ## PROCESS 2
 02  grid_02.txt  bc_02.md  -005  0003  0000  -003  -006  -006
 ## PROCESS 3
 03  grid_03.txt  bc_03.md  0002  -005  0001  -003  -006  -006

Each line starting with # is a comment line and hence will be ignored while reading. The first non-comment line state for how many blocks the layout file is written for and second line state how many entries to read for each block. This number is same as the number of entries in the list above. After these two lines, every non-comment line represents a block. The positive boundary condition at any face represents the interface boundary condition, and the exact number represents the block number to which the current block is connected through that face. The physical boundary conditions are listed below:

Layout

Boundary conditions

  • -1: Supersonic Inlet
  • -2: Supersonic Outflow
  • -3: Subsonic Inflow
  • -4: Subsonic Outflow
  • -5: Wall
  • -6: Symmetry or Slip-Wall
  • -7: Pole
  • -8: Far-field
  • -9: Total inlet