Environment
You can configure the MATLAB desktop with greater layout flexibility.
Move more panels to the center of the desktop — Move the Files, Workspace, Command History, and Project panels to the center of the desktop.
Undock more panels — Undock the Debugger and Code Issues panels, allowing you to arrange them alongside an undocked Editor or Live Editor.
Reposition panels by dragging — Undock a panel or move it to the center of the desktop by dragging its title bar outside the MATLAB window or toward the center. For example, to move the Command History to the center of the desktop, drag the Command History panel title bar toward the center.
Identify and manage document groups using panel title bars — By default, documents in the center of the desktop include a title bar, which helps identify and manage document groups and panels. To show the title bar only when you hover over the edge of a document or panel tab, click the Panel actions button
on the title bar and select Panel Headers > Show On Hover.
MATLAB also restores document locations more reliably in a session, preserving your desktop layout when you close and reopen documents.
For more information, see Configure the Desktop.
You can render Markdown text and LaTeX equations directly in the Command Window and Live
Editor using the markdowndisp
function.
For example, you can display bold and italic text and an equation.
In addition, the Command Window now renders ANSI escape codes for styled and colored
text, including bold, underlined, italic, and strikethrough formatting, as well as
foreground and background colors. To display styled and colored text, use the fprintf, sprintf, or compose functions.
For example, you can display bold and blue text in the Command Window.
The Command Window now truncates most large two‑dimensional numeric matrices by default. To view the contents of a truncated matrix, click the link below the matrix. You also can view the contents by right-clicking the matrix or pressing Ctrl+D to open it in the Variables editor.
To disable truncating matrices by default, on the Home tab, in the Environment section, click Settings. Select MATLAB > Command Window, and in the Display section, clear the Show enhanced output (truncate matrix, render Markdown) option.
If your code file contains long code lines, the Editor or Live Editor can display those code lines across multiple visual lines without adding line breaks. This display-only wrapping helps you avoid horizontal scrolling while preserving the original code.
To enable wrapping long code lines, go to the View tab, and in the Display section, toggle the Wrap Code Lines button on. For more information, see Edit and Format Code.
To change the end-of-line sequence for the file currently open in the Editor, click the end-of-line sequence indicator at the bottom-right corner of the MATLAB desktop and select the end-of-line sequence style to use.
For more information, see Change Line Endings.
You can add a variable selector to your live script to select a workspace variable interactively. To add a variable selector, go to the Live Editor tab, and in the Code section, select Control > Variable Selector.
For more information, see Add Interactive Controls to Live Scripts.
Use the improved Go To interface to navigate to a specific location in a file open in the Editor or Live Editor more quickly. To navigate to a specific location, on the Editor or Live Editor tab, in the Navigate section, select Go To > Line. Then, specify the line and optionally the column number that you want to navigate to.
Language and Programming
Data Analysis
When joining tables using the innerjoin and outerjoin functions, you can control the ordering of output table rows by
using the RowOrder name-value argument. Previously,
innerjoin and outerjoin sorted output table rows
by key values. To return the output table without sorting the rows, specify
RowOrder="stable". For large tables and tall arrays, this option can
improve computation time by skipping the sort operation.
When joining tables using the Join
Tables Live Editor task, you can specify the ordering of output table
rows by using the Sort by values in merging variables check box.
Previously, Join Tables always sorted output table rows by
values in the merging variables. To return the output table without sorting the rows, clear
the Sort by values in merging variables check box. Clearing this check
box is equivalent to calling innerjoin or
outerjoin with the RowOrder="stable" name-value
argument.
Data Import and Export
You can now create, configure, and manage multiple Amazon S3 connections directly from the Connections panel in MATLAB. Previously, accessing remote data in Amazon S3 required configuring credentials programmatically. Using the Connections panel, you can interactively set up connections by specifying a bucket name, Amazon Web Services (AWS) access key ID, and secret access key. Optionally, you also can specify the session token (if you are using temporary security credentials), the endpoint, and the geographic region of your bucket.
To create an Amazon S3 connection, go to the Home tab, and in the Environment section, click the Connections button to open the Connections panel. Then, in the Available Connections section, click the Add button next to Amazon S3.
For more information, see Work with Remote Data.
Mathematics
Graphics
Now you can use more plotting functions to visualize multiple data sets simultaneously:
The
histogram,polarhistogram, andstem3functions support plotting multiple table variables.The
binscatter,geoplot,geodensityplot, andgeoscatterfunctions support plotting multiple table variables and matrices of coordinates.
To accommodate multiple data sets, binscatter plots now support
transparency. When you create multiple binned scatter plots, each distribution has a
different overall hue by default, and transparency varies across the tiles according to the
bin counts. If you plot one binned scatter plot, the plot is opaque and has the same
appearance as in previous releases.
Create HTML files that contain interactive web canvases by selecting Save As > Export To in the figure toolstrip or by using the uiexportdlg
function. In both approaches, select the HTML format option in the Export dialog box to
export a figure as a web canvas.
For more information, see Print or Export Figure from Figure Toolstrip.
Control the transparency level of the edges and meshes of function plots created with
the fsurf, fmesh, and fimplicit3 functions by setting the
EdgeAlpha property of the plot to a number between 0 and
1. A value of 0 makes the edges completely
transparent and 1 makes the edges opaque.
Maximize geographic axes by filling the available space within the parent container. To
maximize the axes, set the MapLayout property of the GeographicAxes object to
"maximized". Maximizing the axes hides the axis labels, ticks, tick
labels, grid, and titles. The default for MapLayout is
"normal", which displays the axes in a box that is inset from the
edges of the parent container.
This image compares the normal map layout and the maximized map layout.
App Building
Performance
Software Development
External Language Interfaces
Hardware Support
Environment
You can create multilevel bulleted or numbered lists in live scripts or functions. To create a multilevel list, with your cursor in a text line, go to the Live Editor tab and in the Text section, click the Bulleted list or Numbered list button. Then, press the Tab key to indent a numbered or bulleted item.
To decrease the indentation, press Shift+Tab. To change a sublist to a different list type, use the Bulleted list and Numbered list buttons.
For more information, see Format Text in the Live Editor.
The new MATLAB Home page gives you quick access to your recent files, online training, and
other resources. To open the MATLAB Home page, in MATLAB, click the MATLAB Home button 
to the left of the Home tab.
Manage a custom Live Editor task from the task gallery, including configuring task metadata, opening the task class definition file, and removing the task from the task gallery and from code suggestions. To view these options, hover over the Live Editor task icon in the task gallery.
Language and Programming
Data Analysis
The Join Tables Live Editor task has a button for switching the order of the input tables. When you press it, the left table becomes the right table and the right table becomes the left table. The corresponding merging variables are switched along with the tables.
Data Import and Export
Mathematics
Graphics
Create HTML files containing interactive web canvases directly from your MATLAB plots and live scripts. A web canvas is an interactive plot element within an HTML page. Most visualizations in a web canvas support pan, zoom, and rotate interactions.
You can open an HTML file containing a web canvas using a web browser with an internet connection, share the file with others, or host it on a web server. No MATLAB license is required to view and interact with graphics in a web canvas. For more information, see Display Interactive Graphics on Webpages.
To create rain cloud plots for grouped numeric data, use the raincloudplot
function. The upper half of each rain cloud plot displays a violin plot, and the lower half
displays a swarm chart. If you specify a matrix of input data,
raincloudplot creates a separate plot for each column in the
matrix. You can also specify a positional grouping variable to split your data into
groups.
App Building
When you have an app open in Code View, you can view details about your app code in the status bar at the bottom of App Designer. For example, you can view how many times a highlighted variable appears in your code or the name of the function your cursor is in.
Performance
Line plots created using the plot function show improved responsiveness
for panning and zooming. If you plot approximately 2.5 million or more points and then pan
or zoom within the axes, the content that was previously outside the boundaries of the axes
comes into view more quickly in R2026a than in the previous release. Before R2026a, gaps in
the content appeared as you panned or zoomed.
For example, on a Windows 11, AMD EPYC 74F3 24-Core Processor @ 3.19 GHz test system that has an NVIDIA® A16-2B GPU with 2 GB RAM, if you run this code and then pan within the axes, the content updates immediately without any gaps.
x = 1:2500000; y = [log(x') log(x')+2 log(x')+4] + rand(2500000,1); plot(x,y) xlim([1500 4500])
quiver and stem plots show improved responsiveness for panning and zooming. This
improvement is more noticeable when you plot approximately 25,000 or more points.
For example, on a Windows 11, AMD EPYC 74F3 24-Core Processor @ 3.19 GHz test system that has an NVIDIA A16-2B GPU with 2 GB RAM, if you run this code and then pan within the axes, the panning action is smoother and follows the cursor more closely in R2026a than in the previous release.
[x1,y1] = meshgrid(0:1:150, 0:1:300);
[x2,y2] = meshgrid(151:1:300, 0:1:300);
u1 = cos(x1);
v1 = sin(y1);
quiver(x1,y1,u1,v1,LineWidth=2)
hold on
u2 = cos(x2);
v2 = sin(y2);
quiver(x2,y2,u2,v2,LineWidth=2)
xlim([130 170])
ylim([130 170])
Scatter histogram plots show improved responsiveness for panning and zooming. If you
plot a large number of points using the scatterhistogram function, the interaction is smoother and the visual
changes follow the cursor more closely.
For example, on a Windows 11, AMD EPYC 74F3 24-Core Processor @ 3.19 GHz test system that has an NVIDIA A16-2B GPU with 2 GB RAM, if you run this code and then pan within the plot, the panning action follows the cursor more closely in R2026a than in the previous release.
x1 = 2*randn(50000,1) - 1; x2 = randn(50000,1) + 10; y1 = 2*randn(50000,1) - 1; y2 = randn(50000,1) + 7; x = [x1; x2]; y = [y1; y2]; g = [ones(50000,1); ones(50000,1)*2]; scatterhistogram(x,y,GroupData=g,MarkerAlpha=0.2)
Software Development
You can switch Git branches directly by selecting a branch from the Branch drop-down list in the Source Control panel.
External Language Interfaces
You can use the new External Languages panel to manage external programming language environments in MATLAB. Starting in R2026a, you can add Python environments, create virtual environments, switch between environments and execution modes, and manage libraries within Python environments.
To open the External Languages panel, click the Open more panels button
on any sidebar and select External
Languages. To manage Python environments using the External Languages panel, select the
Python option from the menu at the upper left. For more information,
see Manage Python Environments Using External Languages Panel.
Hardware Support
Environment
In R2025a, the MATLAB desktop has a new layout designed to improve productivity and streamline workflows. The new layout includes customizable sidebars on the left, right, and bottom of the desktop. The sidebars show the tools, such as the Files panel (previously referred to as the Current Folder browser), the Workspace panel, and the Command Window, that are docked in the desktop.
You can use the sidebars to access the desktop tools in panels and change the desktop layout. For example, to show or hide a panel, click its icon on the sidebar. To move a panel, drag the panel's title bar or sidebar icon to the left, right, or bottom of the desktop. To open a panel that is not already open, click the Open more panels button in any sidebar. Then, in the Open Panel dialog box, select from the available panels.
For more information about how to configure your desktop, see Configure the Desktop.
As part of this change, undocking some tools, such as the Files panel and Workspace panel, is no longer supported. Undocking the Command Window, Find Files panel, and Variables editor is still supported. In addition, customized layouts saved in a previous release of MATLAB are not supported.
You can change the colors of the MATLAB desktop using themes. For example, to select the dark theme, on the
Home tab, in the Environment section, click
Settings. Select MATLAB > Appearance and set Desktop Theme to
Dark.
For more information, see Change Desktop Theme and Colors.
You can now use the search box in the top-right corner of the desktop to easily access toolstrip actions, settings, and Help Center resources such as functions, blocks, examples, answers, and videos. To navigate to the search box using a keyboard, press Ctrl+Shift+Space (or Command+Shift+Space on macOS systems).
For example, to restore the MATLAB desktop
to its default layout, type the word layout in the search box. In the
list of results, select the Layout - Two Column (Default)
toolstrip action.
You can now create and save live scripts and functions using a plain text file format
(.m). This new file format for live scripts improves integration with
source control and allows you to open live scripts in external text editors.
Live scripts saved using the plain text file format behave just like other live scripts. They open in the Live Editor and can contain code, output, and formatted text. They also can include interactive controls and tasks.
For more information, see Live Code File Format (.m).
You can add YouTube® videos and video files to your live scripts. Online videos are subject to the terms of service and privacy policy of the video provider.
To add a video to a live script, go to the Insert tab, and select Video > Online Video or Video > Video File. You can add videos only in text lines. If you insert a video in a code line, the Live Editor places it in a text line below the current code line.
MATLAB preferences are now renamed as
settings, and you can search for and modify these settings using the updated Settings
window. To open the Settings window, go to the Home tab,
and in the Environment section, click
Settings.
For more information, see Settings Window.
Starting in R2025a, when you write code in the Command Window, MATLAB automatically provides real-time suggestions as you type. These suggestions include the names of functions, models, MATLAB objects, files, folders, variables, structures, and graphics properties. In addition, when you type a function name, MATLAB shows basic syntax information for the function and offers suggestions for parameters and options.
To disable or change the default behavior of code suggestions in the Command Window, go
to the Home tab, and in the Environment section, click
Settings. Select MATLAB
> Command Window > Suggestions and in the Suggestions section,
configure the settings based on your preferences.
For more information, see Code Suggestions.
As part of this change, the Function browser and the Browse for functions button
have been removed. To find functions, use code
suggestions or the search box in the top-right corner of the MATLAB desktop.
When you open a Markdown file in MATLAB, the Editor shows a preview of the file to the right of the Markdown file. As you make edits to the file, the Editor updates the preview. To close the preview, go to the View tab and in the Preview section, click the Markdown button off.
Code snippets are templates designed to simplify adding recurring code structures, such
as loops or conditional statements, to your code. As you type in the Editor or Live Editor,
MATLAB shows relevant code snippets along
with other name suggestions. For example, if you type the word if,
MATLAB suggests the If-Else
Statement and If Statement snippets in addition to
functions whose name starts with if.
The Outline panel provides a high-level outline of scripts, live scripts, functions, and classes. To view an outline of a file open in the Editor or Live Editor, go to the View tab, and in the Tools section, click Outline. To navigate to an area within your code file, double-click the related entry in the Outline panel.
You can use the Code Issues panel to view error and warning messages about your code. The Code Issues panel displays potential coding problems that the MATLAB Code Analyzer finds as it automatically checks your code. Using the Code Issues panel, you can choose to view the errors and warnings for the current file or for all open files. You also can filter the list of messages by type (error, warning, or info) as well as by message text.
To open the Code Issues panel, go to the Editor or Live
Editor tab, and in the Analyze section, click Code Issues. By default, the Code Issues panel opens on the right
side of the desktop. To hide the Code Issues panel, click the Code Issues icon
on the sidebar.
You can use the Find Files panel to search for text in filenames and file content. To
search, click the Find Files icon 
on the left sidebar. When searching, you can choose
whether to match the case of your search text as well as whether to match the whole word.
You also can select what folder to search in and filter results by file extension.
To replace text in filenames and file content, click the expand button
to the left of the search box to open the replace
options. Replacing text is supported in text files (.txt) and
MATLAB plain text code files
(.m).
To open the Find Files panel in a separate window, click the Find Files actions button
at the top of the Find Files panel and select
Undock Find Files.
For more information, see Find Files.
As part of this change, you can no longer exclude files from the search based on their file type or size.
Use the Connections panel to view and manage your available connections, including OneDrive and MATLAB Drive. To open the Connections panel, click the Open more panels button on any sidebar and select the Connections panel.
You can use the Add-Ons panel to find, install, and manage add-ons. You also can update
an installed add-on, such as a support package, directly from the Add-Ons panel. To open
the Add-Ons panel, click the Add-Ons icon 
on the left sidebar.
For more information, see Get and Manage Add-Ons.
You can view and install add-ons from MATLAB package repositories directly from the Add-Ons panel. To view and install the add-ons,
click the Add-Ons actions button at the top of the Add-Ons panel and select
Manage Package Repositories to open the Connections panel. In
the Connections panel, add a connection to the MATLAB package repository. Then in the My
Connections section, click the button to the right of the package repository connection
and select Browse for Repository Add-Ons to return to the
Add-Ons panel. In the Add-Ons panel, go to the From your Package
Repositories section and select an add-on to install. You also can search for
an add-on using the search box at the top of the panel.
For more information, see Install Add-Ons from MATLAB Package Repositories.
Customizing the quick access toolbar and Current Folder toolbar using the Settings window is no longer supported. In addition, moving the quick access toolbar is no longer supported. Previously, you could rearrange, add, and remove controls from both toolbars using the Settings window, and you could move the quick access toolbar below the MATLAB Toolstrip.
To rearrange controls in the quick access toolbar, drag them to the desired locations
instead. To add a toolstrip control to the quick access toolbar, right-click the control
and select Add to Quick Access Toolbar. You also can select
from a list of common controls by going to the quick access toolbar and clicking the
Common Controls button 
. To remove a control from the quick access toolbar,
right-click the control and select Remove from Quick Access
Toolbar.
There is no alternative way to customize the Current Folder toolbar.
Language and Programming
Use the Debugger panel to manage breakpoints and navigate the function call stack while debugging. To open the Debugger panel, go to the Editor or Live Editor tab, and in the Analyze section, click Debugger. You also can open the panel using the Open more panels button on the sidebar.
For more information, see Debug MATLAB Code Files.
Data Analysis
The Variables editor has new tools for navigating and analyzing variable contents. For example, you can:
View edits to variables of all types as MATLAB code in the Command Window.
View sparklines and summary statistics for data in a table or timetable.
Create a logical variable from selected data indices.
Navigate variable contents using the Find and Go To buttons on the toolstrip.
Create a linked plot that is synchronized with workspace variables.
Edit categories of a categorical table variable.
The Variables editor display has enhanced readability for some variable types. For example, you can:
Review and analyze data in a table, timetable, structure array, or cell array using a simplified, borderless design and row striping.
Edit the contents of and view useful information for data in a scalar structure, object array, or cell array.
Interactively edit each page of data in a multidimensional array.
View the event labels for data in a timetable.
You can open the Variables editor by double-clicking a variable in the Workspace panel
or using the openvar function.
Data Import and Export
Mathematics
Graphics
You can view and create figures in light or dark theme. When you create plots, MATLAB automatically selects colors that are visually appealing for the theme. By default, figures use the theme of the MATLAB desktop, but you can choose a different graphics theme.
You can manage the colors of a chart and the theme of a figure in these ways:
themefunction or theThemeproperty of the figure – Set and get the theme of a figure.MATLAB Settings window – Configure themes for all figures.
fliplightnessfunction – Flip the lightness of color values.getThememethod – Get the theme of the figure for aChartContainersubclass.
For more information, see Graphics and App Themes.
Use the nebula
function to get a blue-to-red colormap for coloring your charts. Like for all predefined
colormaps, you can optionally specify the number of colors for the
nebula colormap.
Set the XJitterDirection, YJitterDirection, and ZJitterDirection properties to control the direction of the jitter in a
swarm chart. Each of these properties can have a value of "negative",
"positive", or "both".
The "streets-light", "streets-dark",
"streets", and "topographic" basemaps hosted by
Esri® have an improved appearance when the basemap tiles contain text. For example,
this image compares a basemap in R2024b with the same basemap in R2025a. In R2025a, the
labels for Wisconsin and St. Louis are fully visible.
In addition, all cached basemap tiles have a crisper appearance. For more information about cached basemap tiles, see Access Basemaps for Geographic Axes and Charts.
By default, figures created using the figure function appear as tabs in a figure container. This change impacts
the figures in these ways:
By default, the
WindowStyleproperty ofFigureobjects is"docked"because the figures are docked in the figure container. In previous releases, theWindowStyleproperty was"normal"because figures were not docked by default.By default, the figure container is undocked from the MATLAB desktop, and the figure container docked state does not persist between MATLAB sessions. In previous releases, the figure container was docked in the desktop by default, and the figure container docked state persisted between MATLAB sessions.
To create a figure window that is independent of other windows, specify the window
style as
"normal".
f = figure(WindowStyle="normal");To dock the figure container into the desktop, click the Dock button
in the top-right corner of the figure
container.
In addition, figures have a larger default size that changes based on the size of
your monitor. To use the previous default figure size for a single figure, set its
Position property using a position vector of the form
[left bottom width height]. Setting the
Position property undocks the figure from the figure
container.
f = figure(Position=[100 100 560 420]);
To use the previous default initial figure size for all figures, including those in the figure container, set the default figure position of the graphics root object.
set(groot,DefaultFigurePosition=[100 100 560 420])
Some of the default colors of graphics objects have changed. These changes affect the light theme colors. This table describes the changes and provides the RGB triplets and color samples to compare R2025a with the previous release.
| Affected Graphics | Affected Object Properties | R2024b Color | R2025a Color | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Figure background color |
|
|
| ||||||||||||||||||||||||||||||||
Plot colors |
(This property controls the default color of
|
|
| ||||||||||||||||||||||||||||||||
Plot titles and annotations |
|
|
| ||||||||||||||||||||||||||||||||
Axes labels, tick labels, and rulers | Axes labels: Axes tick labels and
rulers: |
|
|
The fonts and text spacing of some TeX and LaTeX equations and symbols have changed. For example, here are two paragraphs containing LaTeX equations and a fraction. The left paragraph shows the appearance in R2024b, and the right paragraph shows the same text in R2025a.
Content exported from a figure as vector graphics (SVG, PDF, EPS, or EMF files) continue to use the R2024b format in R2025a.
| R2024b | R2025a |
|---|---|
|
|
App Building
You can view and create figures in light or dark theme. When you create UI components and plots, MATLAB automatically selects colors that are visually appealing for the theme. By default, figures use the theme of the MATLAB desktop, but you can choose a different graphics theme.
You can manage the colors and themes of your apps in these ways:
themefunction orThemeproperty of the figure — Set and get the theme of a figure.MATLAB Settings window — Configure themes for all figures.
ThemeChangedFcnproperty of the figure — Program response to figure theme change.fliplightnessfunction — Flip the lightness of color values.getThememethod — Get the theme of the figure for aComponentContainerclass.
For more information, see Graphics and App Themes.
When you create a table UI component using the uitable function, the table adjusts row heights to display multiline cell
content. For example, this code creates a table that includes two lines of text in one
cell. The height of the row with multiline content adjusts to display both lines of text.
fig = uifigure; t = uitable(fig, ... Data=["Omelette","Eggs"; "Hamburger","Beef"+newline+"Bun"]);
You can now use the search box in the top-right corner of App Designer to easily access toolstrip actions and Help Center resources, such as functions, examples, and answers.
For example, to show the background grid on the App Designer canvas, type the word
grid in the search box. In the list of results, select the
Grid toolstrip action.
Some of the default colors of UI components and containers have changed. These changes affect the light theme colors. This table describes the changes and provides the RBG triplets and color samples to compare R2025a with the previous release.
| Affected App Area | Affected Component Properties | R2024b Color | R2025a Color |
|---|---|---|---|
| Container backgrounds |
|
|
|
| App text | FontColor property of UI component objects |
|
|
| Unvisited hyperlinks | FontColor property of Hyperlink
object |
|
|
| Visited hyperlinks | VisitedColor property of
Hyperlink object |
|
|
Panels and button groups created in figure-based apps have an
updated appearance. Because of this update, certain title and border options have
changed.
Panel and button group titles can appear only at the top of the container. As a
result, these TitlePosition values have changes in behavior.
| Value | R2024b and Earlier | Starting in R2025a | Recommended Value |
|---|---|---|---|
"leftbottom" |
|
| Update your code to use "lefttop" instead of
"leftbottom" to reflect the title position. |
"centerbottom" |
|
| Update your code to use "centertop" instead of
"centerbottom" to reflect the title position. |
"rightbottom" |
|
| Update your code to use "righttop" instead of
"rightbottom" to reflect the title position. |
Panel and button group borders always appear as a line. As a result, some
BorderType values have changes in behavior. Specifying
BorderType as any of the options in the table causes a warning.
Additionally, the default BorderType value has changed from
'etchedin' to 'line'.
| Value | R2024b and Earlier | Starting in R2025a | Recommended Value |
|---|---|---|---|
"etchedin" |
|
| Update your code to use "line" instead of
"etchedin" to reflect the border type. |
"etchedout" |
|
| Update your code to use "line" instead of
"etchedout" to reflect the border type. |
"beveledin" |
|
| Update your code to use "line" instead of
"beveledin" to reflect the border type. |
"beveledout" |
|
| Update your code to use "line" instead of
"beveledout" to reflect the border type. |
As a result of the changes to the BorderType property, the
ShadowColor property has no effect and warns if you set it. To
specify the border color of a panel or a button group, use the
BorderColor property instead.
The ShadowColor property no longer appears in the list returned
by calling the get function on a Panel or
ButtonGroup object. For more information about container properties,
see Panel or ButtonGroup.
For apps created using the figure function, when you query the
InnerPosition property of a tab group, the property returns a
different value than in the previous release. In addition, if the
TabLocation property is 'left' or
'bottom', when you query the Position,
InnerPosition, and OuterPosition properties of
a tab in the tab group, the properties might return different values than in the
previous release. These changes make the property values and behaviors consistent with
the properties in uifigure-based apps.
This table describes the differences in the property values between R2025a and previous releases.
| Property | R2024b and Earlier | Starting in R2025a | ||
|---|---|---|---|---|
| Description | Image | Description | Image | |
InnerPosition of a tab group | A four-element vector of the form [left bottom width
height] that represents the size and location of the tab group
relative to the drawable area of its parent, including
borders and titles of the tabs it contains | Tab group
| A four-element vector of the form [left bottom width
height] that represents the size and location of the tab group
relative to the drawable area of its parent, excluding
borders and titles of the tabs it contains | Tab group
|
Position, InnerPosition, and
OuterPosition of a tab | A four-element vector of the form [left bottom width
height] that represents the size and location of the tab
relative to the tab group drawable area, where the tab group drawable area
includes borders and titles | Tab
| A four-element vector of the form [left bottom width
height] that represents the size and location of the tab
relative to the tab group drawable area, where the tab group drawable area
excludes borders and titles | Tab
|
If you notice changes in your app layout, consider updating your code in this way:
Tab group
InnerPosition— Replace references to the tab groupInnerPositionproperty with the tab groupPositionproperty to use the size and location of the tab group including the borders and tab titles.Tab
Position,InnerPosition, andOuterPosition— Replace references to the first two elements of the position vector to instead use the space taken up on the left or bottom by the tab titles. For example, if your app contains a tab group with aTabLocationvalue of'left'and you reference thePositionproperty of a tab in that tab group, replace that reference with the horizontal distance between the tab group border and the tab drawable area.
For more information about tab group and tab properties, see TabGroup and Tab.
Performance
Scatter plots that display circle markers show improved responsiveness when you perform interactions, such as panning, zooming, and rotating. The improvement is more noticeable when you plot more than 25,000 points and your system has a GPU.
For example, on a Windows 11, Intel Xeon CPU W-2133 @ 3.60 GHz test system that has an NVIDIA Quadro® P600 GPU, if you run this code and then drag to rotate the plot, the rotation is smoother and follows your cursor more closely in R2025a than in the previous release.
f = figure;
ax = axes(f);
x = randn(1,2000000);
y = randn(1,2000000);
z = randn(1,2000000);
scatter3(ax,x,y,z,"filled")
Line plots in apps or in figures created with the uifigure function
show improved responsiveness when you pan or zoom within the axes. If you plot a large
number of points and then pan within the axes, the content that was previously outside the
boundaries of the axes comes into view more quickly in R2025a than in the previous release.
Before R2025a, gaps in the content appeared as you panned or zoomed.
For example, on a Windows 11, Intel Xeon CPU W-2133 @ 3.60 GHz test system, if you run this code and then pan within the axes, the content updates immediately without any gaps.
f = uifigure; ax = axes(f); x = 1:250000; y = [log(x') log(x')+2 log(x')+4] + rand(250000,1); plot(ax,x,y) xlim(ax,[1500 4500])
If you create the figure with the figure function, the content that
was previously outside the boundaries of the axes comes into view quickly (as in the
previous release), but the interaction follows the cursor more closely.
Software Development Tools
Use the Source Control panel to interact with folders and projects under Git and SVN source control, manage modified and untracked files, and perform
source control operations. If the Source Control icon is not in the sidebar, click the Open
more panels button 
and select the Source Control panel.
For more information, see Source Control Integration in MATLAB.
Starting in R2025a, you can enable MATLAB to generate local avatars or retrieve globally recognized avatars from the web.
When you enable commit signing, MATLAB now verifies commit signatures. A green verification icon 
appears next to your avatar and username in both the Branch
Manager and the line annotations in the MATLAB Editor.
For more information, see Configure Git Settings.
Starting in R2025a, when you compare or merge files under source control, the comparison and merge tools include source control information such as the branch name and tags in the file details.
External Language Interfaces
Hardware Support
Environment
You can customize the font, size, color, and formatting of text and code styles in the Live Editor using the Customize Styles dialog box. To customize a text or code style, go to the Live Editor tab, and in the Text section, click the Customize styles button . Then, select the style that you want to customize and change the font, size, color, and formatting for the selected style. The Customize Styles dialog box shows a preview of each style.
The customized style applies only to the current document. To apply the customized style to all new live scripts as well, select the Use this configuration for new live scripts option.
For more information, see Format Text in the Live Editor.
Add a range slider to your live script to select a range interactively. To add a range slider, go to the Live Editor tab, and in the Code section, select Control > Range Slider.
![Range slider with the range [0 100] selected, assigned to the variable r](24b_live_controls_rangeslider.png){kind=small}
For more information, see Add Interactive Controls to a Live Script.
In the MATLAB Online Editor, you can use the Outline panel to view a high-level outline of scripts, functions, and classes. To view an outline of a file open in the Editor, go to the View tab, and in the Tools section, click Outline. To navigate to an area within your code file, double-click the related entry in the Outline panel.
For more information, see Edit and Format Code.
In MATLAB Online, the Editor displays Target Language Compiler (TLC) files with syntax highlighting for commands, comments, macros, and strings. In addition, the Editor automatically indents lines of code in TLC files while you type.
In MATLAB
Online, you also can use preferences to configure how the Editor displays TLC files.
On the Home tab, in the Environment section,
click
Preferences. Select MATLAB > Editor/Debugger > Other Languages > TLC, and adjust the options as needed.
In MATLAB Online, you can update add-ons directly from the Add-Ons panel. To update an add-on, in the Installed section of the Add-Ons panel, click the Update button to the right of the add-on. The Add-Ons panel displays the Update button next to add-ons that have an update available.
To open the Add-Ons panel if it is not open, click the Add-Ons button
in the sidebar on the left side of the MATLAB
Online desktop. Alternatively, go to the Home tab, and in the
Environment section, select Add-Ons > Add-Ons.
For more information, see Get and Manage Add-Ons.
When searching using the Find Files panel in MATLAB
Online, you can collapse or clear the list of search results. To collapse or clear
the list of search results, click the Find Files actions button
() at the top of the Find Files panel and select
Collapse Results or Clear Results.
You also can export the list of search results as a plain text file
(.txt) that can be viewed in an external text editor. To export the
list, click the Find Files actions button () and select Export as Plain
Text.
For more information, see Advanced Search in MATLAB Online.
The new desktop for MATLAB includes new and updated features, such as:
Dark theme support for the desktop, plots, and apps
An updated layout
Expanded search capabilities
A new figure window experience with a toolstrip, integrated side panels, and a new tabbed container
A new plain text file format for live scripts
A new Debugger panel and Source Control panel
Enhanced workflows for MATLAB projects
Improved screen reader support
Extension points
To try these new features, download the New Desktop for MATLAB (Beta) on File Exchange. For more information about these new features, see Get Started with the New Desktop for MATLAB (Beta).
Note
The new desktop for MATLAB is in beta development and should not be used for development or production activities. Report all feedback and issues directly to the development teams by using the Feedback button directly above the MATLAB Toolstrip.
Language and Programming
When the Pause on Errors or Pause on Warnings breakpoints are enabled and an error or warning occurs, the Debugger panel displays the resulting message and the location at which MATLAB is paused.
For more information about these error breakpoints, see Set Breakpoints.
Data Analysis
Variables in the Variables editor in MATLAB Online have enhanced readability. The updated display has a streamlined look, including a simplified, borderless design and row striping for easier data review and analysis.
Data Import and Export
Mathematics
Graphics
To create violin plots for grouped numeric data, use the violinplot
function. Each violin plot displays the kernel density estimate for a group in the input
data. If you specify a matrix of input data, violinplot creates a
separate violin plot for each column in the matrix. You can also specify a positional
grouping variable to split your data into groups.
Use the compassplot
function to plot one or more sets of arrows originating from the origin in polar
coordinates. This function is recommended over the compass function because this function uses a PolarAxes
object, which provides more options for customization. For example, you can set
PolarAxes properties to display either degree or radian
theta units, adjust theta- and
r-axis limits, or adjust aspects of the tick labels.
Use the constantplane
function to create infinite planes for highlighting regions of interest in 3-D plots. This
function creates semitransparent gray planes by default, but you can change the color and
transparency by setting properties.
Control the width of the legend icons and the width of the legend box by setting the
IconColumnWidth property of a Legend object.
If the legend contains only marker icons, MATLAB automatically minimizes the white space around the icons. Previously, legends included extra white space around the marker icons.
For example, these three legends are the same except for their
IconColumnWidth values (30,
40, and 10, respectively).
Simplify pie charts and donut charts with large numbers of slices by setting properties
that control the order and number of slices. Use the DisplayOrder
property to arrange slices by size, and use the NumDisplayWedges property to specify the number of slices to display
separately (the remaining slice data is grouped together as a slice labeled
"Others").
Other useful properties include:
ShowOthers— Show or hide a slice labeled"Others"to represent values not shown as individual slices. For example,<undefined>categorical values are represented in the"Others"slice.WedgeDisplayNames— Return the labels of the slices shown in the chart.WedgeDisplayData— Return the data values of the slices shown in the chart.
For example, these two donut charts represent the same data, but the chart on the right
has a NumDisplayWedges property value of 3 and a
ShowOthers property value of "on".
Add labels to the ends of bars and position them using the Labels and
LabelLocation
properties of a Bar object. You can also adjust aspects of the font by
setting the LabelColor,
FontName, FontSize,
FontWeight, and FontAngle properties. To
create the labels with LaTeX markup, set the Interpreter
property.
Use the LabelColor
property to control the color of the text label of a ConstantLine object
created with the xline or yline
function.
The piechart
and donutchart
functions now include undefined categorical values and show them in a slice labeled
"Others" by default. Previously, the functions excluded undefined
values from the calculation of the Proportions property, and the
resulting chart did not include undefined values. This change makes it easier to
understand the nature of categorical data in the chart.
For example, create a pie chart using a categorical array containing three undefined
values (""). In R2024a, the chart excludes the undefined values. In
R2024b, the chart contains a slice labeled "Others" to represent the
undefined values.
cats = categorical(["Peach" "Apple" "Apple" "Apple" ... "Pecan" "Pecan" "Pumpkin" "" "" ""]); piechart(cats,LabelStyle="name")
To exclude the "Others" slice from the chart and exclude the
undefined values from the Proportions calculation, set the
ShowOthers property to "off".
piechart(cats,LabelStyle="name",ShowOthers="off")
Plots created with the stem function now have padding on the
right and left sides of the x-axis to prevent overlap with the edges
of the plot box.
To preserve the appearance from previous releases, use the xlim function to adjust the limits of the x-axis. For
example, if the range of the x-coordinates is
[0,10], set the x-axis limits to
[0,10].
x = 0:10; y = (2*x) + 1; stem(x,y) xlim(gca,[0 10])
App Building
In Design View, you can interactively add UI components that span multiple cells in a grid layout manager by dragging the component over multiple cells before dropping it on the canvas.
For more information, see Use Grid Layout Managers in App Designer.
Performance
Software Development Tools
When you run a dependency analysis on your code, the Dependency Analyzer lists the required packages in the Add-Ons section of the Properties pane. For more information, see Find Required Products and Add-Ons.
The Dependency Analyzer also flags any missing package dependencies in the Problems section. For more information, see Investigate and Resolve Problems.
In MATLAB Online, you can view info messages about your code in the Code Issues panel, as well as in the Editor and Live Editor. Info messages are suggestions for how to improve your code, and they can be related to code readability, outdated functionality, and formatting improvements.
To open the Code Issues panel, go to the Editor or Live
Editor tab, and in the Analyze section, click
Code Issues. To change which types of messages are underlined in the
Editor and Live Editor, go to the Home tab, and in the
Environment section, click 
Preferences. Select MATLAB > Code Analyzer, and then select an Underlining option.
For more information, see Check Code for Errors and Warnings Using the Code Analyzer.
Legacy command-line SVN integration had limited functionality and required installation of an additional command-line SVN client. Starting in R2024b, the command-line SVN integration is no longer supported. Use the built-in SVN integration instead.
This illustration shows the deprecated Command-line SVN integration (compatibility mode) option in the Manage Files Using Source Control dialog box. Use the SVN (1.9) option instead.
External Language Interfaces
Hardware Support
The libcamera packages are now installed as part of the Raspberry Pi Blockset for the Bullseye and Bookworm operating systems. The
libcamera functionality is available when you enable the camera module peripheral in the Hardware Setup tool.
As part of the libcamera update, the cameraboard object no longer displays the ImageEffect and
VideoStabilization properties for the Bullseye and Bookworm operating
systems.
These functions have been removed:
enableI2CdisableI2CenableSPIdisableSPI
Instead, in the Hardware Setup tool, use the Configure Peripheral Modules window to enable or disable I2C and SPI interfaces on Raspberry Pi.
Environment
Add a date picker to your live script to select a date interactively. To add a date picker, go to the Live Editor tab, and in the Code section, select Control > Date Picker.
For more information, see Add Interactive Controls to a Live Script.
Tables, timetables, structure arrays, and cell arrays in the output of the Live Editor have enhanced readability. The updated displays have a streamlined look, including a simplified, borderless design and row striping for easier data review and analysis.
You can disable the wrap-around search behavior in the Find and Replace dialog box using settings. To disable the wrap-around search behavior, use this code.
s = settings; s.matlab.editor.find.WrapAround.PersonalValue = 0;
In MATLAB
Online, you also can use preferences to disable the wrap-around search behavior. On
the Home tab, in the Environment section, click
Preferences. Select MATLAB > Editor/Debugger > Find and Replace and in the Search behavior section, clear the
Wrap around option. For more information, see Editor/Debugger Preferences.
You can configure the behavior of automatic indenting in the Editor and Live Editor. For example, you can specify whether automatic indenting formats the entire document and whether it adds white space to empty lines.
To configure the behavior of automatic indenting, use settings. For example, enable formatting the entire document when automatic indenting is enabled.
s = settings; s.matlab.editor.indent.SmartIndentEntireDocument.PersonalValue = 1;
In MATLAB
Online, you also can use preferences to configure automatic indenting behavior. On
the Home tab, in the Environment section, click
Preferences. Select MATLAB > Editor/Debugger > Indenting and in the Smart indenting section, adjust the automatic
indenting options as needed. For more information, see Editor/Debugger Preferences.
The Editor displays YAML files with syntax highlighting for keywords, variables, strings, numbers, and comments. In addition, the Editor automatically indents lines of code in YAML files while you type.
The Editor also displays Markdown files with syntax highlighting for headings, horizontal rules, lists, code blocks, comments, and other entries. You can change the syntax highlighting colors for Markdown files using settings. For example, change the color of headings in Markdown files to purple.
s = settings; s.matlab.editor.language.markdown.HeadingColor.PersonalValue = [183 70 255];
For more information, see matlab.editor Settings.
In MATLAB
Online, you also can use preferences to configure how the Editor displays YAML and
Markdown files. On the Home tab, in the
Environment section, click Preferences. Select MATLAB > Editor/Debugger > Other Languages and then Markdown or
YAML, and adjust the options as needed.
Use the Add-Ons panel to find, install, and manage add-ons in MATLAB
Online. To open the Add-Ons panel, click the Add-Ons button
in the sidebar on the left side of the MATLAB
Online desktop.
For more information, see Get and Manage Add-Ons.
Use the Connections panel to view and navigate to your available connections in
MATLAB
Online, including MATLAB
Drive. To open the Connections panel, in the sidebar on the left side of the
MATLAB
Online desktop, click the Open more panels button () and select the Connections panel.
You can search for and replace text in filenames and file content using the Find Files
panel in MATLAB
Online. Replacing text is supported in text files (.txt) and
MATLAB code files (.m).
To open the Find Files panel, click the Find Files button 
in the sidebar on the left side of the MATLAB
Online desktop. To limit the search to only filenames or file content, click the
Filters button and clear the Filename or Content within
files search type.
For more information, see Find Files.
Form feed characters and vertical tabs now display in the Editor as symbols. Previously, form feed characters and vertical tabs were not displayed.
Language and Programming
Data Analysis
In the Experiment Manager app, you can apply or reset a filter for a variable in the results table. Select Filters in the toolstrip and configure the corresponding section of the Filters pane. Set the bounds for a numeric variable, or specify the contents of a character array or string variable. Previously, you could apply a filter only to numeric variables and you could not reset the numeric filter.
For tables or timetables in the output of the Live Editor, you can display sparklines and summary statistics to quickly visualize and interpret the data in each variable.
To display sparklines or summary statistics, right-click the table and show sparklines or summary statistics using the context menu. To show more information related to specific points, point to a sparkline.
Data Import and Export
Mathematics
Graphics
Plot mathematical expressions in polar coordinates by using the fpolarplot
function. This function replaces the ezpolar function.
Create different types of filled regions in polar coordinates using the thetaregion,
radiusregion,
and polarregion
functions. Filled regions are useful for highlighting one or more sections of a
plot.
Control the line styles of your plots by using the linestyleorder function. When you call this function, MATLAB uses the specified line styles for any new plots you create, and it updates
the existing plots in the specified figure or axes.
You can control the transparency of legend boxes and rectangles:
Control the background transparency of a legend box by setting the
BackgroundAlphaproperty of theLegendobject to a value between0(completely transparent) and1(opaque).Control the transparency of a rectangle by setting the
FaceAlphaproperty of theRectangleobject to a value between0and1.
You can move ConstantLine objects (created with
xline and yline) and
ConstantRegion objects (created with xregion
and yregion) above or below other elements in a plot by setting the
Layer property to "top" or
"bottom".
Control the bar group width by setting the GroupWidth
property of at least one Bar object in the axes.
You can use additional properties to label donut charts and pie charts:
Create a large center label in a donut chart by setting the
CenterLabelproperty of the chart. You can control the font size of the label by setting theCenterLabelFontSizeproperty.Select different labeling schemes for a donut or pie chart by setting the
LabelStyleproperty of the chart. You can choose from six different styles, including"name", which displays slice names, and"namedata", which displays the slice names and data values.
When you create a plot that has a high density of markers in an app or in MATLAB Online using a system that does not have hardware-accelerated graphics, the plot displays fewer markers compared to previous releases. This change helps to maintain responsiveness during plot interactions. This change affects only a subset of systems that do not meet the recommended requirements for running MATLAB.
Here is a plot of 100,000 points on a system without hardware-accelerated graphics in R2023b and R2024a.
App Building
To create a color picker in an app, use the uicolorpicker
function or, in App Designer, drag a color picker UI component from the Component
Library onto the canvas.
When you create a table UI component with editable cells that display categorical data, the cells include a visual indicator that the data can be edited using a drop-down list.
For more information about how data appears in a table UI component, see Format Tabular Data in Apps.
In MATLAB Online, you can now use the Search box in the top-right corner of App Designer to easily access toolstrip actions and Help Center resources such as functions, examples, and answers.
For example, to show the background grid on the App Designer canvas, enter the word
grid in the Search box. In the list of results, select the
Grid toolstrip action.
When you create a plot that has a high density of markers in an app or in MATLAB Online using a system that does not have hardware-accelerated graphics, the plot displays fewer markers compared to previous releases. This change helps to maintain responsiveness during plot interactions.
Note
This change only affects a subset of systems that do not meet the recommended requirements for running MATLAB.
Here is a plot of 100,000 points on a system without hardware-accelerated graphics in R2023b and R2024a.
Performance
The Files panel shows improved performance when previewing a large MAT-file in
MATLAB
Online. The delay between clicking the 
button and the preview being ready is reduced.
For example, create a large MAT-file in MATLAB
Online. Then, pause on the MAT-file name in the Files panel and click the button that appears. You can view the MAT-file preview
5.6x sooner than in the previous release.
x = randn(50000000,1); save sample.mat -v7.3
The approximate rendering times are:
R2023b: 14 s
R2024a: 2.5 s
Because MATLAB Online is hosted, performance is independent of the computer hardware used to access it.
When you scroll to zoom within a plot, the ticks and tick labels update faster. To
observe the improvement, the plot must be created in an app, in a figure created with the
uifigure function, or in MATLAB
Online.
For example, create a scatter plot, and adjust the x- and y-axes limits to exclude some of the plot. Then scroll to zoom in and out. The ticks and tick labels update more quickly on a Windows 11, Intel Xeon CPU W-2133 @ 3.60 GHz test system when you scroll in R2024a than in the previous release.
f = uifigure;
ax = axes(f);
rng(0)
x = randn(1,100);
y = randn(1,100);
scatter(ax,x,y,"filled")
xlim(ax,[-0.5 0.5])
ylim(ax,[-0.5 0.5])
Interactions with partially transparent 3-D plots show improved responsiveness. To
observe the improvement, the plot must be created in an app, in a figure created with the
uifigure function, or in MATLAB
Online.
For example, create a partially transparent surface plot of the
peaks function evaluated over a 500-by-500 grid in an app window.
Then drag to rotate the axes. On a Windows 11, Intel
Xeon CPU W-2133 @ 3.60 GHz test system, the rotation is smoother and responds more
quickly to the drag gesture in R2024a than in the previous release.
f = uifigure;
ax = axes(f);
Z = peaks(500);
surf(ax,Z,EdgeColor="none",FaceAlpha=0.4)
Software Development Tools
For projects that contain only MATLAB files, use Project Upgrade to check for compatibility issues with the current release. For projects that also contain Simulink models and libraries, you can apply fixes and automatically upgrade your project to the current release.
You can now easily interpret the upgrade results and examine the checks marked as need attention. You can also access frequent actions from the Project Upgrade toolstrip:
Rerun checks.
View changes that the upgrade applied.
Save results in a report.
For more information, see Check for Compatibility Issues Using Project Upgrade.
External Language Interfaces
Hardware Support
Environment
You can add tables to your live scripts and functions to format text and images. To
insert a table, go to the Insert tab and select
Table
. Move the cursor over the grid to highlight the numbers
of rows and columns you want and then click to add the table. To create a larger table,
select the Insert a table button and specify the numbers of rows and columns in the dialog
box.
After inserting the table, to modify its rows and columns, right-click the table, select Table, and select from the available options. For more information, see Format Text in the Live Editor.
You can add a color picker to your live script to select a color interactively. You also can add a state button to indicate and interactively set the value of a logical variable.
To add a color picker, go to the Live Editor tab, and in the Code section, select Control > Color Picker. To add a state button, select State Button.
For more information, see Add Interactive Controls to a Live Script.
You can now use keyboard shortcuts to interact with inline output in live scripts. To move focus from the code to the output, use the down arrow and up arrow keys. To activate an output, press Enter. Once an output is activated, you can scroll text using the arrow keys, navigate through hyperlinks and buttons using the Tab key, and open the context menu by pressing Shift+F10. To deactivate an output, press Esc.
To disable using the keyboard to move focus to the output when output is inline, on the
Home tab, in the Environment section, click
Preferences. Select MATLAB > Editor/Debugger > Display, and clear the Focus outputs using keyboard when output is
inline option.
When exporting to PDF, Microsoft Word documents, HTML, and LaTeX, you can use the Export dialog box to customize export options interactively. To open the Export dialog box, on the Live Editor tab, click Export and then select an export format. In MATLAB Online, click Save instead of Export.
You can change the paper size, orientation, and margins when exporting to PDF, Microsoft Word documents, and LaTeX. You also can change the resolution and format of figures when exporting to PDF, HTML, and LaTeX (requires the files to be run before exporting).
For more information, see Ways to Share and Export Live Scripts and Functions.
Search for and replace groups of characters in a file using capture groups in regular
expressions. To begin searching using regular expressions, on the Editor or Live Editor tab, in the Navigate section, click 
Find. Then, select the Regular expression option
.
To create a capture group, surround the characters that you want to group with
parentheses. Then, to access the capture group within the regular expression, use the
format \, where
numbernumber$. For example, to find duplicate
words in a file, use the expression number(\w+)\s\1. To replace the two words
with just one word, use the expression $1.
You also can create a named capture group using the format
?<, where
name>name\k< within the regular
expression, or name>$< within a
replacement pattern. For example, to find duplicate words using a named capture group, use
the expression name>(?<myword>\w+)\s\k<myword>. To replace the two
words with just one word, use the expression $<myword>.
For more information about searching using the find and replace dialog box, see Find and Replace Text in Files and Go to Location.
Use the Debugger panel to manage breakpoints and navigate the function call stack while
debugging in MATLAB
Online. To open the Debugger panel, go to the Editor or
Live Editor tab, and in the Analyze section,
click 
Debugger. You also can open the panel using the Open more panels
button () in the sidebar.
For more information, see Debug MATLAB Code Files.
In MATLAB
Online, you can open additional panels (also referred to as tools) directly from the
sidebars. To open additional panels, in a sidebar, click the Open more panels button (). Then, in the Open Panel dialog box, select from the
available panels. You also can right-click in a sidebar and select Open more
panels.
For example, to open the Code Issues panel, click the Open more panels button (), and select the Code Issues panel.
For more information, see Change Desktop Layout.
In MATLAB Online, when you click the MATLAB background, open windows in the foreground collapse. Collapsing a window reduces the size of the window by displaying only its title bar.
To restore the collapsed windows, click the title bar of one of the previously open windows.
To prevent a window from being collapsed or minimized, click 
on its title bar.
For more information, see Manage Windows in MATLAB Online.
Language and Programming
The Code Compatibility Analyzer app has a new interface that makes it easier to navigate issues found in code. You can now adjust how identified issues are grouped and filter results by text, severity, and issue type.
Data Analysis
Starting in R2023b, the output of the Live Editor displays the contents of tables or timetables that contain nested tables or timetables as variables inline. You can interactively manipulate a nested table, for example, by selecting or sorting a variable or copying a variable with its headers. Previously, the output of the Live Editor displayed the dimensions of nested tables, but not the nested table contents.
For example, use the Pivot Table task to create nested tables. The Live Editor output displays the complete pivoted table contents.
The stackedplot
function can plot events as lines or shaded regions on stacked plots created from
timetables. To plot events associated with a timetable, you must attach an event table to
it before you call stackedplot. For more information on event tables,
see eventtable.
To support events, stackedplot has a new
EventsVisible name-value argument:
If
EventsVisibleis"on", thenstackedplotplots events as lines or shaded regions.If
EventsVisibleis"off", thenstackedplothides events.
The Variables editor in MATLAB Online has improved functionality for these data types:
Scalar structure — You can now view, expand, and interactively edit the fields and nested fields in a scalar structure. Previously, you had to open each field in another tab in the Variables editor to view and edit its contents.
Object array — You can now view and interactively edit the values of common properties of objects in an object array. Previously, you had to open each object in a separate tab in the Variables editor to view and edit its property values.
Table with grouped variables — You can now select and interactively edit the contents of a subcolumn in a group of table variables. Previously, interactively editing a subcolumn in a group of table variables was not supported.
Data Import and Export
Mathematics
You can change the default algorithm and seed for the rng function from the MATLAB Preferences window. On the Home tab, in the
Environment section, click 
Preferences. Select MATLAB > General, and then select a different option for Default
algorithm and select a different value for Default
seed in the Random Number Generation
preference.
To access and modify
settings for the random number generator programmatically, you can access the
matlab.general.randomnumbers settings using the root
SettingsGroup object returned by the settings
function. For example, show the default algorithm and seed that you have set for the random
number generator.
s = settings; s.matlab.general.randomnumbers.DefaultAlgorithm s.matlab.general.randomnumbers.DefaultSeed
When you first start a MATLAB session or call rng("default"), MATLAB initializes the random number generator using the default algorithm and seed
that you have set. If you do not change these settings, then rng uses
the factory value of "twister" for the Mersenne Twister generator with
seed 0, as in previous releases.
When you perform parallel processing (requires Parallel Computing Toolbox), by default, the MATLAB client uses the Mersenne Twister random number generator with seed 0 and the
MATLAB workers use the Threefry 4x64 generator with 20 rounds with seed 0. Changing
the default generator settings in the MATLAB Preferences window or using the
matlab.general.randomnumbers settings affects only the default
behavior of the client and does not affect the default behavior of the parallel
workers.
When using the rng function, you can specify just the algorithm for
the random number generator to use. The rng(generator) syntax allows you
to set the random number algorithm without specifying the seed, where
rng uses a seed of 0. This syntax is equivalent to
rng(0,generator). For example, rng("philox")
initializes the Philox 4x32 generator with a seed of 0.
Graphics
Use the piechart and
donutchart
functions to create charts with more configuration options and interactivity than pie
charts had in previous releases.
Some of the improvements include:
More options for formatting slice labels, slice placement, and colors
Data tips that appear when you move the cursor over the slices
Plot multiple data series together using one of nine different color palettes to
differentiate the individual data series. You can change the palette by passing the
palette's name to the colororder
function. The available names are "gem", "gem12",
"glow", "glow12", "sail",
"reef", "meadow", "dye", and
"earth". The "gem" palette is the default for most
plots.
You can also use the orderedcolors
function to get the RGB triplets for any of the palettes.
Use the abyss
function to get a blue-to-black colormap for coloring your charts. Like for all predefined
colormaps, you can optionally specify the number of colors for the abyss colormap.
Control the order of legend entries by setting the Direction
property of the legend to "normal" or "reverse". In
most cases, the default direction is "normal".
Legends for stacked bar charts and area charts have a reverse order by default so the legend entries match the stacking order of the chart. For more information, see Legend order is reversed for stacked bar charts and area charts.
View any dimension of a plot on a logarithmic or linear scale by calling the xscale,
yscale, or
zscale
function after plotting. To switch between the different scales, call any of these
functions with "linear" or "log" as an input
argument. For example, yscale("log") changes the scale of the
y-axis to be logarithmic.
Create, delete, or modify secondary axis labels by calling the xsecondarylabel, ysecondarylabel, and zsecondarylabel functions. Secondary labels are text labels that appear at
the edge of the axes and provide additional information about the data. Often, they provide
information about the units or scale of the data.
For example, create a bar chart with datetime values along the x-axis
and feet along the y-axis. By default, the chart has a secondary
x-axis label of "2020". Call the
xsecondarylabel function with an empty string to delete the
"2020" label. Then add a secondary label of "Feet"
to the y-axis.
x = datetime(2020,5,1:8); y = 100:100:800; bar(x,y) xsecondarylabel(""); ysecondarylabel("Feet")
Create unbounded filled regions by passing Inf or
-Inf to the xregion and
yregion
functions. You can also create multiple regions by specifying one matrix input argument as
an alternative to specifying two vectors of coordinates. For n regions,
the matrix must be 2-by-n or n-by-2 and contain the
lower and upper bounds for all the regions.
Create text objects with the anchor point positions included in the axes limits
calculation. To include an anchor point in the calculation, set the AffectAutoLimits property of the text object to
"on".
For example, create a line plot.
x = 0:0.1:10; y = sin(x); plot(x,y)
Create a text object outside of the current y-axis limits. Set the
AffectAutoLimits property to "on" so that the
axes limits adjust to include the anchor point of the text.
text(1.1,1.1,"Peak",AffectAutoLimits="on")
Set the LabelColor
property of a Contour object to display labels that match the colors of
the contour lines, or specify one color for all the labels.
Now you can match the colors and line styles of more objects in the axes by setting the
SeriesIndex property of the objects to the same value. The
SeriesIndex property is available for Text,
ConstantLine, ConstantRegion,
Rectangle, Patch, and
AnimatedLine objects, and lines created by the line, streamline, and streamslice functions.
Also, the SeriesIndex property has a new option,
"none", which enables you to opt out of automatic selection for
certain objects, such as reference lines.
With the new SeriesIndex property support, lines created with the
line, streamline, and
streamslice functions have a different default color. For more
information, see Default color is different for lines created with the line
function and Default color is different for plots created with the streamslice
and streamline functions.
Create text, such as titles and axis labels, for heatmap charts with TeX markup, LaTeX markup, or no markup by setting the
Interpreter
property of the chart.
You can now display images using datetime, duration, or categorical coordinate values
with the image and imagesc functions. Previously, only numeric and logical coordinate values
were supported.
For example, display an image with datetime values along the x-axis and duration values along the y-axis.
x = datetime(2020,1,[1 10]); y = minutes([1 10]); C = peaks(10); imagesc(x,y,C)
Create a horizontal swarm chart by setting the YJitter property
when you call the swarmchart
function. When you specify the YJitter property without specifying the
XJitter property, MATLAB sets the XJitter property to "none",
and the resulting distributions in the chart are horizontal.
The "streets-light", "streets-dark",
"streets", and "topographic" basemaps hosted by
Esri, which are used by geographic axes objects and other objects with a
Basemap property, have an improved visual appearance at high zoom
levels. For example, this image compares a basemap at zoom level 21 in R2023a with the same
basemap and zoom level in R2023b.
The basemaps can also have different appearances at other zoom levels. For example, this image compares a basemap at zoom level 15 in R2023a with the same basemap and zoom level in R2023b.
For more information about changing the basemap of geographic axes, see geobasemap.
The basemaps hosted by Esri update periodically. As a result, you might see differences in your visualizations over time.
The default order of legend entries for stacked (vertical) bar charts and area charts is now reversed to match the stacking order of the chart. Previously, the legend entries were listed in the opposite order of stacked bars and area charts.
To preserve the order of previous releases, set the Direction
property of the legend to "normal".
lgd = legend;
lgd.Direction = "normal";
Now that the SeriesIndex property is available for lines created
with the line function, the lines cycle through the
same colors (and optional line styles) that most other plots do.
The default color change applies only to the lines you create when you specify the
x, y, and optional z
arguments. If you create lines with a syntax that uses name-value arguments only, the
plots look the same as in previous releases.
For example, create two lines with x and y input arguments. In R2023b, the first line is blue and the second line is red-orange. Before R2023b, both lines were blue.
line1 = line([0 1],[0 1]); line2 = line([0 1],[1 2]);
To preserve the behavior of previous releases, set the
SeriesIndex property of the lines to 1. You
can set the property using a name-value argument when you call the
line function, or you can set the property of the
Line object using dot notation later.
% Use a name-value argument line1 = line([0 1],[0 1],SeriesIndex=1); % Use dot notation line2 = line([0 1],[1 2]); line2.SeriesIndex = 1;
When you create a streamslice or streamline plot, MATLAB automatically assigns colors and line styles the same way as for most
other plots. For example, the first set of lines created with
streamslice are now a soft blue color.
[x,y] = meshgrid(-10:10);
u = 2.*x.*y;
v = y.^2 - x.^2;
slicelines = streamslice(x,y,u,v);
axis tight
If you call either of the functions repeatedly, subsequent plots cycle through the same set of colors as other plots do. In previous releases, the lines were bright blue.
To preserve the appearance from previous releases, use the set
function to set the Color property to [0 0
1].
set(slicelines,Color=[0 0 1])
App Building
You can create a range slider using the uislider function by specifying the style as "range".
Alternatively, in App Designer, you can drag a Slider (Range)
component from the Component Library onto the canvas. The range slider
has two thumbs that app users can use to adjust the range of values. For example, this code
creates a range slider that specifies values from 10 to 60.
fig = uifigure;
sld = uislider(fig,"range",Value=[10 60]);
Interactively rearrange tabs, menus, tree nodes, and toolbar tools between parents by dragging the component in the Component Browser. For example, interactively move and change the parents of menus and menu items.
For a 2-D view of a 3-D chart in apps created in App Designer or using the
uifigure function, you can zoom into a rectangular region. To
enable region-zooming, click the Zoom In or Zoom Out button in the axes toolbar, or set the
Interactions property of the axes to the
regionZoomInteraction object.
For example, create a 3-D surface plot and set the view to the x- and z-axes. Click the Zoom In button and then drag to select the region of interest.
f = uifigure; a = axes(f); surf(a,peaks); view(a,[0 0]);
Previously, for 3-D charts, the region-zoom interaction was supported only for the xy view.
Performance
Tiled chart layouts that have the "flow" tile arrangement and axes
that span many tiles are more responsive when the tile arrangement changes. The tile
arrangements change under these conditions:
Adding new axes
Resizing the figure
Customizing the appearance of the axes by setting axes properties
For example, this code is about 1.4x faster than in the previous release.
function mylayout tiledlayout("flow") for i = 1:6 nexttile([1000,1000]); end end
The approximate execution times are:
R2023a: 0.0380 s
R2023b: 0.0276 s
The code was timed on a Windows 10, Intel
Xeon CPU W-2133 @ 3.60 GHz test system using the timeit
function.
timeit(@mylayout)
Interactions with scatter plots show improved responsiveness. To observe the
improvement, the plot must be created in an app or in a figure created with the
uifigure function, and the markers must either be points
(".") or have a size less than 35. The improvement is most noticeable
for plots with 1 million or more points.
For example, on a Windows 10, Intel Xeon CPU W-2133 @ 3.60 GHz test system, create a 3-D scatter plot with 7 million points in an app window, and then drag to rotate the axes. The rotation is smoother and responds more quickly to the drag gesture in R2023b than in the previous release.
function myscatter f = uifigure; ax = axes(f); z = linspace(0,4*pi,7e6); x = 2*cos(z) + rand(1,7e6); y = 2*sin(z) + rand(1,7e6); scatter3(ax,x,y,z,[],1:7e6,".") end
These animations start with the corner of the xy-plane at (–2, –2) in the center of the frame.
R2023a | R2023b |
|---|---|
The rotation of the axes lags behind the movement of the cursor.
| The rotation of the axes is smoother and follows the movement of the cursor more closely.
|
In apps, panning a plot containing ConstantLine or
ConstantRegion objects is smoother and the contents of the axes
update immediately as you pan. Previously, panning showed blank areas when you panned
outside of the original axes limits.
For example, on a Windows 10, Intel Xeon CPU W-2133 @ 3.60 GHz test system, if you run this code and then pan within the axes, the horizontal line and the gray vertical region update immediately as you pan.
function myapp fig = uifigure; ax = axes(fig); x = -10:0.1:10; y = sin(x); plot(ax,x,y); xlim(ax,[-6 6]) yline(ax,0) xregion(ax,-3,3) end
R2023a | R2023b |
|---|---|
The plot shows blank areas during the panning interaction.
| The plot updates immediately during the panning interaction.
|
When a user resizes an app figure window for the first time, many apps reposition their
content significantly faster in R2023b than in R2023a. The improvement occurs when resizing
an app with one or more containers that have the AutoResizeChildren
property set to "on", which is the default value. The improvement is
more noticeable for apps with nested containers, such as apps with many tabs or tab
groups.
For example, this code creates an app that contains five top-level tabs, each of which contains five nested tabs. Each of the nested tabs contains 100 edit fields. When you run this app and resize it, the resize operation is about 30x faster in R2023b than in the previous release.
function myApp f = uifigure; f.Position = [100 100 700 500]; % Create five tabs in a tab group tg = uitabgroup(f,"Position",[1 1 700 500]); nTabs = 5; for kTab = 1:nTabs tab = uitab(tg,"Title","Tab " + kTab); createTabContent(tab); end function createTabContent(tab) % Create a nested tab group containing five tabs nestedTg = uitabgroup(tab,"Position",[10 10 650 450]); nNestedTabs = 5; for kNTab = 1:nNestedTabs nestedTab = uitab(nestedTg,"Title","Nested Tab "+ kNTab); % Add 100 edit fields to the tab createNestedTabContent(nestedTab); end end function createNestedTabContent(tab) % Add 100 edit fields to a tab hParent = 400; n = 10; w = 50; h = 22; for kRow = 1:n for kCol = 1:n uieditfield(tab,"Position",[(kCol-1)*(w+10)+10,hParent-kRow*(h+10),w,h]); end end end end
R2023a | R2023b |
|---|---|
The app takes about 60 seconds to resize.
| The app takes about two seconds to resize.
|
The resize interactions were times on a Windows 10, Intel
Xeon Gold 6246R CPU @ 3.40 GHz test system by running the myApp
function and measuring the time it takes for the figure window to resize.
Displaying images and 3-D plots in apps is significantly faster in MATLAB
Online. You might also experience similar improvements outside the context of an app
(by calling figure instead of uifigure).
For example, this code displays a scaled-up version of peppers.png
using the image command. The code is about 22x faster than in the
previous release.
function myapp f = uifigure; ax = axes(f); smallimg = imread("peppers.png"); bigimg = uint8(zeros(3065,4089,3)); bigimg(:,:,1) = uint8(interp2(double(smallimg(:,:,1)),3)); bigimg(:,:,2) = uint8(interp2(double(smallimg(:,:,2)),3)); bigimg(:,:,3) = uint8(interp2(double(smallimg(:,:,3)),3)); tic image(ax,bigimg) drawnow toc end
The approximate execution times are:
R2023a: 138.5 s
R2023b: 6.4 s
The code was timed by calling the myapp function. Because MATLAB
Online is hosted, performance is independent of the computer hardware used to access
it.
Software Development Tools
In MATLAB Online, you can use the Source Control panel to see all active source control repositories, manage modified files, and perform source control operations.
To open the Source Control panel, use the Open more panels button () in the sidebar.
External Language Interfaces
Hardware Support
Environment
You can increment, decrement, multiply, or divide numeric values in the Editor and then run the current section after every change. This workflow can help you fine-tune and experiment with your code.
To adjust a numeric value, select the value or place your cursor next to the value. Next, right-click and select Increment Value and Run Section. In the dialog box that appears, specify a step value for addition and subtraction or a scale value for multiplication and division. Then, click one of the operator buttons to add to, subtract from, multiply, or divide the selected value in your section. MATLAB runs the section after every click.
You can add a file browser to your live script to interactively select a file by
opening a file selection dialog box. To add a file browser, go to the Live
Editor tab, and in the Code section, click
Control. Then, select File
Browser.
For more information, see Add Interactive Controls to a Live Script.
The Live Editor automatically left-aligns drop-down lists, edit fields, numeric sliders, and numeric spinners within a block of code when the code is hidden.
For example, this live script contains three controls in two different blocks of code. When the code is visible, the controls appear inline with the code.
When the code is hidden, the Live Editor automatically aligns the second and third controls, as they are in the same block of code. The first control is not in the same block of code and is therefore not aligned to the other two controls.
The Live Editor does not align check boxes, buttons, and file browsers.
The MATLAB Online desktop includes sidebars on either side of the desktop to access desktop tools and change the desktop layout. The sidebars show the tools, such as the Workspace panel and the Files panel, that are docked on either side of the desktop. If there are no tools docked on one side, the sidebar for that side is hidden. You can use the sidebars to show and hide tools, group them together, and move them from one location to another.
When a tool is docked on the left or right side of the desktop, the sidebar on that side displays an icon for the tool. To show or hide the tool, click its icon in the sidebar. To show and hide multiple tools together, group them by dragging one of the tool icons next to another tool icon. To move a tool to a different location on the desktop, drag the tool or the icon for the tool to the new location. If there are no tools docked on one side, then the sidebar on that side is hidden.
You can use the Code Issues tool to view error and warning messages about your code. The Code Issues tool displays the coding problems found by the MATLAB Code Analyzer as it automatically checks your code. Using the Code Issues tool, you can choose to view the errors and warnings for the current file or for all open files. You also can filter the list of messages by type (error or warning) as well as by message text.
To open the Code Issues tool, go to the Editor or Live
Editor tab, and in the Analyze section, click
Code Issues. By default, the Code Issues tool opens on the right
side of the desktop. To hide the Code Issues tool, click the Code Issues
icon in the sidebar.
You can use the improved Find Files tool to search for files based on name or content.
When searching, you can choose whether to match the case of your search text as well as
whether to match the whole word. You also can select what folder to search in and filter
results by file extension. To search for files, click the Find Files icon
in the sidebar on the left side of the MATLAB
Online desktop.
Language and Programming
Fix certain code issues directly from the Code Analyzer app using the Fix button.
Data Analysis
Data Import and Export
Mathematics
Graphics
Use the sky
function to color charts with the same monochromatic colormap that heatmap charts use.
Like for all predefined colormaps, you can optionally specify the number of colors for
the sky colormap.
Create horizontal or vertical layouts by specifying "horizontal" or
"vertical" as the first input argument to the tiledlayout function. For example, create a horizontal layout and add
three plots.
tiledlayout("horizontal")
x = 1:5;
nexttile
plot(x)
nexttile
bar(x);
nexttile
contourf(peaks)
Change the thickness of grid lines independently of the box outline and tick marks by
setting the GridLineWidth and MinorGridLineWidth properties of the axes. Before R2023a, the
LineWidth property of the axes was the only property for
controlling the grid line width. However, that property controlled the grid lines, box
outline, and tick marks together. Now you can control the thickness of the grid lines
separately.
When you change the Rotation property of
an axis label in a 2-D plot, the HorizontalAlignment and
VerticalAlignment properties of the label automatically change
to prevent overlap between the label and the axes.
For example, create a plot with a y-axis label.
plot([0 3 1 6 4 10])
ylab = ylabel("Y Data");
Rotate the label so that the text is horizontal. MATLAB automatically adjusts the HorizontalAlignment and
VerticalAlignment properties to prevent the overlap.
ylab.Rotation = 0;
When plotting a series of multiple lines, you can use the LineStyleCyclingMethod property of the axes to control how different
lines are distinguished from one another. Specify this property as one of these values:
"withcolor"— Cycle through the line styles with the colors"beforecolor"— Cycle through the line styles before cycling through the colors"aftercolor"— Cycle through the line styles after cycling through the colors (default)
Specify whether a specific line affects the automatically selected axes limits by
setting the AffectAutoLimits property. By default, the axes limits change to
encompass the data range for each successive line you create. Setting this property
enables you to focus on the range of a subset of lines in the axes.
![Two line plots, each showing the same two data sets as a thin red line and thick blue line, but with different x-axis limits. The x-values of the thin red line range from –100 to 100. The x-values of the thick blue line range from 0 to 100. The x-axis in the left plot spans the range [–100, 100]. The x-axis in the right plot spans the range [0, 100]. As a result, the right plot excludes part of the thin red line.](23a-graphics-affectsaoutolims-for-gr.png)
In MATLAB
Online, you can set the default values for these aspects of images displayed
using imshow:
Axes visible — Control whether
imshowdisplays images with the axes box outline and tick labels.Border Style — Control whether
imshowdraws a tight or loose border around images in the figure window.Initial Magnification — Control whether
imshowinitially fits images to the figure window or magnifies them by a specified percentage.
To open these image display preferences, on the Home
tab, in the Environment section, click 
Preferences. Select MATLAB > Image Display.
App Building
When you load an app in App Designer, a progress bar now displays an estimate of its loading progress.
To add a label to a UI component without one, in Design View, right-click the component and select Add Label or use the keyboard shortcut Ctrl+L.
You can now more efficiently create a new callback for a UI component that already has
a callback assigned. To replace an existing callback with a new one, select the
component in the Component Browser and, in the
Callbacks tab, select the option to add a callback. For
example, for a component with a ButtonPushedFcn callback already
assigned, select <add ButtonPushedFcn callback> from the
associated drop-down list. App Designer creates a new callback function, assigns it to
the component, and unassigns the previous callback function.
Previously, you had to first unassign the assigned callback from the component before creating a new callback.
For apps created in App Designer and using the uifigure function,
use data cursor mode to interactively create and edit data tips. For supported charts,
select the Data Tips 
icon in the axes toolbar or use the datacursormode function.
Performance
The ruler-pan interaction is faster and smoother within apps and within figures
created with the uifigure function in R2023a than in R2022b. The
improvement is most noticeable for plots that display a large number of data
points.
For example, this code creates a figure with a plot of a 2500-by-2500 matrix. When you pan the ruler, the ruler-pan interaction is smoother and the axes track your mouse motion more closely in R2023a than in the previous release.
f = uifigure; ax = uiaxes(f); p = peaks(2500); plot(ax,p)
| R2022b | R2023a |
|---|---|
When panning the ruler, the surface plot takes a moment to reposition and jumps to the new location.
| When panning the ruler, the surface plot follows the mouse motion more closely and repositions more quickly at the new location.
|
The ruler-pan interaction was performed on a Windows 10, Intel Xeon CPU E5-1650 v4 @ 3.60 GHz test system by running the above script and panning the y-axis ruler.
In the output of the Live Editor, the performance of filtering a numeric table or timetable variable is improved. When dragging the maximum or minimum value slider, the drag interaction is smoother and faster in R2023a than in R2022b, and the data tip displaying the current slider value appears to the side of the filtering figure.
For example, for a table output in the Live Editor, pause on the header of a numeric variable and click the triangle icon. Then, to filter the data, adjust the maximum value by dragging the slider. The drag interaction is smoother and tracks your mouse motion more closely in R2023a than in the previous release.
| R2022b | R2023a |
|---|---|
After dragging the maximum value slider in a filtering figure, the slider takes a moment to reposition and jumps to the new location. The associated data tip moves with the slider and obscures the filtering figure.
| After dragging the maximum value slider in a filtering figure, the slider follows the mouse motion more closely and repositions more quickly at the new location. The associated data tip is located in a fixed position to the right of the filtering figure.
|
The filtering interaction was performed on a Windows 10, Intel Xeon CPU E5-1650 v4 @ 3.60 GHz test system by dragging the maximum value slider in the filtering figure for a 1000-row numeric table variable.
When a user resizes an app figure window, some apps reposition their content faster in R2023a than in R2022b. The types of apps that show this improvement are:
Large apps with tabs that have an
AutoResizeChildrenvalue of'on'Large apps with panels and button groups that have a
SizeChangedFcncallback
For example, this code creates an app with a tab group where each tab contains many edit fields that are resized automatically. The resize operation is smoother and faster in R2023a than in the previous release.
function tabResize fig = uifigure; tg = uitabgroup(fig,"Position",[20 20 400 375]); for k1 = 1:5 t = uitab(tg,"Scrollable","on"); for k2 = 1:100 ef = uieditfield(t,"Position",[50 22*k2 250 20]); end end end
| R2022b | R2023a |
|---|---|
When the app resizes, the app content takes multiple seconds to reposition. | When the app resizes, the app content takes less than one second to reposition. |
As another example, this code creates an app with many panels, each of which resizes a
button using a SizeChangedFcn callback whenever the app size changes.
The resize operation is smoother and faster in R2023a than in the previous
release.
function panelResize fig = uifigure("AutoResizeChildren","off", ... "SizeChangedFcn",@resizePanels); for k = 1:225 p = uipanel(fig, ... "AutoResizeChildren","off", ... "SizeChangedFcn",@resizeButtons); btn = uibutton(p,"Position",[2 2 20 20]); end end function resizeButtons(src,~) for k = 1:length(src.Children) src.Children(k).Position(3:4) = 0.9*src.Position(3:4); end end function resizePanels(src,~) xscale = src.Position(3)/15; yscale = src.Position(4)/15; for k = 1:length(src.Children) p = src.Children(k); p.Position = [xscale*(mod((k-1),15)), ... yscale*(floor((k-1)/15)), ... xscale, ... yscale]; end end
| R2022b | R2023a |
|---|---|
When the app resizes, the app content takes multiple seconds to reposition.
| When the app resizes, the app content takes about one second to reposition.
|
The resize interactions were performed on a Windows 10, Intel
Xeon CPU E5-1650 v4 @ 3.60 GHz test system by running the
tabResize and panelResize functions and
resizing the figure window.
Software Development Tools
You can now investigate how projects in your hierarchy relate to each other and identify projects that introduce circular dependencies using the Project Hierarchy view in MATLAB Online. For more information, see Analyze Project Dependencies.
External Language Interfaces
Hardware Support
Environment
You can add numeric spinners to your live scripts to interactively increment and
decrement the value of variables. To add a numeric spinner, go to the Live
Editor tab, and in the Code section, click
Control. Then, select Numeric
Spinner.
For more information, see Add Interactive Controls to a Live Script.
Starting in R2022b, you can use Ctrl+Space to show code suggestions
in the Editor, Live Editor, App Designer, and MATLAB
Online Command Window. In addition, you can change when to show suggestions and
how to accept them. On the Home tab, in the
Environment section, click
Preferences. Select Editor/Debugger > Automatic Completions and in the Suggestions and completions section,
adjust one or more of the options:
To disable showing suggestions automatically, clear the Show suggestions automatically option.
To disable showing suggestions after you press the Tab key, clear the Use tab to show suggestions (in addition to ctrl+space) option. When this option is cleared, you can still show suggestions by typing Ctrl+Space.
To disable accepting a suggestion using the Right Arrow key, clear the Use right arrow to accept suggestions (in addition to tab and enter) option. When this option is cleared, you can still accept a suggestion using the Tab and Enter keys.
For more information, see Code Suggestions and Completions.
In MATLAB Online, you can now use the Search box in the top-right corner of the desktop to easily access toolstrip actions, preferences, and Help Center resources such as functions, blocks, examples, and answers. To navigate to the Search box using a keyboard, press Ctrl+Shift+Space (or Command+Shift+Space on macOS systems).
For example, to restore the MATLAB desktop to its default layout, enter the word layout in
the Search box. In the list of results, select the Layout - Two Column
(Default) toolstrip action.
Windows and macOS systems support light and dark color schemes. Starting in R2022b, MATLAB Online is configured to match the current operating system color scheme by default using the system theme. If the selected color scheme for the operating system changes, the colors of the MATLAB desktop change to match the new scheme.
To change the selected theme, on the Home tab, in the
Environment section, click
Preferences. Select MATLAB > Appearance and select a theme from the Theme field. For more
information, see Change Desktop Colors.
If you customize the colors of the MATLAB desktop and then the MATLAB desktop theme changes to a new theme or to match a change to the operating
system color scheme, your customizations will be lost. To avoid unexpectedly losing
color customizations when the operating system color scheme changes, select the
Light or Dark option from the
Theme field before making any color customizations.
When viewing the documentation from an installed version of MATLAB, you can now view the documentation for all products. Previously, you could view only the documentation for installed products. The Help browser indicates installed products using a green bar to the left of the product name or its category.
To view the list of installed products, select Product List at the top left of the Help browser. The Help browser displays the list of products that are installed for the current version of MATLAB. If MATLAB is configured to display the web documentation (default), the Help browser also displays the list of products that are not installed.
Language and Programming
Data Analysis
The Data view in the Data Cleaner app displays sparklines and summary statistics to quickly visualize and interpret the data in each table or timetable variable. Show more information related to specific points by pointing to a sparkline.
In the Live Editor output and Variables editor in MATLAB
Online, you can control the placement of missing values (NaN,
NaT, <undefined>, and
missing) when sorting rows of numeric data.
For example, to place missing elements first, on the Home tab,
in the Environment section, click
Preferences. Select MATLAB > Variables
and set Placement of missing values to
first.
In the Variables editor, you can also control missing value placement using the Variable tab. In the Transform section, from the Sort list, select an option for Missing Placement.
The Variables editor in MATLAB Online now displays sparklines and summary statistics to quickly visualize and interpret the data in each table or timetable variable. Show more information related to specific points by pointing to a sparkline. Show or hide the sparklines or summary statistics using the Display section in the View tab.
Java objects now open in an improved Property Inspector that is consistent with the one used for graphics and other handle objects. For example, view and edit the properties of a Java object using the improved Property Inspector.
myDate = java.util.Date; inspect(myDate)
Data Import and Export
Mathematics
Graphics
Create plots by passing a table directly to any of these functions: stem, stem3, stairs, geoplot,
and geoscatter. If you create any of these plots with a table and then add a
legend, the legend items are automatically labeled with the table variable names. If you
create a stem or stairstep plot, the axis labels are automatically set to the
corresponding variable names (geographic plots always have "Longitude" and "Latitude"
axis labels regardless of the variable names).
For example, create a table with the variables Estimate and
Measurement. Pass the table to the stem
function as the first argument, and specify the variables you want to plot.
Estimate = (1:13)'; Measurement = (1:13)'; T = table(Estimate,Measurement); stem(T,"Estimate","Measurement")
The errorbar function now accepts the same
combinations of matrices and vectors as the plot function does. As
a result, you can plot multiple lines at once rather than calling the
hold function between plotting commands.
Customize the appearance of a contour plot by setting these properties of the
Contour object:
LabelFormat— Specify the formatting of the contour labels as a format operator that thecomposefunction accepts. You can also specify a handle to a function that performs calculations when formatting the labels.FaceColorandEdgeColor— Specify the fill color between contour lines with theFaceColorproperty, and specify the colors of the contour lines with theEdgeColorproperty. These new properties replace theFillandLineColorproperties from previous releases.FaceAlphaandEdgeAlpha— Specify the transparency of the colors between contour lines with theFaceAlphaproperty, and specify the transparency of the contour lines with theEdgeAlphaproperty.
The boxchart
function now includes options for the box edge color and box median line color. You can
specify these colors using the BoxEdgeColor and
BoxMedianLineColor name-value arguments, respectively.
When you pass a table and one or more variable names to a plotting function, the axis and legend labels now display any special characters that are included in the table variable names, such as underscores. Previously, special characters were interpreted as TeX or LaTeX characters.
For example, this code creates a line plot from a table that has underscores in the variable names. In R2022b, the underscores appear in the x-axis label and the legend labels. In R2022a and earlier releases, the underscores are interpreted as subscripts.
Sample_Number = (0:10)'; Mean_AM = (2:12)'; Mean_PM = (3:13)'; t = table(Sample_Number,Mean_AM,Mean_PM); plot(t,"Sample_Number",["Mean_AM" "Mean_PM"]) legend
To display axis and legend labels with TeX or LaTeX formatting, specify the labels
manually. In this case, call the xlabel and
legend functions with the desired label strings.
xlabel("Sample_Number") legend(["Mean_AM" "Mean_PM"])
When you plot into geographic axes by using functions such as geoplot and geoscatter, MATLAB does not reset the basemap. In R2022a and earlier releases, the
basemap resets when you add new plots.
As a result, you can specify a basemap and then visualize data without using the
hold function between commands. For example, this code
creates a map using the streets basemap. Then it displays a
scatter plot over the basemap. In R2022b, the basemap does not reset. In R2022a and
earlier releases, the basemap resets to the default
streets-light.
lat = [35 -22 51 39 37 42 47 -33]; lon = [139 -43 0 116 23 -71 -122 18]; figure geobasemap streets geoscatter(lat,lon,"filled")
This change does not affect existing code that sets the hold
state to "on" between commands.
To reset the basemap when you add a new plot, use the cla reset
syntax of the cla function before you create the
plot. For example, to update the preceding code, use cla reset
between the calls to geobasemap and
geoscatter.
lat = [35 -22 51 39 37 42 47 -33]; lon = [139 -43 0 116 23 -71 -122 18]; figure geobasemap streets cla reset geoscatter(lat,lon,"filled")
Alternatively, you can change the basemap to the default
streets-light by using the geobasemap function. For more information about changing the basemap
of geographic axes, see Access Basemaps for Geographic Axes and Charts.
App Building
When you select multiple components in App Designer that have a callback type in common, you can now create a single shared callback for all the selected components. For example, in an app with an edit field and a slider, you can select the two components, right-click one of them, and select Callbacks > Add ValueChangingFcn callback. App Designer creates a single new callback and assigns it to both the edit field and the slider.
You can also now more easily find callbacks in your app that are not assigned to any
components. In Code View, navigate to the
Callbacks tab in the Code Browser. An
unassigned callback appears with a 
icon next to its name. If you do not need the
callback, you can delete it by right-clicking the callback name and selecting
Delete.
When using the Comparison Tool to merge changes between two app files, you can now
choose to navigate only mergeable changes. To toggle this ability, while in merge mode,
click 
Mergeable Only in the toolstrip. If Mergeable
Only is selected, when you navigate changes using the
Previous and Next buttons, the tool
skips changes that are not mergeable, such as changes to the noneditable code generated
by App Designer. The Mergeable Only button is selected by
default.
For apps created in App Designer and using the uifigure
function, when you query the InnerPosition property of a tab
group created using the uitabgroup, the property returns a
different value than in the previous release. In addition, if the
TabLocation is 'left' or
'bottom', when you query the Position,
InnerPosition, and OuterPosition
properties of a tab created using the uitab function, the properties
might return different values than in the previous release.
This table describes the differences in the property values between R2022b and previous releases.
| Property | Starting in R2022b | R2022a and Earlier | ||
|---|---|---|---|---|
| Description | Image | Description | Image | |
InnerPosition of a tab group | A four-element vector of the form [left bottom width
height] that represents the size and location of the
tab group relative to the drawable area of its parent,
excluding borders and titles of the tabs it
contains | Tab group
| A four-element vector of the form [left bottom width
height] that represents the size and location of the
tab group relative to the drawable area of its parent,
including borders and titles of the tabs it
contains | Tab group
|
Position, InnerPosition,
and OuterPosition of a tab | A four-element vector of the form [left bottom width
height] that represents the size and location of the
tab relative to the tab group drawable area, where the tab group
drawable area excludes borders
and titles | Tab
| A four-element vector of the form [left bottom width
height] that represents the size and location of the
tab relative to the tab group drawable area, where the tab group
drawable area includes borders
and titles | Tab
|
If you notice changes in your app layout, consider updating your code in this way:
Tab group
InnerPosition— Replace references to the tab groupInnerPositionproperty with the tab groupPositionproperty to use the size and location of the tab group including the borders and tab titles.Tab
Position,InnerPosition, andOuterPosition— Replace references to the first two elements of the position vector to instead use the space taken up on the left or bottom by the tab titles. For example, if your app contains a tab group with aTabLocationvalue of'left'and you reference thePositionproperty of a tab in that tab group, replace that reference with the horizontal distance between the tab group border and the tab drawable area.
Performance
Interactions with large images are more performant within apps and within figures
created with the uifigure function. The improvement is noticeable
for images with at least 3000 pixels along one dimension. In particular, these
interactions are more responsive in R2022b than in R2022a:
Zooming out — The image updates immediately after you zoom out of an image. Previously, there was a delay before the image updated.
Panning — The image updates as you are panning within an image. Previously, the image updated after you finished panning (for example, after releasing the mouse).
For example, if you run this code on a Windows 10, Intel Xeon CPU W-2133 @ 3.60 GHz test system with a modern graphics card, and then zoom into the resulting image and pan around, the image updates immediately as you interact.
imdata = imread("peppers.png");
imdata2 = repmat(imdata,8,8,1);
f = uifigure;
ax = axes(f);
image(ax,imdata2)
Axes ticks and grid lines update immediately as you pan within many types of Cartesian plots that are displayed in apps. Previously, the ticks and grid lines updated after you released the mouse. Now, the ticks update immediately for most plots that meet all of these conditions:
They are in 2-D Cartesian space
They display numeric data on a linear scale
They have the default tick values and labels
They have the default axis locations
Grid lines update immediately under the same conditions, but you can see the improvement in 3-D views in addition to 2-D views.
For example, if you run this code on a Windows 10, Intel Xeon CPU W-2133 @ 3.60 GHz test system and then pan within the axes, the ticks and the grid lines update immediately as you pan.
f = uifigure;
ax = uiaxes(f);
x = 1:50;
y = rand(1,50);
plot(ax,x,y);
ax.XLim = [20,30];
grid(ax,"on")
The exportgraphics function has improved performance and creates a smaller
file when you export a complex graphic as a PDF containing vector graphics. To observe
the improvement, the plot must be displayed in an app or in a figure created with the
uifigure function. For example, this code creates a figure
containing a complex contour plot. Then it calls the exportgraphics
function to export the plot as a PDF containing vector graphics content. The
exportgraphics function executes about 2.1x faster, and the
file size is about 23% smaller than in the previous release.
function myapp f = uifigure; ax = uiaxes(f); x = linspace(-250*pi,250*pi); y = linspace(0,500*pi); [X,Y] = meshgrid(x,y); Z = sin(X)+cos(Y); contour(ax,X,Y,Z,50) tic exportgraphics(ax,"mycontours.pdf","contentType","vector") toc end
The approximate execution times (and file sizes) are:
R2022a: 16.3 s (3.45 MB)
R2022b: 7.7 s (2.66 MB)
The code was timed on a Windows 10, Intel
Xeon CPU E5-2660 @ 2.20 GHz test system by calling the myapp
function:
myapp
Tiled chart layouts that have the "flow" tile arrangement and axes
that span several tiles are more performant when they update. Layouts update when you
make changes that affect the arrangement of the tiles, including:
Adding new axes
Resizing the figure
Customizing the appearance of the axes by setting axes properties
The performance improvement is more significant when there are axes that span many tiles. For example, this code is about 1.4x faster than in the previous release.
function mylayout t = tiledlayout("flow"); nexttile(t,[20 15]) nexttile(t,[20 15]) nexttile(t,[10 30]) nexttile(t,[10 30]) nexttile(t,[10 30]) drawnow end
The approximate execution times are:
R2022a: 0.1082 s
R2022b: 0.0788 s
The code was timed on a Windows 10, Intel
Xeon CPU W-2133 @ 3.60 GHz test system using the timeit
function:
timeit(@mylayout)
Software Development Tools
External Language Interfaces
Hardware Support
Environment
In MATLAB Online, you can change the colors of the MATLAB desktop using themes.
For example, to select a dark theme, on the Home tab, in the
Environment section, click
Preferences. Select MATLAB > Appearance and set the Theme to Dark.
To further customize the colors of the MATLAB desktop, select MATLAB > Appearance > Colors. Then, change the colors in the Desktop tool colors, MATLAB syntax highlighting colors, and MATLAB output colors sections.
As part of this change, icons in the MATLAB Online desktop have an improved visual appearance.
For more information about changing the colors of the MATLAB desktop, see Change Desktop Colors.
You can change the text and background colors in the Live Editor by changing the MATLAB desktop tool colors.
To change the text and background colors:
On the Home tab, in the Environment section, click
Preferences.Select MATLAB > Colors
In MATLAB Online, select MATLAB > Appearance > Colors.
In the Desktop tool colors section, clear the Use system colors check box.
In MATLAB Online, the Use system colors check box is not available and this step can be skipped.
Use the Text and Background fields to change the colors. For example, select white for the text color and black for the background color.
The Live Editor automatically selects colors for titles and headings based on the selected background color. To further customize the colors of titles and headings, use settings. For more information, see matlab.fonts Settings.
You can use a subset of regular expressions to search for text that matches a pattern
in an open file in the Editor or Live Editor. To search using a regular expression, on
the Editor or Live Editor tab, in the
Navigate section, click Find. Then, in the find and replace dialog box, enter
a regular expression, and select the Regular Expression button
.
For example, to find all the words in a file that contain the letter
x, enter the expression \w*x\w* and select the
Regular Expression button .
For more information, see Find and Replace Text in Files and Go to Location.
Language and Programming
Data Analysis
Data Import and Export
Mathematics
Graphics
Create plots by passing a table directly to any of these functions: plot,
plot3, loglog, semilogx, semilogy, and polarplot. When you specify your data as
a table, Cartesian axis labels and the legend (if present) are automatically labeled
using the table variable names.
For example, create a table with the variables Temperature and
Humidity. Pass the table to the plot
function as the first argument, and specify the variables you want to plot.
Temperature = (40:70)'; Humidity = (50:80)' + randn(31,1); T = table(Temperature,Humidity); plot(T,"Humidity","Temperature")
When plotting tabular data, the default row labels of data tips created interactively
or with the datatip
function are the names of the table variables associated with the data point.
For example, create a table using the sample file patients.xls.
Then, plot the Systolic, Diastolic, and
Weight variables in a bubble chart. A data tip created with
datatip(b) displays three rows. The row labels are "Systolic",
"Diastolic", and "Weight".
tbl = readtable("patients.xls"); b = bubblechart(tbl,"Systolic","Diastolic","Weight"); datatip(b);
For scatter plots and bubble charts, data tips created interactively or with the
datatip
function include by default rows for visual properties such as size, color, or
transparency that are specified with vector data.
For example, create a scatter plot of random data and define the marker sizes as
vector sz. A data tip created with datatip(s)
displays three rows: X, Y, and
Size. The Size row in the data tip displays
the marker size specified by sz for the associated data point.
x = linspace(0,3*pi,200); y = cos(x) + rand(1,200); sz = linspace(1,100,200); s = scatter(x,y,sz); datatip(s);
The bubblechart, bubblechart3, polarbubblechart, and scatter3 functions now accept the same combinations of matrices and
vectors as the plot function does. As a result, you can visualize multiple data sets at
once rather than using the hold function between plotting commands.
Set the Alignment property of a Quiver object
to control how the arrows align with the data points. Valid values are
"head", "center", and
"tail". For example, plot a grid of vectors with the arrow heads
positioned at the data points. Specify a marker symbol to show the locations of the data points.
[X,Y] = meshgrid(0:6,0:6); U = 0.25*X; V = 0.5*Y; quiver(X,Y,U,V,"Alignment","head","Marker","o")
When you modify a figure in MATLAB Online using the Figure tab, MATLAB generates code that you can view, copy, and export. To view the generated code, select Show Code in the File section of the Figure tab. MATLAB generates code for these actions:
Adding a title, axis label, legend, color bar, grid, or annotation
Changing the text or line style
Using the pan, zoom, rotate, or data tip interactions
MATLAB does not currently generate code for the Select and Edit option in the Figure tab.
For example, you can create a surface plot with surf(peaks). Then,
interactively add a title and colorbar, zoom into the axes, and view generated code.
Polar axes now display tick values in degrees with degree symbols when the
ThetaAxisUnits property is set to
"degrees". For example, create a polar plot. By default, the
theta-axis displays the tick values with degree
symbols.
theta = 0:0.01:2*pi; rho = sin(2*theta).*cos(2*theta); polarplot(theta,rho)
This change clarifies which units are being used for the theta
tick values. You can use the ThetaAxisUnits property to display
the tick values in degrees or radians. To remove the degree symbols, change the tick
label format for the theta-axis:
pax = gca;
pax.ThetaAxis.TickLabelFormat = "%g";App Building
You can now create styles for table and tree UI components that specify an icon and a
text interpreter using the uistyle
function.
Specify the
Iconproperty of the style object to add icons to table cells and tree nodes.Specify the
IconAlignmentproperty of the style object to modify where the icon appears in relation to the text in table cells.Specify the
Interpreterproperty of the style object to format text or add links using HTML markup, or to add equations using TeX or LaTeX markup to table cells and tree nodes.Specify the
HorizontalClippingproperty of the style object to control whether long text is clipped on the left or the right in table cells and tree nodes.
Add a style to a UI component using the addStyle
function.
For example, this code creates two styles, one that specifies an icon and one that specifies the text interpreter as TeX, and applies the styles to columns of a table.
T = table(["x^2";"3x^3+1"],["Success";"Success"]); fig = uifigure(Position=[500 500 300 160]); t = uitable(fig,Position=[10 10 250 140],Data=T); s1 = uistyle(Interpreter="tex"); s2 = uistyle(Icon="success",IconAlignment="right"); addStyle(t,s1,column=1) addStyle(t,s2,column=2)
Grid layout managers with row heights or column widths of 'fit' now
resize to fit the contents of table, list box, and image UI components.
For example, when you create a table UI component inside a grid layout manager with a
row height or column width of 'fit', the height of the row or the
width of the column resizes to fit the data in the
table.
fig = uifigure(Position=[680 558 300 170]);
gl = uigridlayout(fig);
gl.RowHeight = {'fit'};
gl.ColumnWidth = {'fit'};
tbl = uitable(gl,Data=rand(3));
In R2021b, grid layout managers with row heights or column widths of
'fit' scaled to a fixed size when the row or column contained
a table, list box, or image UI component.
Table UI component — Row height and column width previously resized to 300 pixels.
List box UI component — Row height previously resized to display at most four items. The exact pixel value to display four items might vary depending on your settings.
Image UI component — Row height and column width previously resized to 100 pixels.
To display a table, list box, or image at its size in a release before R2022a, set
the corresponding elements of the RowHeight and
ColumnWidth properties of the
GridLayout object to their respective fixed sizes.
To specify error handling options when debugging code in App Designer, configure the
Run button by clicking Run
. You can choose to pause code execution when an error
occurs, when a warning occurs, or when a NaN or
Inf value is returned.
Additionally, error messages in App Designer now contain links to relevant files and functions. Use these links to navigate more easily to the documentation or to line numbers in your code when debugging your apps.
Compare and merge two versions of an app file in MATLAB
Online using the Comparison Tool. To open the Comparison Tool, click
Compare in the Designer tab of the App
Designer Toolstrip.
For more information, see Compare and Merge Apps.
When creating an app with a UIAxes component in App Designer,
the UIAxes component content is not displayed in Design
View when the component is partially or fully off the canvas.
Instead, the UIAxes component is shown as a placeholder image. To
see the content of the component, drag it fully onto the canvas.
You can still modify properties of the UIAxes component when it
is off the canvas, but you will not be able to see a visual reflection of those
changes in Design View until the component is dragged onto the
canvas.
Performance
Apps that involve continuous event-driven updates, such as animations implemented with
a timer, are more responsive to those events. To observe the improvement, the animation
must be created in an app or in a figure created with the uifigure function. For example, an app containing an animation
controlled by a timer object is more responsive when you call the timer’s
start and stop methods.
This code creates an app using a timer object to plot a random number every 0.01 second. If you run this app on a Windows 10, Intel Xeon CPU W-2133 @ 3.60 GHz test system, the animation responds more quickly when you click the Start/Stop button than in the previous release.
function mytimerapp uif = uifigure("CloseRequestFcn",@CloseRequest); uibutton(uif,"State","Position",[235 59 100 22], ... "ValueChangedFcn",@StateButtonChanged,"Text","Start/Stop"); ax = uiaxes(uif,"Position",[25 100 508 300],"XDir","reverse"); % Create initial plot line p = plot(ax,0:60,zeros(1,61)); % Create timer object RandTimer = timer(... "ExecutionMode","fixedRate", ... "Period",0.01, ... "BusyMode","queue", ... "TimerFcn",@RandTimerFcn); % Timer function function RandTimerFcn(~,~,~) % Generate a random number and update plot line ydata = p.YData; ydata = circshift(ydata,1); ydata(1) = rand; p.YData = ydata; end % State button callback function function StateButtonChanged(obj,~) switch obj.Value case 0 stop(RandTimer); case 1 % If timer is not running, start it if strcmp(RandTimer.Running,"off") start(RandTimer); end end end % Figure close request function function CloseRequest(~,~) % Stop timer, then delete timer and figure stop(RandTimer); delete(RandTimer); delete(uif); end end
Responsiveness is improved for panning, rotating, and zooming into a region of
interest within a plot. To observe the improvement, the plot must be created in an app
or in a figure created with the uifigure function. The improvement is most noticeable for plots with
large numbers of points, or those that involve complex effects such as lighting,
transparency, or texture maps. Systems equipped with modern GPUs are more likely to show
the improvement.
For example, create a 3-D scatter plot with 200,000 points. If you run this code on a Windows 10, Intel Xeon CPU W-2133 @ 3.60 GHz test system with an NVIDIA Quadro P620 GPU, and then drag to rotate the plot, the rotation is smoother and responds more quickly to the drag gesture than in the previous release.
z = linspace(0,4*pi,200000);
x = 2*cos(z) + rand(1,200000);
y = 2*sin(z) + rand(1,200000);
f = uifigure; a = axes(f);
scatter3(a,x,y,z,"filled")
Responsiveness is improved for panning, rotating, and zooming into a region of
interest within a UIAxes or Axes object in MATLAB
Online that contains a chart created with yyaxis and a legend. For such charts, updates are faster, and
interactions are smoother in R2022a than in the previous release.
For example, create a UIAxes object with two
y-axes and a legend. If you run this code on a Windows 10, Intel
Xeon CPU E5-1650 v4 @ 3.60 GHz test system, when you drag the cursor to pan the
view of a UIAxes object, the axes pan faster and track the cursor more
closely in R2022a than in R2021b.
f = uifigure;
a = uiaxes(f);
plot(a,1:100,rand(1,100));
yyaxis(a,"right");
plot(a,1:100,linspace(1,10,100));
legend(a);
Animations show improved performance in apps when multiple figures are open. To
observe the improvement, all figures must be created with the uifigure function.
For example, this code opens 10 empty figures and an additional figure containing a plot. The plot displays one marker that traces the path of a line at every iteration of a loop. The loop is about 6x faster than in the previous release.
function movingmarker % Open 10 empty figures for n = 1:10 uifigure("Position",[10+n*3 10+n*3 200 200]); end % Create a figure and a plot with one marker uif = uifigure; x = linspace(0,10,200); y = sin(x); ax = axes(uif); p = plot(ax,x,y,"-o","MarkerIndices",1); % Move the marker along the sine wave tic for idx = 2:200 p.MarkerIndices = idx; drawnow end toc end
The approximate execution times for the loop are:
R2021b: 32.6 s
R2022a: 5.4 s
The code was timed on a Windows 10, Intel
Xeon CPU W-2133 @ 3.60 GHz test system by calling the
movingmarker function.
Software Development Tools
External Language Interfaces
Environment
In the Editor, you now can select a rectangular area in your code (also known as column selection or block edit) by pressing the Alt key while making a selection with the mouse. On macOS systems, use the Option key instead. Selecting and editing a rectangular area of code is useful if you want to copy or delete several columns of data, or if you want to edit multiple lines at one time.
For example, select the second column of data in A.
Type 0 to set all the selected values to
0.
To zoom in or out in the Editor, go to the View tab, and in the
Zoom section, select the 
Zoom In or 
Zoom Out button. As you zoom, MATLAB displays the current scale in the bottom-right corner of the Editor. You
also can hold the Ctrl key and move the scroll wheel, or press
Ctrl+Plus and Ctrl+Minus. On macOS systems, use the Command key and move the scroll wheel,
or press Command+Shift+Plus and
Command+Shift+Minus.
To return to the default scale, in the View tab
Zoom section, select 
Reset Zoom. You also can press Ctrl+Alt+0
(Command+Alt+0 on macOS).
Starting in R2021b, when you write commands in the Editor, MATLAB automatically displays contextual hints for arguments, property values, and alternative syntaxes. In previous releases, MATLAB only completes names in the Editor after a Tab key press.
For example, if you want to use the size function, MATLAB automatically displays the syntax information to help you write the
command as you type.
MATLAB also automatically suggests and completes the names of functions, models, MATLAB objects, files, folders, variables, structures, graphics properties, parameters, and options.
You can disable automatic completions in the Editor and Live Editor by having
MATLAB suggest and complete names only after you press the Tab
key. To do so, on the View tab, in the Display
section, click the 
Automatic Completions button off. You also can go to the
Home tab, and in the Environment section,
click 
Preferences. Then, select Editor/Debugger > Automatic Completions and in the Suggestions and completions section,
select Show on tab.
For more information, see Check Syntax as You Type.
When debugging code in the Editor, you now can diagnose problems using inline
debugging controls. For example, to run to a specific line of code and then pause, click
the 
button to the left of the line.
To step into a file, click the 
button directly to the left of the function you want
to step into. After stepping in, click the 
button at the top of the file to run the rest of the
called function, leave the called function, and then pause.
By default, the button only appears for user-defined functions and
scripts. To show the button for MathWorks functions as well, on the Home tab, in the
Environment section, click
Preferences. Then, select MATLAB > Editor/Debugger, and in the Debugging in the Live Editor section,
clear the Only show Step in button for user-defined functions
option.
When you step into a called function or file, the Editor displays an improved breadcrumb-style list of the functions MATLAB executed before pausing at the current line (also called the function call stack). The function call stack is shown at the top of the file and displays the functions in order, starting on the left with the first called script or function, and ending on the right with the current script or function in which MATLAB is paused.
For more information, see Debug MATLAB Code Files.
MATLAB now automatically completes parentheses and quotes when you enter code in the Editor. For example, if you type an open parenthesis in the Editor, MATLAB automatically adds the closing parenthesis. MATLAB also automatically completes comments, character vectors, strings, and parentheses split across two lines.
You also can have MATLAB automatically complete block endings. To do so, on the
Home tab, in the Environment section,
click
Preferences. Select Editor/Debugger > Automatic Completions and in the Autocoding options section, select one or
more of the Autocomplete block endings options.
To undo an automatic code completion, press Ctrl+Z or the Undo button. To disable automatic code completions, in the Editor/Debugger > Automatic Completions preferences, clear one or more of the options in the Autocoding options section.
Starting in R2021b, sections in the Editor have an improved appearance. To create a new section, go to the Editor tab and in the Section section, click the Section Break button. The new section is highlighted with a blue border, indicating that it is selected.
To maximize the space available for editing code in the Editor, you can hide the Run to Here and Code Folding margins. This minimizes the gray area to the left of your code. To hide the two margins, right-click the gray area to the left of your code and clear the Show Run to Here Margin and Show Code Folding Margin options.
As part of this change, the options for changing the appearance of code sections in the Editor have been removed. These options were previously available in the MATLAB > Colors > Programming Tools preferences, in the Section display options section.
For more information about sections in the Editor, see Create and Run Sections in Code.
Export animations to movies or animated GIFs using the new 
Export Animation button in the Live Editor animation
playback controls. The Export Animation button is not supported for animations generated
by the movie function.
For example, this code animates a line growing as it accumulates 2000 data points in
the Live Editor. When the animation is done playing, playback controls, including the
new Export Animation button, display within the figure
window.
h = animatedline;
axis([0 4*pi -1 1])
x = linspace(0,4*pi,2000);
for k = 1:length(x)
y = sin(x(k));
addpoints(h,x(k),y);
drawnow
end
For more information about creating animations, see Animation Techniques.
In R2021b, the comparison tool uses MATLAB Editor syntax highlighting. Text changes and merge choices are now easier
to understand. Changes are highlighted with strong colors. Modified lines are
highlighted and flagged with the comparison icons 
, 
, or 
. Merging line by line is straightforward, and merge
choices are flagged with the merge content icon 
.
Starting in R2021b, you no longer can save the comparison report as HTML or specify whether to show only the differences or the entire files.
The Increment Value and Run Section tool previously available in the Editor has been removed.
To increment a numeric value within a section, use controls in the Live Editor. For example, this code calculates the factorial of the variable x.
x = 5; y = factorial(x)
y = 120
5 with a numeric slider. By default, MATLAB reruns the current section when the value of the slider
changes.
For more information, see Add Interactive Controls to a Live Script.
Language and Programming
Data Analysis
Data Import and Export
Mathematics
Graphics
Create plots by passing a table directly to any of these functions: scatter, scatter3, bubblechart, bubblechart3, swarmchart, swarmchart3, polarscatter, and polarbubblechart. When you specify your data as a table, the axis labels
and the legend (if present) are automatically labeled using the table variable
names.
The objects returned by these functions have new properties to support tables.
| Property | Description |
|---|---|
| Table containing the data to plot |
| Table variables containing the x, y, and z values for Cartesian plots |
| Table variables containing the angle and radius values for polar plots |
| Table variable containing the marker size data |
| Table variable containing the marker color data |
| Table variable containing the marker transparency data |
For example, create a table with the variables "Trials" and
"Response". Pass the table to the scatter
function as the first argument, and indicate the variables you want to plot by name.
Trials = randi(10,50,1); Response = rand(50,1); t = table(Trials,Response); scatter(t,"Trials","Response")
Now, you can remove tick marks and customize tick label colors independently of other elements in the axes.
Removing Tick Marks — Remove all the tick marks from an axes, polar axes, or geographic axes object by setting the
TickDirproperty to'none'. To remove the tick marks from a specific axis, for example the x-axis, set theTickDirectionproperty of the ruler to'none'.Customizing Tick Label Colors — Customize the color of the tick labels on an axis by setting the
TickLabelColorproperty of the corresponding ruler object. You can customize tick label colors for any axes, polar axes, or geographic axes.
For example, create a bar chart, and then get the current axes. Remove the x-axis tick marks and change the color of the x-axis tick labels to red.
bar([2017 2018 2019 2020],1:4) ax = gca; ax.XAxis.TickDirection = 'none'; ax.XAxis.TickLabelColor = 'r';
Easily add additional visualizations to plots generated using the Create Plot Live Task. To add a new plot, click the Add tab at the bottom of the Live Task Panel and select the visualization and data. This Live Task combines the plot using the hold function.
The Create Plot Live Task now
supports multiple configurations of charting functions with multiple input syntaxes,
including surf and mesh. Use the
Configurations drop-down menu to select the desired
configuration.
App Building
When debugging code in App Designer, you now can diagnose problems using debugging controls in Code View. You can use the controls in the Run section of the Editor tab to run to the next breakpoint, run the next line of code, or step into or out of a function.
You can also debug your app code using inline debugging controls. For example, to run
to a specific line of code and then pause, click the button to the left of the line. To step into a
function, click the button directly to the left of the function you want
to step into. After stepping in, click the button at the top of the file to run the rest of the
called function, leave the called function, and then pause.
When you step into a called function or file, App Designer displays a breadcrumb-style list of the functions MATLAB executed before pausing at the current line (also called the function call stack). The function call stack is shown at the top of the file and displays the functions in order, starting on the left with the first called script or function, and ending on the right with the current script or function in which MATLAB is paused.
Many of the tools and shortcuts for navigating and organizing code that are available in the Live Editor can now be used in App Designer Code View. This table lists the functionality that is new to App Designer.
| Functionality | Menu Item | Keyboard Shortcut |
|---|---|---|
| Wrap comment | Right-click the comment and select Wrap
Comments, or in the Editor tab,
in the Code section, click the | Ctrl+J |
| Navigate code using bookmarks | In the Editor tab, in the Navigate section, click Bookmark. Then, select Bookmark to set or clear a bookmark on the current line, or select Previous or Next to navigate between the existing bookmarks.
| Set or clear bookmark: Ctrl+F2 |
| Move to previous bookmark: Shift+F2 | ||
| Move to next bookmark F2 | ||
| Print app code | In the Editor tab, in the File section, click Print. You can print the entire document or the current selection.
| Ctrl+P |
| Fold and expand code | In the View tab, click the buttons in the Code Folding section.
| Expand current fold: Ctrl+Shift+Period (.) |
| Collapse current fold: Ctrl+Period (.) | ||
| Expand all folds: Ctrl+Shift+Comma (,) | ||
| Collapse all folds: Ctrl+Comma (,) | ||
| Toggle display preferences | In the View tab, in the Display section, toggle line highlighting and line numbers.
| N/A |
| Duplicate line | Right-click a line and select Duplicate Line(s). | Ctrl+Shift+C |
| Insert section break | Right-click a line and select Section Break. | Ctrl+Alt+Enter, or type
%% |
| Convert text to uppercase or lowercase | Highlight the text, right-click it, and select Change Case. | Ctrl+Shift+A |
| Variable rename | When you rename a variable, App Designer gives you the option to automatically update all other instances of the variable in your code.
| Shift+Enter |
Code folding in App Designer persists even after you close and then reopen the file. In R2021a and earlier releases, when opening a file, App Designer expands all the code.
In Design View, use the zoom controls in the lower right corner
of the App Designer canvas, indicated by the 
button, to modify the canvas zoom level.
To automatically zoom to fit the entire app in the view, press Space.
Alternatively, click 
Fit to View in the Zoom section of the
View tab, or right-click on the canvas and select Zoom > Fit to View.
You can now provide help for apps that you create. Help text appears in the Command
Window when an app user calls the help function and specifies the
name of the app.
To add help text, in the Editor tab in Code
View, click 
App Help Text. Use the App Help
Text dialog box to specify the app summary and detailed explanation.
In addition, when an app user views the documentation for your app (for example, by
calling the doc function or by clicking the documentation link in
the help text for the app), the documentation page now displays additional
information:
The top of the page displays the app summary and detailed explanation.
The Methods Summary section displays the public functions. For each function, it also displays any comment that is inserted after the function definition statement.
When you apply Smart Indent to code in App Designer, the indentation change applies only to the current line. In R2021a and earlier releases, the Smart Indent option applied to the entire document.
To apply Smart Indent to the entire document, in Code View,
first select all the code (for example, by pressing Ctrl+A). Then,
apply Smart Indent by clicking the 
button in the Editor tab, or
pressing Ctrl+I.
Performance
In figures created with the uifigure function and in MATLAB
Online, interactions with scatter plots of large data sets have the following
performance improvements:
Data tip markers track the mouse motion more closely.
3-D scatter plots are more responsive to rotation gestures.
This improvement can be seen when the axes are created with either the
axes or uiaxes function.
For example, on a Windows 10, Intel Xeon CPU E5-1650 v4 @ 3.60 GHz system, when you hover the cursor over the following sphere, the cursor changes to a crosshair more quickly, and the data tip markers track the cursor more closely. When you click and drag the cursor within the axes, the sphere rotates more quickly and tracks the cursor more closely.
f = uifigure;
ax = axes(f);
[X,Y,Z] = sphere(900);
scatter3(ax,X(:),Y(:),Z(:),[],Z(:),".")
Saving apps in App Designer after you edit an app function or property is faster in R2021b than in R2021a. The more lines of code in the app file, the greater the performance improvement becomes.
For example, on a Windows 10, Intel
Xeon W-2133 CPU @ 3.60 GHz test system, in an app containing 10,000 lines of
code, if you click Property
to create a new property and then click
Save
to save the app, you can run the updated app sooner
in R2021b than in R2021a.
The approximate save times are:
R2021a: 20 s
R2021b: 1.5 s
When you use the Comparison Tool to compare and merge changes between app code in MLAPP files, these operations have improved performance:
Loading the files into the Comparison Tool
Saving the files after merging changes
For example, if you load two apps with 5000 lines of code into the Comparison Tool by
clicking Compare
in the App Designer toolstrip, you can compare and
merge the files sooner in R2021b than in R2021a.
The approximate loading times are:
R2021a: 13 s
R2021b: 8 s
Also, if you use the Comparison Tool to merge changes between two apps with 5000 lines
of code (for example, by clicking Merge Mode
, merging the changes, and then clicking
Save Result
), you can compare the saved files sooner in R2021b
than in R2021a.
The approximate save times are:
R2021a: 24 s
R2021b: 8 s
Both of these operations were timed on a Windows 10, Intel Xeon W-2133 CPU @ 3.60 GHz test system.
The performance when you resize apps containing a grid layout manager created using
the uigridlayout function has improved when both of these conditions hold:
The grid layout manager contains a component with a
WordWrapvalue of'on'.The row and column containing the component with word wrap have a
RowHeightof'fit'and aColumnWidththat is resizable, such as'1x'.
For example, on a Windows 10, Intel Xeon CPU E5-1650 v4 @ 3.60 GHz test system, if you create 100 labels with wrapping text in a grid layout manager with fit height rows and resizable columns, and then resize the figure window by dragging the corner of the figure, the label text adjusts to fit the size of the figure almost immediately. In R2021a, there is a delay of about 2 seconds before the text adjusts.
f = uifigure;
g = uigridlayout(f);
g.ColumnWidth = {'1x'};
numrows = 100;
g.RowHeight = repmat({'fit'},numrows,1);
for row = 1:numrows
c = uilabel(g);
c.Text = ['Lorem ipsum dolor sit amet, consectetur adipiscing elit,' ...
' sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.'];
c.WordWrap = 'on';
end