A.6. Mesh Operation Utility Functions

Feature	Description	Utility Function
Rename zones	Renames an existing face zone	`(tgapi-util-rename-face-zone "zone-name" "new-name")`
	Renames an existing face zone	`(tgapi-util-rename-face-zone 'zone-id "new-name")`
	Renames an existing edge zone	`(tgapi-util-rename-edge-zone "zone-name" "new-name")`
	Renames an existing edge zone	`(tgapi-util-rename-edge-zone 'zone-id "new-name")`
	Replace the face zone suffix to rename face zones. Specify whether to merge the face zones being renamed (set `merge?` to `#t` or `#f`). Note: If an empty string is specified for the `separator` (`" "`), the string specified for `replace-with` will be appended to the face zone names.	`(tgapi-util-replace-face-zone-suffix '(face-zone-list) "separator" "replace-with" merge?)`
	Replace the cell zone suffix to rename cell zones. Specify whether to merge the cell zones being renamed (set `merge?` to `#t` or `#f`)	`(tgapi-util-replace-cell-zone-suffix '(cell-zone-list) "old-suffix" "new-suffix" merge?)`
	Replace the edge zone suffix to rename edge zones. Specify whether to merge the edge zones being renamed (set `merge?` to `#t` or `#f`)	`(tgapi-util-replace-edge-zone-suffix '(edge-zone-list) "old-suffix" "new-suffix" merge?)`
	Removes the ID suffix from face zone names	`(tgapi-util-remove-id-suffix-from-face-zones)`
	Clean up face zone names by removing IDs wherever possible	`(tgapi-util-clean-face-zone-names)`
	Remove the zone ID (`:id`) from zone ID list.	`(tgapi-util-remove-ids-from-zone-names '(zone-id-list))`
Change zone ID	Renumber zone IDs starting from the number specified (`start-number)`.	`(tgapi-util-renumber-zone-ids '(zone-id-list) start-number)`
Rename objects	Renames the object	`(tgapi-util-rename-object "old-object-name" "new-object-name")`
Rename objects	Rename objects by replacing the object suffix with a new suffix	`(tgapi-util-replace-object-suffix '(object-name) "separator" "new-suffix")`
Rename labels	Renames the face zone label	`(tgapi-util-rename-label "object-name" "old-label-name" "new-label-name")`
Rename labels	Rename labels by replacing the label suffix with a new suffix	`(tgapi-util-replace-label-suffix '(object-list) "separator" "new-suffix")`
Copy labels	Copy labels from one face zone to another. Specify either face zone names or IDs	`(tgapi-util-copy-labels from-face-zone to-face-zone)`
Merge zones	Merges the specified face zones. Specify a list of zone IDs or name pattern.	`(tgapi-util-merge-face-zones '(zone-id-list))`
		`(tgapi-util-merge-face-zones "zone-name-pattern*")`
	Merges face zones of a given type based on name pattern	`(tgapi-util-merge-face-zone-of-type 'zone-type "zone-name-pattern*")`
	Merges face zones containing the specified prefix	`(tgapi-util-merge-face-zones-with-same-prefix "prefix")`
	Merges the specified cell zones. Specify a list of cell zones or name pattern.	`(tgapi-util-merge-cell-zones '(cell-zone-list))`
		`(tgapi-util-merge-cell-zones "cell-zone-name-pattern*")`
	Merge cell zones containing the specified prefix	`(tgapi-util-merge-cell-zones-with-same-prefix "prefix")`
	Merge cell zones containing the specified suffix	`(tgapi-util-merge-cell-zones-with-same-suffix "suffix")`
Separate	Separates cells that are connected to specified face zones into another cell zone. This separation method applies only to prism cells. Specify the number of layers of cells (`nlayers`) to be separated.	`(tgapi-util-separate-cell-zone-layers-by-face-zone '(cell-zone-id) '(face-zone-list) nlayers)`
		`(tgapi-util-separate-cell-zone-layers-by-face-zone '(cell-zone-id) "face-zone-name-pattern*" nlayers)`
		`(tgapi-util-separate-cell-zone-layers-by-face-zone "cell-zone-name" '(face-zone-list) nlayers)`
		`(tgapi-util-separate-cell-zone-layers-by-face-zone "cell-zone-name" "face-zone-name-pattern*" nlayers)`
	Separate face zones based on the cell neighbors.	`(tgapi-util-separate-face-zones-by-cell-neighbor '(face-zone-list))`
	Separate face zones based on the cell neighbors.	`(tgapi-util-separate-face-zones-by-cell-neighbor "face-zone-name-pattern*")`
Refine	Refine marked faces	`(tgapi-util-refine-marked-faces-in-zones '(face-zone-list))`
Refine	Refine marked faces	`(tgapi-util-refine-marked-faces-in-zones "face-zone-name-pattern*")`
Patch	Fill holes associated with free edges for the face zones specified, based on the number of free edges (`max-hole-edges`)	`(tgapi-util-fill-holes-in-face-zone-list '(face-zone-list) max-hole-edges)`
Patch		`(tgapi-util-fill-holes-in-face-zone-list "face-zone-name-pattern*" max-hole-edges)`
Project	Project a zone on the plane specified. Specify three points for defining the plane.	`(tgapi-util-project-zone-on-plane zone-id plane)`
Delete	Deletes all sub-domains (all domains other than global)	`(tgapi-util-delete-all-sub-domains)`
	Delete marked faces	`(tgapi-util-delete-marked-faces-in-zones '(face-zone-list))`
	Delete marked faces	`(tgapi-util-delete-marked-faces-in-zones "face-zone-name-pattern*")`
	Delete empty zones based on the zones specified	`(tgapi-util-delete-empty-face-zones '(face-zone-list))`
		`(tgapi-util-delete-empty-face-zones "face-zone-name-pattern*")`
		`(tgapi-util-delete-empty-edge-zones '(edge-zone-list))`
		`(tgapi-util-delete-empty-edge-zones "edge-zone-name-pattern*")`
		`(tgapi-util-delete-empty-cell-zones '(cell-zone-list))`
		`(tgapi-util-delete-empty-cell-zones "cell-zone-name-pattern*")`
		`(tgapi-util-delete-empty-zones '(zone-list))`
		`(tgapi-util-delete-empty-zones "zone-name-pattern*")`
Validate mesh	Report if the boundary face zone exists	`(tgapi-util-boundary-zone-exists? zone-id)`
	Report if the boundary face zone exists	`(tgapi-util-boundary-zone-exists? 'zone-name)`
	Report if the interior face zone exists	`(tgapi-util-interior-zone-exists? zone-id)`
	Report if the interior face zone exists	`(tgapi-util-interior-zone-exists? 'zone-name)`
	Report if the cell zone exists	`(tgapi-util-cell-zone-exists? zone-id)`
	Report if the cell zone exists	`(tgapi-util-cell-zone-exists? 'zone-name)`
	Report if the volume mesh exists	`(tgapi-util-mesh-exists?)`