2.1.11. geom_canvas

---

Purpose

Changes the (three-dimensional) canvas of a spectral geometry description. Grid can be given as absolute or relative values, e.g. 16 16 16 or 2x 0.5x 32.

Usage

	> geom_canvas options Geom file(s) 
	

Options

-g / --grid [ auto ]

a,b,c grid of hexahedral box.

-o / =--offset=[ 0 0 0 ]

a,b,c offset from old to new origin of grid

-f / --fill [ 0 ]

(background) canvas grain index. "0" selects maximum microstructure index + 1

--float

use float input

--blank

blank out (optional) input canvas content

---

Example

> geom_canvas --grid 16 12 16 --offset 0 -4 0 --fill 0 < micro.geom > micro_supported.geom

This example demonstrates the combination of cropping and the addition of a supporting layer to an existing geometry of eight (periodic) grains discretized by 16 x 16 x 8 voxels.

The original geometry (Figure 1 (a)) is taken from micro.geom. Resulting geometry (Figure 1 (b)) is output to micro_supported.geom.

Option --fill 0 assigns to the new volume an index one larger than the maximum index found in the original geom file. Here, the maximum grain count was 8, hence the new (red) volume is filled with index 9 = 8+1.