Crystal Morphology

Tutorial Created with Software Release: 2026-1
Topics: Pharmaceutical Formulations
Methodology: All-Atom Molecular Dynamics
Products Used: Desmond, MS Maestro, MS Morph

Tutorial files

104 MB

This tutorial is written for use with a 3-button mouse with a scroll wheel.
Words found in the Glossary of Terms are shown like this: Workspacethe 3D display area in the center of the main window, where molecular structures are displayed

 

Tip: You can hover over a glossary term to display its definition. You can click on an image to expand it in the page.
Abstract:

 

In this tutorial, we will learn to predict the macroscopic shape of a crystal using the Crystal Morphology and Wulff Viewer panels in Materials Science Maestro.

 

Tutorial Content
  1. Introduction to Crystal Morphology

  1. Creating Projects and Importing Structures

  1. Generating Slabs and Running the Crystal Morphology Calculation

  1. Analyzing the Crystal Morphology Output with the Wulff Viewer

  1. Conclusion and References 

  1. Glossary of Terms

1. Introduction to Crystal Morphology

Computational prediction of crystal morphology, the macroscopic shape of crystals, is a powerful technique with particular application in pharmaceutical formulation. Practically, tabletability and its effect on delivery, can be understood and controlled with insights regarding the morphology of the crystal. Given a known crystal structure, we can employ the Crystal Morphologyinterchangeably referred to as crystal habit or crystal shape; the set of planes that show on the crystal surface, given by the relative areas of the crystal faces; the macroscopic shape of the crystal and Wulff Viewer panels in Materials Science (MS) Maestro to predict the shape of the macroscopic crystal.

Crystal Morphology method utilizes the Gibbs Principle stating that the equilibrium crystal shape (also referred to as crystal habit) minimizes the crystal’s surface energy. It is assumed that the ideal crystal shape is a polyhedron with the faces representing crystal surfaces with low surface energy. Crystal surfaces are uniquely defined by their Miller indices. Thus the Gibbs Principle takes the form:

∆G = min{∑hklmhklAhklƔhkl},           (1)

Where Ɣhkl, mhkl, and Ahkl  denote respectively the surface energy, multiplicity and the relative area of the crystal surface {hkl}, and the summation taken over all {hkl} triplets corresponding to the lowest energy crystal surfaces.

According to the Wulff theorem, the crystal habit minimizing the free energy (Eq. 1) can be generated using Wulff’s construction. For each surface {hkl}, build vector rhkl with length |Ɣhkl| from origin, and construct a plane normal to rhkl. The inner envelope of all of these planes forms the equilibrium crystal shape:

Note that per this construct, faces with high surface energy do not contribute to the crystal shape, as their length |Ɣhkl| will likely be outside of the inner envelope:

Thus, the problem of crystal morphology is reduced to calculations of surface free energy, Ɣhkl, for multiple surfaces, identification of surfaces with lowest energy and generation of the Wulff shape.  

The workflow begins with inputting the unit cell of the known crystal structure that could be obtained as a .cif file from a suitable database or built manually using Crystal Builder. Then, surface models represented by the slab model are generated (defined by miller indices {hkl}). Next, the surface energya measure of the excess energy present at the surface of a material in comparison to at its bulkhkl) is calculated according to the following expression

where Eslab is the total non-bonding interaction energy of a slab model for the surface {hkl}, Ebulk is the cohesive energy per molecule of the bulk crystal and nslab is the number of molecules in the slab model. Finally, the Wulff construction is applied to obtain the crystal shape, relative crystal area of different facets and other useful properties.

The workflow in MS Maestro facilitates and automates these calculations.

Figure 1. Overview workflow showing the lamotrigine 2D structure, the unit cell, a slab and the crystal habit.

In this tutorial, we will predict the crystal morphology of a known active pharmaceutical ingredient (API), lamotrigine, using the periodic structure tools, as well as the Crystal Morphologyinterchangeably referred to as crystal habit or crystal shape; the set of planes that show on the crystal surface, given by the relative areas of the crystal faces; the macroscopic shape of the crystal and Wulff Viewer panels.

2. Creating Projects and Importing Structures

At the start of the session, change the file path to your chosen Working Directorythe location where files are saved in MS Maestro to make file navigation easier. Each session in MS Maestro begins with a default Scratch Projecta temporary project in which work is not saved, closing a scratch project removes all current work and begins a new scratch project, which is not saved. A MS Maestro project stores all your data and has a .prj extension. A project may contain numerous entries corresponding to imported structures, as well as the output of modeling-related tasks. Once a project is created, the project is automatically saved each time a change is made.

