matlab之“audioread”函数帮助文档翻译
课 程 设 计 (1)
原文
audioread
Read audio file
Syntax
[y,Fs] = audioread(filename)
[y,Fs] = audioread(filename,samples)
[y,Fs] = audioread(___,dataType)
Description
Examples
Read Complete Audio File
Create a WAVE file from the example file
handel.mat
, and read the file back into MATLAB®.Create a WAVE (
.wav
) file in the current folder.load handel.mat filename = 'handel.wav';
audiowrite(filename,y,Fs);
clear y FsRead the data back into MATLAB using
audioread
.[y,Fs] = audioread('handel.wav');Play the audio.
sound(y,Fs);Read Portion of Audio File
Create a FLAC file from the example file
handel.mat
, and then read only the first 2 seconds.Create a FLAC (
.flac
) file in the current folder.load handel.mat filename = 'handel.flac';
audiowrite(filename,y,Fs);Read only the first 2 seconds.
samples = [1,2*Fs];
clear y Fs
[y,Fs] = audioread(filename,samples);Play the samples.
sound(y,Fs);Return Audio in Native Integer Format
Create a FLAC file and read the first 2 seconds according to the previous Example. Then, view the data type of the sampled data
y
.whos yName Size Bytes Class Attributes y 16384x1 131072 doubleThe data type of
y
isdouble
.Request audio data in the native format of the file, and then view the data type of the sampled data
y
.[y,Fs] = audioread(filename,'native');
whos yName Size Bytes Class Attributes y 16384x1 32768 int16The data type of
y
is nowint16
.Input Arguments
filename
— Name of file to readstringName of file to read, specified as a string that includes the file extension. If a path is specified, it can be absolute, relative or partial.
Example:
'myFile.mp3'
Example:
'../myFile.mp3'
Example:
'C:\temp\myFile.mp3'
audioread
supports the following file formats.
Platform Support File Format All platforms WAVE ( .wav
)OGG ( .ogg
)FLAC ( .flac
)AU ( .au
)AIFF ( .aiff
,.aif
)AIFC ( .aifc
)Windows® 7 (or later), Macintosh, and Linux® MP3 ( .mp3
)MPEG-4 AAC ( .m4a
,.mp4
)On Windows platforms prior to Windows 7,
audioread
does not read WAVE files with MP3 encoded data.On Windows 7 (or later) platforms,
audioread
might also read any files supported by Windows Media® Foundation.On Linux platforms,
audioread
might also read any files supported by GStreamer.
audioread
can extract audio from MPEG-4 (.mp4
,.m4v
) video files on Windows 7 or later, Macintosh, and Linux, and from Windows Media Video (.wmv
) and AVI (.avi
) files on Windows 7 (or later) and Linux platforms.
samples
— Audio samples to read[1,inf]
(default) | two-element vector of positive scalar integersAudio samples to read, specified as a two-element vector of the form
[start,finish]
, wherestart
andfinish
are the first and last samples to read, and are positive scalar integers.
start
must be less than or equal tofinish
.
start
andfinish
must be less than the number of audio samples in the file,You can use
inf
to indicate the last sample in the file.
Note: When reading a portion of some MP3 files on Windows 7 platforms,
audioread
might read a shifted range of samples. This is due to a limitation in the underlying Windows Media Foundation framework.When reading a portion of MP3 and M4A files on Linux platforms,
audioread
might read a shifted range of samples. This is due to a limitation in the underlying GStreamer framework.Example:
[1,100]
Data Types:
double
dataType
— Data format of audio data,y
'double'
(default) |'native'
Data format of audio data,
y
, specified as one of the following strings:
'double'
Double-precision normalized samples. 'native'
Samples in the native format found in the file. For compressed audio formats, such as MP3 and MPEG-4 AAC that do not store data in integer form,
'native'
defaults to'single'
.Output Arguments
y
— Audio datamatrixAudio data in the file, returned as an
m
-by-n
matrix, wherem
is the number of audio samples read andn
is the number of audio channels in the file.
If you do not specify
dataType
, ordataType
is'double'
, theny
is of typedouble
, and matrix elements are normalized values between −1.0 and 1.0.If
dataType
is'native'
, theny
can be one of several MATLAB data types, depending on the file format and theBitsPerSample
value of the input file. Callaudioinfo
to determine theBitsPerSample
value of the file.
File Format BitsPerSample Data Type of y Data Range of y WAVE ( .wav
)8 uint8
0 ≤ y
≤ 25516 int16
-32768 ≤ y
≤ +3276724 int32
-2^32 ≤ y
≤ 2^32–132 int32
-2^32 ≤ y
≤ 2^32–132 single
-1.0 ≤ y
≤ +1.064 double
-1.0 ≤ y
≤ +1.0FLAC ( .flac
)8 uint8
0 ≤ y
≤ 25516 int16
-32768 ≤ y
≤ +3276724 int32
-2^32 ≤ y
≤ 2^32–1MP3 ( .mp3
), MPEG-4 AAC (.m4a
,.mp4
), OGG (.ogg
), and certain compressed WAVE filesN/A single
-1.0 ≤ y
≤ +1.0
Note: Where
y
issingle
ordouble
and theBitsPerSample
is 32 or 64, values iny
might exceed −1.0 or +1.0.
Fs
— Sample ratepositive scalarSample rate, in hertz, of audio data
y
, returned as a positive scalar.Limitations
For MP3, MPEG-4 AAC, and AVI audio files on Windows 7 or later and Linux platforms,
audioread
might read fewer samples than expected. On Windows 7 platforms, this is due to a limitation in the underlying Media Foundation framework. On Linux platforms, this is due to a limitation in the underlying GStreamer framework. If you require sample-accurate reading, work with WAV or FLAC files.On Linux platforms,
audioread
reads MPEG-4 AAC files that contain single-channel data as stereo data.
翻译
调用结构&描述
[y, Fs] =audioread(filename)
从以“filename”为文件名的文件中读取数据,并返回抽样数据y和此数据的抽样率Fs 。
[y, Fs] =audioread(filename, samples)
以选定范围从文件中读取音频样本,其中 samples 是具有[start, finish]形式的向量。
[y, Fs] =audioread( ____, dataType)
返回数据域中与 dataType 相对应的采样数据,dataType 可选“native(本地类型)”或“double(双精度型)”。
例子
可以自己从本地音乐里面选择音乐来测试。但是建议适当缩减音频长度,不然计算量会比较大,有可能卡死电脑。剪辑音频可以使用“格式工厂”,它也能用来转换文件格式。
输入 1、对于输入文件,表中给的信息已经很详细了,".wav"格式的音频是一定支持的,通用的".mp3"格式在win7以上及Linux系统上都是可以读取的。
2、 对于输入参数 samples ,在第一种调用结构中其实是隐藏了 [1, inf] 的默认samples参数,意思是从文件头读到文件尾。在第二种调用格式里面我们可以指定读取的参数范围。要注意 start, finish 两个参数都是正整数,而且他们的大小不能超出抽样个数。这个很容易理解,超出了源文件的抽样范围就不可能有数据。在使用中,可以用 [start, inf] 表示从 start 读到文件尾。
注意:当在win7平台上读取MP3以及在Linux上读取MP3&M4A格式文件时,可能会出现读取范围转移的现象,这是由于底层Windows Media Foundation框架的局限性造成的。
3、dataType有两种取值,native 或 double 。默认情况下,native 为单精度类型 single 。
输出
y 为音频数据,是一个mxn 的矩阵,m是读取文件的抽样个数,n是读取文件的音频信道个数。
· 在未明确 dataType 和 dataType 取 double 时,y 的类型也是 double。y 的元素为值介于-1.0和1.0之间的规范化值。
· 如果 dataType 取 native,y 可以为matlab所允许的几种数据类型之一。至于为哪一种类型取决于输入文件的类型,这种对应关系在上面给出的表中。
注意:当 y 为单精度或双精度数, 且 BitPerSample 为32或64时,y 的值有可能超出 -1.0~1.0。
局限
· 对于 MP3, MPEG-4 AAC, AVI音频文件,在win7及更高版本和Linux平台上,有可能会出现抽样个数比预期要少的现象。
· 在Linux上读取MPEG-4 AAC文件时,即使是单声道数据文件,也会当成立体声文件来读。
matlab之“audioread”函数帮助文档翻译的更多相关文章
- matlab中patch函数的用法
http://blog.sina.com.cn/s/blog_707b64550100z1nz.html matlab中patch函数的用法——emily (2011-11-18 17:20:33) ...
- Matlab基本函数-conj函数
Matlab基本函数-conj函数 1.conj函数:用于计算复数的共轭值 2.用法说明:y=conj(x)函数计算复数x的共轭值.输出结果y的维数跟输入x的维数一致,返回值为:real(y)-i*i ...
- 【原创】Matlab.NET混合编程技巧之找出Matlab内置函数
本博客所有文章分类的总目录:[总目录]本博客博文总目录-实时更新 Matlab和C#混合编程文章目录 :[目录]Matlab和C#混合编程文章目录 Matlab与.N ...
- 【原创】Matlab.NET混合编程技巧之直接调用Matlab内置函数
本博客所有文章分类的总目录:[总目录]本博客博文总目录-实时更新 Matlab和C#混合编程文章目录 :[目录]Matlab和C#混合编程文章目录 在我的上一篇文章[ ...
- matlab画图形函数 semilogx
matlab画图形函数 semilogx loglog 主要是学习semilogx函数,其中常用的是semilogy函数,即后标为x的是在x轴取对数,为y的是y轴坐标取对数.loglog是x y轴都取 ...
- 【matlab】设定函数默认参数
C++/java/python系列的语言,函数可以有默认值,通常类似如下的形式: funtion_name (param1, param2=default_value, ...) 到了matlab下发 ...
- matlab中subplot函数的功能
转载自http://wenku.baidu.com/link?url=UkbSbQd3cxpT7sFrDw7_BO8zJDCUvPKrmsrbITk-7n7fP8g0Vhvq3QTC0DrwwrXfa ...
- Matlab:max函数
Matlab中max函数在矩阵中求函数大小的实例如下: C = max(A)返回一个数组各不同维中的最大元素.如果A是一个向量,max(A)返回A中的最大元素.如果A是一个矩阵,max(A)将A的每一 ...
- 【原创】Matlab中plot函数全功能解析
[原创]Matlab中plot函数全功能解析 该帖由Matlab技术论(http://www.matlabsky.com)坛原创,更多精彩内容参见http://www.matlabsky.com 功能 ...
随机推荐
- ALV添加文字输入框
一.业务场景 在合同打印中,需要临时添加其他约定事项,在打印程序的ALV中添加其他事项字段,点击之后弹出文字输入窗口,点击确定,文字内容存表,并在ALV中展示,点击打印后,文字内容加载到smartfo ...
- sublime中安装package control总是失败
今天下载了个sublime编辑器,要运行vue文件,想让vue也能高亮显示,在网上搜了一下如何安装.但总是提示控制器没有安装Package Control:There are no packages ...
- 做直线不要使用hr
需要横线.竖线时不要使用hr标签来做,容易出问题,可以使用高度或宽度为1px并加上背景色的div.p代替.
- MySQL常用存储引擎
MySQL存储引擎主要有两大类: 1. 事务安全表:InnoDB.BDB. 2. 非事务安全表:MyISAM.MEMORY.MERGE.EXAMPLE.NDB Cluster.ARCHIVE.CSV. ...
- JAVA 的 Date、Calendar的常用用法
一.Date与String的互转用法,这里需要用到SimpleDateFormat Date date = new Date(); //设置格式 SimpleDateFor ...
- Java基础笔记11
异常: 即java程序在运行时出现的意外情况. java如何处理异常. try{ //可能发生异常的地方 }catch(异常类型 对象){ //异常处理处 }catch(异常类型 对象){ }.. ...
- .3-Vue源码之数据劫持(1)
写了一半关机了,又得重新写,好气. 上一节讲到initData函数,其中包含格式化.代理.监听. // Line-3011 function initData(vm) { var data = vm. ...
- trait与policy模板技术
trait与policy模板技术 我们知道,类有属性(即数据)和操作两个方面.同样模板也有自己的属性(特别是模板参数类型的一些具体特征,即trait)和算法策略(policy,即模板内部的操作逻辑). ...
- Xilinx ISE14.1用Verilog语言实现一个半加器并测试
<一>建立一个工程 注:Xilinx ISE的安装在此不再过多说明,网上有参考资料 1.打开软件进入如下界面 2.创建工程 File-->New Project 3.创建文件(我取名 ...
- Linux必知必会的目录与启动过程
第1章 /etc/目录 1.1 /etc/sysconfig/network-scripts/ifcfg-eth0 linux第一块网卡的配置文件 [root@znix ~]# cat /etc/sy ...