CzEngVallex – REST-API

 

3 methods

i/ pairOfVerbs – searching by verbs (lemmas)

ii/ pairOfFrames – searching by frames (frame IDs)

iii/ parameters – searching by parameters verbs (lemmas), arguments, forms in valency lexicon (Eng/PDT-Vallex) and forms in corpora (PCEDT)

 

i/ searching by verbs

parameters

- mandatory

  • language – value “cz” or “en”

- optional

  • sourceVerb, targetVerb – string (with regular expressions) – source/target verb lemma, default value is “.*”
  • pairsLimit – number - maximum of listed frame pairs, default value is “1000”
  • examplesLimit – number – maximum of listed sentences from corpora for one frame pair, default value is “5”
  • examplesForm – type of listing sentences from corpora – value “plain” or “complex”, default value is “plain”

output

- number of found frame pairs

- found frame pairs – pair of verbs, frame of source verb (and arguments of this frame, notes and examples from valency lexicon PDT-/EngVallex), frame of target verb (and its arguments, notes and examples from Eng/PDT-Vallex), CzEngVallex mapping and examples from PCEDT

examples

https://lindat.mff.cuni.cz/services/CzEngVallex/api/pairOfVerbs?language=en&sourceVerb=abandon&targetVerb=.*&examplesLimit=3&examplesForm=plain&pairsLimit=2

or

curl --data 'language=en&sourceVerb=abandon&targetVerb=.*&examplesLimit=3&examplesForm=plain&pairsLimit=2' https://lindat.mff.cuni.cz/services/CzEngVallex/api/pairOfVerbs

 

ii/ searching by frames

parameters

- mandatory

  • language – value “cz” or “en”

- optional

  • sourceFrame, targetFrame – string (with regular expressions) – source/target frame ID, default value is “.*”
  • pairsLimit – number - maximum of listed frame pairs, default value is “1000”
  • examplesLimit – number – maximum of listed sentences from corpora for one frame pair, default value is “5”
  • examplesForm – type of listing sentences from corpora – value “plain” or “complex”, default value is “plain”

output

- number of found frame pairs

- found frame pairs – pair of verbs, frame of source verb (and arguments of this frame, notes and examples from valency lexicon PDT-/EngVallex), frame of target verb (and its arguments, notes and examples from Eng/PDT-Vallex), CzEngVallex mapping and examples from PCEDT

examples

https://lindat.mff.cuni.cz/services/CzEngVallex/api/pairOfFrames?language=en&sourceFrame=ev-w1f3&targetFrame=v-w5.*

or

curl --data 'language=en&sourceFrame=ev-w1f3&targetFrame=v-w5.*' https://lindat.mff.cuni.cz/services/CzEngVallex/api/pairOfFrames

 

iii/ searching by parameters

parameters

- mandatory

  • language – value “cz” or “en”

- optional

  • sourceVerb, targetVerb – string (with regular expressions) – source/target verb lemma, default value = “.*”
  • pairsLimit – number - maximum of listed frame pairs, default value = 1000
  • functors – string – searched arguments separated by “|”
  • lexArgForms – searched argument forms from valency lexicon separated by “|” (more about searching at the ufal.mff.cuni.cz/czengvallex page; if you need to use “+” sign use “%2B” instead)
  • corpArgForms – searched argument forms from PCEDT separated by “|” (more about searching at the ufal.mff.cuni.cz/czengvallex page; if you need to use “+” sign use “%2B” instead)

output

- number of found frame pairs

- found frame pairs in the form

  • for empty parameter corpArgForms (all sentences from PCEDT for frame pair)                       

        [

                "abound.ev-w10f1",

                "být.v-w243f2",

                "ALL"

        ],

  • for non-empty parameter corpArgForms – in the third line are sentences from PCEDT that match the conditions from corpArgForms       

        [

                "abandon.ev-w1f2",

                "opustit.v-w3161f1",

                "{EnglishT-wsj_0118-s14:EnglishT-wsj_0118-s14-t26.T-wsj0118-001-p1s13:T-wsj0118-001-p1s13a22}"

        ]

 

examples

https://lindat.mff.cuni.cz/services/CzEngVallex/api/parameters?language=en&sourceVerb=abandon&targetVerb=opustit&functors=ACT|ACT&lexArgForms=|1&corpArgForms=|f:domy

or

curl --data 'language=en&sourceVerb=abandon&targetVerb=opustit&functors=ACT|ACT&lexArgForms=|1&corpArgForms=|f:domy'  https://lindat.mff.cuni.cz/services/CzEngVallex/api/parameters