The SuperBatchTransform command auto-generates image stimuli by rendering 3D head models in Morphanalyser. Each output image can be manipulated to transform (warp) the models and apply arbitrary rotations. From this it is possible to generate a wide range of animated stimuli, by varying the amount of a transform of view angle.

The SuperBatchTransform is driven by Comma Separated Value files (CSV) produced by spreadsheet programs (e.g. Excel). (Use the Comma Separated Value (CSV) file option in the Save As… file dialog in Excel). The first row in each file must be a series of text labels (headers) describing the columns. The names here are very important as they are used to determine how to use the contents of the column bellow. The order the columns appear is not important, the name of the header is. Each row holds a description of an individual image to produce. There needs to be a blank line at the end, or the last row will not be executed.

The available headers are:
image – The name of the image generated using the values specified in this row. This must be specified.
template – the name of a template. This is not used but this column must exist and something appear here.

Warp options.
input – the file name of a mesh (.obj file) to load to produce the image. This must appear. This is the object that will appear in each rendered image.
source – [optional] File name used to specify the start mesh in a 3D warp.
target - [optional] File name used to specify the target mesh in a 3D warp.
shape - [optional] Number value (decimal point fraction) between 0.0 and 1.0 the specify how much of the warp to apply. Requires both source and target to be specified.

Angle options (type 1).
angle_x – [optional] Number value, specifies the angle of display (around the x-axis - head nodding, positive up)
angle_y – [optional] Number value, specifies the angle of display (around the y-axis - head shaking, positive shows left cheek)
angle_z – [optional] Number value, specifies the angle of display (around the z-axis - 180 is inverted, positive is clockwise)

Angle options (type 2), all seven of these must be present if any are.
start_angle_x – [optional] Number value. Specifies the start angle (x-axis) of a rotation animation.
start_angle_y – [optional] Number value. Specifies the start angle (y-axis) of a rotation animation.
start_angle_z – [optional] Number value. Specifies the start angle (z-axis) of a rotation animation.
end_angle_x – [optional] Number value. Specifies the end angle (x-axis) of a rotation animation.
end_angle_y – [optional] Number value. Specifies the end angle (y-axis) of a rotation animation.
end_angle_z – [optional] Number value. Specifies the end angle (z-axis) of a rotation animation.
angle_fraction – [optional] Number value 0.0 to 1.0. Specifies position between the start and end angle for the current image.

Image size
image_width – [optional] The width of the output image (max 2000)
image_height – [optional] The height of the output image. (max 2000)

Position of the head in the image frame
position_x – [optional] The horizontal position of the head. Range [-0.5 … 0.5]
position_y – [optional] The vertical position of the head. Range [-0.5 … 0.5]
position_z – [optional] The distance into the screen of the head. Range [0 … 1]

Locations of the lights
Morphanalyser uses two light sources, the location of which is described using two angles, phi and theta
light_phi_1 – the phi angle of the first light
light_theta_1 – the theta angle of the first light
light_phi_2 – the phi angle of the second light
light_theta_2 – the theta angle of the second light

The headers are case sensitive and must appear exactly as shown above. All files are loaded relative to the directory containing the CSV SuperBatchFile.
Example. This example produces two images, test1 and test2. The subject f_1229_eybrw_warped.obj and loaded and a warp between the average.avg and pca0.obj define. The first image uses half the warp and the second uses twice the defined warp.

image,template,input,source,target,shape
test1.jpg,test.tem,f_1229_eybrw_warped.obj,average.avg,pca0.obj,0.5
test2.jpg,test.tem,f_1229_eybrw_warped.obj,average.avg,pca0.obj,2