Grid Connectivity

• One-to-One Connectivity
  • cg_n1to1_global - Get total number of 1-to-1 interfaces in a database
  • cg_1to1_read_global - Read data for all 1-to-1 interfaces in a database
  • cg_1to1_write - Write 1-to-1 connectivity data for a zone
  • cg_n1to1 - Get number of 1-to-1 interfaces in a zone
  • cg_1to1_read - Read 1-to-1 connectivity data for a zone
• Generalized Connectivity
  • cg_conn_write - Write generalized connectivity data
  • cg_conn_write_short - Write generalized connectivity data without donor information
  • cg_nconns - Get number of generalized connectivity interfaces in a zone
  • cg_conn_info - Get info about a generalized connectivity interface
  • cg_conn_read - Read generalized connectivity data
• Special Grid Connectivity Properties
  • cg_conn_periodic_write - Write data for periodic interface
  • cg_conn_average_write - Write data for averaging interface
  • cg_conn_periodic_read - Read data for periodic interface
  • cg_conn_average_read - Read data for averaging interface
• Overset Holes
  • cg_hole_write - Write overset hole data
  • cg_nholes - Get number of overset holes in a zone
  • cg_hole_info - Get info about an overset hole
  • cg_hole_read - Read overset hole data

1-to-1 Connectivity

The above functions may be used to get information about all the one-to-one zone interfaces in a CGNS database.

Functions	Modes
ier = cg_1to1_write(int fn, int B, int Z, char *connectname,       char *donorname, cgsize_t *range, cgsize_t *donor_range,       int *transform, int *I);	- w m
ier = cg_n1to1(int fn, int B, int Z, int *n1to1);	r - m
ier = cg_1to1_read(int fn, int B, int Z, int I, char *connectname,       char *donorname, cgsize_t *range, cgsize_t *donor_range,       int *transform);	r - m
call cg_1to1_write_f(fn, B, Z, connectname, donorname, range,      donor_range, transform, I, ier)	- w m
call cg_n1to1_f(fn, B, Z, n1to1, ier)	r - m
call cg_1to1_read_f(fn, B, Z, I, connectname, donorname, range,      donor_range, transform, ier)	r - m

Input/Output

	fn		CGNS file index number.
	B		Base index number, where 1 ≤ B ≤ nbases.
	Z		Zone index number, where 1 ≤ Z ≤ nzones.
	I		Interface index number, where 1 ≤ I ≤ n1to1.
	n1to1		Number of one-to-one interfaces in zone Z, stored under GridConnectivity1to1_t nodes. (I.e., this does not include one-to-one interfaces that may be stored under GridConnectivity_t nodes, used for generalized zone interfaces.)
	connectname		Name of the interface.
	donorname		Name of the zone interfacing with the current zone.
	range		Range of points for the current zone.
	donor_range		Range of points for the donor zone.
	transform		Short hand notation for the transformation matrix defining the relative orientation of the two zones.
	ier		Error status.

The above functions are used to read and write one-to-one connectivity data for a specific zone.

Generalized Connectivity

Note that the interpolation factors stored in the InterpolantsDonor data array are accessed using the cg_goto and cg_array_xxx functions.

Special Grid Connectivity Properties

These functions may be used to store special grid connectivity properties. The "cg_conn" functions apply to generalized grid connectivity nodes (i.e., GridConnectivity_t), and the "cg_1to1" functions apply to 1-to-1 grid connectivity nodes (i.e., GridConnectivity1to1_t).

The "write" functions will create the GridConnectivityProperty_t node if it doesn't already exist, then add the appropriate connectivity property. Multiple grid connectivity properties may be recorded under the same GridConnectivityProperty_t node.

The "read" functions will return with ier = 2 = CG_NODE_NOT_FOUND if the requested connectivity property, or the GridConnectivityProperty_t node itself, doesn't exist.

Overset Holes