Skip to content

Latest commit

 

History

History
16 lines (10 loc) · 2.18 KB

ccmake-options.md

File metadata and controls

16 lines (10 loc) · 2.18 KB

Compiling sections of EMsoft

EMsoft contains a large number of programs for a number of electron scattering modalities as well as other modalities (optical microscopy, XRD, ...). Compilation of different modalities can be controlled by means of CMake switches that can be accessed readily using the ccmake program. When the following command is executed inside the EMsoftBuild/Release folder in a command window:

  ccmake ../../EMsoft

a simple interface showing name-value pairs appears; a screen shot of the interface on Mac OS X is shown here:

Screen shot of ccmake, showing the EMsoft configuration switches

The parameters are listed on the left, their values on the right inside the dark background box. Use the arrow keys to navigate the cursor to a particular value field; hit enter to activate editing of the field if it is a text field, or to toggle its value between all possible values. In an editable field, press enter again to leave editing mode. The red box outlines a number of switches that can be used to control compilation; for instance, to turn compilation of TEM programs off, navigate to the EMsoft_enable_TEM switch and toggle its value to OFF. When all parameters have been set correctly, hit the c-key to configure, then the g-key to generate the new make files; if any asterisks appear in front of value fields, press the c-key again until no more asterisks are present. The program will terminate when the generation process ends; recompile the EMsoft package using make -j or nmake, depending on your platform. If only EBSD dictionary indexing is needed, it is sufficient to turn all switches to OFF, except for EMsoft_enable_DictionaryIndexing, EMsoft_enable_SEM, EMsoft_enable_HDF5_SUPPORT, and EMsoft_enable_Utilities.

Starting with release 4.3, you can also control compilation of the spherical indexing codes (EMSphInx) by turning the new switch EMsoft_enable_EMSphInx to ON.

To activate the compilation of the EMsoftWorkbench, toggle the corresponding EMsoft_enable_EMsoftWorkbench parameter to ON; note that this requires that the Qt library has been installed in the SDK.