Structures can be imported directly or from your Working Directorythe location where files are saved using File > Import Structures, and are added to the Entry Lista simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion and Project Tabledisplays the contents of a project and is also an interface for performing operations on selected entries, viewing properties, and organizing structures and data. The Entry Lista simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion is located to the left of the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed. The Project Tabledisplays the contents of a project and is also an interface for performing operations on selected entries, viewing properties, and organizing structures and data can be accessed by Ctrl+T (Cmd+T) or Window > Project Table if you would like to see an expanded view of your project data.

  1. Double-click the Materials Science icon

Figure 2-1. Change Working Directory option.

  1. Go to File > Change Working Directory
  2. Find your directory, and click Choose
  3. Pre-generated files are included for running jobs or examining output. Download the zip file here: schrodinger.com/sites/default/files/s3/release/current/Tutorials/zip/crystal_morphology.zip
  4. After downloading the zip file, unzip the contents in your working directorythe location where files are saved for ease of access throughout the tutorial

Figure 2-2. Save Project panel.

  1. Go to File > Save Project As
  2. Change the File name to crystal_morphology_tutorial, click Save
    • The project is now named crystal_morphology_tutorial.prj

Figure 2-3. The structure after directly importing the provided cif.

  1. Go to File > Import Structures
  2. Navigate to where you downloaded the provided tutorials, choose lamotrigine_EFEMUX01.cif and click Open
    • A new entry is added to the entry lista simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion

Figure 2-4. Renaming and stylizing the structure.

  1. Rename the entry lamotrigine (double-click on the entry name in the entry list to rename)
  2. Select all of the atoms in the workspace (this can be done in several ways, including using Quick Select: All from the toolbar )
  3. From the Style palette (), change to ball-and-stick with the Apply ball-and-stick representation button
    ()
  4. From the Style palette (), change to Color Atoms Element by using the dropdown and selecting Element, then clicking Color Atoms Element in the palette
    • The atom coloring should be updated to match the figure

Figure 2-5. Building the unit cell.

Note, .cif files typically contain lattice parameters, the space group of the crystal and coordinates of the atoms of the asymmetric unit. At the same time, the crystal morphology workflow requires the full crystal unit cell as an input.  To convert the  asymmetric unit to the complete unit cell, we use the periodic structure tool:

  1. Click on the button to open the Periodic Structure Tool Window
  2. Go to Build Cell and click Apply
    • The workspace is updated to now show the entire unit cell
    • Next to the Periodic Structure Tool icon, the green text indicates CELL: 1 x 1 x 1

 

This structure is now ready for crystal morphology calculations. For a complete summary of periodic structure tools, see the Building and Manipulating Crystal Structures tutorial.

3. Generating Slabs and Running the Crystal Morphology Calculation

This section demonstrates how to use the Crystal Morphologyinterchangeably referred to as crystal habit or crystal shape; the set of planes that show on the crystal surface, given by the relative areas of the crystal faces; the macroscopic shape of the crystal panel to set up and run the calculation for predicting the macroscopic structure of lamotrigine.

Figure 3-1. Selecting and including the entry and opening the panel.

  1. Ensure that lamotrigine is selected(1) the atoms are chosen in the Workspace. These atoms are referred to as "the selection" or "the atom selection". Workspace operations are performed on the selected atoms. (2) The entry is chosen in the Entry List (and Project Table) and the row for the entry is highlighted. Project operations are performed on all selected entries in the entry lista simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion and includedthe entry is represented in the Workspace, the circle in the In column is blue in the workspacethe 3D display area in the center of the main window, where molecular structures are displayed
  2. Go to Tasks > Materials > Classical Mechanics > Crystal Morphology > Crystal Morphology Calculations

Figure 3-2. Loading the bulk structure and enumerating planes.

  1. Click Load Bulk from Workspace
    • lamotrigine appears next to the button

In cases where you know in advance which Miller planes contribute most significantly to the crystal morphology (typically based on experimental data or previous calculations), you can input a Single plane by inputting the indices and clicking Add.

More commonly, in cases where you do not know which planes will contribute most significantly, the Enumerate planes tool can be used

  1. Change the Min plane to -3, -3, -3 and the Max plane to 3, 3, 3 and click Enumerate
    • The planes table is populated with 99 unique Miller planes as well as their corresponding interplanar distance (dHKL) and multiplicity (mult.)
    • Note that these planes are unique to the particular unit cell

