`readmatrix`

Lê uma matriz numérica de um arquivo de texto ou de planilha.

Categoria: Data Import and Analysis > Data Import and Export

Sintaxe

A = readmatrix(filename)

Lê o arquivo, detectando o delimitador e pulando linhas de cabeçalho em texto.

A = readmatrix(filename, Name, Value)

Define opções como 'NumHeaderLines', 'Delimiter' ou, para planilhas, 'Sheet'.

A = readmatrix(filename, opts)

Usa um objeto de opções de importação.

Descrição

readmatrix é a forma padrão de carregar uma tabela de números. Ela examina o arquivo, descarta um cabeçalho de texto no início e retorna uma matriz double. Campos que não podem ser lidos como número, como células vazias ou a palavra NaN, ficam como NaN.

Quando o arquivo mistura texto e números, use readtable ou readcell para preservar o texto.

Argumentos de entrada

filename: Nome de um arquivo de texto, CSV ou planilha.
'NumHeaderLines': Número de linhas a pular no topo.
'Delimiter': Separador de campos; detectado automaticamente se omitido.
'Sheet': Nome ou número da planilha em um arquivo de planilha.

Argumentos de saída

A: Matriz numérica. Campos vazios ou não numéricos viram NaN.

Exemplo

Cabeçalho e valores ausentes

fid = fopen('h.csv', 'w'); fprintf(fid, 't,v\n1,NaN\n2,5\n,7\n'); fclose(fid);
A = readmatrix('h.csv')
B = readmatrix('h.csv', 'NumHeaderLines', 1);
isequaln(A, B)

Saída

A = 3×2

     1   NaN
     2     5
   NaN     7
ans = logical
   1

Observações

As opções 'Range' e 'OutputType', 'string' não são respeitadas pelo MatLivre: a primeira devolve mais que o bloco pedido e a segunda ainda devolve números.

Veja também

writematrix readtable readcell csvread dlmread