Revision as of 12:57, 14 March 2016 by Brauer (Talk | contribs)

Jump to: navigation, search



The microscale material model is a research code that have been developed outside and used at CAVS for modeling dislocation interactions and reactions in an elastic continuum. The code is used in a hierarchical multiscale framework of the plasticity to obtained information related to the hardening of the material (see for example multiscale framework‎). Details of the discrete dislocations model can be found in the methodology‎ paper. This particular site contains the research code that has been developed outside for performing and analyzing discrete dislocations simulation results. The research codes used at CAVS comes with a user's manual. We caution the user that there is some risk in using the research version of the codes. For any questions that are not addressed in the user's manual or the 'readme' files accompanying the code, please contact the code developers.

The discrete dislocation simulation code can be used for HCP, BCC and FCC materials.



Source code and inputs can be downloaded from this link.

Run MDDP from a Linux terminal using the single Frank-Read source (SFRS) input and/or the multiple Frank-Read sources (MFRS) input. Be sure to change the data file to reflect the properties of the material you wish to study. The inputs from the zip file are setup for aluminum. After running MDDP using the given input files you can post process to obtain stress-strain plots and the location/orientation of dislocations as follows:

Visualization of the dislocation structure

TecPlot is a general postprocessor which offers enhanced capabilities and can read output data from different software. The output files from MDDP are configured to be ready used with TecPlot. The information describing the dislocation structure is dumped into a chain of files starting with “tech” followed by a series number of the file (tech002, tech004, etc.). Each file has the dislocation structure data for 500 time steps. The first 500 steps are written to tech002, the next 500 steps are written to tech004, and so on. This is done in order to keep the files’ size reasonable. To visualize the dislocation structure, open TecPlot and follow these steps:

  • From File-->Load Data Files ‐‐ change Files of type: to TecPlot Data Loader and browse for the directory in which you ran the executable
  • In the File name: box type te* and hit enter
  • The folder should populate with files from tech002 to techIJK (where IJK is the final number of tech files generated)
  • Select all of the files you wish to load, and click Open
  • Under Plot change XY Line to 3D Cartesian
  • From the Plot drop menu, select Axis and from the Axis Details box, check the Show Axis box to show all axes; uncheck Preserve length when changing range, and change the Min: and Max: values for each axis to -6000 and 6000, respectively; click Close
  • Under Plot go to Vectorvariableschoose V1, V2, and V3 for U, V, and W respectively. Then go to VectorLength and make sure that the Relative Grid Units/Magnitudes set to 1.0 by going to and click Close
  • Click Zone Style... select all of the zones and uncheck Show Zone; Click on Zone 001 and check Show Zone
  • On the left hand side of the screen, check the box next to Vector. You should be able to see the initial dislocation lines and use the typical controls to rotate, zoom, etc. to help you visualize the structure
  • To visualize the structure at different time steps, under DataEdit Time Strands... Select Constant Delta and ensure that Delta: is set to 1; Click Apply (For a large amount of zones this will take somewhere between 10 minutes and 1 hour to animate)
  • An area for animation playback should appear with play, step forward, and go to end blue- colored buttons; you should now be able to play the animation\
  • You can modify the speed of playback by clicking Details... next to Solution time:

XY plot of time histories and stress-strain curves

The main file that contains this information is DDtimeResults.out, which plots the history of multiple variables including the dislocation density, stress, strain, etc. Each plot is referred to as a map in TecPlot. Open TecPlot and follow these steps:

  • From File-->Load Data Files ‐‐ change Files of type: to TecPlot Data Loader and browse for the directory in which you ran the executable
  • In the File name: box type DD* and hit enter
  • Choose DDtimeResults.out and click Open
  • The initial XY plot will be a disDensity vs. timenow; you can change this by clicking Mapping Style...
  • In the Mapping Style window you will have several map numbers with corresponding names and the variables they are plotted against
  • To create the stress-strain curve for your DDtimeResults.out uncheck Show Map for disDens... and check Stress; Right-click on 1:timenow to change the x-axis variable to 4:Strain
  • From the Plot drop menu, select Axis and from the Axis Details box, click Reset Range and select Reset to Nice Values; select Y1 at the top and repeat the previous procedure; click Close
  • You can now repeat the entire process to produce other curves such as dislocation density vs. stress or strain

Material Models


Multiscale Dislocation Dynamics Plasticity (MDDP) is a discrete dislocation dynamics (DD) model for crystalline materials coupled by finite element (FE) analysis developed by Hussein M. Zbib and colleagues [1].

MDDP simulations can run for calibration of data upscaled from atomistic scale calculations. It is run from an executable and requires two input files. For example, for modeling crystal plasticity in aluminum, the code MDDP can be used to calibrate values of dislocation mobility determined from molecular dynamics simulations. Stress-strain curve data can then be used to upscale to the mesoscale crystal plasticity length scale [2] [3].


For additional information regarding MDDP, please view the MDDP Manual.

This section includes links to versions of the discrete dislocation dynamics codes. microMegas is commonly used at CAVS to simulate the behavior of dislocations for metals at the microscale.

  • microMegas (download the original microMegas code from the French Aerospace Lab here)
    • mM v.1.0: serial version with Intel Compiler Optimizations (download mM v. 1.0 from the Codes Repository at CAVS here, using "Download GNU tarball"; compile it as 'mm')
    • mM v.1.0: parallel version with Intel Compiler Optimizations and MPI (download mM v. 1.0 from the Codes Repository at CAVS here, using "Download GNU tarball"; compile it as 'mmp')
    • mMpar v.1.0: parallel version of mM v.1.0 using openMP threads (download mMpar v. 1.0 from the Codes Repository at CAVS here, using "Download GNU tarball"; compile it as 'mm_omp')

See Tutorials

Microscale Research







Please remember to cite the following references when publishing results obtained with microMegas:

  • F. M. Ciorba, S. Groh and M. F. Horstemeyer. Parallelizing discrete dislocation dynamics simulations on multi-core systems. 10th Int. Conf. on Computational Science, Procedia Computer Science, 1:1, pp. 2129-2137, 2010.
  • S. Groh, E. B. Marin, M. F. Horstemeyer, and H. M. Zbib. Multiscale modeling of the plasticity in an aluminum single crystal. Int. J. of Plasticity, 25, pp. 1456-1473, 2009.
  • S. Groh and H. M. Zbib. Advances in Discrete Dislocations Dynamics and Multiscale Modeling, J. Eng. Mater. Technol. vol. 131:4, 041209 (10 pages), 2009.
  • Multiscale Modeling of Heterogenous Materials: From microstructure to macro-scale properties. Chapter 2: Discrete Dislocation Dynamics: Principles and Recent Applications (by Marc Fivel). Edited by Oana Cazacu. Published by Wiley. ISBN: 9781848210479, 2008.
  • B. Devincre, V. Pontikis, Y. Brechet, G.R. Canova, M. Condat and L.P. Kubin. Three-dimensional Simulations of Plastic Flow in Crystals. Plenum Press: New York, M. Marechal, B.L. Holian (eds.), 1992, p. 413
  • L.P. Kubin and G. R. Canova. The modelling of dislocation patterns. Scripta Metall., 27, pp. 957-962, 1992

back to the Material Models home

Cite error: <ref> tags exist, but no <references/> tag was found


This category has the following 4 subcategories, out of 4 total.

Pages in category "Microscale"

The following 56 pages are in this category, out of 56 total.









M cont.








Personal tools

Material Models