Of`FSrSSKrSSKrSSKJr SSKJr "SS\5rg)z An NLTK interface to the VerbNet verb lexicon For details about VerbNet see: https://verbs.colorado.edu/~mpalmer/projects/verbnet.html N) defaultdict)XMLCorpusReadercj\rSrSrSrS$Sjr\R"S5r\R"S5r \R"S5r S%Sjr S%S jr S&S jr S rS%S jrS rSrSrSrSrSrSrSrSrSrSrSrSrS'SjrS'SjrS'SjrS'Sjr S'Sjr!S'Sjr"S'S jr#S'S!jr$S'S"jr%S#r&g)(VerbnetCorpusReadera An NLTK interface to the VerbNet verb lexicon. From the VerbNet site: "VerbNet (VN) (Kipper-Schuler 2006) is the largest on-line verb lexicon currently available for English. It is a hierarchical domain-independent, broad-coverage verb lexicon with mappings to other lexical resources such as WordNet (Miller, 1990; Fellbaum, 1998), XTAG (XTAG Research Group, 2001), and FrameNet (Baker et al., 1998)." For details about VerbNet see: https://verbs.colorado.edu/~mpalmer/projects/verbnet.html c[R"XX#5 [[5Ul[[5Ul0Ul0UlUR5 gN) r__init__rlist_lemma_to_class_wordnet_to_class_class_to_fileid_shortid_to_longid _quick_index)selfrootfileids wrap_etrees ]+>|NcUc#[URR55$[U[5(aUR U5nUR S5Vs/sHo"RS5PM sn$s snf)z` Return a list of all verb lemmas that appear in any class, or in the ``classid`` if specified. MEMBERS/MEMBERname)sortedr keys isinstancestrvnclassfindallget)rrmembers rlemmasVerbnetCorpusReader.lemmasHsk ?$..3356 6'3'',,w/5<__EU5VW5V6JJv&5VW WWs A=cUc#[URR55$[U[5(aUR U5n[ SURS55/5$)zd Return a list of all wordnet identifiers that appear in any class, or in ``classid`` if specified. c3b# UH%nURSS5R5v M' g7f)wnN)r!split).0r"s r 1VerbnetCorpusReader.wordnetids..as."CJJtR(..00"Cs-/r)rr rrrrsumr )rrs r wordnetidsVerbnetCorpusReader.wordnetidsUsi ?$005578 8'3'',,w/")//2B"C  rcUb6URR5VVs/sHupVXc:XdM UPM snn$UbURU$UbURU$UbBUR U5nUR S5Vs/sHnUR S5PM sn$[URR55$s snnfs snf)a? Return a list of the VerbNet class identifiers. If a file identifier is specified, then return only the VerbNet class identifiers for classes (and subclasses) defined by that file. If a lemma is specified, then return only VerbNet class identifiers for classes that contain that lemma as a member. If a wordnetid is specified, then return only identifiers for classes that contain that wordnetid as a member. If a classid is specified, then return only identifiers for subclasses of the specified VerbNet class. If nothing is specified, return all classids within VerbNet SUBCLASSES/VNSUBCLASSID) ritemsr r rr r!rr) rlemma wordnetidfileidclassidcfxmltreesubclasss rclassidsVerbnetCorpusReader.classidshs  $($9$9$?$?$AQ$A&1Q[A$AQ Q  ''. .  ")))4 4  ll7+G!(0G H HH T" H  $//4467 7Rs CCC cXR;aURU5$URU5nX R;awURURU5nURU5nX$R S5:XaU$UR S5HnX%R S5:XdMUs $ e[ SU35e)awReturns VerbNet class ElementTree Return an ElementTree containing the xml for the specified VerbNet class. :param fileid_or_classid: An identifier specifying which class should be returned. Can be a file identifier (such as ``'put-9.1.xml'``), or a VerbNet class identifier (such as ``'put-9.1'``) or a short VerbNet class identifier (such as ``'9.1'``). r2z .//VNSUBCLASSzUnknown identifier )_fileidsxmllongidrr!r ValueError)rfileid_or_classidr7r6treer;s rrVerbnetCorpusReader.vnclasss  -88-. .++/0 ++ +**4;;w+?@F88F#D((4.( $ _ =H,,t"44'!>!523D2EFG GrcUc UR$[U[5(aURUR U5/$UVs/sH!nURUR U5PM# sn$s snf)z Return a list of fileids that make up this corpus. If ``vnclass_ids`` is specified, then return the fileids that make up the specified VerbNet class(es). )r?rrrrA)r vnclass_ids vnclass_ids rrVerbnetCorpusReader.fileidssy  ==  S ) )))$++k*BCD D#."-J%%dkk*&=>"- s(A3c .[U[5(aURU5n/nURS5nUHUnUR UR U5UR U5URU5URU5S.5 MW U$)a(Given a VerbNet class, this method returns VerbNet frames The members returned are: 1) Example 2) Description 3) Syntax 4) Semantics :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. :return: frames - a list of frame dictionaries z FRAMES/FRAME)example descriptionsyntax semantics) rrrr append_get_example_within_frame_get_description_within_frame _get_syntactic_list_within_frame_get_semantics_within_frame)rrframesvnframesvnframes rrTVerbnetCorpusReader.framess gs # #ll7+G??>2G MM#==gF#'#E#Eg#N"CCGL!%!A!A'!J    rc[U[5(aURU5nURS5Vs/sHo"R S5PM nnU$s snf)aReturns subclass ids, if any exist Given a VerbNet class, this method returns subclass ids (if they exist) in a list of strings. :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. :return: list of subclasses r1r2)rrrr r!)rrr; subclassess rrYVerbnetCorpusReader.subclassess\ gs # #ll7+G07?V/W /W8LL /W   sAc X[U[5(aURU5n/nURS5HgnUR UR S5URS5Vs/sH&nUR S5UR S5S.PM( snS.5 Mi U$s snf)a*Returns thematic roles participating in a VerbNet class Members returned as part of roles are- 1) Type 2) Modifiers :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. :return: themroles: A list of thematic roles in the VerbNet class zTHEMROLES/THEMROLEtypeSELRESTRS/SELRESTRValuevaluer\)r\ modifiers)rrrr rOr!)rr themrolestrolerestrs rrbVerbnetCorpusReader.themroless gs # #ll7+G __%9:E   !IIf-&+]]3G%H"%HE#())G"4eii>OP%H" ; "s+-B' clURH$nURURU5U5 M& g)a Initialize the indexes ``_lemma_to_class``, ``_wordnet_to_class``, and ``_class_to_fileid`` by scanning through the corpus fileids. This is fast if ElementTree uses the C implementation (<0.1 secs), but quite slow (>10 secs) if only the python implementation is available. N)r? _index_helperr@)rr6s r_indexVerbnetCorpusReader._indexs+mmF   txx/ 8$rcURS5nX RU'X0RURU5'UR S5HunUR URS5R U5 URSS5R5H!nURUR U5 M# Mw UR S5HnURXb5 M g)zHelper for ``_index()``r2rrr'r(r1N) r!rrshortidr r rOr)r rg)rr:r6rr"r'r;s rrg!VerbnetCorpusReader._index_helper s++d#)/g&9@ W 56oo&67F  F!3 4 ; ;G Djjr*002&&r*11':38 (?@H   x 0ArcURGH/nUSSnXRU'X RURU5'UR U5nUR R UR55HnUR5nUSb[URUSRU5 USR5H!nURURU5 M# MtUSb5XRUS'USnX RURU5'MS5e SSS5 GM2 g!,(df  GME=f)a Initialize the indexes ``_lemma_to_class``, ``_wordnet_to_class``, and ``_class_to_fileid`` by scanning through the corpus fileids. This doesn't do proper xml parsing, but is good enough to find everything in the standard VerbNet corpus -- and it runs about 30 times faster than xml parsing (with the python ElementTree; only 2-3 times faster if ElementTree uses the C implementation). Nrzunexpected match condition) r?rrrkopen _INDEX_REfinditerreadgroupsr rOr)r )rr6rfpmrur's rr VerbnetCorpusReader._quick_indexs'mmFSbkG-3 ! !' *=D # #DLL$9 :6"b00;AXXZFay,,,VAY7>>wG"()//"3B 2226==gF#4.;A--fQi8"()IP// W0EFB&BBu<#" $#"s C"E E cURRU5(aU$URRU5(d[SU-5eURU$![ an[SU-5UeSnAff=f)zReturns longid of a VerbNet class Given a short VerbNet class identifier (eg '37.10'), map it to a long id (eg 'confess-37.10'). If ``shortid`` is already a long id, then return it as-isvnclass identifier %r not foundN) _LONGID_REmatch _SHORTID_RErBrKeyError)rrkes rrAVerbnetCorpusReader.longid;s ??  ) )N!!''00>HI I Q**73 3 Q>HIq P QsA!! A?+A::A?cURRU5(aU$URRU5nU(aURS5$[ SU-5e)zReturns shortid of a VerbNet class Given a long VerbNet class identifier (eg 'confess-37.10'), map it to a short id (eg '37.10'). If ``longid`` is already a short id, then return it as-is.rprz)r}r|r{grouprB)rrArws rrkVerbnetCorpusReader.shortidJsV    ! !& ) )M OO ! !& ) 771: >GH Hrc4/nURS5H{nURS5Vs/sH&nURS5URS5S.PM( nnURURS5UURS5S:HS.5 M} U$s snf) a.Returns semantics within a single frame A utility function to retrieve semantics within a frame in VerbNet Members of the semantics dictionary: 1) Predicate value 2) Arguments :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. :return: semantics: semantics dictionary zSEMANTICS/PREDzARGS/ARGr\r`)r\r`bool!)predicate_value argumentsnegated)r r!rO)rrVsemantics_within_single_framepredargrs rrS/VerbnetCorpusReader._get_semantics_within_frame\s)+%OO$45D << 33C37773CD3  * 0 0'+xx'8!*#xx/36  6-,s-BcNURS5nUbURnU$SnU$)zReturns example within a frame A utility function to retrieve an example within a frame in VerbNet. :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. :return: example_text: The example sentence for this particular frame zEXAMPLES/EXAMPLEr()findtext)rrVexample_element example_texts rrP-VerbnetCorpusReader._get_example_within_framews9",,'9:  &*//LLrchURS5nURSURSS5S.$)a2Returns member description within frame A utility function to retrieve a description of participating members within a frame in VerbNet. :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. :return: description: a description dictionary with members - primary and secondary DESCRIPTIONprimary secondaryr()rr)rattribr!)rrVdescription_elements rrQ1VerbnetCorpusReader._get_description_within_frames;&ll=9*11)<,00bA  rc/nURS5HnURn[5nSUR;aUR S5OSUS'UR S5Vs/sH&nUR S5UR S5S.PM( snUS'UR S 5Vs/sH&nUR S5UR S5S.PM( snUS 'UR XES .5 M U$s snfs snf) aReturns semantics within a frame A utility function to retrieve semantics within a frame in VerbNet. Members of the syntactic dictionary: 1) POS Tag 2) Modifiers :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. :return: syntax_within_single_frame SYNTAXr`r(r]r^r\r_ selrestrszSYNRESTRS/SYNRESTR synrestrs)pos_tagra)rtagdictrr!r rO)rrVsyntax_within_single_frameeltrrards rrR4VerbnetCorpusReader._get_syntactic_list_within_frames&("<<)CggGI5< 5J!1PRIg ![[)=>&>E ))G,eii6GH>&Ik " ![[)=>&>E ))G,eii6GH>&Ik " ' - -#< **)&&s &-C8,-C=c0[U[5(aURU5nURS5S-nX R USS9S-- nX R USS9S-- nUS- nX R USS9S-- nUS- nX RUSS9- nU$)zReturns pretty printed version of a VerbNet class Return a string containing a pretty-printed representation of the given VerbNet class. :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. r2  )indentz Thematic roles:  z Frames: )rrrr!pprint_subclassespprint_memberspprint_themroles pprint_frames)rrss rpprintVerbnetCorpusReader.pprints gs # #ll7+G KK  $ # #GD # 9D @@  6 == "" " "76 " :T AA ]    77rc[U[5(aURU5nURU5nU(dS/nSSR U5-n[ R "USX"S-S9$)aReturns pretty printed version of subclasses of VerbNet class Return a string containing a pretty-printed representation of the given VerbNet class's subclasses. :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. (none)z Subclasses:  Frinitial_indentsubsequent_indent)rrrrYjointextwrapfill)rrrrYrs rr%VerbnetCorpusReader.pprint_subclassessf gs # #ll7+G__W- "J SXXj1 1}} r&TM  rc[U[5(aURU5nURU5nU(dS/nSSR U5-n[ R "USX"S-S9$)aReturns pretty printed version of members in a VerbNet class Return a string containing a pretty-printed representation of the given VerbNet class's member verbs. :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. rz Members: rrrr)rrrr#rrr)rrrmembersrs rr"VerbnetCorpusReader.pprint_memberssf gs # #ll7+G++g&jG #((7+ +}} r&TM  rc[U[5(aURU5n/nURU5HsnUS-UR S5-nUSVs/sHnUSUS-PM nnU(a#USR SR U55- nURU5 Mu SR U5$s snf)a Returns pretty printed version of thematic roles in a VerbNet class Return a string containing a pretty-printed representation of the given VerbNet class's thematic roles. :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. * r\rar`[{}]rr)rrrrbr!formatrrO)rrrpiecesthemrolepiecemodifierras rr$VerbnetCorpusReader.pprint_themroless gs # #ll7+Gw/HTMHLL$88E!) 5 5H!HV$44 5 sxx ':;; MM% 0yy  sCc[U[5(aURU5n/nURU5H#nUR UR XB55 M% SR U5$)aReturns pretty version of all frames in a VerbNet class Return a string containing a pretty-printed representation of the list of frames within the VerbNet class. :param vnclass: A VerbNet class identifier; or an ElementTree containing the xml contents of a VerbNet class. r)rrrrTrO_pprint_single_framer)rrrrrVs rr!VerbnetCorpusReader.pprint_framess] gs # #ll7+G{{7+G MM$33GD E,yy  rcURX5S-nX0RXS-5S-- nUURXS-5S-- nX2S-- nX0RXS-5- nU$)zReturns pretty printed version of a single frame in a VerbNet class Returns a string containing a pretty-printed representation of the given frame. :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. rrz Syntax: z Semantics: r) _pprint_description_within_frame_pprint_example_within_frame_pprint_syntax_within_frame_pprint_semantics_within_frame)rrVr frame_strings rr(VerbnetCorpusReader._pprint_single_frames<>'-*@*MN NKrc /nUSHnUSn/nSUS;a$USS(aURUSS5 UUSSUSS-Vs/sHnSRUSUS5PM sn- nU(a#US RS RU55- nURU5 M US RU5-$s snf) zReturns pretty printed version of syntax within a frame in a VerbNet class Return a string containing a pretty-printed representation of the given VerbNet frame syntax. :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. rMrr`rarrz{}{}r\rr)rOrr)rrVrrelementr modifier_listrds rr/VerbnetCorpusReader._pprint_syntax_within_frameJsx(GI&EM'+..7;3G3P$$W[%9'%BC K(5k*;788 eGneFm<8 Msxx '>?? MM% ) (((s"C c ^/nUSHQnUSVs/sHoUSPM nnURUS(aSOSUSSS RU5S 35 MS S RU4S jU55$s snf) aReturns a pretty printed version of semantics within frame in a VerbNet class Return a string containing a pretty-printed representation of the given VerbNet frame semantics. :param vnframe: An ElementTree containing the xml contents of a VerbNet frame. rNrr`r¬r(r(z, )rc32># UH nTSU3v M g7f)rNr)r*rrs rr+EVerbnetCorpusReader._pprint_semantics_within_frame..usB6%F82eW-6s)rOr)rrVrr predicateargumentrs ` rr2VerbnetCorpusReader._pprint_semantics_within_framefs -I;D[;QR;Qx'*;QIR MM$Y/4R8CT9U8VVWX\XaXabkXlWmmno . yyB6BBB SsA9)rr rr )Fr )NNNN)r()'__name__ __module__ __qualname____firstlineno____doc__r recompiler{r}rrr#r.r<rrrTrYrbrhrgrrArkrSrPrQrRrrrrrrrrrr__static_attributes__rrrrrs .67JB**]+K2 WI! X&88HB 8$> 9 1CD Q I$-6  *D* ( (!0! $ > )8Crr)rrr collectionsrnltk.corpus.reader.xmldocsrrrrrrs( #6_ C/_ Cr