API Reference for Enthought Tool Suite 3.0.1

Function summary

• loadtxt(fname, dtype = float, comments = '#', delimiter = None, converters = None, skiprows = 0, usecols = None, unpack = False)

Functions

• loadtxt(fname, dtype = float, comments = '#', delimiter = None, converters = None, skiprows = 0, usecols = None, unpack = False)

  Load ASCII data from fname into an array and return the array.

  The data must be regular, same number of values in every row

  Parameters

  fname : filename or a file handle.

  Support for gzipped files is automatic, if the filename ends in .gz

  dtype : data-type

  Data type of the resulting array. If this is a record data-type, the resulting array will be 1-d and each row will be interpreted as an element of the array. The number of columns used must match the number of fields in the data-type in this case.

  comments : str

  The character used to indicate the start of a comment in the file.

  delimiter : str

  A string-like character used to separate values in the file. If delimiter is unspecified or none, any whitespace string is a separator.

  converters : {}

  A dictionary mapping column number to a function that will convert that column to a float. Eg, if column 0 is a date string: converters={0:datestr2num}. Converters can also be used to provide a default value for missing data: converters={3:lambda s: float(s or 0)}.

  skiprows : int

  The number of rows from the top to skip.

  usecols : sequence

  A sequence of integer column indexes to extract where 0 is the first column, eg. usecols=(1,4,5) will extract the 2nd, 5th and 6th columns.

  unpack : bool

  If True, will transpose the matrix allowing you to unpack into named arguments on the left hand side.

  Examples

  >>> X = loadtxt('test.dat')  # data in two columns
  >>> x,y,z = load('somefile.dat', usecols=(3,5,7), unpack=True)
  >>> r = np.loadtxt('record.dat', dtype={'names':('gender','age','weight'),
            'formats': ('S1','i4', 'f4')})
  

  SeeAlso: scipy.io.loadmat to read and write matfiles.

Imported Names

© Copyright 2002-2008 Enthought, Inc.