Upgrade MATLAB and Simulink

Frequently Asked Questions


Getting Started

1. What are the recommended steps for upgrading?

For non-critical applications, the upgrade process is relatively straightforward. You simply install the new version of MATLAB into a new folder. The installer will not overwrite any other versions that are already installed.

For upgrading critical applications to newer releases of MATLAB and Simulink, MathWorks recommends the following process:

  • Assess: Understand the overall effect of the upgrade and determine if the benefits outweigh the costs.
  • Plan: Define the overall scope and plan for the project.
  • Migrate: Convert code, models, and custom tools in an iterative manner to the new release.
  • Test: Ensure that the code and models produce equivalent results between the new and previous releases.
  • Release and Support: Release the upgraded code and models, and support the rest of the organization through the upgrade process with a dedicated team.

2. How do I select which MATLAB and Simulink release to upgrade to?

Prior to deciding which MATLAB and Simulink release that you and your organization should upgrade to, review the following resources:

You should also review the platform availability by product, choosing a computer to run MATLAB and Simulink products, and adopting 64-bit Windows resources if they are applicable to your organization’s situation.

3. Where can I get a list of all major new features in each release so I can evaluate an upgrade?

A list of all major new features by product for the latest release can be found in the release notes

To see all features introduced each release for a particular product, go to that product’s specific release notes page (e.g., the MATLAB release notes and Simulink release notes pages).

4. What are the system requirements for the current release?

Review the system and platform requirements for the current release. You can also refer to the system and platform requirements for older releases.

5. How do I know which release I am currently using?

When you open MATLAB, the titlebar always shows the release number.

Alternatively, the MATLAB command ver can be used to determine the release of MATLAB you are using, along with other information such as license number, products installed, etc.

Refer to the documentation for syntax and examples.

6. I am moving to Windows 10. Is it supported by MathWorks?

Yes. Windows 10 is supported by MathWorks starting with R2015a. See detailed system requirements.


Timing

1. When is a good time to upgrade?

MathWorks recommends establishing a regular upgrade cadence to get the most out of your upgrade. Most users can upgrade easily to each release, while users with critical applications and models need to balance the cost of upgrading with the benefits.

2. When should I start planning the next upgrade?

MathWorks recommends adopting a continuous upgrade philosophy. Continuously performing upgrade activities ensures that the next upgrade is easier than the last. To assist with this, consider taking advantage of prerelease testing and industry model testing, as well as MathWorks seminars, webinars, and conferences. Please see the overview titled Industry Model and Code Testing for more information about this topic.


Best Practices and Other Considerations

1. What are the best practices for handling dependencies such as third-party tools and in-house custom tools?

It is a best practice to evaluate your workflow and document the third-party hardware and software tools that your MathWorks products are dependent on. You should also identify which MathWorks releases the third-party vendors plan to support. This will help you assess the target release you should upgrade to. It is also important to understand when those third-party vendors offer support for each new MATLAB and Simulink release. This is especially true if you are planning to update to a MATLAB and Simulink release that isn’t available yet.

2. Once I upgrade to a new release, is it possible to use the upgraded files with older releases?

When working with Simulink models, you are required to save your models so they are compatible with a previous release using “Export Model to Previous Version.” This enables you to be able to open an upgraded model in an older release.

There are no additional steps required for opening upgraded MATLAB files in an older release. However, keep in mind that if you add functionality to your code or models that is only available in the newer release, then your code or models will not run in the older release.

3. What steps should we take to confirm numerical equivalence of our models and code from one release to another?

During the upgrade process, focus your upgrade testing on your organization’s typical workflows (e.g., updating, simulating, and generating code from models). After the models and custom tools are upgraded, the models will need to be validated in the new release by the engineers responsible for their development. Test the models and the generated code in a software-in-the-loop (SIL) environment. Verify that the simulation and code generation outputs match the outputs from previous MATLAB and Simulink releases, and use automation if possible.

4. Can we reuse code that was generated in a prior release to reduce verification effort?

Starting in R2016b, you can automate simulation and integration of generated C code from previous releases (R2010a and later) with models and generated code from the current release. The code from the previous release is integrated into the new release without changes, improving reuse and reducing verification cost.

Refer to the documentation for details on how to reuse existing generated C code from a prior release.

5. How should we roll out the upgrade to a large organization?

It is recommended that engineers upgrade their own MATLAB code and Simulink models instead of having a separate group perform the migration. The engineers who developed the code and models have the expertise needed to perform validation. They are also aware of the production deadlines that they are facing and what portions need to be modified for future releases. If for some reason it is not possible for engineers to upgrade their own code and models, then you would need test cases that produce the desired level (100% is recommended) of test coverage.


Getting Help

1. How can MathWorks help?

MathWorks offers a wide variety of support options, which you can find on the support page. For troubleshooting tips and technical assistance, create a service request.

In addition, the Software Upgrade Service puts you in touch with MathWorks Consultants who can help your organization upgrade MATLAB and Simulink.

2. Where can I get answers to my general installation questions?

You can review the “MATLAB Installation, Activation & Startup Help” pages to find answers to installation and license activation questions.

3. What tools does MathWorks provide to help with upgrading?

You can find and resolve issues that may occur when upgrading your code and models to a newer release using the Code Compatibility Report and Simulink Upgrade Advisor.

Download the “MATLAB and Simulink Version Upgrades for Large Organizations” white paper, which details best practices for upgrading.