Quick Installation Guide

This guide helps you to get a working TC-Toolbox for MATLAB® installation. It is only a short guideline, please refer to the Thermo-Calc Installation Guides for more details if required.

The present documentation is also included in your installation as a PDF-file. In the Thermo-Calc menu, select Help → Manuals Folder. Then double-click to open the Software Development Kits (SDKs) folder.

Note

A license is required to run TC-Toolbox for MATLAB®.

Note

TC-Toolbox for MATLAB® is available for Windows.

Installing TC-Toolbox for MATLAB®

Automatic Installation of TC-Toolbox

When the following conditions are met, Thermo-Calc automatically installs the TC-Toolbox for MATLAB® component on your computer.

  1. MATLAB® is already installed.

  2. There is only one Windows user on the computer where TC-Toolbox is being installed.

    Note

    Administrator privileges are needed when you start the Thermo-Calc installer.

Then follow the regular installation instructions for Thermo-Calc, choosing whether you use a Standalone or Network installation.

Manual Installation of TC-Toolbox

The installation is not automatic if:

  • There are multiple Windows users on the same machine, or

  • The installer cannot find the directory path to the MATLAB® installation.

Multiple Windows Users on Same Machine

If there are multiple Windows users on the same machine, then the following manual steps are done at the end of the automatic installation.

  1. A message at the end of the Thermo-Calc installation process displays with instructions.

  2. An Explorer window automatically opens to this folder C:\Users\<user>\Documents\Thermo-Calc\2023b\SDK\TC-Toolbox-MATLAB.

  3. Double-click the InstallTCToolboxMATLAB.cmd file to finalize the process. This briefly launches MATLAB® and installs TC-Toolbox.

Installer Cannot Find the MATLAB® Installation Directory

  1. Start the version of MATLAB® that you want to install TC-Toolbox in.

  2. Open and run the script C:\Users\<user>\Documents\Thermo-Calc\2023b\SDK\TC-Toolbox-MATLAB\setupTCToolbox.m.

For more information, se the more detailed instructions given in the Thermo-Calc Installation Guides.

Check the Installation

To check if the installation was successful start MATLAB® and run, for example, the diagnostics script, which is located in the folder C:\Users\<user>\Documents\Thermo-Calc\2023b\SDK\TC-Toolbox-MATLAB\Examples\Miscellaneous.

Alternatively open the Add-Ons menu (in the HOME tab) in MATLAB® and choose Manage Add-Ons. If the toolbox is installed it will be included in this list.

Uninstalling TC-Toolbox for MATLAB®

If you are logged in as a user with administrator rights, and have Thermo-Calc installed for this user, then the uninstallation is automatically done at the same time as a full Thermo-Calc uninstallation. Otherwise a manual step is required:

Note

To uninstall the TC-Toolbox for MATLAB® if it is not uninstalled by the Thermo-Calc uninstaller, start MATLAB® and select (in the HOME tab) Manage Add-Ons from the Add-Ons menu. Right-click TC-Toolbox and choose Uninstall.