CBlockGrid.md

@@ -3,7 +3,7 @@
 Basic grid properties 
 ---------------------
 
-Basic grid properties are set once by the readPFMetadat function. They are essential, all other grid metadata can be calculated from them. They can be accessed using functions (named as them) marked by the python "@property" decorator.
+Basic grid properties are set once by the readPFMetadat function. They are essential, each grid must provide them, all other grid metadata can be calculated from them. They can be accessed using functions (named as them) marked by the python "@property" decorator.
 
 * bb - Bounding boxes of all blocks. 3dims: block, direction, LO/HI.
 * blkshape - Shape of blocks (same for all of them) - number of grid cells in all directions. (3-element array)
@@ -11,4 +11,24 @@ Basic grid properties are set once by the readPFMetadat function. They are essen
 * nodetype - Returns nodetypes of all blocks (1 = leaf block). 1dim: block.
 * rlevel - Refinement levels for all blocks. 1dim: block
 * vnames - List of field variables names available in the grid datafile. Python list of (preferentially 4 character) strings.
-     
\ No newline at end of file
+
+Derived grid properties
+-----------------------
+
+Properties of the grid that can be derived from the above basic grid properties. They are calculated only once, at the first call of the function. They are marked by the "@cached_property" decorator.
+
+* bcCoords - Coordinates of block centres. 2dim: block, direction.
+* bs - Sizes of all blocks in all directions. 2dim: block, direction.
+* CD - Computational domain (calculated from bb of all blocks). 3dim: block, direction, LO/HI.
+* cs - Cell sizes of all blocks. 2dim: block, direction.
+* minbs - Size of the smallest block. 1dim: direction.
+* mincs - Size of the smallest grid cell. 1dim: direction.
+     
+Calculating various values from metadata
+----------------------------------------
+
+* blockCellCoords
+* blocksIntersectingBox
+* csrl
+* getDict
+