9iwSrSSKrSSKrSSKrSSKrSSKrSSKrSSKJ r /SQr "SS\ 5r "SS5r "S S \ 5r\R\R 1rS rS rSS jrSrSrSrSSjrSrSrg)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 P/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/scipy/io/wavfile.pyrrsrrcZ\rSrSrSrSrS Sjr\R4Sjr Sr Sr Sr S r g ) 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. cXlSUlg)Nr)readerpos)selfrs r__init__SeekEmulatingReader.__init__&s rcxURRU5nU=R[U5- slU$N)rrrlen)rsizedatas rrSeekEmulatingReader.read*s-{{% CI rcU=[R:Xa9XR:a* URXR- 5 UR$=[R:Xa$US:a URU5 UR$[R :Xa"US:XaUR5 UR$[ R"S5e)NrzNSeekEmulatingReader was asked to emulate a seek operation it does not support.)osSEEK_SETrrSEEK_CURSEEK_ENDioUnsupportedOperation)roffsetwhences rseekSeekEmulatingReader.seek/s(( 2 &88+,xx!  &! xx !  xx--/WXXrcUR$r)rrs rtellSeekEmulatingReader.tell<s xxrc8URR5 gr)rcloser,s rr0SeekEmulatingReader.close?s rc.[R"S5e)Nz SeekEmulatingReader can't flush.)r%r&r,s rflushSeekEmulatingReader.flushDs%%&HIIr)rrN))r r r r __doc__rrr!r"r)r-r0r3rr rrrrs/  #%++  Jrrc\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_FORMATHz 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  !"#$%&'(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 r6UNKNOWNPCMADPCM 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 rrr8r8Hs 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 DJKrr8c[U5Rn[SUS3SRS[55-5e![a USnN$_raise_bad_format..gsB/A!vv/As)r8r ValueErrorjoinKNOWN_WAVE_FORMATS) format_tag format_names r_raise_bad_formatr`sm+!*-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 ><Ir=rrEz.Binary structure of wave file is not compliantHHIIHHrGHr;rKr?s 8qs 8qNz{WAV header is invalid: nAvgBytesPerSec must equal product of nSamplesPerSec and nBlockAlign, but file has nSamplesPerSec = z, nBlockAlign = z, and nAvgBytesPerSec = ) structunpackrrr8rendswithrr_handle_pad_byter)fid is_big_endianfmtrres bytes_readrchannelsfsbytes_per_second block_align bit_depthext_chunk_sizeextensible_chunk_dataraw_guidtails r_read_fmt_chunkrjs. ==S#((1+ .q 1D byIJJ --H chhrl 3CJILFJ" [+++s3w r<r>r?r@V1rgiz(Unsupported bit depth: the WAV file has z-bit integer data.>rPrgfz-bit floating-point data.)dtypecount)rr<i4i8r5N>r:r;r=rAc)rmoder'shapezmmap=True not compatible with z-byte container size.)rrrr8rrrrr-npfromfiler%r&r) frombufferzerosrritemsizereshapeviewrmemmapr)rrrrris_rf64rmmaprf64_chunk_sizerrbytes_per_sample n_samplesrstartrrdtas 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=IA J'&J'cU(aSnOSnURS5nU(a7[R"X#5SnURUS5 [ X5 gg)N>IUS-(aURSS5 gg)Nr;r:)r))rrs rrrZs ax Arc [US5(aUnSnO [US5nUR5=n(d [U5n[ U5upEpgSnSn UR 5U:GauUR S5n U (dEU (a3[R"SUR 5SSUSS3[S S 9 GO#[S 5e[U 5S:aES [U 53n U(a%U (a[R"U S -[S S 9 O [U 5eU S:Xa Sn[X%5n U SSupnU SnU SnOU S:Xa [X%5 OuU S:Xa&Sn U(d [S5e[UW WWXVWX5 nOIU S:Xa [X%5 O7U S;a [X%5 O%[R"S[S S 9 [X%5 UR 5U:aGMu[US5(dUR!5 WW4$U(aUR#S5 WW4$![US5(dUR!5 fU(aUR#S5 ff=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() rFrbr=z%Reached EOF prematurely; finished at dz bytes, expected z bytes from header.r;) stacklevelzUnexpected end of file.zIncomplete chunk ID: z, ignoring it.fmt Tr:r?r>factdatazNo fmt chunk before datasLIST>FakeJUNKz-Chunk (non-data) not understood, skipping it.r)hasattropenseekablerrr-rwarningswarnrrrrrrrr0r))filenamerr was_seekablerrrrfmt_chunk_receiveddata_chunk_receivedchunk_idmsg fmt_chunkrrrrrrs rrrasRLx  8T"LLN *L *!#&:=Mc=R: '"#hhj9$xx{H&MM? 1~N$$-a=0CE&16$%>??X"-d8n-=>%*=MM#(8"8.-.0%S/)7"%)"+C? +4Qq>( b%aL 'l W$#C7W$&*#)$%?@@'Z9(5 (,?W$#C7//#C7 M,<#C7_hhj9$bx(( IIK t8O  HHQK t8Ox(( IIK  HHQKs FH##=I c [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 ''rrsrr rr:rAz ::??. 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 rr/r/s%IIdjjl$))*r)FN)F)r6r%r!r-numpyrrrenumr__all__ UserWarningrrr8rrrrrrrrrrrr/r rrr=s     [ &J&JRR'Rj"oo{'='=>DL`?CbJ$"(>Vk\Vr+r