Figure 3-3. Sorting by interplanar distance.

In general, planes with larger interplanar distances are more likely to have smaller interplanar interactions, and therefore are expected to be more stable surfaces. These planes are more likely to contribute to the Wulff construction (Bravais-Friedel-Dannay-Harker model (BFDH)).

  1. Click on the dHKL column header twice tosort the crystal planes by their interplanar distance, dHKL, from the largest to the smallest 

Figure 3-4. Deleting planes with low interplanar distances.

Using the BFDH model argument, we can assume that the crystal facets with dHKL below ~4 Å are unlikely to contribute to the crystal habit. These facets can be excluded from the subsequent MD simulation.

  1. In the table, highlight rows 42-99 (be sure that these are the rows with dHKL < 4 Å) and click Delete
    • The table should now contain 41 rows

Figure 3-5. Defining the slab geometries.

Next, we generate slab models for the selected crystal planes:

  1. Change the Slab thickness to 4, the Vacuum buffer to 4 and the Cell extents to 4
    • n refers to the number of cells (n = 1 being the original cell size and slab thickness, etc.)
    • This will determine the geometry of the slabs; these values are reasonable. The thickness should ensure energy convergence, the vacuum buffer should avoid periodic image effects and the extents should give reasonable size cells for MD (see the Modeling Surfaces tutorial for more on preparing slabs)

Figure 3-6. Generating the 41 slabs.

As a general practice, you can view the slabs to be generated independent of the forthcoming MD simulation (i.e. view the slabs but do not perform the surface energy calculations). This is a good idea to confirm that all the slabs models are correct. For example, you want to avoid slabs with half monolayers on the top and bottom or cases of polar slabs with different termination at the top and bottom. In cases like these, you can adjust the slabs and then load them back into the panel.

In this example, the generated slabs are all sufficient for the MD simulation, but we will generate them anyway for visual inspection:

  1. Highlight all of the rows in the table and click Generate Slabs
    • When a Question appears, simply click OK. At this stage, some additional duplicates will be identified and removed
    • This process may take a minute or so

Figure 3-7. The bulk structure and some of the slabs tiled in the workspace.

A new entry group is added to the entry list titled morphology_1-surfaces (41) containing the bulk structure and the generated slabs.

Feel free to visualize any of the slabs. In the Figure we show the bulk structure and five of the slabs tiled.

In this case, we do not need to alter any of the slabs. In cases in which slab manipulation is necessary, you can Delete slabs from the table in the panel and use the Load Selected Entries button to load manipulated slabs back into the panel.

For background on manipulating slabs, visit the Modeling Surfaces tutorial

Figure 3-8. Setting the MD parameters.

Return to the panel to now define the Brownie simulation protocols:

  1. Change the Simulation time to 2000.0 ps
    • We recommend a minimum of 2 ns for the molecular dynamics simulation. Note, longer runs may be required to converge cohesive energy (see Section 4)
  2. Check Save intermediate data and maintain CMS files from the dropdown
    • This will provide the surfaces slabs after relaxation (useful for visualization and troubleshooting), but will not include the complete trajectories (disk-space intensive)

Figure 3-9. Naming and running the job.

  1. Change the Job name to morphology_lamotrigine
  2. This job takes about 4 hours on an 8 GPU Host. If you would like to run the job yourself, adjust your Job settings () as needed and click Run.
    • To run from the command line, use the Write option from the Job settings dropdown. Note that parallel calculation on multiple GPUs is supported for simultaneous calculation of surface energies for multiple slabs.
  3. Alternatively, if you would prefer to proceed with pre-generated structures, skip directly to Section 4 where you will be guided to import a provided output.

4. Analyzing the Crystal Morphology Output with the Wulff Viewer

After performing the Crystal Morphology calculation, we can proceed to visualize the bulk and slab models, confirm that their cohesive energies have converged and use the Wulff Viewer panel to predict the crystal morphology.

Figure 4-1. The entry list after running the job or importing (note that the output has been translated into the unit cell).

If you ran the job yourself, you can skip the importing step. Otherwise:

  1. Go to File > Import Structures
  2. Navigate to where you downloaded the provided tutorials, choose Section_04 > morphology_lamotrigine > morphology_lamotrigine-out.maegz and click Open
    • 41 entries are added to the entry list
    • These entries are the outputs of the MD simulations for the bulk crystal cell and each surface slab

