readmatrix

Create matrix array from file.

📝 Syntax

• M = readmatrix(filename)

• M = readmatrix(filename, opts)

• M = readmatrix(filename, opts, 'OutputType', type)

📥 Input argument

• filename - a string: an existing filename source.

• opts - DelimitedTextImportOptions object

• type - a string: 'double', 'single', 'char', 'string', 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'uint64'.

📤 Output argument

• M - a matrix.

📄 Description

M = readmatrix(filename) creates a matrix array by importing column-oriented data from a text or spreadsheet file.

M = readmatrix(filename, opts) creates a matrix array using the settings defined in the opts import options object. The importoptions object allows you to customize howreadmatrix interprets the file, offering greater control, improved performance, and the ability to reuse the configuration compared to the default syntax.

💡 Examples

filename = [tempdir,'readmatrix_1.csv']; Names = {'John'; 'Alice'; 'Bob'; 'Diana'}; Age = [28; 34; 22; 30]; Height = [175; 160; 180; 165]; Weight = [70; 55; 80; 60]; T = table(Names, Age, Height, Weight); writetable(T, filename) M = readmatrix(filename)

filename = [tempdir,'readmatrix_2.csv']; M = magic(6); writematrix(M, filename) options = detectImportOptions(filename) options.DataLines = [2 4]; M2 = readmatrix(filename, options, 'OutputType', 'int64') M3 = readmatrix(filename, options, 'OutputType', 'char')

🔗 See also

writematrix, detectImportOptions, writetable, readtable, fileread.

🕔 History

Version	📄 Description
1.10.0	initial version