+ O\i` RtRt^RIt^RIt^RIHtHtHt^RI H t ^RI H t]tR^R^R^R ^R ^R ^R ^R ^R^ R^/ t/RRbRRbRRbRRbRRbRRbRRbRRbR R!bR"R#bR$R%bR&R'bR(R)bR*R+bR,R-bR.R/bR0R1bR2R3R4R5R6R7R8R9R:R;RR?R@RARBRC/ Ct/RD^bRE^bRF^bRG^bRH^bRI^bRJ^bRK^bRL^bRM^bRN^bRO^ bRP^!bRQ^"bRR^#bRS^$bRT^0b/RU^1bRV^2bRW^@bRX^AbRY^BbRZ^CbR[^PbR\^QbR]^`bR^^dbR_^pbR`^qbRa^rbRb^sbRc^bRd^bRe^bCtRf^RgRhRiRjRkRl/t/RREbRREbRREbRREbRREbRREbRREbR REbR"REbR$RJbR&RJbR(REbR*R\bR,REbR.REbR0REbR2REbR4RER6RER8RER:RLRRER@RERBRe/CtRmRnRoRpRqRrRsRt/tRu^Rv^Rw^/t]P4Rx8Xd^RyIHtRz]!4,R{,tM]P4R|8Xd[^R}IHt^RyIHt]!4^,R~8XdRtM|]!4^,R8XdRtMf] !RPC]!4]!444h]P4R8Xd,^RyIHt]!4R9dRtMRz]!4,R,tM] !R4h^RI"t"]PFPI]"PJ4t&]PFPO]&]4t(]PR!](4t*]Pb!]*Pe44PgRR4t4]4PkR4'd ]4]6!R4Rt4RRlt7RRlt8RRlt9!RR]:4t;RRltRRlt?Rt@!RR]:4tARRltBRtCRtDRtERtFRtG]*P3RltIRtJRtKRtL!RR]M4tN!RR]N]O4tP!RR]P4tQR# ]d]tELIi;i ] ]+],3Ed] !R4t-]-f ] !R4h]PR!]-4t*EL" ] d]P4Rx8XdRt.M)]P4R|8XdRt.M]P4R8XdRt.Mh^RyIHt]P4Rx8Xdb]!4R8XdV]PFP_R4'dRMRt0]PR!]PFPO]0].44t*EL]PR!].4t*ELi;ii;i)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)ffititle copyrightsoftwareartistcommentdatealbumlicense tracknumbergenreWAViAIFFiAUiRAWiPAFiSVXiNISTiVOCiIRCAMi W64i MAT4i MAT5i PVFiXIiHTKiSDSiAVRiWAVEXiSD2iFLACiCAFiWVEiOGGi MPC2Ki!RF64i"MP3i#PCM_S8PCM_16PCM_24PCM_32PCM_U8FLOATDOUBLEULAWALAW IMA_ADPCMMS_ADPCMGSM610 VOX_ADPCM NMS_ADPCM_16 NMS_ADPCM_24 NMS_ADPCM_32G721_32G723_24G723_40DWVW_12DWVW_16DWVW_24DWVW_NDPCM_8DPCM_16VORBISOPUSALAC_16ALAC_20ALAC_24ALAC_32 MPEG_LAYER_I MPEG_LAYER_IIMPEG_LAYER_IIIFILELITTLEiBIGi CPUi0float64doublefloat32floatint32intint16shortCONSTANTAVERAGEVARIABLEdarwin)machine libsndfile_z.dylibwin32) architecture64bitzlibsndfile_x64.dll32bitzlibsndfile_x86.dllz%no packaged library for Windows {} {}linuxzlibsndfile_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-c \VRWWW4;_uu_4pVPW#V4pVPWWVV4pRRR4XXP3# +'giL;i)a Provide 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_valueoutrmchannelsformatsubtypeendianclosefdfdatas&&&&&&&&&&&&&& a/Users/agent/.cache/uv/archive-v0/6ZL4-8mCcRNgGE9wi6M6J/lib/python3.14/site-packages/soundfile.pyrlrlscl 4jF 5 589f5vvfYC@ 5    5 5s &A A$ c  ^RIp V PV4pVP^8Xd^p MVP^,p \ VRW*W4WVWx4 ;_uu_4p V P V4RRR4R# +'giR#;i)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') Nw)numpyasarrayndimshaperjwrite) rnr|rmrxryrwrzcompression_level bitrate_modenprvr{s &&&&&&&&& r}rr8sqZ ::d D yyA~::a= 4jF$ 4 478   4 4 4 4s A11 B c #"\VRWWW4;_uu_4pVPWEV4pVPWVWgW4FpVxK RRR4R# +'giR#;i5i)aReturn 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' riN)rjrkblocks)rn blocksizeoverlaprorprqrrrsrtrurmrvrwrxryrzr{blocks&&&&&&&&&&&&&&&& r}rrqsjf 4jF 5 589f5XXi&# AEKA 5 5 5 5sA*2A A* A' ! A*c@a]tRtRtoRtRt]R4tRtRt Vt R#)_SoundFileInfoizInformation about a SoundFilec>W n\V4;_uu_4pVPVnVPVnVPVnVP Vn\ VP 4VP, VnVPVnVPVn VPVn VPVn VPVn VPVn VPVnRRR4R# +'giR#;iN)verboserjnamermrvrorTdurationrwrxry format_info subtype_infosections extra_info)selfrnrr{s&&& r}__init___SoundFileInfo.__init__s t__DIllDOJJDM((DK!$++.q||;DM((DK99DL((DK }}D  !D JJDMllDO___s C'D  D c&\VPR4wr\V^<4wr4V^8dRPWV4pV#V^8dRPW44pV#V^8:dRPVP4pV#RPV4pV#)iz{0:.0g}:{1:02.0g}:{2:05.3f} hz{0:02.0g}:{1:05.3f} minz {0:d} samplesz {0:.3f} s)divmodrrwro)rhoursrestminutessecondsrs& r} _duration_str_SoundFileInfo._duration_strsT]]D1 !$+ A:6==egVH \077IH  \&--dkk:H#))'2HcRP.RO4pVP'dVRP.RO4, pRPVPPR44pVP W4#) )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 )joinrrsplitrw)rinfoindented_extra_infos& r}__repr___SoundFileInfo.__repr__skyy 89 <<< DII  D *//0E0Ed0KL{{455r) rvrryrrwrrorrmrrxrrN) __name__ __module__ __qualname____firstlineno____doc__rpropertyrr__static_attributes____classdictcell__ __classdict__s@r}rrs+'+   66rrc\W4#)zReturns an object with information about a `SoundFile`. Parameters ---------- verbose : bool Whether to print additional information. )r)rnrs&&r}rrs $ ((rcd\\\P\P44#)auReturn 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_MAJORrr}available_formatsrs-" )$*I*I*.*C*CE FFrc~a\\P\P4p\ V3RlV44#)a4Return 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'} c3^<"TF"wrSe\SV4'gKW3xK$ R#5ir) check_format).0rxrrws& r} %available_subtypes..s+DXMG>\&'%B Xs- -)rrSFC_GET_FORMAT_SUBTYPE_COUNTSFC_GET_FORMAT_SUBTYPEr)rwsubtypessf r}available_subtypesrs>"))J)J)-)D)DFH DXD DDrc^\\WV44# \\3dR#i;i)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)rwrxrys&&&r}rrs0K899  "s ,,c^\V4\PVP44#)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)rws&r}default_subtyper)s#&   00rc\a]tRtRtoRtR:Rlt]!R4t]!R4t]!R4t ]!R4t ]!R 4t ]!R 4t ]!R 4t ]!R 4t]!R 4t]!R4t]!R4t]!R4t]!R4t]!R4t]!R4t]R4tRtRtRtRtRtRtRtRtRtRt Rt!]"3Rlt#R t$R;R!lt%RR'lt+R(t,R)t-R*t.R+t/R,t0R-t1R.t2R/t3R0t4R1t5R2t6R3t7R4t8R5t9R6t:R7t;R8tR#)?rji9zA sound file. For more documentation see the __init__() docstring (which is also used for the online documentation (https://python-soundfile.readthedocs.io/). Nc  \VR4'dVP4MTpWnVf\VRR4p\ V4p W nWnWn\WW4WuV4Vn VPWV4Vn \V4PR4'd(VP4'dVP^4\ P#VP\ P$\&P(\ P*4VP eIVP-VP 4VPeVP/VP4R#R#R#)aAOpen 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+)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) rrnrrmrvrxryrwrzrrmode_ints &&&&&&&&&&& r}rSoundFile.__init__AsN%,D,$?$?t T <4.Dt$ "3)(Z)/&B ZZ8 t9   % %$--// IIaL  D$9$9499  &  " " .  ' '(?(? @!!-&&t'9'9:. /rcVP#r)rrs&r}SoundFile.rcVP#r)rrs&r}rrrrc.VPP#r)rrmrs&r}rrstzz'<'rcx\VPP\P,4^,#r)rrrwrrrs&r}rrs+\$**"3"3"&"8"8#9::;=rc.VPP#r)rrrs&r}rrrrcVPRJ#r)rrs&r}rrs 4::#5rc@\PVP4#r)rsf_errorrrs&r}rrst}}TZZ'@rcVP#r)rrs&r}rrs d.E.ErcVP#r)rrs&r}rrs ););rc \P!RR4p\PVP\P V\P !V44\P!V4PRR4#)z8Retrieve the log string generated when opening the file.zchar[]rfrgi@) rnewrrrSFC_GET_LOG_INFOsizeofstringdecode)rrs& r}rSoundFile.extra_infosXxx%(  D$9$9dkk$/ 1{{4 '';;rcVPeRPVP4MRpTVPeRPVP4MR, pRPW4#)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}))rrwr)rcompression_settings& r}rSoundFile.__repr__st"&"8"8"D 9??@V@VWJL #'#4#4#@!7 = =d>O>O PFH J*+1&*K Mrc&VP4R#rclosers&r}__del__SoundFile.__del__  rcV#rrrs&r} __enter__SoundFile.__enter__s rc&VP4R#rr)rargss&*r}__exit__SoundFile.__exit__rrc V\9dXVP4\PVP\V,VP 44p\ V4R#\PWV4R#)z:Write text meta-data in the sound file through properties.N) _str_types_check_if_closedr sf_set_stringrencode _error_checkobject __setattr__)rrvalueerrs&&& r}r-SoundFile.__setattr__sT :   ! ! #$$TZZD1A%*\\^5C     t5 1rc "V\9dlVP4\PVP\V,4pV'd'\ P !V4PRR4#R#\RPV44h)z9Read text meta-data in the sound file through properties.rfrgrz)'SoundFile' object has no attribute {0!r}) r'r(r sf_get_stringrrrrAttributeErrorrw)rrr|s&& r} __getattr__SoundFile.__getattr__sq :   ! ! #%%djj*T2BCDCG4;;t$++GY? OR O ;BB4HJ Jrc.VPP#rrrs&r}__len__SoundFile.__len__szz   rcR#)Trrs&r}__bool__SoundFile.__bool__src"VP4#r)r:rs&r} __nonzero__SoundFile.__nonzero__"s}}rc PVPP\P8H#)z)Return True if the file supports seeking.)rrrrrs&r}rSoundFile.seekable'szz""dll22rc VP4\PVPW4p\ VP 4V#)a Set 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 )r(rsf_seekrr+ _errorcode)rrowhencepositions&&& r}rSoundFile.seek+s6H << F;T__%rc .VP^\4#)z'Return the current read/write position.)rrrs&r}tellSoundFile.tellTsyyH%%rc Vf%VPW4pVPWV4pM"V^8gV\V48d \V4pVPRWQ4p\V4V8dVfVRVpV#WEVR%V#)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 Nrl) _check_frames_create_empty_arraylen _array_io)rrorrrsrtrus&&&&&&r}rlSoundFile.readXs` ;'';F**6eDCzVc#h.S4 s8f !'6l  *FG  rc VPVRR7pVPV4p\P!VR,WP,4pVP RWCV4pWQ8XgQh\P !V4#)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)rtz[]rl)rK _check_dtyperrrv _cdata_iobuffer)rrorrctypecdata read_framess&&& r} buffer_readSoundFile.buffer_readsq8##Ft#<!!%(v '=>nnVU6B $$${{5!!rc tVPV4pVPW4wrEVPRWCV4pV#)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 rl)rQ _check_bufferrR)rrSrrrTrUros&&& r}buffer_read_intoSoundFile.buffer_read_intos=8!!%(**69 f= rc ^RIpVPV4pVPRV\V44pV\V48XgQhVP V4R#)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 Nr)rascontiguousarrayrNrM_update_frames)rr|rwrittens&& r}rSoundFile.writesP\ ##D)..$D :#d)### G$rc VPV4pVPW4wrEVPRWCV4pWe8XgQhVPV4R#)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)rQrZrRr_)rr|rrrTrUror`s&&& r} buffer_writeSoundFile.buffer_write0sR*!!%(**47 ..%?    G$rc # "^RIpRVP9dRVP9d \R4hVPW64pVf6Vf \ R4hVeTM \ W4p VP WV4pRp MVe \ R4h\V4pRp Rp V^8dV f^p M\V 4p WRV %\ W, V4p VPWWVW|R4V'd"V fVPWr)R4p MWr)RV R &WV,8dVf VRW2,pMTpV 'dVPV4MTxW=,pKR#5i) 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' Nri+z*blocks() is not allowed in write-only modez)One of {blocksize, out} must be specifiedTz-Only one of {blocksize, out} may be specifiedFNNN) rrSoundFileRuntimeErrorrKrminrLrMrlcopy)rrrrorrrsrtrurout_sizecopy_outoverlap_memory output_offsettoreadrs&&&&&&&& r}rSoundFile.blocksKscd  dii Ctyy$8'(TU U##F7 ;  KLL$.$:yI@VH**8FCH$CEECIHqj% ! #N 3 &4N]#2F;F IIfYCYY[Foodjj$*@*@"hh}f="kk,79 -- +C!#'BC C" rc dVP4\PVP4R#)a:Write 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)r(r sf_write_syncrrs&r}flushSoundFile.flushs"  4::&rc VP'gDVP4\PVP4pRVn\ V4R#R#)z.Close the file. Can be called multiple times.N)closedryrsf_closerr+)rr/s& r}rSoundFile.closes:{{{ JJL-- +CDJ   rc 0\V\\34'EdW\PP V4'dRVP 9d%\RPVP44h\VP 4PR4'dO\P!\P!V\P\P,44\ P"p\V\4'dK\$P&R8Xd\ P(pM$VP+\$P,!44pV!WVP.4pM\V\04'd#\ P3WVP.V4pMt\5W4'd@\ P7VP9V4W P.\:P<4pM$\?RPVP44hV\:P<8Xd<\ PAV4p\CVRPVP4R7hV\ PD8Xd^VP.n#V#)z9Call the appropriate sf_open*() function from libsndfile.xzFile exists: {0!r}zw+r_zInvalid file: {0!r}zError opening {0!r}: prefix)$ isinstance_unicodebytes_ospathisfilerOSErrorrwrrrropenO_WRONLYO_TRUNCrsf_open_sysplatform sf_wchar_openr*getfilesystemencodingrrV sf_open_fd_has_virtual_io_attrssf_open_virtual_init_virtual_iorrrr rt SFM_WRITEro)rrnrrz openfunctionfile_ptrr/s&&&& r}rSoundFile._opens dXu- . .xxt$$$))#!"6"="=dii"HII^..t44IIchhtS\\CKK-GHI<.vio_get_filelens:99;D IIa "99;D IIdH %Kr sf_vio_seekcF<SPW4SP4#r)rrH)offsetrDrrns&&&r}vio_seek,SoundFile._init_virtual_io..vio_seeks IIf %99; r sf_vio_readc<\P!W4pSPV4pV# \d;SP T4p\ T4p\P!Y4pYS^T%T#i;ir)rrSreadintor3rlrM)ptrcountrbuf data_readr|rns&&& r}vio_read,SoundFile._init_virtual_io..vio_read sr (kk#- MM#.   " (yy'I kk#1#'Ai    (s',AA10A1 sf_vio_writect<\P!W4pVR,pSPV4pVfTpV#)rg)rrSr)rrrrr|r`rns&&& r} vio_write-SoundFile._init_virtual_io..vio_writes7++c)Cq6Djj&GNr sf_vio_tellc$<SP4#r)rH)rrns&r}vio_tell,SoundFile._init_virtual_io..vio_tell!s99; r get_filelenrrlrrHzSF_VIRTUAL_IO*)rcallback _virtual_ior)rrnrrrrrs&f r}rSoundFile._init_virtual_ios + ,  -  } %  &  } %  &  ~ &  '  } %  & *?"H"H#Y"H . xx($*:*:;;rc \#)zpReturn all attributes used in __setattr__ and __getattr__. This is useful for auto-completion (e.g. IPython). )r'rs&r}_getAttributeNamesSoundFile._getAttributeNames.s rc @VP'd \R4hR#)zuCheck 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)r|rhrs&r}r(SoundFile._check_if_closed6s ;;;'(FG G rc VP4'd7VPVP4, pV^8g W8dVfTpV#V^8d \R4hV#)z8Reduce frames to no more than are available in the file.z/frames must be specified for non-seekable files)rrorHr)rrortremaining_framess&&& r}rKSoundFile._check_frames?sZ ==??#{{TYY[8 zf7(0) aZNO O rc 4V\P49gQh\V\4'g\P !V4p\ \V4VP\P!V4,4wr4V'd \R4hW3#)z1Convert buffer to cdata and check for valid size.z*Data size must be a multiple of frame size) _ffi_typesvaluesrrr from_bufferrrMrvrr)rr|rTro remainders&&& r}rZSoundFile._check_bufferJsv ))++++$&&##D)D"3t9#'==4;;u3E#EG IJ J|rc ^RIpV'gVP^8dWP3pMV3pVPWSRR7#)z-Create an empty array with appropriate shape.NC)order)rrvempty)rrorsrrrrs&&&& r}rLSoundFile._create_empty_arrayUs9  )MM)EGExxCx00rc  \V,# \d8\RP\ \P 44T44hi;i)z7Check if dtype string is valid and return ctype string.z(dtype must be one of {0!r} and not {1!r})rKeyErrorrrwsortedkeys)rrrs&&r}rQSoundFile._check_dtype^sM 3e$ $ 3GNNz()523 3 3s AAc VPR9dA\RPVPVP^8d R44hR44hVP^8Xd^MVP^,pW@P8wd1\RPVPVPV44hVP P 'g \R4hVPVPP4pVPP\P!V48XgQh\P!VR,VPR,^,4pVPWWS4#) z+Check array and call low-level IO function.zInvalid shape: {0!r} ({1})z0 dimensions not supportedztoo many dimensionsz5Invalid shape: {0!r} (Expected {1} channels, got {2})zData must be C-contiguous*r|)r)rrrwrrvflags c_contiguousrQrrritemsizerrcast__array_interface__rR)ractionarrayroarray_channelsrTrUs&&&& r}rNSoundFile._array_iofsC ::U "9@@nsnxnx{|n|NjYZ ZCXYZ Z#jjAo5;;q> ]] *T[[\a\g\gimivivyGHI I{{'''89 9!!%++"2"23{{##t{{5'9999 %#+u'@'@'H'KL~~fU;;rc V\P49gQhVP4VP4'dVP 4p\ \ RV,R,V,4pV!VPW$4p\VP4VP4'dVPXV,\4V#)z.Call one of libsndfile's read/write functions.sf_f_) rrr(rrHrrrr+rCrr)rrr|rTrorfuncs&&&&& r}rRSoundFile._cdata_iots ))++++  ==??99;DtUV^d2U:;djj$/T__% ==?? IIdVmX . rc VP4'dNVP4pVP^\4VPnVPV\ 4R#VP;P V, unR#)z!Update self.frames after writing.N)rrHrrrror)rr`rs&& r}r_SoundFile._update_framessR ==??99;D $ !X 6DJJ  IIdH % JJ   ( rc VV^8wd"VP4'g \R4hV^8dVe \R4h\W4P VP 4wrpW!8dTpV^8d W!, pVP4'dVP V\4V#)z)Seek to start frame and calculate length.z(start is only allowed for seekable filesz&Only one of {frames, stop} may be used)rrrsliceindicesrorr)rrprqro_s&&&& r}rkSoundFile._prepare_reads A:dmmooGH H Q;4+DE Eu+33DKK@Q <D A:\F ==?? IIeX & rc /p\P4FWwr#\PVPV4pV'gK/\ P !V4PRR4W&KY V#)zGet 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'. rfrg)r'itemsrr2rrrr)rstrsstrtypestridr|s& r} copy_metadataSoundFile.copy_metadatas](..0NG%%djj%8Dt $ D 1 8 8) L 1 rc zV\9gQh\P!R4p\V,V^&\P VP \P V\P!V44pV\P8wd/\PVP 4p\VRV 24hR#)z,Call libsndfile's set bitrate mode function.zint[1]zError set bitrate mode N) _bitrate_modesrrrrrSFC_SET_BITRATE_MODErrr rt)rrpointer_bitrate_moder/s&& r}rSoundFile._set_bitrate_modes~---#xx1"0">Qoodjj$*C*CEY[_[f[fg{[|} $,, -- +C!#)@'OP P rc ^Tu;8:d^8:gM\R4h\P!R4pW^&\P VP \P V\P!V44pV\P8wd/\PVP 4p\VRV 24hR#)z1Call libsndfile's set compression level function.z)Compression level must be in range [0..1]z double[1]zError set compression level N) rrrrrrSFC_SET_COMPRESSION_LEVELrrr rt)rrpointer_compression_levelr/s&& r}r SoundFile._set_compression_levels&+!+HI I$(HH[$9!'8!$oodjj$*H*HJceiepeprKfLM $,, -- +C!#)EFWEX'YZ Z r)rrrrrrr) riNNNNNTNN)rQFNN)rN)NrrrQFNNr)?rrrrrrrrrrmrorvrwrxryrrrr|rCrrrrrrr r$r-r4r7r:r=rrrrHrlrWr[rrcrruryrrrrr(rKrZrLrQrNrRr_rkrrrrrrs@r}rjrj9s};~ + ,D* + ,D7<=J, 4 5F189H3 MOF-LNG4 LNF8 >?K? =>L:89H3 5 6F2@AJ' !EF,;** 88J DKDM D!T]]2 ?A A M# C188ABBC F5<> OrcTpVf+\W4p\V\\34'gQhM \ V4\ P !R4pRV9gVP4R8Xd>Vf \R4hW(n Vf \R4hW8n \WEV4Vn V#\;QJdRW#WuV34F 'gK RM RM!RW#WuV344'd \R 4hV#) z*Check arguments and create SF_INFO struct.rrirzsamplerate must be specifiedzchannels must be specifiedc3("TFqRJxK R#5irr)rargs& r}r&_create_info_struct..sI+H3$+HsTFz\Not allowed for existing files (except 'RAW'): samplerate, channels, format, subtype, endian)_get_format_from_filenamerrrrrrrrrmrvrrwany) rnrrmrvrwrxryoriginal_formatrs &&&&&&& r}rrsO ~*46&8S/2222f 88J D $&,,.E1  :; ;$  89 9 !&6: K 3Io+HI333Io+HI I ILM M Krc:Rp\VRV4p\PPV4R,R,pVP RR4pVP 4\9d"RV9d\RPV44hV# \ dLIi;i) 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). rr:rNNrfrgrizGNo format specified and unable to get format from file extension: {0!r}r) rrrsplitextr Exceptionr_formatsrrw)rnrrws&& r}rrsF 4 &D ""4(,R0w 2||~X%#T/006t > > M    s?B BBc\\\3F(pVP4Fwr#W08XgK Vuu# K* R#)z;Return the string representation of a given numeric format.zn/a)rrrr) format_int dictionarykvs& r}rr1s7 83 $$&DA'4 rcP\P!R4pWn\P \P W\P !R44VPp\VP4V'd(\P!V4PRR43#R3#)z6Return the ID and short description of a given format.zSF_FORMAT_INFO*SF_FORMAT_INFOrfrgr) rrrwrrrrrrrr)r format_flagrrs&& r}rr;s((,-K#OODII{KK 013   D  ** +<@DKK  $ $Wi 8 JJFH JJrc#"\P!R4p\P\PW\P !R44\ V^,4Fp\W14xK R#5i)z8Helper for available_formats() and available_subtypes().zint*rVN)rrrrrrranger) count_flagr!rrs&& r}rrFsM HHV EOODIIz$++e2DEE!Ho :33&sA8A:c\V\\34'g\RP V44h\ VP 4,pV# \d\RP T44hi;i)z4Check if `format_str` is valid and return format ID.zInvalid format: {0!r}zUnknown format: {0!r}) rrrrrwrrrr) format_strrs& r}rrNsu j8S/ 2 2/66zBCCEj..01   E077 CDDEs A&A;c  V\P8HpV\P8Hp\\ VR4\ VR4\ VR4;'gT\ VR4;'g\ VR4;'gT.4#)z>Check if file has all the necessary attributes for virtual IO.rrHrrlr)rr rallr)rnrreadonly writeonlys&& r}rrYsw4==(HDNN*I ffg**(fGGz!:GGi  rc]tRtRtRtRtR#)SoundFileErroriez-Base class for all soundfile-specific errors.rNrrrrrrrrr}r,r,es7rr,c]tRtRtRtRtR#)rhiizGsoundfile module runtime error. Errors that used to be `RuntimeError`.rNr-rrr}rhrhis . rrhcDa]tRtRtoRtRRlt]R4tRtRt Vt R#) rtiozVlibsndfile errors. Attributes ---------- code libsndfile internal error number. cJ\PWV4WnW nR#r)rhrcoder)rr1rs&&&r}rLibsndfileError.__init__xs&&t6:  rc VP'dF\PVP4p\P!V4P RR4#R#)zRaw libsndfile error message.rfrgz'(Garbled error message from libsndfile))r1rsf_error_numberrrr)rerr_strs& r} error_stringLibsndfileError.error_string}sB 999**4995G;;w'..w B B =rc<VPVP,#r)rr6rs&r}__str__LibsndfileError.__str__s{{T....r)r1rNr) rrrrrrrr6r9rrrs@r}rtrtos-  = =//rrt)aarch64 aarch64_bearmv8barmv8l) rrNrQFNNNNNNNT)NNNTNN)NrrrNrQFNNNNNNNT)Fr)NNr;)Rr __version__osrsysrrrr ctypes.utilr _find_library _soundfilerrunicoder NameErrorrr'rrrrrrrr]_machine_packaged_libnamer` _architecturerrw_soundfile_datardirname__file___pathr _full_pathdlopenr ImportErrorr_libname_explicit_libnameisdir _hbrew_pathrsf_version_stringr__libsndfile_version__ startswithrMrlrrr,rrrrrrrjr+rrrrrSFC_GET_FORMAT_INFOrrrrrr, RuntimeErrorrhrtrrr}r[sl  ++5"H  444 4 4 4 4 44 4    X  X  X  X    X    X   X  X  X  X  X  X  X  X  X   X! " X# $ X X X X X X X X X5 :#  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 j j j j   X X X  X   X  X X X X X X X Y X  X!" X#$ X%& X X X V X X X 5<x w U W   q :2 }} 0)HJ6A ' !:0 ?1  ( 4  _Q 7 * 4 A!6-/8:>@ @ ' !0 :F F 5  - :U B =>> HH  _55 6Eu&78J ;;z "D<T%;%;%=>EEgyY$$]333C 4F4GHZz6r8v16V16h)F*D.$ 1 I[I[X2 @&60*.)A)AJ4  Y  NL /+/u2HJ i(22 +  TU U{{8$ 2 ==H $ 2  ]]g % 0  ]]g % /   1 ==H $w)>25((..AU2V2V.& ;;sxx}}[:KLMD;;01D'22sOM#D3M3# M0/M03 Q??&N((BQ;00Q; Q?$Q;6Q?:Q;;Q?