0Phŕ dZdZdZdZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z mZgdZd Zd Zd Zd Zd Zejd ejZejdejZejdejZejdZejdejZejdejZe e Zee dfZerddlm Z Gdde Z!n e e"e fZ!dZ#e#\Z$Z%ddddddddd d Z&d!e'd"DZ(e()d#e&*Dde(d$<e&)d%e'd&Dd'Z+d(Z,d)Z-dZ.d*Z/d+Z0d,Z1d-Z2e.e/e0e1e2gZ3Gd.d/e4Z5Gd0d1e5Z6Gd2d3e5Z7Gd4d5e5Z8Gd6d7e5Z9Gd8d9e5Z:Gd:d;e5Z;Gd<d=e5Z<Gd>d?e5Z=Gd@dAe5Z>GdBdCe5Z?GdDdEe5Z@dFZAdGZBGdHdIZCGdJdKZDGdLdMZEGdNdOZFGdPdQeFeEZGGdRdSZHGdTdUZIGdVdWeFeIZJdXZKdYZLGdZd[ZMGd\d]ZNd^e.fd_ZOd^e.fd`ZPdaZQdbZRdS)ca The liac-arff module implements functions to read and write ARFF files in Python. It was created in the Connectionist Artificial Intelligence Laboratory (LIAC), which takes place at the Federal University of Rio Grande do Sul (UFRGS), in Brazil. ARFF (Attribute-Relation File Format) is an file format specially created for describe datasets which are commonly used for machine learning experiments and software. This file format was created to be used in Weka, the best representative software for machine learning automated experiments. An ARFF file can be divided into two sections: header and data. The Header describes the metadata of the dataset, including a general description of the dataset, its name and its attributes. The source below is an example of a header section in a XOR dataset:: % % XOR Dataset % % Created by Renato Pereira % rppereira@inf.ufrgs.br % http://inf.ufrgs.br/~rppereira % % @RELATION XOR @ATTRIBUTE input1 REAL @ATTRIBUTE input2 REAL @ATTRIBUTE y REAL The Data section of an ARFF file describes the observations of the dataset, in the case of XOR dataset:: @DATA 0.0,0.0,0.0 0.0,1.0,1.0 1.0,0.0,1.0 1.0,1.0,0.0 % % % Notice that several lines are starting with an ``%`` symbol, denoting a comment, thus, lines with ``%`` at the beginning will be ignored, except by the description part at the beginning of the file. The declarations ``@RELATION``, ``@ATTRIBUTE``, and ``@DATA`` are all case insensitive and obligatory. For more information and details about the ARFF file description, consult http://www.cs.waikato.ac.nz/~ml/weka/arff.html ARFF Files in Python ~~~~~~~~~~~~~~~~~~~~ This module uses built-ins python objects to represent a deserialized ARFF file. A dictionary is used as the container of the data and metadata of ARFF, and have the following keys: - **description**: (OPTIONAL) a string with the description of the dataset. - **relation**: (OBLIGATORY) a string with the name of the dataset. - **attributes**: (OBLIGATORY) a list of attributes with the following template:: (attribute_name, attribute_type) the attribute_name is a string, and attribute_type must be an string or a list of strings. - **data**: (OBLIGATORY) a list of data instances. Each data instance must be a list with values, depending on the attributes. The above keys must follow the case which were described, i.e., the keys are case sensitive. The attribute type ``attribute_type`` must be one of these strings (they are not case sensitive): ``NUMERIC``, ``INTEGER``, ``REAL`` or ``STRING``. For nominal attributes, the ``atribute_type`` must be a list of strings. In this format, the XOR dataset presented above can be represented as a python object as:: xor_dataset = { 'description': 'XOR Dataset', 'relation': 'XOR', 'attributes': [ ('input1', 'REAL'), ('input2', 'REAL'), ('y', 'REAL'), ], 'data': [ [0.0, 0.0, 0.0], [0.0, 1.0, 1.0], [1.0, 0.0, 1.0], [1.0, 1.0, 0.0] ] } Features ~~~~~~~~ This module provides several features, including: - Read and write ARFF files using python built-in structures, such dictionaries and lists; - Supports `scipy.sparse.coo `_ and lists of dictionaries as used by SVMLight - Supports the following attribute types: NUMERIC, REAL, INTEGER, STRING, and NOMINAL; - Has an interface similar to other built-in modules such as ``json``, or ``zipfile``; - Supports read and write the descriptions of files; - Supports missing values and names with spaces; - Supports unicode values and names; - Fully compatible with Python 2.7+, Python 3.5+, pypy and pypy3; - Under `MIT License `_ z7Renato de Pontes Pereira, Matthias Feurer, Joel NothmanzTrenato.ppontes@gmail.com, feurerm@informatik.uni-freiburg.de, joel.nothman@gmail.comz2.4.0N) TYPE_CHECKING)OptionalListDictAnyIteratorUnionTupleNUMERICREALINTEGERSTRING%z @RELATIONz @ATTRIBUTEz@DATAz^([^\{\}%,\s]*|\".*\"|\'.*\')$z%^(\".*\"|\'.*\'|[^\{\}%,\s]*)\s+(.+)$z["\'\\\s%,\000-\031]z(?=["\'\\%])|[\n\r\t\000-\031]z^\s*\{.*\}\s*$z["'{}\s].) TypedDictcHeZdZUeed<eed<eed<eeefed<dS)ArffContainerType descriptionrelation attributesdataN) __name__ __module__ __qualname__str__annotations__rr ArffDenseDataTypeArffSparseDataTypeW/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sklearn/externals/_arff.pyrrsK %'99::::::r rcd}d|d|ddd}tjd|}tjd d |iz}||fS) Na " # open quote followed by zero or more of: (?: (?r:s$===aSVVX\===r ci|]\}}|| Srrr8kvs r!r:r:sCCC41a!QCCCr c4i|]}d|zt|S)z\%dr5r7s r!r:r:s$>>>q CFF>>>r cX|}t|dkr. t|S#t$rt d|zwxYw|ddkr%t t |dddSt t |dddS)NzUnsupported escape sequence: %su)grouplen_ESCAPE_SUB_MAPKeyError ValueErrorr6int)matchss r!_escape_sub_callbackrQs A 1vv{{ D"1% % D D D>BCC C Dts{{3qub>>"""3qua==!!!s 6Acp|dddvr#tjdt|ddS|dvrdS|S)NrE)r#r$z\\([0-9]{1,3}|u[0-9a-f]{4}|.)?r@)r'subrQ)r?s r!_unquoterWsM!u v68L"g  itr c@t|s,dttj|gDSt t d|z\}}t|s d|DSt |r dt|DS#t$rft |D];}|ds$td|zz!_parse_values.. s4000YA000r ,c,g|]}t|Sr)rW)r8r?s r!rZz!_parse_values..&s,,, ,,,r cNi|]"\}}t|t|#Sr)rNrWr=s r!r:z!_parse_values..)s@BBB1FFHQKKBBBr rEzError parsing %rzUnknown parsing errorrD)_RE_NONTRIVIAL_DATAsearchnextcsvreaderzip_RE_DENSE_VALUESfindallany_RE_SPARSE_LINErO_RE_SPARSE_KEY_VALUESrMfinditerrI BadLayout)rPvalueserrorsrOs r! _parse_valuesrms  % %a ( (000cj!oo..000 0*2237;;GG         r rceZdZdZdZdS)BadAttributeTypezSError raised when some invalid type is provided into the attribute declaration.z Bad @ATTRIBUTE type, at line %d.Nr}rr r!rr]s0GGGr rc"eZdZdZfdZxZS)BadAttributeNamezTError raised when an attribute name is provided twice the attribute declaration.cntd|zdzd|zz|_dS)NzBad @ATTRIBUTE name %s at linez( %d, this name is already in use in linez %d.r)rvrvalue2rs r!rwzBadAttributeName.__init__fs@  - 5 6 7 f_  r rrs@r!rrbsB         r rc"eZdZdZfdZxZS)BadNominalValuezyError raised when a value in used in some data instance but is not declared into it respective attribute declaration.cbtd|zdz|_dS)Nz0Data value %s not found in nominal declaration, z at line %d.rrs r!rwzBadNominalValue.__init__rs4  ?% G  r rrs@r!rrnsB::         r rc"eZdZdZfdZxZS)BadNominalFormattingzDError raised when a nominal value with space is not properly quoted.cbtd|zdz|_dS)Nz4Nominal data value "%s" not properly quoted in line z%d.rrs r!rwzBadNominalFormatting.__init__{s4  Ce K   r rrs@r!rrys>NN         r rceZdZdZdZdS)BadNumericalValuezPError raised when and invalid numerical value is used in some data instance.z$Invalid numerical value, at line %d.Nr}rr r!rrs4GGGr rceZdZdZdZdS)BadStringValuez;Error raise when a string contains space but is not quoted.z Invalid string value at line %d.Nr}rr r!rrsEE0GGGr rc(eZdZdZdZdfd ZxZS)rjzBError raised when the layout of the ARFF file has something wrong.z,Invalid layout of the ARFF file, at line %d.r@ct|r-tjdz|ddz|_dSdS)N rz%%)rrwrjrrr&)rvmsgrs r!rwzBadLayout.__init__sT   L$,s2S[[d5K5KKDLLL L Lr r@)rrrr~rrrwrrs@r!rjrjsRLL.s:::1q!:::r r) enumeraterkrvrks r!rwz EncodedNominalConversor.__init__s.:: &(9(9:::  Ar cX |j|S#t$rt|wxYwry)rkrLrrvrs r!__call__z EncodedNominalConversor.__call__s= );u% % ) ) )!%(( ( )s )Nrrrrwrrr r!rrs2)))))r rceZdZdZdZdS)NominalConversorcHt||_|d|_dSNr)setrk zero_valuers r!rwzNominalConversor.__init__s&kk  )r cj||jvr|dkr|jSt|t|Sr)rkrrrrs r!rzNominalConversor.__call__s<  # #zz &!%(( (5zzr Nrrr r!rrs2$$$     r rc4eZdZdZdZedZdZdS)DenseGeneratorDatazyInternal helper class to allow for different matrix types without making the code a huge collection of if statements.c#K|D]}t|ttrZr/tt |krt |fdt t |Dn/t t |krt |||VdS)Nc,g|]}|vr|ndS)rr)r8r9rks r!rZz2DenseGeneratorData.decode_rows..s5222aqF{{&))222r )rm isinstancedictmaxrJrrange_decode_values)rvstream conversorsrowrks @r! decode_rowszDenseGeneratorData.decode_rowss : :C"3''F&$'' --c&kkS__<<',,,2222J00222v;;#j//11',,,%%fj99 9 9 9 9 : :r c dt||D}n6#t$r)}dt|vrtYd}~nd}~wwxYw|S)Nc2g|]\}}|dn ||Sryr)r8 conversorrs r!rZz5DenseGeneratorData._decode_values..s>222*)U$mdd51A1A222r float: )rcrMrr)rkrexcs r!rz!DenseGeneratorData._decode_valuess *22Z00222FF * * *CHH$$')))%$$$$ * s AA  Ac #Kd}|D]}t|t|kr/td|t|t|fzg}|D]D}| |dks||krd}ntt|}||E|dz }d|VdS)aZ(INTERNAL) Encodes a line of data. Data instances follow the csv format, i.e, attribute values are delimited by commas. After converted from csv. :param data: a list of values. :param attributes: a list of attributes. Used to check if data is valid. :return: a string with the encoded data line. r*Instance %d has %d attributes, expected %dNr@rUrEr[)rJrrrappendjoin)rvrr current_rowinstnew_datarrPs r! encode_datazDenseGeneratorData.encode_datas  % %D4yyC OO++@!3t99c*oo>? H # #=ERKK5E>>AA%c%jj11A"""" 1 K((8$$ $ $ $ $! % %r N)rrrr~r staticmethodrrrr r!rrsW;;::: \%%%%%r rc"eZdZdZfdZxZS)_DataListMixinz>Mixin to return a list from decode_rows instead of a generatorcbtt||Sry)listrr)rvrrrs r!rz_DataListMixin.decode_rowss%EGG'' ;;<<HH=========r rceZdZdS)DataNrrrrr r!rr Dr rceZdZdZdZdS)COODatacxggg}}}t|D]\}}t|}t|tst |s;t t |\} } fdt | |D}nJ#t$r%} dt| vrtd} ~ wt$rt|wxYw| || |gt|z| |  |||fS)Nc@g|]\}}||n||Sryrr8keyrrs r!rZz'COOData.decode_rows..sICCC(c5$)=%%ojoe6L6LCCCr r)rrmrrrjrcsorteditemsrMrr IndexErrorrextendrJ) rvrrrrowscolsr9rrkrow_colsrs ` r!rzCOOData.decode_rowssrr2Dd'' " "FAs"3''Ffd++ "kk! "F6<<>>$:$:; Hf )CCCC,/&,A,ACCC   C((+--- ) ) )#C((( ) KK    KKc&kk) * * * KK ! ! ! !T4s>B C"% CC"c# Kt|}g}d}|j |j}|j}t fdt t dz Dst dt|| D]\}} |kr@| kr:ddd|dgVg}|dz }| k:||krtd ||dz|fz| |d ks||krd }ntt|}| d ||fzddd|dgVdS) Nrc3BK|]}||dzkVdS)rENr)r8r9rs r! z&COOData.encode_data..5s4EEA3q6SQZ'EEEEEEr rEz8liac-arff can only output COO matrices with sorted rows.r{r[}z3Instance %d has at least %d attributes, expected %dr@rU%d %s) rJrcolrallrrMrcrrrrr) rvrrnum_attributesrrrr?rPrs @r!rzCOOData.encode_data+sZ hhyEEEEs3xx!|1D1DEEEEE -,-- -tS#.. 0 0KAsC[  !C''((C(););S#ABBBBB!H1$K"C'' n$$I #'>:; yAGGqAvv!#a&&)) OOGsAh. / / / /hhSXXh//56666666r Nrrrrrrr r!rrs2   4"7"7"7"7"7r rceZdZdZdZdS)LODGeneratorDatac#TK|D]}t|}t|tst fd|DVX#t $r%}dt |vrtd}~wt$rt|wxYwdS)NcBi|]\}}||dn||Sryrrs r!r:z0LODGeneratorData.decode_rows..WsE999%3EMDDz#u7M7M999r r) rmrrrjrrMrrrr)rvrrrrkrs ` r!rzLODGeneratorData.decode_rowsPs ) )C"3''Ffd++ "kk! )9999)/9999999   C((+--- ) ) )#C((( ) ) )s"A B%( BB%c#Kd}t|}|D]}g}t|dkr8t||kr%td|t|dz|fzt|D]Q}||}| |dks||krd} nt t |} |d|| fzR|dz }ddd |d gVdS) NrrrEr@rUrrrr[r)rJrrrrrrr) rvrrrrrrrr?rPs r!rzLODGeneratorData.encode_dataas' Z ; ;CH3xx!||CN : :@ #c((Q,?@ c{{ 4 4H9R166AA%c!ff--A3( 23333 1 K((C(!3!3S9:: : : : :% ; ;r Nrrr r!rrOs2)))";;;;;r rceZdZdS)LODDataNrrr r!rryrr rc:|tkrtS|tkrtS|tkrt S|t krtS|tkrtStdt|z)NzMatrix type %s not supported.) DENSErCOOrLODr DENSE_GENrLOD_GENrrMr) matrix_types r!_get_data_object_for_decodingr}sevv   yy   yy  ! !!###   !!!83{;K;KKLLLr ct|dr(|jdkrtStdt |dt rt StS)Nr)coozCannot guess matrix format!r)hasattrr)rrMrrrr)matrixs r!_get_data_object_for_encodingr scvx   =E ! !99 :;; ; F1It $ $yyvv r cBeZdZdZdZdZdZdZdefdZ defdZ d S) ArffDecoderzAn ARFF decoder.c"g|_d|_dS)z Constructor.rN) _conversors _current_linerus r!rwzArffDecoder.__init__sr c2tjdd|}|S)a(INTERNAL) Decodes a comment line. Comments are single line strings starting, obligatorily, with the ``%`` character, and can have any symbol, including whitespaces or special characters. This method must receive a normalized string, i.e., a string without padding, including the " " characters. :param s: a normalized string. :return: a string with the decoded comment. z^\%( )?r@)r'rV)rvrPress r!_decode_commentzArffDecoder._decode_commentsfZQ'' r c|dd\}}|}t|st t |d}|S)aF(INTERNAL) Decodes a relation line. The relation declaration is a line with the format ``@RELATION ``, where ``relation-name`` is a string. The string must start with alphabetic character and must be quoted if the name includes spaces, otherwise this method will raise a `BadRelationFormat` exception. This method must receive a normalized string, i.e., a string without padding, including the " " characters. :param s: a normalized string. :return: a string with the decoded relation name. rrE"')splitstrip _RE_RELATIONrOr|r)rvrP_r?rs r!_decode_relationzArffDecoder._decode_relationsdwwsA1 GGII!!!$$ &#%% %!''%..!! r c|dd\}}|}t|}|st |\}}t |d}|dddkrr|dddkrd t|d}n#t$rtwxYwt|trtn3t | }|d vrt||fS) a(INTERNAL) Decodes an attribute line. The attribute is the most complex declaration in an arff file. All attributes must follow the template:: @attribute where ``attribute-name`` is a string, quoted if the name contains any whitespace, and ``datatype`` can be: - Numerical attributes as ``NUMERIC``, ``INTEGER`` or ``REAL``. - Strings as ``STRING``. - Dates (NOT IMPLEMENTED). - Nominal attributes with format: {, , , ...} The nominal names follow the rules for the attribute names, i.e., they must be quoted if the name contains whitespaces. This method must receive a normalized string, i.e., a string without padding, including the " " characters. :param s: a normalized string. :return: a tuple (ATTRIBUTE_NAME, TYPE_OR_VALUES). rrErNrrSrz{} r ) rr _RE_ATTRIBUTErOrgroupsrrm Exceptionrrrupper)rvrPrr?mnametype_s r!_decode_attributezArffDecoder._decode_attributesI6wwsA1 GGII    " " '$&& &hhjj e4::e$$%% !9  bcc c 1 1 )%ekk%&8&899 ) ) )&((( )%&& )&((( ) JJ$$&&EDDD&(((e}s ."CC*Fcd_ttr<ddddddggd}i}t |}t}tD]q}xjdz c_|d}|s+| } | tr2|tkr'|d xx |dzz cc<| tr9|tkrtt}||d <| tr(|tkr|tkrtt}|} | d|vr"t#| d|| dj|| d<|d | t| dt&t(fr.|rt+| d} n;t-| d} n%td t.t.d } | | d} j| !| t2r|tkrtn+| t4r stfd} || j|d<|d dr|d dd|d <|S)zDo the job the ``encode``.rz z r0r@)rrrrrEz rrrc:tt|Sry)rNfloat)xs r!z%ArffDecoder._decode..Gs#eAhh--r )rrr r c3KD]F}xjdz c_|}|r|ts|VGdS)NrE)rr startswith _TK_COMMENT)rrPrvs r!rz#ArffDecoder._decode..stream_sf  ""a'""iikks~~k::III   r rNrS)rrrrr&rr_TK_DESCRIPTIONiterr!r,r _TK_RELATIONrjr _TK_ATTRIBUTEr%rrrtuplerrr(r_TK_DATAr-rendswith)rvrPencode_nominalrobjattribute_namesrSTATEru_rowattrr CONVERSOR_MAPrs`` r!_decodezArffDecoder._decodes a   C  ((66<$;DG$D$D $4T!W$=$= /20G0G05-2%4%4M!.d1g 6I '' 2222!!(++ M))#++%!!+.. ++       &&vvxx1ABBF }  & &t , , 9!$]!3CRC!8C  r ct ||||S#t$r}|j|_|d}~wwxYw)aReturns the Python representation of a given ARFF file. When a file object is passed as an argument, this method reads lines iteratively, avoiding to load unnecessary information to the memory. :param s: a string or file object with the ARFF file. :param encode_nominal: boolean, if True perform a label encoding while reading the .arff file. :param return_type: determines the data structure used to store the dataset. Can be one of `arff.DENSE`, `arff.COO`, `arff.LOD`, `arff.DENSE_GEN` or `arff.LOD_GEN`. Consult the sections on `working with sparse data`_ and `loading progressively`_. )r5rN)r<rqrrt)rvrPr5 return_typees r!decodezArffDecoder.decodensW <<.,7 99 9   'AFG s 727N) rrrr~rwrrr%rr<r@rr r!rrs  .888t).5iiiiV(-%r rc2eZdZdZd dZdZdZdZdZdS) ArffEncoderzAn ARFF encoder.r@c2|r td|SdtzS)a(INTERNAL) Encodes a comment line. Comments are single line strings starting, obligatorily, with the ``%`` character, and can have any symbol, including whitespaces or special characters. If ``s`` is None, this method will simply return an empty comment. :param s: (OPTIONAL) string. :return: a string with the encoded comment line. rr)r-)rvrPs r!_encode_commentzArffEncoder._encode_comments(  &'KK+ ++% %r c:dD] }||vrd|z}ntd|S)a(INTERNAL) Decodes a relation line. The relation declaration is a line with the format ``@RELATION ``, where ``relation-name`` is a string. :param name: a string. :return: a string with the encoded relation declaration.  %{},"%s"r)r0)rvr#chars r!_encode_relationzArffEncoder._encode_relationsB  Dt||d{% dd++r cdD] }||vrd|z}nt|ttfr$d|D}dd|z}td|d|S)a(INTERNAL) Encodes an attribute line. The attribute follow the template:: @attribute where ``attribute-name`` is a string, and ``datatype`` can be: - Numerical attributes as ``NUMERIC``, ``INTEGER`` or ``REAL``. - Strings as ``STRING``. - Dates (NOT IMPLEMENTED). - Nominal attributes with format: {, , , ...} This method must receive a the name of the attribute and its type, if the attribute type is nominal, ``type`` must be a list of values. :param name: a string. :param type_: a string or a list of string. :return: a string with the encoded attribute declaration. rFrGc2g|]}dt|zS)r)r)r8type_ks r!rZz1ArffEncoder._encode_attribute..s%III}V444IIIr z{%s}z, r)rr2rrr1)rvr#r$rHtype_tmps r!_encode_attributezArffEncoder._encode_attributes.  Dt||d{ eeT] + + 1II5IIIHDIIh//0E(==$$$66r cjd||D}d|S)zEncodes a given object to an ARFF file. :param obj: the object containing the ARFF information. :return: the ARFF file as an string. cg|]}|Srr)r8rs r!rZz&ArffEncoder.encode..s555555r r0) iter_encoder)rvr6rs r!encodezArffEncoder.encodes5 65t//44555yyr c#HK|ddr5|ddD]}||V|dstd||dVdV|dstdt }|dD]e}t |ttfr.t|d kst |d tstd t|zt |d tr/|d tvrtd t|znAt |d ttfstd t|z|d |vr%tdt|d z| |d | |d |d VgdV|d}tVd|vrQt|d}||d|Ed{VdVdS)aThe iterative version of `arff.ArffEncoder.encode`. This encodes iteratively a given object and return, one-by-one, the lines of the ARFF file. :param obj: the object containing the ARFF information. :return: (yields) the ARFF file as strings. rNr0rz.Relation name not found or with invalid value.r@rzAttributes not found.rDrz"Invalid attribute declaration "%s"rEzInvalid attribute type "%s"z6Trying to use attribute name "%s" for the second time.r)getrrDrrIrrr2rrJr _SIMPLE_TYPESaddrNr3r r)rvr6rr7r:rrs r!rQzArffEncoder.iter_encodes 77=$ ' ' 0=)//55 0 0**3//////wwz"" NLMM M##C O44444ww|$$ 5344 4%% % ; ;DdUDM22 P4yyA~~d1gs++ DSYY NOOO$q'3'' I7-//#$A#d))$KLLL0 Q%77 I =c$ii GHHHAw/))!/14T!W!>??? ##DG,,,((a$q':: : : : :&  S==0AAD''DD D D D D D D Dr Nr) rrrr~rDrIrNrRrQrr r!rBrBsk&&&&",,, 7 7 7D;;;;;r rBFcNt}||||S)a(Load a file-like object containing the ARFF document and convert it into a Python object. :param fp: a file-like object. :param encode_nominal: boolean, if True perform a label encoding while reading the .arff file. :param return_type: determines the data structure used to store the dataset. Can be one of `arff.DENSE`, `arff.COO`, `arff.LOD`, `arff.DENSE_GEN` or `arff.LOD_GEN`. Consult the sections on `working with sparse data`_ and `loading progressively`_. :return: a dictionary. r5r>rr@)fpr5r>decoders r!loadr\s/mmG >>"^&1  3 33r cNt}||||S)aConvert a string instance containing the ARFF document into a Python object. :param s: a string object. :param encode_nominal: boolean, if True perform a label encoding while reading the .arff file. :param return_type: determines the data structure used to store the dataset. Can be one of `arff.DENSE`, `arff.COO`, `arff.LOD`, `arff.DENSE_GEN` or `arff.LOD_GEN`. Consult the sections on `working with sparse data`_ and `loading progressively`_. :return: a dictionary. rXrY)rPr5r>r[s r!loadsr^'s/mmG >>!N&1  3 33r ct}||}t|}|D]}||dz|}|||S)zSerialize an object representing the ARFF document to a given file-like object. :param obj: a dictionary. :param fp: a file-like object. r0)rBrQr`write)r6rZencoder generatorlast_rowrs r!dumprd9snmmG##C((IIH D!!!HHX Ir cHt}||S)zSerialize an object representing the ARFF document, returning a string. :param obj: a dictionary. :return: a string with the ARFF document. )rBrR)r6ras r!dumpsrfKs mmG >>#  r )Sr~ __author____author_email__ __version__r'ratypingrrrrrrr r rUr.r-r0r1r3r(UNICODErrrrrgr^rrtyping_extensionsrrrr-rdrhrKrrupdaterrQrWrmrrrrr_SUPPORTED_DATA_STRUCTURESr rqr|rrrrrrrrrjrrrrrrrrrrrrr rrBr\r^rdrfrr r!ros6ttjG - DDDDDDDDDDDDDDDDDD988    2:?LL 2:F SS "*4bjAA2:?@@"*. ;; bjrz::TN49% '++++++;;;;;I;;;;S#X///f+;*:*<*<''           >=5599===CC?+@+@+B+BCCCDDD">>EE"II>>>??? " " "111<  #S#y'B&&&&&I&&&22222 22233333333     M   11111}111      }          m         =   55555 555 11111]111LLLLL LLL ,,,   ) ) ) ) ) ) ) )";%;%;%;%;%;%;%;%|========      >-   =7=7=7=7=7=7=7=7~(;(;(;(;(;(;(;(;T     n.    M M M   hhhhhhhhVKKKKKKKK`"u3333$"u3333$$r