Note: It is possible that some outputs may appear outside of the unit cell. This is purely visual, but can be adjusted with the Translate to First Unit Cell option in the Periodic Structure Tools ()

Figure 4-2. Viewing the cohesive energy for the bulk structure.

It is good practice to perform a trajectory analysis for the bulk or any of the slabs. For example, we might be interested in viewing the cohesive energy, the key output for the Wulff crystal shape prediction, to confirm convergence

  1. Go to Tasks > Materials > Classical Mechanics > Trajectory Analysis > MS MD Trajectory Analysis
  2. Go to the Bulk Properties tab
  3. Click Load
  4. Navigate to the morphology_lamotrigine_bulk-out.eaf file in the provided tutorial files and click Open
    • The top plot shows Volume (or Density from the dropdown), which is constant as expected (NVT calculation was performed).
    • The bottom plot shows the parameter of interest, Cohesive Energy. We can confirm that the running average of the energy is converged in the last 20% of the trajectory. This part of the trajectory will be used for calculation of the crystal morphology.

Figure 4-3. Viewing the cohesive energy for one of the slab structures.

  1. In the MS MD Trajectory Analysis, view an additional .eaf file, for example the {1,1,-1} slab as shown in the Figure

 

 

In this case, the cohesive energy is clearly converged before the final 20% of the trajectory. If this were not the case, a longer simulation time would be recommended in the initial Crystal Morphology calculations.

 

 

  1. Close the MS MD Trajectory Analysis panel

Figure 4-4. Including the lamotrigine unit cell and selecting the MD outputs.

Now, we can proceed to use the Wulff Viewer panel to predict the crystal morphology:

  1. Includethe entry is represented in the Workspace, the circle in the In column is blue the original lamotrigine entry in the workspacethe 3D display area in the center of the main window, where molecular structures are displayed and select(1) the atoms are chosen in the Workspace. These atoms are referred to as "the selection" or "the atom selection". Workspace operations are performed on the selected atoms. (2) The entry is chosen in the Entry List (and Project Table) and the row for the entry is highlighted. Project operations are performed on all selected entries the 41 entries output from the MD simulations
    • Recall that includethe entry is represented in the Workspace, the circle in the In column is blue means to fill the blue circle to show the structure in the workspace and select(1) the atoms are chosen in the Workspace. These atoms are referred to as "the selection" or "the atom selection". Workspace operations are performed on the selected atoms. (2) The entry is chosen in the Entry List (and Project Table) and the row for the entry is highlighted. Project operations are performed on all selected entries means to highlight the row in the entry list

Figure 4-5. The Wulff Viewer panel after loading the bulk and the slabs.

  1. Go to Tasks > Materials > Classical Mechanics > Crystal Morphology > Wulff Viewer
    • Alternatively, use the Workflow Action Menu (WAM) button to open the Wulff Viewer panel.
    • The Wulff Viewer panel opens
  2. If necessary, click Load Bulk from Workspace to load the unit cell into the panel, and Load Selected Entries to load the slabs into the Miller plane table
    • Your panel may already be populated, in which case, confirm it matches the one shown in the Figure and proceed. If the bulk is loaded, lamotrigine will appear next to the button, and if the slabs are loaded, the table will be populated

 

Before proceeding, note that the table looks similar to our input table, but now includes Energy J/m2 and Area Å2 which are the cohesive energies and physical surface areas of the slabs. These columns are sortable.

Figure 4-6. The structure after plotting with the table sorted by Relative Area.

  1. Click Plot
    • The viewer is updated with the macroscopic structure
  2. Click on the Relative Area column header twice to sort in descending order to see the planes with the greatest contribution to the structure

 

Note that lower surface energy slabs contribute more to the overall structure, but that symmetry and multiplicity can result in some slabs with slightly higher energies contributing more to the crystal.

Figure 4-7. The workspace view.

In addition to visualizing the macroscopic structure in the Wulff Viewer, we can view the plot in the workspace.

  1. Maintain Show in Workspace (or click the check if it is not selected)
  2. Check Show Miller indices
  3. Adjust your view so that you can see the workspacethe 3D display area in the center of the main window, where molecular structures are displayed, the plot is shown as well as the indices corresponding with the various planes

Figure 4-8. Turning on planes view.

It can be useful to view {hkl} crystal planes in the workspace.

  1. Open the Show Workspace Configuration panel ()
  2. Click Planes
    • The default {1,1,0} plane is shown in the workspace
  3. Click on the 3-dot icon to the right of Planes ()
    • The Crystal Planes panel opens

