/;ji` vdZdZddlZddlZddlmZmZmZddl m Z ddl m Z eZn #e$reZYnwxYwddd d d d d dddd Ziddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;ddd?dd@d dAd dBd dCd dDd dEddFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWidXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdyZddzd{d|d}Zidd?dd?dd?dd?dd?dd?d d?d"d?d$d?d&dDd(dDd*d?d,dfd.d?d0d?d2d?d~d?d?d?d?dFdhd?d?dxdZdddddZddddZ ejdkrddlmZdezdzZnejdkriddlmZddlmZeddkrdZneddkrdZnke d!eeejdkr&ddlmZedvrdZndezdzZn e dddl"Z"ej#$e"j%Z&ej#'e&eZ(ej)e(Z*n#e e+e,f$r e dZ-e- e dej)e-Z*n#e $rejdkrdZ.nejdkrdZ.nejdkrdZ.nddlmZejdkrVedkrHej#/drdndZ0ej)ej#'e0e.Z*nej)e.Z*YnwxYwYnwxYwej1e*23ddZ4e45dre4e6ddZ4 ddZ7 ddZ8 ddZ9Gdde:Z;ddZddZ?dZ@Gdde:ZAddZBdZCdZDdZEdZFdZGe*jHfdZIdZJdZKdZLGddeMZNGddeNeOZPGddePZQdS)akpython-soundfile is an audio library based on libsndfile, CFFI and NumPy. Sound files can be read or written directly using the functions `read()` and `write()`. To read a sound file in a block-wise fashion, use `blocks()`. Alternatively, sound files can be opened as `SoundFile` objects. For further information, see https://python-soundfile.readthedocs.io/. z0.13.1N)SEEK_SETSEEK_CURSEEK_END) find_library)ffi ) title copyrightsoftwareartistcommentdatealbumlicense tracknumbergenreWAViAIFFiAUiRAWiPAFiSVXiNISTiVOCiIRCAMi W64i MAT4i MAT5i PVFiXIiHTKiSDSiAVRiiiiiii i!i"i#) WAVEXSD2FLACCAFWVEOGGMPC2KRF64MP3PCM_S8PCM_16PCM_24PCM_32PCM_U8FLOATDOUBLEULAWALAW IMA_ADPCMMS_ADPCMGSM610 VOX_ADPCM! NMS_ADPCM_16" NMS_ADPCM_24# NMS_ADPCM_32$G721_320G723_241G723_402DWVW_12@DWVW_16ADWVW_24BDWVW_NCDPCM_8PDPCM_16QVORBIS`OPUSdALAC_16pALAC_20qALAC_24rALAC_32s MPEG_LAYER_I MPEG_LAYER_IIMPEG_LAYER_IIIii i0)FILELITTLEBIGCPUr-)r.r/r0r1r2r3r4r5doublefloatintshort)float64float32int32int16)CONSTANTAVERAGEVARIABLEdarwin)machine libsndfile_z.dylibwin32) architecture64bitzlibsndfile_x64.dll32bitzlibsndfile_x86.dllz%no packaged library for Windows {} {}linux)aarch64 aarch64_bearmv8barmv8lzlibsndfile_arm64.soz.soz%no packaged library for this platformsndfilez8sndfile library not found using ctypes.util.find_libraryzlibsndfile.dylibzlibsndfile.dllz libsndfile.soarm64z/opt/homebrew/lib/z/usr/local/lib/utf-8replacez libsndfile-rzFTc t|d|| | | | | 5}||||}||||||}dddn #1swxYwY||jfS)aProvide audio data from a sound file as NumPy array. By default, the whole file is read from the beginning, but the position to start reading can be specified with *start* and the number of frames to read can be specified with *frames*. Alternatively, a range can be specified with *start* and *stop*. If there is less data left in the file than requested, the rest of the frames are filled with *fill_value*. If no *fill_value* is specified, a smaller array is returned. Parameters ---------- file : str or int or file-like object The file to read from. See `SoundFile` for details. frames : int, optional The number of frames to read. If *frames* is negative, the whole rest of the file is read. Not allowed if *stop* is given. start : int, optional Where to start reading. A negative value counts from the end. stop : int, optional The index after the last frame to be read. A negative value counts from the end. Not allowed if *frames* is given. dtype : {'float64', 'float32', 'int32', 'int16'}, optional Data type of the returned array, by default ``'float64'``. Floating point audio data is typically in the range from ``-1.0`` to ``1.0``. Integer data is in the range from ``-2**15`` to ``2**15-1`` for ``'int16'`` and from ``-2**31`` to ``2**31-1`` for ``'int32'``. .. note:: Reading int values from a float file will *not* scale the data to [-1.0, 1.0). If the file contains ``np.array([42.6], dtype='float32')``, you will read ``np.array([43], dtype='int32')`` for ``dtype='int32'``. Returns ------- audiodata : `numpy.ndarray` or type(out) A two-dimensional (frames x channels) NumPy array is returned. If the sound file has only one channel, a one-dimensional array is returned. Use ``always_2d=True`` to return a two-dimensional array anyway. If *out* was specified, it is returned. If *out* has more frames than available in the file (or if *frames* is smaller than the length of *out*) and no *fill_value* is given, then only a part of *out* is overwritten and a view containing all valid frames is returned. samplerate : int The sample rate of the audio file. Other Parameters ---------------- always_2d : bool, optional By default, reading a mono sound file will return a one-dimensional array. With ``always_2d=True``, audio data is always returned as a two-dimensional array, even if the audio file has only one channel. fill_value : float, optional If more frames are requested than available in the file, the rest of the output is be filled with *fill_value*. If *fill_value* is not specified, a smaller array is returned. out : `numpy.ndarray` or subclass, optional If *out* is specified, the data is written into the given array instead of creating a new array. In this case, the arguments *dtype* and *always_2d* are silently ignored! If *frames* is not given, it is obtained from the length of *out*. samplerate, channels, format, subtype, endian, closefd See `SoundFile`. Examples -------- >>> import soundfile as sf >>> data, samplerate = sf.read('stereo_file.wav') >>> data array([[ 0.71329652, 0.06294799], [-0.26450912, -0.38874483], ... [ 0.67398441, -0.11516333]]) >>> samplerate 44100 rN) SoundFile _prepare_readread samplerate)fileframesstartstopdtype always_2d fill_valueoutrchannelsformatsubtypeendianclosefdfdatas C/root/voice-cloning/.venv/lib/python3.11/site-packages/soundfile.pyrrsl 4j(FFG 5 5A89f55vvfeY C@@AAAAAAAAAAAAAAA  s1AAAc ddl} | |}|jdkrd} n |jd} t |d|| |||||| 5} | |ddddS#1swxYwYdS)aWrite data to a sound file. .. note:: If *file* exists, it will be truncated and overwritten! Parameters ---------- file : str or int or file-like object The file to write to. See `SoundFile` for details. data : array_like The data to write. Usually two-dimensional (frames x channels), but one-dimensional *data* can be used for mono files. Only the data types ``'float64'``, ``'float32'``, ``'int32'`` and ``'int16'`` are supported. .. note:: The data type of *data* does **not** select the data type of the written file. Audio data will be converted to the given *subtype*. Writing int values to a float file will *not* scale the values to [-1.0, 1.0). If you write the value ``np.array([42], dtype='int32')``, to a ``subtype='FLOAT'`` file, the file will then contain ``np.array([42.], dtype='float32')``. samplerate : int The sample rate of the audio data. subtype : str, optional See `default_subtype()` for the default value and `available_subtypes()` for all possible values. Other Parameters ---------------- format, endian, closefd, compression_level, bitrate_mode See `SoundFile`. Examples -------- Write 10 frames of random data to a new file: >>> import numpy as np >>> import soundfile as sf >>> sf.write('stereo_file.wav', np.random.randn(10, 2), 44100, 'PCM_24') rNrw)numpyasarrayndimshaperwrite) rrrrrrrcompression_level bitrate_modenprrs rrr8sZ ::d  D yA~~:a= 4j(FFG$l 4 478  s A00A47A4c #Kt|d| | | || |5}||||}|||||||| D]}|V ddddS#1swxYwYdS)a8Return a generator for block-wise reading. By default, iteration starts at the beginning and stops at the end of the file. Use *start* to start at a later position and *frames* or *stop* to stop earlier. If you stop iterating over the generator before it's exhausted, the sound file is not closed. This is normally not a problem because the file is opened in read-only mode. To close the file properly, the generator's ``close()`` method can be called. Parameters ---------- file : str or int or file-like object The file to read from. See `SoundFile` for details. blocksize : int The number of frames to read per block. Either this or *out* must be given. overlap : int, optional The number of frames to rewind between each block. Yields ------ `numpy.ndarray` or type(out) Blocks of audio data. If *out* was given, and the requested frames are not an integer multiple of the length of *out*, and no *fill_value* was given, the last block will be a smaller view into *out*. Other Parameters ---------------- frames, start, stop See `read()`. dtype : {'float64', 'float32', 'int32', 'int16'}, optional See `read()`. always_2d, fill_value, out See `read()`. samplerate, channels, format, subtype, endian, closefd See `SoundFile`. Examples -------- >>> import soundfile as sf >>> for block in sf.blocks('stereo_file.wav', blocksize=1024): >>> pass # do something with 'block' rN)rrblocks)r blocksizeoverlaprrrrrrrrrrrrrrblocks rrrqsf 4j(FFG 5 589f55XXi&#Y CAA  EKKKK s:A!!A%(A%c4eZdZdZdZedZdZdS)_SoundFileInfozInformation about a SoundFilec||_t|5}|j|_|j|_|j|_|j|_t |j|jz |_|j|_|j |_ |j |_ |j |_ |j |_ |j |_ |j|_ddddS#1swxYwYdSN)verbosernamerrrrwdurationrrr format_info subtype_infosections extra_info)selfrrrs r__init__z_SoundFileInfo.__init__s t__ +DIlDOJDM(DK!$+..q|;DM(DK9DL(DK }D  !D JDMlDO + + + + + + + + + + + + + + + + + +sB&C  CCc>t|jd\}}t|d\}}|dkrd|||}nS|dkrd||}n6|dkrd|j}nd|}|S)Ni<rz{0:.0g}:{1:02.0g}:{2:05.3f} hz{0:02.0g}:{1:05.3f} minz {0:d} samplesz {0:.3f} s)divmodrrr)rhoursrestminutessecondsrs r _duration_strz_SoundFileInfo._duration_strsT]D11 t!$++ A::6==eWgVVHH \\077IIHH \\&--dk::HH"))'22Hcdgd}|jr|dgdz }d|jd}|||S)N )z{0.name}zsamplerate: {0.samplerate} Hzzchannels: {0.channels}zduration: {0._duration_str}z$format: {0.format_info} [{0.format}]z'subtype: {0.subtype_info} [{0.subtype}])z endian: {0.endian}zsections: {0.sections}zframes: {0.frames}zextra_info: """z {1}"""z )joinrrsplitr)rinfoindented_extra_infos r__repr__z_SoundFileInfo.__repr__syy 8 8 899 < DII   D *//0E0Ed0K0KLL{{4!4555rN)__name__ __module__ __qualname____doc__rpropertyrrrrrrsS''+++   X 66666rrc"t||S)zReturns an object with information about a `SoundFile`. Parameters ---------- verbose : bool Whether to print additional information. )r)rrs rrrs $ ( ((rcdtttjtjS)aReturn a dictionary of available major formats. Examples -------- >>> import soundfile as sf >>> sf.available_formats() {'FLAC': 'FLAC (FLAC Lossless Audio Codec)', 'OGG': 'OGG (OGG Container format)', 'WAV': 'WAV (Microsoft)', 'AIFF': 'AIFF (Apple/SGI)', ... 'WAVEX': 'WAVEX (Microsoft)', 'RAW': 'RAW (header-less)', 'MAT5': 'MAT5 (GNU Octave 2.1 / Matlab 5.0)'} )dict_available_formats_helper_sndSFC_GET_FORMAT_MAJOR_COUNTSFC_GET_FORMAT_MAJORrrravailable_formatsrs3" )$*I*.*CEE F FFrcttjtj}t fd|DS)adReturn a dictionary of available subtypes. Parameters ---------- format : str If given, only compatible subtypes are returned. Examples -------- >>> import soundfile as sf >>> sf.available_subtypes('FLAC') {'PCM_24': 'Signed 24 bit PCM', 'PCM_16': 'Signed 16 bit PCM', 'PCM_S8': 'Signed 8 bit PCM'} c3JK|]\}}t|||fVdSr) check_format).0rrrs r z%available_subtypes..sJDDMGT>\&'%B%B>$!>>>DDr)rrSFC_GET_FORMAT_SUBTYPE_COUNTSFC_GET_FORMAT_SUBTYPEr)rsubtypess` ravailable_subtypesrsb"))J)-)DFFH DDDDXDDD D DDrcp tt|||S#ttf$rYdSwxYw)zCheck if the combination of format/subtype/endian is valid. Examples -------- >>> import soundfile as sf >>> sf.check_format('WAV', 'PCM_24') True >>> sf.check_format('FLAC', 'VORBIS') False F)bool _format_int ValueError TypeError)rrrs rrrsHK88999  "uus  55cxt|t|S)zReturn the default subtype for a given format. Examples -------- >>> import soundfile as sf >>> sf.default_subtype('WAV') 'PCM_16' >>> sf.default_subtype('MAT5') 'DOUBLE' ) _check_format_default_subtypesgetupper)rs rdefault_subtyper)s.&   0 00rceZdZdZ d>dZedZ edZ edZ ed Z ed Z ed Z ed Z ed Z edZ edZ edZ edZ edZ edZ edZ edZdZdZdZdZdZdZdZdZdZdZdZ e!fd Z"d!Z# d?d%Z$d@d&Z%d'Z&d(Z'd)Z( dAd+Z)dBd,Z*d-Z+d.Z,d/Z-d0Z.d1Z/d2Z0d3Z1d4Z2d5Z3d6Z4d7Z5d8Z6d9Z7d:Z8d;Z9d<Z:d=Z;dS)CrzA sound file. For more documentation see the __init__() docstring (which is also used for the online documentation (https://python-soundfile.readthedocs.io/). rNTc t|dr|n|}||_|t|dd}t |} ||_| |_| |_t||||||||_ | || ||_ t| dr)|r|dt |j t jt&jt j|j=||j|j||jdSdSdS)aOpen a sound file. If a file is opened with `mode` ``'r'`` (the default) or ``'r+'``, no sample rate, channels or file format need to be given because the information is obtained from the file. An exception is the ``'RAW'`` data format, which always requires these data points. File formats consist of three case-insensitive strings: * a *major format* which is by default obtained from the extension of the file name (if known) and which can be forced with the format argument (e.g. ``format='WAVEX'``). * a *subtype*, e.g. ``'PCM_24'``. Most major formats have a default subtype which is used if no subtype is specified. * an *endian-ness*, which doesn't have to be specified at all in most cases. A `SoundFile` object is a *context manager*, which means if used in a "with" statement, `close()` is automatically called when reaching the end of the code block inside the "with" statement. Parameters ---------- file : str or int or file-like object The file to open. This can be a file name, a file descriptor or a Python file object (or a similar object with the methods ``read()``/``readinto()``, ``write()``, ``seek()`` and ``tell()``). mode : {'r', 'r+', 'w', 'w+', 'x', 'x+'}, optional Open mode. Has to begin with one of these three characters: ``'r'`` for reading, ``'w'`` for writing (truncates *file*) or ``'x'`` for writing (raises an error if *file* already exists). Additionally, it may contain ``'+'`` to open *file* for both reading and writing. The character ``'b'`` for *binary mode* is implied because all sound files have to be opened in this mode. If *file* is a file descriptor or a file-like object, ``'w'`` doesn't truncate and ``'x'`` doesn't raise an error. samplerate : int The sample rate of the file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files). channels : int The number of channels of the file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files). subtype : str, sometimes optional The subtype of the sound file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files), if not, the default value depends on the selected `format` (see `default_subtype()`). See `available_subtypes()` for all possible subtypes for a given `format`. endian : {'FILE', 'LITTLE', 'BIG', 'CPU'}, sometimes optional The endian-ness of the sound file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files), if not, the default value is ``'FILE'``, which is correct in most cases. format : str, sometimes optional The major format of the sound file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files), if not, the default value is determined from the file extension. See `available_formats()` for all possible values. closefd : bool, optional Whether to close the file descriptor on `close()`. Only applicable if the *file* argument is a file descriptor. compression_level : float, optional The compression level on 'write()'. The compression level should be between 0.0 (minimum compression level) and 1.0 (highest compression level). See `libsndfile document `__. bitrate_mode : {'CONSTANT', 'AVERAGE', 'VARIABLE'}, optional The bitrate mode on 'write()'. See `libsndfile document `__. Examples -------- >>> from soundfile import SoundFile Open an existing file for reading: >>> myfile = SoundFile('existing_file.wav') >>> # do something with myfile >>> myfile.close() Create a new sound file for reading and writing using a with statement: >>> with SoundFile('new_file.wav', 'x+', 44100, 2) as myfile: >>> # do something with myfile >>> # ... >>> assert not myfile.closed >>> # myfile.close() is called automatically at the end >>> assert myfile.closed __fspath__Nmodezr+r)hasattrr_namegetattr _check_mode_mode_compression_level _bitrate_mode_create_info_struct_info_open_fileset issupersetseekableseekr sf_commandSFC_SET_CLIPPING_ffiNULLSF_TRUE_set_compression_level_set_bitrate_mode) rrrrrrrrrrrmode_ints rrzSoundFile.__init__As\N%,D,$?$?It   T <4..Dt$$ "3)(tZ)/&BB ZZh88 t99   % % $--//  IIaLLL  D$949  & & &  " .  ' '(? @ @ @!-&&t'9::::: / ..-rc|jSr)rrs rzSoundFile.rc|jSr)rrs rrzSoundFile.rrc|jjSr)rrrs rrzSoundFile.s tz'<rc|jjSrrrrs rrzSoundFile.s 4:#4rc|jjSr)rrrs rrzSoundFile. TZ%8rcNt|jjtjzSr) _format_strrrrSF_FORMAT_TYPEMASKrs rrzSoundFile.s[!2T5L!LMMrcNt|jjtjzSr)rrrrSF_FORMAT_SUBMASKrs rrzSoundFile.[!2T5K!KLLrcNt|jjtjzSr)rrrrSF_FORMAT_ENDMASKrs rrzSoundFile.r rcZt|jjtjzdSNr) _format_inforrrrrs rrzSoundFile.s*\$*"3"&"9#:;;;<>rcZt|jjtjzdSr$)r%rrrrrs rrzSoundFile.s*\$*"3"&"8#9:::;=rc|jjSr)rrrs rrzSoundFile.rrc|jduSr)rrs rrzSoundFile.s 4:#5rc@t|jSr)rsf_errorrrs rrzSoundFile.st}}TZ'@'@rc|jSr)rrs rrzSoundFile.s d.Erc|jSr)rrs rrzSoundFile.s );rctjdd}t|jtj|tj|tj|ddS)z8Retrieve the log string generated when opening the file.zchar[]i@rr) r newrr rSFC_GET_LOG_INFOsizeofstringdecode)rrs rrzSoundFile.extra_infoscx%((  D$9dk$// 1 1 1{4  '';;;rc|jd|jnd}||jd|jndz }d||S)Nz, compression_level={0}z, bitrate_mode='{0}'zSoundFile({0.name!r}, mode={0.mode!r}, samplerate={0.samplerate}, channels={0.channels}, format={0.format!r}, subtype={0.subtype!r}, endian={0.endian!r}{1}))rrr)rcompression_settings rrzSoundFile.__repr__sz"&"8"D 9??@VWWWJL #'#4#@!7 = =d>O P P PFH J*+1&7J*K*K Mrc.|dSrclosers r__del__zSoundFile.__del__ rc|Srrrs r __enter__zSoundFile.__enter__s rc.|dSrr7)rargss r__exit__zSoundFile.__exit__r:rc|tvrc|t|jt||}t |dSt|||dS)z:Write text meta-data in the sound file through properties.N) _str_types_check_if_closedr sf_set_stringrencode _error_checkobject __setattr__)rrvalueerrs rrGzSoundFile.__setattr__s| :    ! ! # # #$$TZD1A%*\\^^55C         tT5 1 1 1 1 1rc.|tvrk|t|jt|}|r(t j|ddndStd |)z9Read text meta-data in the sound file through properties.rrr4z)'SoundFile' object has no attribute {0!r}) rArBr sf_get_stringrr r1r2AttributeErrorr)rrrs r __getattr__zSoundFile.__getattr__s :    ! ! # # #%%dj*T2BCCDCGO4;t$$++GY???R O ;BB4HHJJ Jrc|jjSrrrs r__len__zSoundFile.__len__sz  rcdS)NTrrs r__bool__zSoundFile.__bool__s trc*|Sr)rQrs r __nonzero__zSoundFile.__nonzero__"s}}rc6|jjtjkS)z)Return True if the file supports seeking.)rrrr rs rrzSoundFile.seekable'sz"dl22rc|t|j||}t |j|S)aSet the read/write position. Parameters ---------- frames : int The frame index or offset to seek. whence : {SEEK_SET, SEEK_CUR, SEEK_END}, optional By default (``whence=SEEK_SET``), *frames* are counted from the beginning of the file. ``whence=SEEK_CUR`` seeks from the current position (positive and negative values are allowed for *frames*). ``whence=SEEK_END`` seeks from the end (use negative value for *frames*). Returns ------- int The new absolute read/write position in frames. Examples -------- >>> from soundfile import SoundFile, SEEK_END >>> myfile = SoundFile('stereo_file.wav') Seek to the beginning of the file: >>> myfile.seek(0) 0 Seek to the end of the file: >>> myfile.seek(0, SEEK_END) 44100 # this is the file length )rBrsf_seekrrE _errorcode)rrwhencepositions rrzSoundFile.seek+sCH << FF;;T_%%%rc8|dtS)z'Return the current read/write position.r)rrrs rtellzSoundFile.tellTsyyH%%%rrrzFc2|.|||}||||}n(|dks|t|krt|}|d||}t||kr| |d|}n|||d<|S)a Read from the file and return data as NumPy array. Reads the given number of frames in the given data format starting at the current read/write position. This advances the read/write position by the same number of frames. By default, all frames from the current read/write position to the end of the file are returned. Use `seek()` to move the current read/write position. Parameters ---------- frames : int, optional The number of frames to read. If ``frames < 0``, the whole rest of the file is read. dtype : {'float64', 'float32', 'int32', 'int16'}, optional Data type of the returned array, by default ``'float64'``. Floating point audio data is typically in the range from ``-1.0`` to ``1.0``. Integer data is in the range from ``-2**15`` to ``2**15-1`` for ``'int16'`` and from ``-2**31`` to ``2**31-1`` for ``'int32'``. .. note:: Reading int values from a float file will *not* scale the data to [-1.0, 1.0). If the file contains ``np.array([42.6], dtype='float32')``, you will read ``np.array([43], dtype='int32')`` for ``dtype='int32'``. Returns ------- audiodata : `numpy.ndarray` or type(out) A two-dimensional NumPy (frames x channels) array is returned. If the sound file has only one channel, a one-dimensional array is returned. Use ``always_2d=True`` to return a two-dimensional array anyway. If *out* was specified, it is returned. If *out* has more frames than available in the file (or if *frames* is smaller than the length of *out*) and no *fill_value* is given, then only a part of *out* is overwritten and a view containing all valid frames is returned. Other Parameters ---------------- always_2d : bool, optional By default, reading a mono sound file will return a one-dimensional array. With ``always_2d=True``, audio data is always returned as a two-dimensional array, even if the audio file has only one channel. fill_value : float, optional If more frames are requested than available in the file, the rest of the output is be filled with *fill_value*. If *fill_value* is not specified, a smaller array is returned. out : `numpy.ndarray` or subclass, optional If *out* is specified, the data is written into the given array instead of creating a new array. In this case, the arguments *dtype* and *always_2d* are silently ignored! If *frames* is not given, it is obtained from the length of *out*. Examples -------- >>> from soundfile import SoundFile >>> myfile = SoundFile('stereo_file.wav') Reading 3 frames from a stereo file: >>> myfile.read(3) array([[ 0.71329652, 0.06294799], [-0.26450912, -0.38874483], [ 0.67398441, -0.11516333]]) >>> myfile.close() See Also -------- buffer_read, .write Nrr) _check_frames_create_empty_arraylen _array_io)rrrrrrs rrzSoundFile.readXs` ;'' ;;F**69eDDCCzzVc#hh..SV44 s88f  !'6'l)FGG  rc||d}||}tj|dz||jz}|d|||}||ksJtj|S)aRead from the file and return data as buffer object. Reads the given number of *frames* in the given data format starting at the current read/write position. This advances the read/write position by the same number of frames. By default, all frames from the current read/write position to the end of the file are returned. Use `seek()` to move the current read/write position. Parameters ---------- frames : int, optional The number of frames to read. If ``frames < 0``, the whole rest of the file is read. dtype : {'float64', 'float32', 'int32', 'int16'} Audio data will be converted to the given data type. Returns ------- buffer A buffer containing the read data. See Also -------- buffer_read_into, .read, buffer_write N)rz[]r)r] _check_dtyper r.r _cdata_iobuffer)rrrctypecdata read_framess r buffer_readzSoundFile.buffer_reads8##Ft#<<!!%((v '=>>nnVUE6BB f$$$${5!!!rc||}|||\}}|d|||}|S)aRead from the file into a given buffer object. Fills the given *buffer* with frames in the given data format starting at the current read/write position (which can be changed with `seek()`) until the buffer is full or the end of the file is reached. This advances the read/write position by the number of frames that were read. Parameters ---------- buffer : writable buffer Audio frames from the file are written to this buffer. dtype : {'float64', 'float32', 'int32', 'int16'} The data type of *buffer*. Returns ------- int The number of frames that were read from the file. This can be less than the size of *buffer*. The rest of the buffer is not filled with meaningful data. See Also -------- buffer_read, .read r)rb _check_bufferrc)rrdrrerfrs rbuffer_read_intozSoundFile.buffer_read_intosL8!!%((**6599 vuf== rcddl}||}|d|t|}|t|ksJ||dS)aWrite audio data from a NumPy array to the file. Writes a number of frames at the read/write position to the file. This also advances the read/write position by the same number of frames and enlarges the file if necessary. Note that writing int values to a float file will *not* scale the values to [-1.0, 1.0). If you write the value ``np.array([42], dtype='int32')``, to a ``subtype='FLOAT'`` file, the file will then contain ``np.array([42.], dtype='float32')``. Parameters ---------- data : array_like The data to write. Usually two-dimensional (frames x channels), but one-dimensional *data* can be used for mono files. Only the data types ``'float64'``, ``'float32'``, ``'int32'`` and ``'int16'`` are supported. .. note:: The data type of *data* does **not** select the data type of the written file. Audio data will be converted to the given *subtype*. Writing int values to a float file will *not* scale the values to [-1.0, 1.0). If you write the value ``np.array([42], dtype='int32')``, to a ``subtype='FLOAT'`` file, the file will then contain ``np.array([42.], dtype='float32')``. Examples -------- >>> import numpy as np >>> from soundfile import SoundFile >>> myfile = SoundFile('stereo_file.wav') Write 10 frames of random data to a new file: >>> with SoundFile('stereo_file.wav', 'w', 44100, 2, 'PCM_24') as f: >>> f.write(np.random.randn(10, 2)) See Also -------- buffer_write, .read rNr)rascontiguousarrayr`r__update_frames)rrrwrittens rrzSoundFile.writesr\ ##D))..$D ::#d))#### G$$$$$rc||}|||\}}|d|||}||ksJ||dS)aWrite audio data from a buffer/bytes object to the file. Writes the contents of *data* to the file at the current read/write position. This also advances the read/write position by the number of frames that were written and enlarges the file if necessary. Parameters ---------- data : buffer or bytes A buffer or bytes object containing the audio data to be written. dtype : {'float64', 'float32', 'int32', 'int16'} The data type of the audio data stored in *data*. See Also -------- .write, buffer_read rN)rbrjrcrn)rrrrerfrros r buffer_writezSoundFile.buffer_write0sr*!!%((**477 v..%??&     G$$$$$rrc #Kddl}d|jvrd|jvrtd|||}|?|t d||nt ||} || ||}d} n"|t dt|}d } d} |dkr| d} nt| } | |d| <t || z |} || ||||| d|r1| | || d} n|| d| dd<|||zkr||d||z}n|}| r| |n|V|| z}|dkdSdS) aReturn a generator for block-wise reading. By default, the generator yields blocks of the given *blocksize* (using a given *overlap*) until the end of the file is reached; *frames* can be used to stop earlier. Parameters ---------- blocksize : int The number of frames to read per block. Either this or *out* must be given. overlap : int, optional The number of frames to rewind between each block. frames : int, optional The number of frames to read. If ``frames < 0``, the file is read until the end. dtype : {'float64', 'float32', 'int32', 'int16'}, optional See `read()`. Yields ------ `numpy.ndarray` or type(out) Blocks of audio data. If *out* was given, and the requested frames are not an integer multiple of the length of *out*, and no *fill_value* was given, the last block will be a smaller view into *out*. Other Parameters ---------------- always_2d, fill_value, out See `read()`. fill_value : float, optional See `read()`. out : `numpy.ndarray` or subclass, optional If *out* is specified, the data is written into the given array instead of creating a new array. In this case, the arguments *dtype* and *always_2d* are silently ignored! Examples -------- >>> from soundfile import SoundFile >>> with SoundFile('stereo_file.wav') as f: >>> for block in f.blocks(blocksize=1024): >>> pass # do something with 'block' rNr+z*blocks() is not allowed in write-only modez)One of {blocksize, out} must be specifiedTz-Only one of {blocksize, out} may be specifiedF) rrSoundFileRuntimeErrorr]rminr^r_rcopy)rrrrrrrrrout_sizecopy_outoverlap_memory output_offsettoreadrs rrzSoundFile.blocksKsd  di  Cty$8$8'(TUU U##FJ77 ;  KLLL$.$:yyIv@V@VH**8YFFCHH$CEEECIHqjj% ! #N 3 3 &4N]N#]2F;;F IIfeY C YY[[Foodj$*@"h}f=="k,7799  D-- ++C!#'BCC C" rcl|t|jdS)ajWrite unwritten data to the file system. Data written with `write()` is not immediately written to the file system but buffered in memory to be written at a later time. Calling `flush()` makes sure that all changes are actually written to the file system. This has no effect on files opened in read-only mode. N)rBr sf_write_syncrrs rflushzSoundFile.flushs2  4:&&&&&rc|jsK|t|j}d|_t |dSdS)z.Close the file. Can be called multiple times.N)closedrrsf_closerrE)rrIs rr8zSoundFile.closesQ{  JJLLL-- ++CDJ         rct|ttfr+tj|rd|jvr'td|j t|j dr>tj tj |tjtjzt j}t|trCt$jdkr t j}n&|t%j}||||j}nt|t0r#t |||j|}nwt5||r@t ||||jt:j}n't?d|j |t:jkrCt |}tC|d|j |t j"kr d|j_#|S) z9Call the appropriate sf_open*() function from libsndfile.xzFile exists: {0!r}zw+rzInvalid file: {0!r}zError opening {0!r}: prefixr)$ isinstance_unicodebytes_ospathisfilerOSErrorrrrrr8openO_WRONLYO_TRUNCrsf_open_sysplatform sf_wchar_openrDgetfilesystemencodingrrx sf_open_fd_has_virtual_io_attrssf_open_virtual_init_virtual_ior r rr*r SFM_WRITEr)rrrr openfunctionfile_ptrrIs rrzSoundFile._opens dXu- . . Ext$$ J$)##!"6"="=di"H"HIII^^..t44JIchtS\CK-GHHIII.vio_get_filelensJ99;;D IIa " " "99;;D IIdH % % %Kr sf_vio_seekcX||Sr)rr[)offsetrXrrs rvio_seekz,SoundFile._init_virtual_io..vio_seeks% IIff % % %99;; r sf_vio_readc tj||}|}nP#t$rC|}t |}tj||}||d|<YnwxYw|Sr)r rdreadintorLrr_)ptrcountrbuf data_readrrs rvio_readz,SoundFile._init_virtual_io..vio_read s (k#u-- MM#.. ! ( ( (yy''II k#y11#'AiK    (  s*.A A;:A; sf_vio_writecxtj||}|dd}|}||}|Sr)r rdr)rrrrrrors r vio_writez-SoundFile._init_virtual_io..vio_writesA+c5))Cqqq6Djj&&GNr sf_vio_tellc,Sr)r[)rrs rvio_tellz,SoundFile._init_virtual_io..vio_tell!s99;; r) get_filelenrrrr[zSF_VIRTUAL_IO*)r callback _virtual_ior.)rrrrrrrs ` rrzSoundFile._init_virtual_ios* + , ,     - ,  } % %     & %  } % %     & %  ~ & &     ' &  } % %     & % ,;$,$,%.$, .. x($*:;;;rctS)zReturn all attributes used in __setattr__ and __getattr__. This is useful for auto-completion (e.g. IPython). )rArs r_getAttributeNameszSoundFile._getAttributeNames.s rc2|jrtddS)zCheck if the file is closed and raise an error if it is. This should be used in every method that uses self._file. zI/O operation on closed fileN)rrtrs rrBzSoundFile._check_if_closed6s* ; H'(FGG G H Hrc|r-|j|z }|dks||kr||}n|dkrtd|S)z8Reduce frames to no more than are available in the file.rNz/frames must be specified for non-seekable files)rrr[r)rrrremaining_framess rr]zSoundFile._check_frames?se ==?? P#{TYY[[8 zzf'777(0) aZZNOO O rc,|tvsJt|tst j|}t t||jt j |z\}}|rtd||fS)z1Convert buffer to cdata and check for valid size.z*Data size must be a multiple of frame size) _ffi_typesvaluesrrr  from_bufferrr_rr0r)rrrer remainders rrjzSoundFile._check_bufferJs ))++++++$&& *#D))D"3t99#'=4;u3E3E#EGG  KIJJ JV|rcnddl}|s |jdkr ||jf}n|f}|||dS)z-Create an empty array with appropriate shape.rNrC)order)rrempty)rrrrrrs rr^zSoundFile._create_empty_arrayUsO   ))DM)EEGExxuCx000rc  t|S#t$rHtdt t|wxYw)z7Check if dtype string is valid and return ctype string.z(dtype must be one of {0!r} and not {1!r})rKeyErrorrrsortedkeys)rrs rrbzSoundFile._check_dtype^si 3e$ $ 3 3 3GNNz(())52233 3 3s AA!cb|jdvr5td|j|jdkrdnd|jdkrdn |jd}||jkr.td|j|j||jjstd||jj }|jj tj |ksJtj |dz|jd d }|||||S) z+Check array and call low-level IO function.)rr zInvalid shape: {0!r} ({1})rz0 dimensions not supportedztoo many dimensionsz5Invalid shape: {0!r} (Expected {1} channels, got {2})zData must be C-contiguous*rr)rrrrrflags c_contiguousrbrritemsizer r0cast__array_interface__rc)ractionarrayrarray_channelsrerfs rr`zSoundFile._array_iofsJ :U " "9@@nsnx{|n|n|NjNjCXYYZZ Z#jAoo5;q> T] * *T[[\a\gimivyGHHII I{' :899 9!!%+"233{#t{5'9'99999 %#+u'@'H'KLL~~feUF;;;rc|tvsJ||r|}t t d|zdz|z}||j||}t|j |r| ||zt|S)z.Call one of libsndfile's read/write functions.sf_f_) rrrBrr[rrrrErWrr)rrrrerrfuncs rrczSoundFile._cdata_iots ))++++++  ==?? 99;;DtUV^d2U:;;dj$//T_%%% ==?? / IIdVmX . . . rc|rV|}|dt|j_||t dS|jxj|z c_dS)z!Update self.frames after writing.rN)rr[rrrrr)rrors rrnzSoundFile._update_framessm ==?? )99;;D $ !X 6 6DJ  IIdH % % % % % J   (    rcb|dkr#|std|dkr|tdt|||j\}}}||kr|}|dkr||z }|r||t|S)z)Seek to start frame and calculate length.rz(start is only allowed for seekable filesNz&Only one of {frames, stop} may be used)rrrsliceindicesrrr)rrrr_s rrzSoundFile._prepare_reads A::dmmoo:GHH H Q;;4+DEE Eud++33DK@@tQ %<<D A::E\F ==?? ' IIeX & & & rci}tD]R\}}t|j|}|r+t j|dd||<S|S)a5Get all metadata present in this SoundFile Returns ------- metadata: dict[str, str] A dict with all metadata. Possible keys are: 'title', 'copyright', 'software', 'artist', 'comment', 'date', 'album', 'license', 'tracknumber' and 'genre'. rr)rAitemsrrKrr r1r2)rstrsstrtypestridrs r copy_metadatazSoundFile.copy_metadatass(..00 M MNGU%%dj%88D M $ D 1 1 8 8) L LW  rcd|tvsJtjd}t||d<t|jtj|tj|}|tjkr2t |j}t|d|dS)z,Call libsndfile's set bitrate mode function.zint[1]rzError set bitrate mode N) _bitrate_modesr r.rr rSFC_SET_BITRATE_MODEr0r r*r)rrpointer_bitrate_moderIs rrzSoundFile._set_bitrate_modes~----#x11"0">Qoodj$*CEY[_[fg{[|[|}} $,  -- ++C!#'O'O'OPP P  rctd|cxkrdksntdtjd}||d<t|jtj|tj|}|tjkr2t |j}t|d|dS)z1Call libsndfile's set compression level function.rrz)Compression level must be in range [0..1]z double[1]zError set compression level N) rr r.rr rSFC_SET_COMPRESSION_LEVELr0r r*r)rrpointer_compression_levelrIs rrz SoundFile._set_compression_levels&++++!++++HII I$(H[$9$9!'8!!$oodj$*HJceieprKfLfLMM $,  -- ++C!#'YFW'Y'YZZ Z  r) rNNNNNTNN)rrzFNN)rN)NrrrzFNNr) >??K?8 = =>>L:x8899H3 X55 6 6F2@@AAJ' !E!EFF,8;;<t |t t fs"td| |t|z}n0#t$r#td|wxYw|d}n>t |t t fs"td| |t|z}n0#t$r#td|wxYwtj d}||_d |_t|tjkrtd |S) z8Return numeric ID for given format|subtype|endian combo.Nz)No default subtype for major format {0!r}zInvalid subtype: {0!r}zUnknown subtype: {0!r}rrzInvalid endian-ness: {0!r}zUnknown endian-ness: {0!r}SF_INFO*rz1Invalid combination of format, subtype and endian)rrrrrrstr _subtypesrrr_endiansr r.rrsf_format_checkSF_FALSE)rrrresultrs rrrs 6 " "F!&)) ?;BB6JJLL L (C 1 1B077@@AAAC)GMMOO,, CCC188AABBBC ~ 3 0 0E4;;FCCDDDF(6<<>>** FFF5< Orc|}|/t||}t|ttfsJnt |t jd}d|vs|dkrG|td||_ |td||_ t||||_ n-td|||||fDrtd|S) z*Check arguments and create SF_INFO struct.Nrrrzsamplerate must be specifiedzchannels must be specifiedc3K|]}|duV dSrr)rargs rrz&_create_info_struct..s>II3s$IIIIIIrz\Not allowed for existing files (except 'RAW'): samplerate, channels, format, subtype, endian)_get_format_from_filenamerrrrr r.rrrrrrany) rrrrrrroriginal_formatrs rrrs#O ~*466&8S/222222f 8J  D $&,,..E11  :;; ;$  899 9  !&'6:: IIHow+HIII I I MLMM M KrcXd}t|d|} tj|ddd}|dd}n#t $rYnwxYw|tvr&d|vr"td ||S) aReturn a format string obtained from file (or file.name). If file already exists (= read mode), an empty string is returned on error. If not, an exception is raised. The return type will always be str or unicode (even if file/file.name is a bytes object). r4rrrNrrrzGNo format specified and unable to get format from file extension: {0!r}) rrrsplitextr2 Exceptionr_formatsrr)rrrs rrrsF 4 & &D ""4((,QRR0w 22       ||~~X%%#T//006t >> > MsAA A&%A&ctttfD](}|D]\}}||kr|ccS)dS)z;Return the string representation of a given numeric format.zn/a)r rrr) format_int dictionarykvs rrr1s^ 83 $$&&  DAqJ urc8tjd}||_ttj||tjd|j}t|j|r(tj | ddndfS)z6Return the ID and short description of a given format.zSF_FORMAT_INFO*SF_FORMAT_INFOrrr4) r r.rrr r r0rrr1r2)r  format_flagrrs rr%r%;s(,--K#KOODI{KK 011333  D  * + +<@ HDK   $ $Wi 8 8 8b JJrc#Ktjd}ttj||tjdt |dD]}t||VdS)z8Helper for available_formats() and available_subtypes().zint*rxrN)r r.rr r r0ranger%) count_flagrrr s rrrFsu HV  EOODIz5$+e2D2DEEEE!Hoo44 :{33333344rc$t|ttfs"td| t |}n0#t$r#td|wxYw|S)z4Check if `format_str` is valid and return format ID.zInvalid format: {0!r}zUnknown format: {0!r}) rrrrrr rrr) format_strr s rrrNs j8S/ 2 2D/66zBBCCCEj..001 EEE077 CCDDDE s A -B c |tjk}|tjk}tt |dt |dt |dp|t |dpt |dp|gS)z>Check if file has all the necessary attributes for virtual IO.rr[rrr)rrrallr)rrreadonly writeonlys rrrYs~4=(HDN*I ffg*(fGz!:!:Gi   rceZdZdZdS)SoundFileErrorz-Base class for all soundfile-specific errors.Nrrrrrrrrres77DrrceZdZdZdS)rtzKsoundfile module runtime error. Errors that used to be `RuntimeError`.Nrrrrrtrtis.. Drrtc6eZdZdZddZedZdZdS)rzjlibsndfile errors. Attributes ---------- code libsndfile internal error number. r4cZt|||||_||_dSr)rtrcoder)rr!rs rrzLibsndfileError.__init__xs,&&tT6:::  rc|jrGt|j}tj|ddSdS)zRaw libsndfile error message.rrz'(Garbled error message from libsndfile))r!rsf_error_numberr r1r2)rerr_strs r error_stringzLibsndfileError.error_string}sK 9 =**4955G;w''..w BB B =rDsf    ++++++++++555555""""""HHHHH      X  X  X  X    X    X   X  X  X  X  X  X  X  X  X   X! " X# $        5   :#  f#  f#  f#  f #   f #   f #  f#  f#  f# f# f#  f# f# f# f#  f!# "f## # $f%# &f'# (f)# *f+# ,f-# . f/# 0 f1# 2f3# 4 f5# 6 f7# 8f9# :f;# <f=# >f?# @fA# BfC# DfE# #  L    X X X  X   X  X X X X X X X Y X  X!" X#$ X%&       5<     :2 }  000000)HHJJ6A ' ! !::::::000000 =??1  ( ( 4   ]__Q 7 * * 4  'A!6--//88::>>@@ @ ' ! !000000 8::F F F 5   - :U B  g=>>> H  _5 6 6Eu&788J 4;z " "DDi(2222 =++  'TUU Ut{8$$ 222 =H $ $ 2   ]g % % 0   ]g % % /    100000 =H $ $w)>)>25(..AU2V2V'..& 4;sx}}[:KLLMMDD4;011D'228%T%;%;%=%=>>EEgyYY$$]33I3CC 4F4F4G4GHJO>B9=ZZZZzEI=A6666rFJBF%);?8888v1616161616V161616h))))FFF*DDDD.$ 1 1 1 I[I[I[I[I[I[I[I[X2222 @&60*.)AJJJJ444        Y        NL   /////+/////sD'11D I""M+(JMB'L>;M=L>>MM