CryDisGen Documentation ( version 1.0-Mar 2025 )

About CryDisGen

CryDisGen represents Crystal Dislocation Generator.

CryDisGen is a scientific software tailored for researchers and engineers working with crystal structures. Originally developed by Bian et. al. from Xi’an University of Architecture and Technology and Xi’an Jiaotong Univeristy, CryDisGen empowers users to create precise atomic models of general dislocation structures in crystals. With its robust modeling capabilities, this free tool supports academic, non-commercial, and commercial applications—making advanced crystallographic research more accessible and efficient. Now at version 1.0, CryDisGen is actively maintained with updates from its creators, ensuring reliable performance for its users.

---

Once you’re familiar with CryDisGen, we recommend bookmarking the page Tags in Parameter file, which provides quick access to all tags with clear explanations that the CryDisGen code uses in the Parameter file.

---

User Guide

Core structures of screw dislocations in single crystal FCC aluminum (left) and BCC niobium (right).

Contents:

• 1. Introduction
• 2. Download and Install
  • 2.1. Download
  • 2.2. Install
• 3. Usage
• 4. Input and output files
• 5. Parameter file
  • 5.1. General Format
  • 5.2. Sections
  • 5.3. Key Characteristics
  • 5.4. Purpose and Usage
• 6. Tags in Paramater file
  • 6.1. Indication tags
  • 6.2. Counter tags
  • 6.3. Parameter tags
• 7. Tools
  • 7.1. Create BCC region
  • 7.2. Create FCC region
  • 7.3. Helical surface
  • 7.4. Clip a crystal region
  • 7.5. Parameter file for loop array
  • 7.6. Parameter file for nested loops
  • 7.7. Parameter file for tetrahedron array
• 8. Examples
  • 8.1. Shockley partial loop
  • 8.2. Frank partial loop
  • 8.3. Stacking fault tetrahedron
  • 8.4. Dislocation helix
  • 8.5. Dislocation helix with a loop
  • 8.6. Double helical dislocations
  • 8.7. Nested full dislocation loop
  • 8.8. Stacking fault tetrohedron array
  • 8.9. Full dislocation loop array
  • 8.10. Combination of dislocations

Appendix:

• 1. Contact
• 2. Reference

Web Browser Compatibility

The HTML version of the manual makes use of advanced features present in “modern” web browsers. Please use the web browser such as Google Chrome, Apple Safari, or Microsoft Edge to open and read the HTML version of this manual.