dlmread

(No recomendado) Leer un archivo ASCII delimitado de datos numéricos en una matriz

dlmread no se recomienda. En su lugar, utilice readmatrix. Para obtener más información, consulte Consideraciones sobre compatibilidad.

Sintaxis

M = dlmread(filename)

M = dlmread(filename,delimiter)

M = dlmread(filename,delimiter,R1,C1)

M = dlmread(filename,delimiter,[R1 C1 R2 C2])

Descripción

M = dlmread(filename) lee un archivo ASCII delimitado de datos numéricos en una matriz M. La función dlmread detecta el delimitador del archivo y trata los espacios en blanco repetidos como un delimitador único.

M = dlmread(filename,delimiter) lee los datos del archivo usando el delimitador especificado y trata los caracteres delimitadores repetidos como delimitadores separados.

M = dlmread(filename,delimiter,R1,C1) empieza a leer en el desplazamiento de fila R1 y el desplazamiento de columna C1. Por ejemplo, los desplazamientos R1=0 y C1=0 especifican el primer valor del archivo.

Para especificar los desplazamientos de fila y columna sin especificar un delimitador, utilice un carácter vacío como marcador de posición, por ejemplo, M = dlmread(filename,'',2,1).

M = dlmread(filename,delimiter,[R1 C1 R2 C2]) lee solo el rango acotado por los desplazamientos de fila R1 y R2 y por los desplazamientos de columna C1 y C2. Otra forma de definir el rango es usando notación de hojas de cálculo, como 'A1..B7' en lugar de [0 0 6 1].

Ejemplos

Leer todo el archivo delimitado

Lea el archivo de muestra, count.dat.

M = dlmread('count.dat')

M = 24×3

    11    11     9
     7    13    11
    14    17    20
    11    13     9
    43    51    69
    38    46    76
    61   132   186
    75   135   180
    38    88   115
    28    36    55
      ⋮

dlmread detecta el delimitador del archivo y devuelve una matriz.

Leer un archivo que contiene campos delimitados vacíos

Escriba dos matrices en un archivo y, después, lea todo el archivo con dlmread.

Exporte una matriz a un archivo llamado myfile.txt. A continuación, añada una matriz adicional al archivo que esté desplazada una fila por debajo de la primera.

X = magic(3);
dlmwrite('myfile.txt',[X*5 X/5],' ')
dlmwrite('myfile.txt',X,'-append', ...
   'roffset',1,'delimiter',' ')

Vea el contenido del archivo.

type myfile.txt

40 5 30 1.6 0.2 1.2
15 25 35 0.6 1 1.4
20 45 10 0.8 1.8 0.4
  
8 1 6
3 5 7
4 9 2

Lea todo el archivo con dlmread.

M = dlmread('myfile.txt')

M = 6×6

   40.0000    5.0000   30.0000    1.6000    0.2000    1.2000
   15.0000   25.0000   35.0000    0.6000    1.0000    1.4000
   20.0000   45.0000   10.0000    0.8000    1.8000    0.4000
    8.0000    1.0000    6.0000         0         0         0
    3.0000    5.0000    7.0000         0         0         0
    4.0000    9.0000    2.0000         0         0         0

Cuando dlmread importa un archivo que contiene datos no rectangulares, rellena los campos vacíos con ceros.

Leer un archivo delimitado comenzando en un desplazamiento de fila y columna específico

Cree un archivo llamado dlmlist.txt que contenga encabezados de columna y valores delimitados por espacios.

test max min direction
10 27.7 12.4 12
11 26.9 13.5 18
12 27.4 16.9 31
13 25.1 12.7 29  

Lea los valores numéricos del archivo. Especifique un delimitador de espacio, un desplazamiento de fila de 1 y un desplazamiento de columna de 0.

filename = 'dlmlist.txt';
M = dlmread(filename,' ',1,0)

M =

   10.0000   27.7000   12.4000   12.0000
   11.0000   26.9000   13.5000   18.0000
   12.0000   27.4000   16.9000   31.0000
   13.0000   25.1000   12.7000   29.0000

Leer un rango específico de un archivo delimitado

Cree un archivo llamado dlmlist.txt que contenga encabezados de columna y valores delimitados por espacios.

test max min direction
10 27.7 12.4 12
11 26.9 13.5 18
12 27.4 16.9 31
13 25.1 12.7 29  

Lea únicamente las dos últimas filas de datos numéricos del archivo.

M = dlmread('dlmlist.txt',' ',[3 0 4 3])

M =

   12.0000   27.4000   16.9000   31.0000
   13.0000   25.1000   12.7000   29.0000

Argumentos de entrada

filename — Nombre de archivo

vector de caracteres | cadena

Nombre de archivo, especificado como vector de caracteres o cadena.

Ejemplo: 'myFile.dat' o "myFile.dat"

Tipos de datos: char | string

delimiter — Carácter delimitador de campo

vector de caracteres | cadena

Carácter delimitador de campo, especificado como vector de caracteres o cadena. Utilice '\t' para especificar un delimitador de tabulación.

Ejemplo: ',' o ","

Ejemplo: ' ' o " "

Tipos de datos: char | string

R1 — Desplazamiento de la fila inicial

0 (predeterminado) | entero no negativo

Desplazamiento de fila inicial, especificado como entero no negativo. La primera fila tiene un desplazamiento de 0.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

C1 — Desplazamiento de la columna inicial

0 (predeterminado) | entero no negativo

Desplazamiento de la columna inicial, especificado como entero no negativo. La primera columna tiene un desplazamiento de 0.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

R2 — Desplazamiento de la fila final

entero no negativo

Desplazamiento de la fila final, especificado como entero no negativo. La primera fila tiene un desplazamiento de 0.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

C2 — Desplazamiento de la columna final

entero no negativo

Desplazamiento de la columna final, especificado como entero no negativo. La primera columna tiene un desplazamiento de 0.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Sugerencias

• Omita las filas o columnas del encabezado especificando desplazamientos de fila y de columna. Todos los valores del archivo distintos a los encabezados deben ser numéricos.

Algoritmos

dlmread rellena los campos delimitados vacíos con cero. Cuando la función dlmread lee archivos de datos con líneas que terminan con un delimitador no espacial, como un punto y coma, devuelve una matriz, M, que tiene una última columna adicional de ceros.

dlmread importa cualquier número complejo en conjunto a un campo numérico complejo. Esta tabla muestra las formas válidas para un número complejo.

Forma	Ejemplo
±<real>±<imag>i|j	5.7-3.1i
±<imag>i|j	-7j

El espacio blanco integrado en un número complejo no es válido y dlmread lo considera un delimitador de campo.

Historial de versiones

Introducido antes de R2006a

R2019a: dlmread no se recomienda.

dlmread no se recomienda. En su lugar, utilice readmatrix. No se prevé eliminar dlmread.

A partir de la versión R2019a, utilice la función readmatrix para leer una matriz de un archivo delimitado. La función readmatrix tiene estas ventajas frente a la función dlmread:

• Mejor compatibilidad y rendimiento entre plataformas

• Detección automática del formato y de los tipos de los datos

• Capacidad de utilizar opciones de importación para controlar el proceso de importación de datos, incluida la gestión de errores y de datos ausentes

Esta tabla muestra usos típicos de dlmread y cómo actualizar el código para que utilice readmatrix en su lugar.

No recomendado	Recomendado
M = dlmread(filename)	M = readmatrix(filename)

Consulte también

readmatrix | dlmwrite | readtable | textscan | uiimport

Temas

• Importar archivos de texto