Figure 4-9. Viewing the {2,1,0} plane.

  1. For Plane 0, input 2, 1, 0 for h, k and l, respectively
    • The {2,1,0} plane is shown in the workspace

 

Feel free to explore adding and viewing additional planes in the workspace.

Figure 4-10. Viewing the crystal habit based solely on the interplanar distance.

It is useful to also be aware that the Wulff Viewer can be used to construct crystal habits without actually performing any molecular dynamics simulation. Recall that in general, planes with larger interplanar distances are more likely to have smaller interplanar interactions, and therefore are expected to be more stable surfaces. These planes are more likely to contribute to the Wulff construction according to the BFDH model.

 

  1. Return to the Wulff Viewer panel and check Use interplanar distance
    • The Wulff Viewer updates to display the predicted crystal habit using the simplest BFDH model
    • Clearly, without accounting for surface energy, the crystal habit prediction is too oversimplified

 

Note: In addition to viewing the output based on interplanar distance alone, if we were interested in simply generating a crystal habit for planes that we suspect will contribute, we can manually add those planes and Plot the resultant output. Use the Add, Delete and Plot buttons to explore this further.

Figure 4-11. Deleting the 0 0 2 entry.

  1. Return the viewer to the original output (uncheck Use interplanar distance and, if you added or deleted any planes, reload the entries from the workspace; or simply repeat steps 9-12).

Another way the Wulff Viewer can be used in a predictive fashion is by changing the Energy associated with any of the surfaces and viewing the expected crystal habit. In this way, we can consider strategies for altering our crystallization approach or formulation entirely towards some desired outcome. For example, let’s change the Energy of the {0 0 2} entry and see the effect on the crystal habit.

  1. Click to highlight the  0 0 2 row in the table
  2. Click Delete
    • The 0 0 2 row is removed from the table
    • Of course, we can always load the original data back in from the entry list

Figure 4-12. Manually changing the energy of a plane.

  1. In the Miller plane input at the top of the panel, enter 0 0 2 and click Add
    • The 0 0 2 row is added back to the table at the end
  2. Change the Energy to 0.1 by double-clicking on the default 1.0 energy and typing in the new energy
  3. Click Plot
    • The crystal habit is updated to demonstrate the effect of lowering the energy of the {0 0 2} slab

 

Feel free to explore manually utilizing the Wulff Viewer to study the effect of different slab contributions with different energy values. Such exploration may be useful for predictive efforts.

5. Conclusion and References

In this tutorial, we learned to predict the macroscopic shape of a crystal using the Crystal Morphology and Wulff Viewer panels in Materials Science Maestro.

For further learning:

For introductory content, focused on navigating the Schrödinger Materials Science interface, an Introduction to Materials Science Maestro tutorial is available. Please visit the materials science training website for access to 70+ tutorials. For scientific inquiries or technical troubleshooting, submit a ticket to our Technical Support Scientists at help@schrodinger.com.

For self-paced, asynchronous, online courses in Materials Science modeling, including access to Schrödinger software, please visit the Schrödinger Online Learning portal on our website.

For some related practice, proceed to explore other relevant tutorials:

For further reading:

6. Glossary of Terms

Crystal Morphology - interchangeably referred to as crystal habit or crystal shape; the set of planes that show on the crystal surface, given by the relative areas of the crystal faces; the macroscopic shape of the crystal

Crystal Plane - interchangeably referred to as a crystal facet or crystal surface; planes that make rational intercepts with crystallographic axes; such planes may represent crystal faces or cleavage planes

Entry List - a simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion

Included - the entry is represented in the Workspace, the circle in the In column is blue

Project Table - displays the contents of a project and is also an interface for performing operations on selected entries, viewing properties, and organizing structures and data

Recent actions - This is a list of your recent actions, which you can use to reopen a panel, displayed below the Browse row. (Right-click to delete.)

Scratch Project - a temporary project in which work is not saved, closing a scratch project removes all current work and begins a new scratch project

Selected - (1) the atoms are chosen in the Workspace. These atoms are referred to as "the selection" or "the atom selection". Workspace operations are performed on the selected atoms. (2) The entry is chosen in the Entry List (and Project Table) and the row for the entry is highlighted. Project operations are performed on all selected entries

Slab - a model of a crystal surface generated by cleaving a bulk structure

Surface Energy - a measure of the excess energy present at the surface of a material in comparison to at its bulk

Working Directory - the location where files are saved

Workspace - the 3D display area in the center of the main window, where molecular structures are displayed