How to access and manage the main mesh entities and mesh quantities ?

Mesh variables

These variables are defined in cs_mesh.h.

• Members of the global C structure cs_glob_mesh are accessed as:
  cs_glob_mesh->name,
  i.e. adding cs_glob_mesh-> in front of the name of the variable.
• For a more concise syntax, defining a local m or mesh variable is recommended:

  const cs_mesh_t *m = cs_glob_mesh;

  so that the shorter name of the local variable may be used.
• In functions which have a domain argument, using domain->mesh is recommended, and may be combined with the use of a local argument (as above) for conciseness.
• Note that the number of elements given here are local to a given rank when running in parallel. Global sizes should only be used in specific instances, though they are available in cs_mesh_t structures.

C code	Description
cs_glob_mesh->dim	Space dimension (always 3)
cs_glob_mesh->n_cells_with_ghosts	Total number of cells on the local rank (n_cells + n_ghost_cells)
cs_glob_mesh->n_cells	Number of cells
cs_glob_mesh->n_i_faces	Number of interior faces
cs_glob_mesh->n_b_faces	Number of boundary faces
cs_glob_mesh->n_vertices	Number of vertices
cs_glob_mesh->n_b_cells	Number of boundary cells
cs_glob_mesh->i_face_vtx_connect_size	Size of the connectivity interior faces -> vertices
cs_glob_mesh->b_face_vtx_connect_size	Size of the connectivity boundary faces -> vertices
cs_glob_mesh->i_face_cells	Interior faces -> cells connectivity
cs_glob_mesh->b_face_cells	Boundary faces -> cells connectivity
cs_glob_mesh->i_face_vtx_idx	Interior faces -> vertices index
cs_glob_mesh->i_face_vtx_lst	Interior faces -> vertices connectivity
cs_glob_mesh->b_face_vtx_idx	Boundary faces -> vertices index
cs_glob_mesh->b_face_vtx_lst	Boundary faces -> vertices connectivity
cs_glob_mesh->b_cells	Boundary cell list
cs_glob_mesh->vtx_coord	Vertex coordinates

Note that the faces - vertices connectivity is stored using indexed arrays.

Mesh quantity variables

These variables are defined in cs_mesh_quantities.h.

• Members of the global C structure cs_glob_mesh_quantities are accessed as:
  cs_glob_mesh_quantities->name,
  i.e. adding cs_glob_mesh_quantities-> in front of the name of the variable.
• For a more concise syntax, defining a local mq variable is recommended:

  const cs_mesh_quantities_t *mq = cs_glob_mesh_quantities;

  so that the shorter name of the local variable may be used.
• In functions which have a domain argument, using domain->mesh_quantities is recommended, and may be combined with the use of a local argument (as above) for conciseness.

C code	Description
cs_glob_mesh_quantities->b_sym_flag	Symmetry flag for boundary faces
cs_glob_mesh_quantities->cell_cen	Cell center coordinates
cs_glob_mesh_quantities->i_face_normal	Surface normal of interior faces
cs_glob_mesh_quantities->b_face_normal	Surface normal of border faces
cs_glob_mesh_quantities->i_face_cog	Center of gravity of interior faces
cs_glob_mesh_quantities->b_face_cog	Center of gravity of border faces
cs_glob_mesh_quantities->cell_vol	Cell volume
cs_glob_mesh_quantities->i_face_surf	Surface of interior faces
cs_glob_mesh_quantities->b_face_surf	Surface of boundary faces
cs_glob_mesh_quantities->i_dist	Distance between the cell center and the center of gravity of interior faces
cs_glob_mesh_quantities->b_dist	Distance between the cell center and the center of gravity of border faces
cs_glob_mesh_quantities->weight	Interior faces weighting factor