MPREAD

MPREAD, Fname, Ext, --, LIB
Reads a file containing material properties.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Fname

File name and directory path (248 characters maximum, including directory). If you do not specify the LIB option, the default directory is the current working directory. If you specify the LIB option, the default is the following search path: the current working directory, the user's home directory, MPLIB_DIR (as specified by the /MPLIB,READ,PATH command) and /ansys_dir/matlib (as defined by installation). If you use the default for your directory, you can use all 248 characters for the file name.

The file name defaults to Jobname.

Ext

Filename extension (eight-character maximum).

If you omit the default extension is MP. extension is units_MPL, where units is the system of units currently in use. (See the description of the /UNITS command.) For example, if /UNITS is set to SI, the extension defaults to SI_MPL.

--

Unused field.

LIB

Reads material library files previously written with the MPWRITE command. (See the description of the LIB option for the MPWRITE command.) The only allowed value for LIB is LIB.

The LIB field indicates that the specified file was written by MPWRITE using the LIB option, and that the file is consistent with the material library file format. When the MPREAD command executes, Mechanical APDL reads material properties defined in the specified file into the current Mechanical APDL working database. The currently selected material, as defined by the MAT command (MAT,MAT), determines the material number used when reading the material properties. The LIB option for MPREAD and MPWRITE supports storing and retrieving both linear and nonlinear properties.

Notes

Material properties written to a file without the LIB option do not support nonlinear properties. Also, properties written to a file without the LIB option are restored in the same material number as originally defined. To avoid errors, use MPREAD with the LIB option only when reading files written using MPWRITE with the LIB option.

If you omit the LIB option for MPREAD, this command supports only linear properties.

Material numbers are hardcoded. If you write a material file without specifying the LIB option, then read that file in via the MPREAD command with the LIB option, Mechanical APDL does not write the file to a new material number; instead, it writes the file to the old material number (the number specified on the MPWRITE command that created the file.)

This command is also valid in SOLUTION.

Menu Paths

Main Menu>Preprocessor>Loads>Load Step Opts>Other>Change Mat Props>Material Library>Export Library
Main Menu>Preprocessor>Loads>Load Step Opts>Other>Change Mat Props>Material Library>Import Library
Main Menu>Preprocessor>Loads>Load Step Opts>Other>Change Mat Props>Material Library>Select Units
Main Menu>Preprocessor>Loads>Load Step Opts>Other>Change Mat Props>Read from File
Main Menu>Preprocessor>Material Props>Material Library>Export Library
Main Menu>Preprocessor>Material Props>Material Library>Import Library
Main Menu>Preprocessor>Material Props>Material Library>Select Units
Main Menu>Preprocessor>Material Props>Read from File
Main Menu>Solution>Load Step Opts>Other>Change Mat Props>Material Library>Export Library
Main Menu>Solution>Load Step Opts>Other>Change Mat Props>Material Library>Import Library
Main Menu>Solution>Load Step Opts>Other>Change Mat Props>Material Library>Select Units
Main Menu>Solution>Load Step Opts>Other>Change Mat Props>Read from File