#### Previous topic

scipy.io.mmwrite

#### Next topic

scipy.io.FortranFile.close

# scipy.io.FortranFile

class `scipy.io.``FortranFile`(filename, mode='r', header_dtype=<type 'numpy.uint32'>)

  A file object for unformatted sequential files from Fortran code.

  Parameters: | filename : file or str Open file object or filename. mode : {‘r’, ‘w’}, optional Read-write mode, default is ‘r’. header_dtype : dtype, optional Data type of the header. Size and endiness must match the input/output file.

  Notes

  These files are broken up into records of unspecified types. The size of each record is given at the start (although the size of this header is not standard) and the data is written onto disk without any formatting. Fortran compilers supporting the BACKSPACE statement will write a second copy of the size to facilitate backwards seeking.

  This class only supports files written with both sizes for the record. It also does not support the subrecords used in Intel and gfortran compilers for records which are greater than 2GB with a 4-byte header.

  An example of an unformatted sequential file in Fortran would be written as:

      OPEN(1, FILE=myfilename, FORM='unformatted')

      WRITE(1) myvariable

  Since this is a non-standard file format, whose contents depend on the compiler and the endianness of the machine, caution is advised. Files from gfortran 4.8.0 and gfortran 4.1.2 on x86_64 are known to work.

  Consider using Fortran direct-access files or files from the newer Stream I/O, which can be easily read by `numpy.fromfile`.

  Examples

  To create an unformatted sequential Fortran file:

      >>> from scipy.io import FortranFile
      >>> f = FortranFile('test.unf', 'w')
      >>> f.write_record(np.array([1,2,3,4,5],dtype=np.int32))
      >>> f.write_record(np.linspace(0,1,20).reshape((5,-1)))
      >>> f.close()

  To read this file:

      >>> from scipy.io import FortranFile
      >>> f = FortranFile('test.unf', 'r')
      >>> print(f.read_ints(dtype=np.int32))
      [1 2 3 4 5]
      >>> print(f.read_reals(dtype=np.float).reshape((5,-1)))
      [[ 0.          0.05263158  0.10526316  0.15789474]
       [ 0.21052632  0.26315789  0.31578947  0.36842105]
       [ 0.42105263  0.47368421  0.52631579  0.57894737]
       [ 0.63157895  0.68421053  0.73684211  0.78947368]
       [ 0.84210526  0.89473684  0.94736842  1.        ]]
      >>> f.close()

  Methods

  `close`() | Closes the file.
  `read_ints`([dtype]) | Reads a record of a given type from the file, defaulting to an integer type (INTEGER*4 in Fortran) :Parameters: dtype : dtype, optional Data type specifying the size and endiness of the data.
  `read_reals`([dtype]) | Reads a record of a given type from the file, defaulting to a floating point number (real*8 in Fortran) :Parameters: dtype : dtype, optional Data type specifying the size and endiness of the data.
  `read_record`([dtype]) | Reads a record of a given type from the file.
  `write_record`(s) | Write a record (including sizes) to the file.