### Navigation

- index
- modules |
- modules |
- next |
- previous |
- SciPy v0.12 Reference Guide (DRAFT) »
- Input and output (`scipy.io`) »

# scipy.io.savemat

`scipy.io.``savemat`(file_name, mdict, appendmat=True, format='5', long_field_names=False, do_compression=False, oned_as=None)

  Save a dictionary of names and arrays into a MATLAB-style .mat file.

  This saves the array objects in the given dictionary to a MATLAB- style .mat file.

  Parameters : | file_name : str or file-like object Name of the .mat file (.mat extension not needed if `appendmat == True`). Can also pass open file_like object. mdict : dict Dictionary from which to save matfile variables. appendmat : bool, optional True (the default) to append the .mat extension to the end of the given filename, if not already present. format : {‘5’, ‘4’}, string, optional ‘5’ (the default) for MATLAB 5 and up (to 7.2), ‘4’ for MATLAB 4 .mat files long_field_names : bool, optional False (the default) - maximum field name length in a structure is 31 characters which is the documented maximum length. True - maximum field name length in a structure is 63 characters which works for MATLAB 7.6+ do_compression : bool, optional Whether or not to compress matrices on write. Default is False. oned_as : {‘column’, ‘row’, None}, optional If ‘column’, write 1-D numpy arrays as column vectors. If ‘row’, write 1-D numpy arrays as row vectors. If None (the default), the behavior depends on the value of format (see Notes below).

  See also

  `mio4.MatFile4Writer`, `mio5.MatFile5Writer`

  Notes

  If `format == '4'`, mio4.MatFile4Writer is called, which sets oned_as to ‘row’ if it had been None. If `format == '5'`, mio5.MatFile5Writer is called, which sets oned_as to ‘column’ if it had been None, but first it executes:

  `warnings.warn("Using oned_as default value ('column')" +`
    `" This will change to 'row' in future versions",` `FutureWarning, stacklevel=2)`

  without being more specific as to precisely when the change will take place.

### Navigation

- index
- modules |
- modules |
- next |
- previous |
- SciPy v0.12 Reference Guide (DRAFT) »
- Input and output (`scipy.io`) »