MPS Commands

Basic Operations

quit

end the program; end of file (control-D) also terminates the program;

read file-name format-name

write file-name format-name

The input and output commands are of the same form. The first argument is the name of the file containing the data. The second is the name of the format to be read. Formats for input and output are described in MPS Input Formats and MPS Output Formats. The file is not closed after reading or writing, so you can keep many data objects in a single file.

close file-name

close-file file-name

close the named file. This is typically used if you want to reread the data from the file, or if you write a file and want to read it in.

Output Options

output-parameterization parameterization-name

output-angle-units unit-string

specify whether angles should be in degrees or radians; unit-string has possible values degrees or radians

output-weights true|false

setting this to true will have the program write weights with the orientations on output;

output-hardnesses true|false

setting this to true will have the program write hardness values with the orientations on output;

Control Variables

time-increment real-number

this specifies the size of the time step;

linking-assumption option

there are only two choices; iso-strain-rate assigns the same strain rate to all grains; iso-stress assigns the same stress to all grains; currently, iso-stress is not yet implemented.

Initializations

If weights are read in the orientation file, you still need to call normalize-weights to ensure they sum to unity; otherwise, you need to call initialize-weights after reading the orientations.

initialize-weights

this initializes the weights uniformly; nonuniform weights would be read in with the orientations;

initialize-hardnesses real-number

initialize all of the hardnesses to a constant value; a nonuniform hardness field would be read in with the orientations;

normalize-weights

this rescales the weights so that they sum to one;

rescale-velocity-gradient real-number

this multiplies the velocity gradient by a constant

High Level Commands

take-time-steps integer-number

advance the material state in time; integer-number is the number of time steps to take; this assumes that the time increment has been specified; note that you use this command multiple times and change various data in between calls;

compute-list-of-stresses

compute the stress tensors associated with a list of deformation rates; this is for the discrete yield surface calculation; the stresses are computed using the polycrystal model for each one, as compared to the analagous low-level command which computes the stresses at the single crystal level

Low Level Commands

compute-dees-from-stresses

compute-stresses-from-dees

spread-dee-prime-to-grains

spread-sigma-prime-to-grains

convert-dee-prime-to-crystal

convert-dee-prime-to-sample

convert-sigma-prime-to-crystal

convert-sigma-prime-to-sample

these are various functions to operate on the crystal stresses or deformation rates;

compute-taylor-factors-from-stresses

this computes the taylor factor for each crystal from the single crystal stress value; it prints the values to the screen; the values are not saved; it assumes that the current values of single crystal stresses are correct;