Zpreload#

Description#

This command is used to “pre-load” a Z-mat material file, enabling users to debug syntax errors and obtain information regarding the state variable allocation that must be passed to external FE solvers (such as Abaqus, Ansys, Forge, Samcef, Ls-Dyna, etc.). The command can also be utilized to examine the available keywords in the Z-mat and user libraries.

In normal run mode, the command loads the material file as if it were executing in external solvers, outputting the variable names and storage locations along with their associated output variables. Additionally, it suggests commands that should be added to the input file for some external solvers. As such, this command is highly useful during post-processing and for organizing the output commands to be included in the input file.

We recommend that every Z-mat input file be verified using this command. Doing so will help eliminate potential issues and save time by preventing unnecessary delays during the initial run of the problem.

Syntax#

% Zpreload [ options ] mat_file \(\hookleftarrow\)

The command line options are as follows:

CODE

DESCRIPTION

-h

gives a list of available switches for the command

-H

outputs all the keywords which are auto-loaded in the Z-mat and user libraries

-d dim

takes an integer parameter dim defining the space dimension for the behavior loading (by default, dim=3)

Example#

Consider a material file gen_evp.mat:

***behavior gen_evp
 **elasticity
   young 200000.0
   poisson 0.3
 **potential gen_evp ep
  *criterion mises
  *isotropic constant
   R0 250.0
  *kinematic nonlinear
   C 0.0
   D 100.0
***return

To preload this file

Zpreload gen_evp.mat

The output of this command is

============================================
Flux Name:
  sig11  sig22  sig33  sig12  sig23
  sig31

Grad Name:
  eto11  eto22  eto33  eto12  eto23
  eto31

var_int Name:
  eel11(sdv1) eel22(sdv2) eel33(sdv3) eel12(sdv4) eel23(sdv5)
  eel31(sdv6)
  epcum(sdv7)
  al111(sdv8) al122(sdv9) al133(sdv10) al112(sdv11) al123(sdv12)
  al131(sdv13)

var_aux Name:
  epi11(sdv14) epi22(sdv15) epi33(sdv16) epi12(sdv17) epi23(sdv18)
  epi31(sdv19)
============================================
done with material file reading...

Temperature not needed...


- ABAQUS ---------------------------------
*MATERIAL,NAME=gen_evp.mat
*DEPVAR
  19
*USER MATERIAL,CONSTANTS=1
0.0
------------------------------------------

- ABAQUS Shells (run again with -d 2) ----
*TRANSVERSE SHEAR STIFFNESS
6.41026e+04*thick, 6.41026e+04*thick, 0.0
------------------------------------------


- LS Dyna --------------------------------
*CONTROL_ACCURACY
0, 4
*MAT_USER_DEFINED_MATERIAL_MODELS
$      mid        ro        mt       lmc       nhv     iorth     ibulk        ig
$    ivect     ifail  ithermal  ihyper  ieq_of_state
$       p1        p2
$
1, XXXX, 41, 2, 25   , 0, 1, 2
0, 0, 0, 0, 0
 1.667e+05,  7.692e+04
------------------------------------------


- FORGE3 --------------------------------
VAR PLASTIC_PWR=0.D0
VAR ELASTIC_PWR=0.D0
VAR STRAIN_RATE=0.D0
VAR EQ_STRESS=0.D0
VAR Q_TRANS=0.D0
VAR SOURCE_PWR=0.D0

ETA STRESSTENSOR(6)=exist
ETA EQ_STRAIN=exist

ETA eel(6)=exist
ETA epcum=exist
ETA al1(6)=exist
ETA epi(6)=exist
 ! extra Zforge variables
ETA temp0=exist
ETA eto(6)=exist
------------------------------------------