+ h`HRt^RIt^RIt^RIHt^RIHt!RR]4tR#)z An NLTK interface to the VerbNet verb lexicon For details about VerbNet see: https://verbs.colorado.edu/~mpalmer/projects/verbnet.html N) defaultdict)XMLCorpusReadercva]tRt^toRtR#Rlt]P!R4t]P!R4t ]P!R4t R$Rlt R$Rlt R%R lt R tR$R ltR tR tRtRtRtRtRtRtRtRtRtRtRtR&RltR&RltR&RltR&Rlt R&Rlt!R&Rlt"R&Rlt#R&R lt$R&R!lt%R"t&Vt'R#)'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\P!WW#4\\4Vn\\4Vn/Vn/VnVP4R#N) r__init__rlist_lemma_to_class_wordnet_to_class_class_to_fileid_shortid_to_longid _quick_index)selfrootfileids wrap_etrees&&&&]+>|Nc Vf$\VPP44#\V\4'dVP V4pVP R4Uu.uFq"PR4NK up#uupi)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>c Vf$\VPP44#\V\4'dVP V4p\ RVPR44.4#)zd Return a list of all wordnet identifiers that appear in any class, or in ``classid`` if specified. c3b"TF%pVPRR4P4xK' R#5i)wnN)rsplit).0r s& r 1VerbnetCorpusReader.wordnetids..as."CJJtR(..00"Cs-/r)rr rrrrsumr)rrs&&r wordnetidsVerbnetCorpusReader.wordnetidsUsi ?$005578 8'3'',,w/")//2B"C  rc Ve7VPP4UUu.uFwrVWc8XgK VNK upp#VeVPV,#VeVPV,#VeBVP V4pVP R4Uu.uFpVP R4NK up#\VPP44#uuppiuupi)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) r itemsr r rrrrr) rlemma wordnetidfileidclassidcfxmltreesubclasss &&&&& rclassidsVerbnetCorpusReader.classidshs  $($9$9$?$?$AQ$A&1Q[AA$AQ Q  ''. .  ")))4 4  ll7+G!(0G H HH T" H  $//4467 7Rs CCCc WP9dVPV4#VPV4pW P9d~VPVPV4,pVPV4pW$P R48XdV#VP R4FpW%P R48XgKVu# Qh\ RV 24h)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'``). r0z .//VNSUBCLASSzUnknown identifier )_fileidsxmllongidr rr ValueError)rfileid_or_classidr5r4treer9s&& rrVerbnetCorpusReader.vnclasss  -88-. .++/0 ++ +**4;;w+?@F88F#D((4.( $ _ =H,,t"44'!>!523D2EFG Grc Vf VP#\V\4'd$VPVP V4,.#VUu.uF%pVPVP V4,NK' up#uupi)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=rrr r?)r vnclass_ids vnclass_ids&& rrVerbnetCorpusReader.fileidss|  ==  S ) )))$++k*BCD D#."-J%%dkk*&=>>"- s+A<c  6\V\4'dVPV4p.pVPR4pVFXpVP RVP V4RVP V4RVPV4RVPV4/4KZ V#)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/FRAMEexample descriptionsyntax semantics) rrrrappend_get_example_within_frame_get_description_within_frame _get_syntactic_list_within_frame_get_semantics_within_frame)rrframesvnframesvnframes&& rrRVerbnetCorpusReader.framess gs # #ll7+G??>2G MMt==gF!4#E#Eg#NdCCGL!A!A'!J    rc \V\4'dVPV4pVPR4Uu.uFq"P R4NK ppV#uupi)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 r/r0)rrrrr)rrr9 subclassess&& rrWVerbnetCorpusReader.subclassess\ gs # #ll7+G07?V/W /W8LL /W   sAc \\V\4'dVPV4p.pVPR4FhpTP RVP R4RVPR4Uu.uF'pRVP R4RVP R4/NK) up/4Kj V#uupi)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/THEMROLEtype modifiersSELRESTRS/SELRESTRvalueValue)rrrrrMr)rr themrolestrolerestrs&& rr_VerbnetCorpusReader.themroless gs # #ll7+G __%9:E   EIIf-%*]]3G%H"%HE!%))G"4feii>OP%H" ; "s.-B)c nVPF$pVPVPV4V4K& R#)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>)rr4s& r_indexVerbnetCorpusReader._indexs+mmF   txx/ 8$rc VPR4pW PV&W0PVPV4&VP R4F}pVP VPR4,P V4VPRR4P4F%pVPV,P V4K' K VP R4FpVPWb4K R#)zHelper for ``_index()``r0rrr%r&r/N) rr r shortidrr rMr'r rd)rr8r4rr r%r9s&&& rrd!VerbnetCorpusReader._index_helper s++d#)/g&9@ W 56oo&67F  F!3 4 ; ;G Djjr*002&&r*11':38 (?@H   x 0Arc  VPEFYpVRRpWPV&W PVPV4&VP V4;_uu_4pVP P VP44FpVP4pV^,elVPV^,,PV4V^,P4F%pVPV,PV4K' KV^,e>WPV^,&V^,pW PVPV4&KQR4h RRR4EK\ R# +'giEKr;i)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). Nzunexpected match condition) r=r r rhopen _INDEX_REfinditerreadgroupsr rMr'r )rr4rfpmrpr%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 DE-- E? c "VPPV4'dV#VPPV4'g\RV,4hVPV,# \ dp\RT,4ThRp?ii;i)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_REr@r KeyError)rrhes&& rr?VerbnetCorpusReader.longid;s ??  ) )N!!''00>HI I Q**73 3 Q>HIq P QsA++ B6B  Bc VPPV4'dV#VPPV4pV'dVP^4#\ RV,4h)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.ru)rxrwrvgroupr@)rr?rrs&& rrhVerbnetCorpusReader.shortidJsV    ! !& ) )M OO ! !& ) 771: >GH Hrc  8.pVPR4F}pVPR4Uu.uF'pRVPR4RVPR4/NK) ppVPRVPR4RVRVPR4R 8H/4K V#uupi) 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/ARGrZr]predicate_value argumentsnegatedbool!)rrrM)rrTsemantics_within_single_framepredargrs&& rrQ/VerbnetCorpusReader._get_semantics_within_frame\s)+%OO$45D << 33C'37773CD3  * 0 0%txx'8txx/36  6-,s-Bc PVPR4pVeVPpV#RpV#)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)rrTexample_element example_texts&& rrN-VerbnetCorpusReader._get_example_within_framews9",,'9:  &*//LLrc rVPR4pRVPR,RVPRR4/#)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&)rattribr)rrTdescription_elements&& rrO1VerbnetCorpusReader._get_description_within_framesA&ll=9 *11)< ,00bA  rc  .pVPR4FpVPp\4pRVP9dVP R4MRVR&VP R4Uu.uF'pRVP R4RVP R4/NK) upVR&VP R4Uu.uF'pRVP R4RVP R4/NK) upVR &VP R VR V/4K V#uupiuupi) 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^rZ selrestrszSYNRESTRS/SYNRESTR synrestrspos_tagr[)rtagdictrrrrM)rrTsyntax_within_single_frameeltrr[ras&& rrP4VerbnetCorpusReader._get_syntactic_list_within_frames&("<<)CggGI5< 5J!1PRIg ![[)=>&>E%))G,feii6GH>&Ik " ![[)=>&>E%))G,feii6GH>&Ik " ' - -G[)< **)&&s '-C;--Dc \V\4'dVPV4pVPR4R,pW P VRR7R,, pW P VRR7R,, pVR, pW P VRR7R,, pVR, pW PVRR7, pV#)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. r0  )indentz Thematic roles:  z Frames: )rrrrpprint_subclassespprint_memberspprint_themroles pprint_frames)rrss&& rpprintVerbnetCorpusReader.pprints gs # #ll7+G KK  $ # #GD # 9D @@  6 == "" " "76 " :T AA ]    77rc \V\4'dVPV4pVPV4pV'gR.pRRP V4,p\ P !V^FW"R,R7#)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:  rinitial_indentsubsequent_indent)rrrrWjointextwrapfill)rrrrWrs&&& rr%VerbnetCorpusReader.pprint_subclassessf gs # #ll7+G__W- "J SXXj1 1}} r&TM  rc \V\4'dVPV4pVPV4pV'gR.pRRP V4,p\ P !V^FW"R,R7#)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: rrr)rrrr!rrr)rrrmembersrs&&& rr"VerbnetCorpusReader.pprint_memberssf gs # #ll7+G++g&jG #((7+ +}} r&TM  rc \V\4'dVPV4p.pVPV4FpVR,VP R4,pVR,Uu.uFpVR,VR,,NK ppV'd(VRP RP V44, pVPV4K RP V4#uupi)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. * rZr[r][{}]rr)rrrr_rformatrrM)rrrpiecesthemrolepiecemodifierr[s&&& rr$VerbnetCorpusReader.pprint_themroless gs # #ll7+Gw/HTMHLL$88E!) 5 5H!HV$444 5 sxx ':;; MM% 0yy  s( Cc \V\4'dVPV4p.pVPV4F#pVP VP WB44K% RP V4#)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)rrrrRrM_pprint_single_framer)rrrrrTs&&& rr!VerbnetCorpusReader.pprint_framess] gs # #ll7+G{{7+G MM$33GD E,yy  rc &VPW4R,pW0PWR,4R,, pVVPWR,4R,, pW2R,, pW0PWR,4, pV#)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)rrTr frame_strings&&& rr(VerbnetCorpusReader._pprint_single_frames<>'-*@*MN NKrc  0.pVR,FpVR,p.pRVR,9d6VR,R,'d VPVR,R,4TVR,R,VR,R,,Uu.uF#pRPVR,VR,4NK% up, pV'd(VR PR PV44, pVPV4K VR PV4,#uupi) 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. rKrr]r[rrz{}{}rZrr)rMrr)rrTrrelementr modifier_listras&&& rr/VerbnetCorpusReader._pprint_syntax_within_frameJsx((GI&EM'+..7;3G3P3P$$W[%9'%BC K(5k*;788 eGneFm<8 Msxx '>?? MM% ) (((s)Dc  $a.pVR,FapVR,Uu.uF qUR,NK ppTPVR,'dRMR VR, RR PV4 R 24Kc R PV3R lV44#uupi) 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. rLrr]r¬r&r(z, )rc32<"TF pS RV 2xK R#5i)rNr)r(rrs& rr)EVerbnetCorpusReader._pprint_semantics_within_frame..usB6%F82eW-6s)rMr)rrTrr predicateargumentrs&&f rr2VerbnetCorpusReader._pprint_semantics_within_framefs --I;D[;QR;Qx'**;QIR MM$Y//4R8CT9U8VVWX\XaXabkXlWmmno . yyB6BBB SsB )r r r r )Fr)NNNN)r&)(__name__ __module__ __qualname____firstlineno____doc__rrecompilervrxrmr!r,r:rrrRrWr_rerdrr?rhrQrNrOrPrrrrrrrrrr__static_attributes____classdictcell__) __classdict__s@rrrs .67JB**]+K2 WI! X&88HB 8$> 9 1CD Q I$-6  *D* ( (!0! $ > )8CCrr)rrr collectionsrnltk.corpus.reader.xmldocsrrrrrrs( #6_ C/_ Cr