+ LV-jwRt^RIt^RIt^RIt^RIt^RIt^RIt^RIH t .ROt !RR] 4t !RR4t !RR] 4t]P]P 0tR tR tRR ltR tR tRtRRltRtRtR#)z Module to read / write wav files using NumPy arrays Functions --------- `read`: Return the sample rate (in samples/sec) and data from a WAV file. `write`: Write a NumPy array as a WAV file. N)IntEnumWavFileWarningc]tRt^tRtRtR#)rz Warning for WAV files with format issues that can still be read. Raised when a WAV file has problems like missing metadata or non-standard formatting, but can still be processed successfully. N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__ra/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/scipy/io/wavfile.pyrrs   r cfa]tRt^%toRtRtR Rlt]P3Rlt Rt Rt Rt Rt VtR #) SeekEmulatingReaderz Tracks stream position, provides tell(), and emulates only those seeks that can be supported by reading forward. Other seeks raise io.UnsupportedOperation. Note that this class implements only the minimum necessary to keep wavfile.read() happy. c Wn^VnR#)N)readerpos)selfrs&&r __init__SeekEmulatingReader.__init__,s r cVPPV4pV;P\V4, unV#N)rreadrlen)rsizedatas"" r rSeekEmulatingReader.read0s-{{% CI r cT;\P8Xd?WP8d/VPWP, 4VP#;\P8Xd&V^8dVPV4VP#\P 8Xd$V^8XdVP4VP#\ P!R4h)rzNSeekEmulatingReader was asked to emulate a seek operation it does not support.)osSEEK_SETrrSEEK_CURSEEK_ENDioUnsupportedOperation)roffsetwhences"""r seekSeekEmulatingReader.seek5s(( 2 &88+,xx!  &! xx !  xx--/WXXr cVP#r)rrs&r tellSeekEmulatingReader.tellBs xxr c:VPP4R#r)rcloser*s&r r.SeekEmulatingReader.closeEs r c.\P!R4h)z SeekEmulatingReader can't flush.)r#r$r*s&r flushSeekEmulatingReader.flushJs%%&HIIr )rrN))rrrr r rrrr r'r+r.r1r __classdictcell__) __classdict__s@r rr%s8  #%++  JJr rcn]tRt^NtRt^t^t^t^t^t ^t ^t ^t ^t ^ t^ t^ t^t^t^t^t^t^t^t^t^t^t^t^t^ t^!t^"t^#t ^$t!^%t"^&t#^'t$^(t%^0t&^1t'^2t(^3t)^4t*^5t+^6t,^7t-^8t.^9t/^:t0^;t1^^`t?^at@^btA^ctB^dtC^etD^ftE^gtF^itG^ptH^qtI^rtJ^stK^ttL^utM^vtN^wtO^xtP^ytQ^ztR^{tS^tT^tU^tV^tW^tX^tY^tZ^t[^t\^t]^t^^t_^t`^ta^tb^tc^td^te^tf^tg^th^ti^tj^tk^tl^tm^tnRtoRtpRtqRtrRtsRttRtuR tvR twR txR tyR tzRt{Rt|Rt}Rt~RtRtRtRtRtRtRtRtRtRtRtRtRtRtR tR!tR"tR#tR$tR%tR&tR'tR(tR)tR*tR+tR,tR-tR.tR/tR0tR1tR2tR3tR4tR5tR6tR7tR8tR9tR:tR;tRtR?tR@tRAtRBtRCtRDtREtRFtRGtRHtRItRJtRKtRLtRMtRNtROtRPtRQtRRtRStRTtRUtRVtRWtRXtRYtRZtR[tR\tR]tR^tR_tR`tRatRbtRctRdtRetRftRgtRhtRitRjtRktRltRmtRntRotRptRqtRrtRstRttRutRvtRwtRxtRytRztR{tR|tR}tR~tRtRtRtRtRtRtRtRtRtRtRtRtRtRtRtRtRtRtRtRtREtREtREtREtREtREtREtREtREtREt REt REt REt REt REtREtREtREtR#) WAVE_FORMATz WAVE form wFormatTag IDs Complete list is in mmreg.h in Windows 10 SDK. ALAC and OPUS are the newest additions, in v10.0.14393 2016-07 iiii i!i#i%i0i1i2i3i4i5i6i@iAiBiPiQiUi`iaibicidipiqirisitiuiviwixiiiiiiiii i0i@iAiIiPiQi`ipiqirisiiiiiPiQiiiiPiiiiiiiiiiiiiiiiiiiiiii i i iiiqiyii iii i i3iCAiBiCBiLCiLViVWiOgiPgiQgiogipgiqgialipiOpimpiasibsicsi!zi"ziiiiiiiiii i i i i iiiiiiiiiiiiiiiiiii i!i"i#i$iiirN(rrrr r UNKNOWNPCMADPCM IEEE_FLOATVSELPIBM_CVSDALAWMULAWDTSDRM WMAVOICE9 WMAVOICE10 OKI_ADPCM DVI_ADPCM IMA_ADPCMMEDIASPACE_ADPCM SIERRA_ADPCM G723_ADPCMDIGISTDDIGIFIXDIALOGIC_OKI_ADPCMMEDIAVISION_ADPCMCU_CODEC HP_DYN_VOICE YAMAHA_ADPCMSONARCDSPGROUP_TRUESPEECHECHOSC1AUDIOFILE_AF36APTXAUDIOFILE_AF10 PROSODY_1612LRC DOLBY_AC2GSM610MSNAUDIO ANTEX_ADPCMECONTROL_RES_VQLPCDIGIREAL DIGIADPCMCONTROL_RES_CR10 NMS_VBXADPCM CS_IMAADPCMECHOSC3ROCKWELL_ADPCMROCKWELL_DIGITALKXEBEC G721_ADPCM G728_CELPMSG723 INTEL_G723_1 INTEL_G729 SHARP_G726MPEGRT24PAC MPEGLAYER3 LUCENT_G723CIRRUSESPCMVOXWARE CANOPUS_ATRAC G726_ADPCM G722_ADPCMDSAT DSAT_DISPLAYVOXWARE_BYTE_ALIGNED VOXWARE_AC8 VOXWARE_AC10 VOXWARE_AC16 VOXWARE_AC20 VOXWARE_RT24 VOXWARE_RT29VOXWARE_RT29HW VOXWARE_VR12 VOXWARE_VR18 VOXWARE_TQ40 VOXWARE_SC3 VOXWARE_SC3_1 SOFTSOUND VOXWARE_TQ60MSRT24G729AMVI_MVI2DF_G726 DF_GSM610ISIAUDIOONLIVEMULTITUDE_FT_SX20INFOCOM_ITS_G721_ADPCM CONVEDIA_G729 CONGRUENCYSBC24DOLBY_AC3_SPDIFMEDIASONIC_G723 PROSODY_8KBPS ZYXEL_ADPCM PHILIPS_LPCBBPACKEDMALDEN_PHONYTALKRACAL_RECORDER_GSMRACAL_RECORDER_G720_ARACAL_RECORDER_G723_1RACAL_RECORDER_TETRA_ACELPNEC_AACRAW_AAC1RHETOREX_ADPCMIRAT VIVO_G723 VIVO_SIREN PHILIPS_CELPPHILIPS_GRUNDIG DIGITAL_G723SANYO_LD_ADPCMSIPROLAB_ACEPLNETSIPROLAB_ACELP4800SIPROLAB_ACELP8V3 SIPROLAB_G729SIPROLAB_G729ASIPROLAB_KELVIN VOICEAGE_AMR G726ADPCMDICTAPHONE_CELP68DICTAPHONE_CELP54QUALCOMM_PUREVOICEQUALCOMM_HALFRATETUBGSMMSAUDIO1WMAUDIO2WMAUDIO3WMAUDIO_LOSSLESSWMASPDIFUNISYS_NAP_ADPCMUNISYS_NAP_ULAWUNISYS_NAP_ALAWUNISYS_NAP_16KSYCOM_ACM_SYC008SYCOM_ACM_SYC701_G726LSYCOM_ACM_SYC701_CELP54SYCOM_ACM_SYC701_CELP68KNOWLEDGE_ADVENTURE_ADPCMFRAUNHOFER_IIS_MPEG2_AACDTS_DSCREATIVE_ADPCMCREATIVE_FASTSPEECH8CREATIVE_FASTSPEECH10 UHER_ADPCMULEAD_DV_AUDIOULEAD_DV_AUDIO_1 QUARTERDECKILINK_VC RAW_SPORTESST_AC3GENERIC_PASSTHRUIPI_HSX IPI_RPELPCS2SONY_SCXSONY_SCY SONY_ATRAC3SONY_SPC TELUM_AUDIOTELUM_IA_AUDIONORCOM_VOICE_SYSTEMS_ADPCM FM_TOWNS_SNDMICRONASMICRONAS_CELP833 BTV_DIGITALINTEL_MUSIC_CODER INDEO_AUDIO QDESIGN_MUSIC ON2_VP7_AUDIO ON2_VP6_AUDIO VME_VMPCMTPCLIGHTWAVE_LOSSLESSOLIGSMOLIADPCMOLICELPOLISBCOLIOPRLH_CODEC LH_CODEC_CELP LH_CODEC_SBC8LH_CODEC_SBC12LH_CODEC_SBC16NORRIS ISIAUDIO_2SOUNDSPACE_MUSICOMPRESS MPEG_ADTS_AAC MPEG_RAW_AAC MPEG_LOASNOKIA_MPEG_ADTS_AACNOKIA_MPEG_RAW_AACVODAFONE_MPEG_ADTS_AACVODAFONE_MPEG_RAW_AAC MPEG_HEAACVOXWARE_RT24_SPEECHSONICFOUNDRY_LOSSLESSINNINGS_TELECOM_ADPCMLUCENT_SX8300PLUCENT_SX5363SCUSEEMENTCSOFT_ALF2CM_ACMDVMDTS2MAKEAVISDIVIO_MPEG4_AACNOKIA_ADAPTIVE_MULTIRATE DIVIO_G726 LEAD_SPEECH LEAD_VORBIS WAVPACK_AUDIOOGG_VORBIS_MODE_1OGG_VORBIS_MODE_2OGG_VORBIS_MODE_3OGG_VORBIS_MODE_1_PLUSOGG_VORBIS_MODE_2_PLUSOGG_VORBIS_MODE_3_PLUSALAC _3COM_NBXOPUSFAAD_AACAMR_NBAMR_WBAMR_WP GSM_AMR_CBRGSM_AMR_VBR_SIDCOMVERSE_INFOSYS_G723_1COMVERSE_INFOSYS_AVQSBCCOMVERSE_INFOSYS_SBC SYMBOL_G729_AVOICEAGE_AMR_WBINGENIENT_G726 MPEG4_AAC ENCORE_G726 ZOLL_ASAO SPEEX_VOICE VIANIX_MASCWM9_SPECTRUM_ANALYZERWMF_SPECTRUM_ANAYZERGSM_610GSM_620GSM_660GSM_690GSM_ADAPTIVE_MULTIRATE_WB POLYCOM_G722 POLYCOM_G728POLYCOM_G729_A POLYCOM_SIRENGLOBAL_IP_ILBCRADIOTIME_TIME_SHIFT_RADIONICE_ACA NICE_ADPCM VOCORD_G721 VOCORD_G726 VOCORD_G722_1 VOCORD_G728 VOCORD_G729 VOCORD_G729_A VOCORD_G723_1 VOCORD_LBC NICE_G728FRACE_TELECOM_G729CODIANFLAC EXTENSIBLE DEVELOPMENTr rr r r7r7Ns G C EJ EH D E C CIJIIILJGGHLL F GN DNL CI FHLHILKGN EJI FLJJ D D CJK F EGMJJ DL!KLLLLLNLLLKMIL F EHGIH F#MJ EOOMKM F""!'GHN DIJLOLNMNOLI FHHHHOON#$$ &% FN!"JNKHIHGI CHHKHKN!'LHKKMMMI C FHG F FHMMNN FJ$MLI #"J ""NNG C DHO%JKKM### DI DH F F FKO$$!MONIKIKK"!GGGG &LLNMN!'HJKKMKKMMJI F DJKr r7c\V4Pp\RV R2RPR\44,4h \dTR pLAi;i)z#06xzUnknown wave file format: z. Supported formats: z, c38"TFqPxK R#5ir)name).0xs& r $_raise_bad_format..msB/A!vv/As)r7rG ValueErrorjoinKNOWN_WAVE_FORMATS) format_tag format_names& r _raise_bad_formatrQfsm+!*-22  1+?!!YYB/ABBC DD +#D) +sAAAcV'dRpMRp\P!VR,VP^44^,pV^8d \R4h\P!VR,VP^44p^pVwrgrrV\P 8XdV^8d\P!VR,VP^44^,p V^, pV ^8dqVP^4p V^, pV ^^pV'dRpMRpVP V4'd-\P!VR,VR ,4^,pM \R4hV\9d \V4W58dVPW5, 4\W4V\P8Xd"WV ,8wd\R V R V R V 24hW6WxWV 3#) a Returns ------- size : int size of format subchunk in bytes (minus 8 for "fmt " and itself) format_tag : int PCM, float, or compressed format channels : int number of channels fs : int sampling frequency in samples per second bytes_per_second : int overall byte rate for the file block_align : int bytes per sample, including all channels bit_depth : int bits per sample Notes ----- Assumes file pointer is immediately after the 'fmt ' id ><Iz.Binary structure of wave file is not compliantHHIIHHHs 8qs 8q:NNz{WAV header is invalid: nAvgBytesPerSec must equal product of nSamplesPerSec and nBlockAlign, but file has nSamplesPerSec = z, nBlockAlign = z, and nAvgBytesPerSec = ) structunpackrrLr7rCendswithrNrQ_handle_pad_byter:)fid is_big_endianfmtrres bytes_readrOchannelsfsbytes_per_second block_align bit_depthext_chunk_sizeextensible_chunk_dataraw_guidtails&& r _read_fmt_chunkrkps. ==S#((1+ .q 1D byIJJ --H chhrl 3CJILFJ" [+++s3w ^Tu;8:d^8:dMMRp MfV R9dRp M\V^@8:d V RV 2p MM\ RV R24hV\P 8XdVR9d V R V 2p M\ RV R 24h\V4VP4pV'gX R8XdT MT p\P!W VR 7pV R8XdV ^8XdV R 2MV R2p\P!\!V4V ,\P"!V4P$3RR 7pV'dVP'RV 34VRRV 13&MVP'RV 34VRV )R13&VP)V4P'VP*RR4pMZV R9dEVP4p\P,!VX RVV 3R7pVPW,4M\ RV R24h\/W 4V^8dVP'RV4pV# \Pd>TPT^4\P!TPT 4X R 7pELi;i)a Notes ----- Assumes file pointer is immediately after the 'data' id It's possible to not use all available bits in a container, or to store samples in a container bigger than necessary, so bytes_per_sample uses the actual reported container size (nBlockAlign / nChannels). Real-world examples: Adobe Audition's "24-bit packed int (type 1, 20-bit)" nChannels = 2, nBlockAlign = 6, wBitsPerSample = 20 http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/Samples/AFsp/M1F1-int12-AFsp.wav is: nChannels = 2, nBlockAlign = 4, wBitsPerSample = 12 http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/Docs/multichaudP.pdf gives an example of: nChannels = 2, nBlockAlign = 8, wBitsPerSample = 20 rSrTrUu1V1iz(Unsupported bit depth: the WAV file has z-bit integer data.fz-bit floating-point data.)dtypecount)rqi4i8:NNNNc)rqmoder%shapezmmap=True not compatible with z-byte container size.>> @r3>rX)rYrZrr7r:rLr<rQr+npfromfiler#r$r' frombufferzerosrrqitemsizereshapeviewrwmemmapr\)r]rOrbrfr^is_rf64remmaprf64_chunk_sizer_rbytes_per_sample n_samplesrqstartrrrdtas&&&&&&&&& r _read_data_chunkrs4 }}SWchhqk215  #.(I[__$ Q E  -E "_e1-./E$$-;.@BC C {-- -  e1-./E$$-;.GIJ J *% HHJE  >!TMDyE;;su=D D=/14C5SE*B#d)'77"9N9NO"&(A*.,, HHUA ==$u=D >s#JAKKcV'dRpMRpVP^4pV'd=\P!W#4^,pVPV^4\ W4R#R#)>I>> from os.path import dirname, join as pjoin >>> from scipy.io import wavfile >>> import scipy.io Get the filename for an example .wav file from the tests/data directory. >>> data_dir = pjoin(dirname(scipy.io.__file__), 'tests', 'data') >>> wav_fname = pjoin(data_dir, 'test-44100Hz-2ch-32bit-float-be.wav') Load the .wav file contents. >>> samplerate, data = wavfile.read(wav_fname) >>> print(f"number of channels = {data.shape[1]}") number of channels = 2 >>> length = data.shape[0] / samplerate >>> print(f"length = {length}s") length = 0.01s Plot the waveform. >>> import matplotlib.pyplot as plt >>> import numpy as np >>> time = np.linspace(0., length, data.shape[0]) >>> plt.plot(time, data[:, 0], label="Left channel") >>> plt.plot(time, data[:, 1], label="Right channel") >>> plt.legend() >>> plt.xlabel("Time [s]") >>> plt.ylabel("Amplitude") >>> plt.show() rFrbz%Reached EOF prematurely; finished at dz bytes, expected z bytes from header.) stacklevelzUnexpected end of file.zIncomplete chunk ID: z, ignoring it.fmt T:r~rXNfactdatazNo fmt chunk before datasLISTz-Chunk (non-data) not understood, skipping it.>FakeJUNK)hasattropenseekablerrr+rwarningswarnrrLrrrkrrr.r')filenamerr] was_seekablerr^rrfmt_chunk_receiveddata_chunk_receivedchunk_idmsg fmt_chunkrOrbrcrfrers&& r rrgs<Lx  8T"LLN *L *!#&:=Mc=R: '"#hhj9$xx{H&MM? 1~N$$-a=0CE&16$%>??X"-d8n-=>%*=MM#(8"8.-.0%S/)7"%)"+C? +4S>( b%aL 'l W$#C7W$&*#)$%?@@'Z9(5 (,?W$#C7//#C7 M,<#C7x(( IIK t8O  HHQK t8Ox(( IIK  HHQKs.AI IA.IB I A4I+J.Jc  \VR4'dTpM \VR4pTpVPPp.ROpVPPV9d\ RVP R24hRpVR, pVR, pVR, pVR , pVR 8Xd\ PpM\ PpVP^8Xd^p MVP^,p VPP^,p WJ^,,V ,p W^,,p \P!R WVWV 4p VR 8XgVR 8Xg V R, p V\P!R\V 44, pW}, p\V4^,^,VP,pV^, R8pV'EdRpVR, pVR, pVR, pVR, pV\P!R^4, pV\P!R^4, pV\P!RVP4, pV\P!RVP^,4, pV\P!R^4, pVR , pV\P!R\V 44, pW}, pVR 8XgAVR 8Xg:VR, pV\P!R^VP^,4, pVP!V4VP!R4VP!\P!R\#VPR444VPP$R8Xg1VPP$R8Xd&\&P$R8XdVP)4p\+W24VP-4pV'g@VP/^4VP!\P!RV^, 44M>VP/^4VP!\P!RV^, 44\VR4'gVP14R#VP/^4R# \TR4'gTP14iTP/^4i;i)aS Write a NumPy array as a WAV file. Parameters ---------- filename : string or open file handle Output wav file. rate : int The sample rate (in samples/sec). data : ndarray A 1-D or 2-D NumPy array of either integer or float data-type. Notes ----- * Writes a simple uncompressed WAV file. * To write multiple-channels, use a 2-D array of shape (Nsamples, Nchannels). * The bits-per-sample and PCM/float will be determined by the data-type. Common data types: [1]_ ===================== =========== =========== ============= WAV format Min Max NumPy dtype ===================== =========== =========== ============= 32-bit floating-point -1.0 +1.0 float32 32-bit PCM -2147483648 +2147483647 int32 16-bit PCM -32768 +32767 int16 8-bit PCM 0 255 uint8 ===================== =========== =========== ============= Note that 8-bit PCM is unsigned. References ---------- .. [1] IBM Corporation and Microsoft Corporation, "Multimedia Programming Interface and Data Specifications 1.0", section "Data Format of the Samples", August 1991 http://www.tactilemedia.com/info/MCI_Control_Info.html Examples -------- Create a 100Hz sine wave, sampled at 44100Hz. Write to 16-bit PCM, Mono. >>> from scipy.io.wavfile import write >>> import numpy as np >>> samplerate = 44100; fs = 100 >>> t = np.linspace(0., 1., samplerate) >>> amplitude = np.iinfo(np.int16).max >>> data = amplitude * np.sin(2. * np.pi * fs * t) >>> write("example.wav", samplerate, data.astype(np.int16)) writewbzUnsupported data type ''r rsrrrpz ::??. 06tzzl!DE E w ** w  w C<$//J$J 99>Hzz!}HJJ''!+ A~.x7q.1 Y b%5IO  k )Nv{{4^)<== % "+.2Q6D&*j8 7K 7 "K . .K 7 "K 7 "K 6;;tR0 0K 6;;tQ/ /K 6;;tT[[9 9K 6;;tTZZ]; ;K 6;;tQ/ /K 7 "K 6;;tS-@A AK  )K  7 "K 6;;uaA? ?K + ' &++dC Z$@AB ::  3 &4::+?+?3+F+.==E+A==?Dc xxz HHQK IIfkk$Q/ 0 HHRL IIfkk$Q/ 0x)) IIK HHQKx)) IIK HHQKs QR--6S#cvVPVP4PR4P4R#)bN)rravelrr)r]rs&&r rrs%IIdjjl$))*r )rrr)FN)F)r r#rrnumpyrrYrenumr__all__ UserWarningrrr7r:r<rNrQrkrrrr\rrrrr r rs     [ &J&JRR'Rj"oo{'='=>DL^bJ$"(>Vk\Vr+r