(phoSrSSKrSSKrSSKrSSKrSSKrSSKJr /SQr "SS\ 5r "SS\5r \ R\ R1rS rS rSS jrS rS rSrSSjrSrSrg)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)IntEnum)WavFileWarningreadwritec\rSrSrSrg)rN)__name__ __module__ __qualname____firstlineno____static_attributes__r C/var/www/html/venv/lib/python3.13/site-packages/scipy/io/wavfile.pyrrsrrc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr Sr!Sr"S r#S!r$S"r%S#r&S$r'S%r(S&r)S'r*S(r+S)r,S*r-S+r.S,r/S-r0S.r1S/r2S0r3S1r4S2r5S3r6S4r7S5r8S6r9S7r:S8r;S9rSrAS?rBS@rCSArDSBrESCrFSDrGSErHSFrISGrJSHrKSIrLSJrMSKrNSLrOSMrPSNrQSOrRSPrSSQrTSRrUSSrVSTrWSUrXSVrYSWrZSXr[SYr\SZr]S[r^S\r_S]r`S^raS_rbS`rcSardSbreScrfSdrgSerhSfriSgrjShrkSirlSjrmSkrnSlroSmrpSnrqSorrSprsSqrtSrruSsrvStrwSurxSvrySwrzSxr{Syr|Szr}S{r~S|rS}rS~rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSGrSGrSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGr GSGr GSGr GS Gr GS Gr GS GrGS GrGS GrGSGrGg( 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 r r !"#$%&'(0123456789:;<=@ABCDEPRSUY`abcdefgipqrstuvwxyz{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$iiir N(r r r r __doc__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 DEVELOPMENTrr rrrrs 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 DJKrrc[U5Rn[SUS3SRS[55-5e![a USnN$_raise_bad_format..=sB/A!vv/As)rr ValueErrorjoinKNOWN_WAVE_FORMATS) format_tag format_names r_raise_bad_formatr6sm+!*-22  1+?!!YYB/ABBC DD +#D) +sAAAcFU(aSnOSn[R"US-URS55SnUS:a [S5e[R"US-URS55nSnUupgppU[R :XaUS :a[R"US -URS 55Sn US - nU S :a^URS 5n US - nU S S nU(aSnOSnUR U5(a [R"US-USS5SnO [S5eU[;a [U5 X5:aURX5- 5 [X5 U[R:XaXU -:wa[SUSU SU 35eX6XxXU 4$)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 ><Irrrz.Binary structure of wave file is not compliantHHIIHHr!Hrr%rs 8qs 8qNz{WAV header is invalid: nAvgBytesPerSec must equal product of nSamplesPerSec and nBlockAlign, but file has nSamplesPerSec = z, nBlockAlign = z, and nAvgBytesPerSec = ) structunpackrrrrendswithrr_handle_pad_byter~)fid is_big_endianfmtsizeres bytes_readrchannelsfsbytes_per_second block_align bit_depthext_chunk_sizeextensible_chunk_dataraw_guidtails r_read_fmt_chunkr@s. ==S#((1+ .q 1D byIJJ --H chhrl 3CJILFJ" [+++s3w rrrrV1r@iz(Unsupported bit depth: the WAV file has z-bit integer data.>r)r@fz-bit floating-point data.)dtypecount)rri4i8N>rrrrc)rmodeoffsetshapezmmap=True not compatible with z-byte container size.)rrrtellseekrr~rrrnpfromfileioUnsupportedOperation frombufferzeroslenritemsizereshapeviewrmemmapr)rrrrris_rf64rmmaprrposbytes_per_sample n_samplesrstartrdatadtas r_read_data_chunkrs4 }}SWchhqk215hhj  }}T388A;/2    #.(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 >sJ22A L?LcU(aSnOSnURS5nU(a7[R"X#5SnURUS5 [ X5 gg)N>IUS-(aURSS5 gg)Nrr)r)rrs rrr1s ax Arc f[US5(aUnSnO [US5n[U5up4nSnSnUR5U:GauUR S5nU(dEU(a3[ R "SUR5SSUSS3[S S 9 GO#[S 5e[U5S:aES [U53n U(a%U(a[ R "U S -[S S 9 O [U 5eUS:Xa Sn[X$5n U SSupn U SnU SnOUS:Xa [X$5 OuUS:Xa&SnU(d [S5e[UW W WXEWU5nOIUS:Xa [X$5 O7US;a [X$5 O%[ R "S[S S 9 [X$5 UR5U:aGMu[US5(dUR5 W W4$URS5 W W4$![US5(dUR5 fURS5 f=f)a Open a WAV file. Return the sample rate (in samples/sec) and data from an LPCM WAV file. Parameters ---------- filename : string or open file handle Input WAV file. mmap : bool, optional Whether to read data as memory-mapped (default: False). Not compatible with some bit depths; see Notes. Only to be used on real files. .. versionadded:: 0.12.0 Returns ------- rate : int Sample rate of WAV file. data : numpy array Data read from WAV file. Data-type is determined from the file; see Notes. Data is 1-D for 1-channel WAV, or 2-D of shape (Nsamples, Nchannels) otherwise. If a file-like input without a C-like file descriptor (e.g., :class:`python:io.BytesIO`) is passed, this will not be writeable. Notes ----- Common data types: [1]_ ===================== =========== =========== ============= WAV format Min Max NumPy dtype ===================== =========== =========== ============= 32-bit floating-point -1.0 +1.0 float32 32-bit integer PCM -2147483648 +2147483647 int32 24-bit integer PCM -2147483648 +2147483392 int32 16-bit integer PCM -32768 +32767 int16 8-bit integer PCM 0 255 uint8 ===================== =========== =========== ============= WAV files can specify arbitrary bit depth, and this function supports reading any integer PCM depth from 1 to 64 bits. Data is returned in the smallest compatible numpy int type, in left-justified format. 8-bit and lower is unsigned, while 9-bit and higher is signed. For example, 24-bit data will be stored as int32, with the MSB of the 24-bit data stored at the MSB of the int32, and typically the least significant byte is 0x00. (However, if a file actually contains data past its specified bit depth, those bits will be read and output, too. [2]_) This bit justification and sign matches WAV's native internal format, which allows memory mapping of WAV files that use 1, 2, 4, or 8 bytes per sample (so 24-bit files cannot be memory-mapped, but 32-bit can). IEEE float PCM in 32- or 64-bit format is supported, with or without mmap. Values exceeding [-1, +1] are not clipped. Non-linear PCM (mu-law, A-law) is not supported. 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 .. [2] Adobe Systems Incorporated, "Adobe Audition 3 User Guide", section "Audio file formats: 24-bit Packed Int (type 1, 20-bit)", 2007 Examples -------- >>> 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() rFrbrz%Reached EOF prematurely; finished at dz bytes, expected z bytes from header.r) stacklevelzUnexpected end of file.zIncomplete chunk ID: z, ignoring it.fmt TrrrfactdatazNo fmt chunk before datasLIST>FakeJUNKz-Chunk (non-data) not understood, skipping it.r)hasattropenrrrwarningswarnrrrrrrrcloser)filenamerrrrrfmt_chunk_receiveddata_chunk_receivedchunk_idmsg fmt_chunkrrrrrrs rrr8s&Lx  8T"7,??X"-d8n-=>%*=MM#(8"8.-.0%S/)7"%)"+C? +4Qq>( b%aL 'l W$#C7W$&*#)$%?@@'Z9(5 TSW$#C7//#C7 M,<#C7]hhj9$`x(( IIK t8O HHQK t8O x(( IIK HHQKs FG;;5H0c [US5(aUnO [US5nUnURRn/SQnURRU;a[ SURS35eSnUS- nUS- nUS - nUS - nUS :Xa[ RnO[ RnURS :XaS n OURS n URRS -n XJS --U -n XS --n [R"SXUXU 5n US:Xd US:XdU S- n U[R"S[U 55- nX}- n[U5S-S-UR-nUS - S:nU(aSnUS- nUS- nUS - nUS- nU[R"SS5- nU[R"SS5- nU[R"SUR5- nU[R"SURS5- nU[R"SS5- nUS - nU[R"S[U 55- nX}- nUS:Xd3US:Xd-US- nU[R"SSURS5- nUR!U5 UR!S5 UR![R"S[#URS555 URR$S:Xd.URR$S:Xa$[&R$S :XaUR)5n[+X25 UR-5nU(d;UR/S5 UR![R"SUS - 55 O:UR/S!5 UR![R"SUS - 55 [US5(dUR15 g"UR/S5 g"![US5(dUR15 fUR/S5 f=f)#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)) rwb)float32float64uint8int16int32int64zUnsupported data type ''rrsrrrrrz ::??. 06tzzl!DE E w ** w  w C<$//J$J 99>Hzz!}HJJ''!+ A~.x7q.1 Y b%5IO  k )Nv{{4^)<== % "+.2Q6D&*j8 K 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 N4P 5QctURUR5RS5R5 g)Nb)rravelrr)rrs rrrys%IIdjjl$))*r)F)r|rrnumpyrrrenumr__all__ UserWarningrrr~rrrrrrrrrrrr rrrs     [ R'Rj"oo{'='=>DL`(-eP$"&-RePVr+r