**process clip_image

Description

This command is used to generate maps of Gauss point variables inside a predefined cut plane. Produced images are 256 colors GIF files where the value for each pixel is the value of the closest Gauss point. It is also possible to obtain the mean of the element Gauss point values. This process can be quite long as the image is generated finding the element location of each pixel in the structure.

Syntax

**process clip_image \(~\,\) *list_var var1 var2 … \(~\,\) *output output-file-name \(~\,\) *P0 vector \(~\,\) *P1 vector \(~\,\) *P2 vector [ *ortho ortho-dir-value ] [ *step spatial-step-value ] [ *dimx dimx-value ] [ *dimy dimy-value ] [ *color_map color-map-name ] [ *min_max mode ] [ *mini min-value ] [ *maxi max-value ] [ *values type ] [ *transparency background-color ] [ *draw_limits_between_elsets ] [ *elsets_start_with prefix ] [ *latex orientation ]

*list_var

specifies Gauss point variables to be plotted.

*output

is used to specify the gif output file name.

*P0, P1, P2

specify points describing the cut plane: image will be plotted for all \(P=P0+\alpha\,P0P1+\beta\,P0P2\) with \((\alpha,\beta)\in[0,1]^2\).

*ortho

is used to impose an orthogonal (P0,P1,P2) base. If value 1 is given a new P2 point will be searched as the projection of the original P2 point on a direction normal to P0P1. If value 2 is given, the same process if done for P1 point respecting P0P2 direction.

*step

is used to impose the spatial pitch of generated image pixels.

*dimx, *dimy

are used to imposed the number of pixel used in P0P1 and P0P2 direction (length and height of the GIF image). If only one parameter is set, the other will be computed as to respect a spatial aspect ratio. Note that at least one of the commands step dimx dimy must be specified.

*color_map

specifies the color map that will be employed, choice are one of: default, bone, broken, BW, BW2, cool, copper, hot, HSV, inv_default, inverse, jet, Low_white, pink, prism, PS-default, White_to_dark (same as those in the Zmaster interface).

*min_max

is used to specify how the scale bar limits are determined and can be manual or auto. Default behavior is auto. If manual mode is selected, user has to provide min and max values thanks to the *mini and *maxi keywords.

*values

is used to specify if the values are taken as closest Gauss point (integration_point, which is the default behavior), as the mean of the element Gauss point values (average_in_element) or as the values of the continuous field which has been extrapolated to the nodes from the Gauss points values (at the global scale, not element-wise) and then interpolated (interp).

*transparency

is used to specify the background color in order to produce transparent pixels when no element are found. It can be white or black.

*draw_limits_between_elsets

print limits between elsets with background color (useful to visualize grain boundaries inside polycrystals).

*elsets_start_with

is used specify what is the prefix of the involved elsets to print limits between. By defaults, all elsets are involved.

*latex

requires portrait or landscape modifier. This command will generate latex and PDF files containing generated images with color bars, if a valid imagemagick and latex environment is present.

Example

**process clip_image
 *list_var sig23
 *output cuts
 *P0 (-1. -1. 0.)
 *P1 (41. 0. 4.)
 *P2 (0. 41. 4.)
 *dimx 1000
 *ortho 1
 *latex portrait