forked from PolMine/RcppCWB
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcqp_query.html
More file actions
242 lines (214 loc) · 16.5 KB
/
cqp_query.html
File metadata and controls
242 lines (214 loc) · 16.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Execute CQP Query and Retrieve Results. — cqp_query • RcppCWB</title><!-- jquery --><script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script><!-- Bootstrap --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous"><script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script><!-- bootstrap-toc --><link rel="stylesheet" href="../bootstrap-toc.css"><script src="../bootstrap-toc.js"></script><!-- Font Awesome icons --><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous"><!-- clipboard.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script><!-- headroom.js --><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script><!-- pkgdown --><link href="../pkgdown.css" rel="stylesheet"><script src="../pkgdown.js"></script><meta property="og:title" content="Execute CQP Query and Retrieve Results. — cqp_query"><meta property="og:description" content="Using CQP queries requires a two-step procedure: At first, you execute a
query using cqp_query. Then, cqp_dump_subcorpus will return a
matrix with the regions of the matches for the query."><!-- mathjax --><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script><!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]--></head><body data-spy="scroll" data-target="#toc">
<div class="container template-reference-topic">
<header><div class="navbar navbar-default navbar-fixed-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<span class="navbar-brand">
<a class="navbar-link" href="../index.html">RcppCWB</a>
<span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="">0.6.0</span>
</span>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav"><li>
<a href="../reference/index.html">Reference</a>
</li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
Articles
<span class="caret"></span>
</a>
<ul class="dropdown-menu" role="menu"><li>
<a href="../articles/vignette.html">Writing performance code with RcppCWB</a>
</li>
</ul></li>
<li>
<a href="../news/index.html">Changelog</a>
</li>
</ul><ul class="nav navbar-nav navbar-right"><li>
<a href="https://github.com/PolMine/RcppCWB/" class="external-link">
<span class="fab fa-github fa-lg"></span>
</a>
</li>
</ul></div><!--/.nav-collapse -->
</div><!--/.container -->
</div><!--/.navbar -->
</header><div class="row">
<div class="col-md-9 contents">
<div class="page-header">
<h1>Execute CQP Query and Retrieve Results.</h1>
<small class="dont-index">Source: <a href="https://github.com/PolMine/RcppCWB/blob/HEAD/R/cqp.R" class="external-link"><code>R/cqp.R</code></a></small>
<div class="hidden name"><code>cqp_query.Rd</code></div>
</div>
<div class="ref-description">
<p>Using CQP queries requires a two-step procedure: At first, you execute a
query using <code>cqp_query</code>. Then, <code>cqp_dump_subcorpus</code> will return a
matrix with the regions of the matches for the query.</p>
</div>
<div id="ref-usage">
<div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">cqp_query</span><span class="op">(</span><span class="va">corpus</span>, <span class="va">query</span>, subcorpus <span class="op">=</span> <span class="st">"QUERY"</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">cqp_dump_subcorpus</span><span class="op">(</span><span class="va">corpus</span>, subcorpus <span class="op">=</span> <span class="st">"QUERY"</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">cqp_subcorpus_size</span><span class="op">(</span><span class="va">corpus</span>, subcorpus <span class="op">=</span> <span class="st">"QUERY"</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">cqp_list_subcorpora</span><span class="op">(</span><span class="va">corpus</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">cqp_drop_subcorpus</span><span class="op">(</span><span class="va">corpus</span><span class="op">)</span></span></code></pre></div>
</div>
<div id="arguments">
<h2>Arguments</h2>
<dl><dt>corpus</dt>
<dd><p>a CWB corpus</p></dd>
<dt>query</dt>
<dd><p>a CQP query</p></dd>
<dt>subcorpus</dt>
<dd><p>subcorpus name</p></dd>
</dl></div>
<div id="details">
<h2>Details</h2>
<p>The <code>cqp_query</code> function executes a CQP query. The
<code>cqp_subcorpus_size</code> function returns the number of matches for the CQP
query. The <code>cqp_dump_subcorpus</code> function will return a two-column matrix
with the left and right corpus positions of the matches for the CQP query.</p>
</div>
<div id="references">
<h2>References</h2>
<p>Evert, S. 2005. The CQP Query Language Tutorial. Available online at
<a href="https://cwb.sourceforge.io/files/CWB_Encoding_Tutorial.pdf" class="external-link">https://cwb.sourceforge.io/files/CWB_Encoding_Tutorial.pdf</a></p>
</div>
<div id="author">
<h2>Author</h2>
<p>Andreas Blaette, Bernard Desgraupes, Sylvain Loiseau</p>
</div>
<div id="ref-examples">
<h2>Examples</h2>
<div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span><span class="fu">cqp_query</span><span class="op">(</span>corpus <span class="op">=</span> <span class="st">"REUTERS"</span>, query <span class="op">=</span> <span class="st">'"oil";'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> <pointer: 0x6000011da3a0></span>
<span class="r-in"><span><span class="fu">cqp_subcorpus_size</span><span class="op">(</span><span class="st">"REUTERS"</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] 78</span>
<span class="r-in"><span><span class="fu">cqp_dump_subcorpus</span><span class="op">(</span><span class="st">"REUTERS"</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [,1] [,2]</span>
<span class="r-out co"><span class="r-pr">#></span> [1,] 15 15</span>
<span class="r-out co"><span class="r-pr">#></span> [2,] 50 50</span>
<span class="r-out co"><span class="r-pr">#></span> [3,] 57 57</span>
<span class="r-out co"><span class="r-pr">#></span> [4,] 72 72</span>
<span class="r-out co"><span class="r-pr">#></span> [5,] 89 89</span>
<span class="r-out co"><span class="r-pr">#></span> [6,] 119 119</span>
<span class="r-out co"><span class="r-pr">#></span> [7,] 121 121</span>
<span class="r-out co"><span class="r-pr">#></span> [8,] 129 129</span>
<span class="r-out co"><span class="r-pr">#></span> [9,] 163 163</span>
<span class="r-out co"><span class="r-pr">#></span> [10,] 173 173</span>
<span class="r-out co"><span class="r-pr">#></span> [11,] 177 177</span>
<span class="r-out co"><span class="r-pr">#></span> [12,] 200 200</span>
<span class="r-out co"><span class="r-pr">#></span> [13,] 243 243</span>
<span class="r-out co"><span class="r-pr">#></span> [14,] 300 300</span>
<span class="r-out co"><span class="r-pr">#></span> [15,] 370 370</span>
<span class="r-out co"><span class="r-pr">#></span> [16,] 473 473</span>
<span class="r-out co"><span class="r-pr">#></span> [17,] 494 494</span>
<span class="r-out co"><span class="r-pr">#></span> [18,] 549 549</span>
<span class="r-out co"><span class="r-pr">#></span> [19,] 585 585</span>
<span class="r-out co"><span class="r-pr">#></span> [20,] 608 608</span>
<span class="r-out co"><span class="r-pr">#></span> [21,] 773 773</span>
<span class="r-out co"><span class="r-pr">#></span> [22,] 780 780</span>
<span class="r-out co"><span class="r-pr">#></span> [23,] 840 840</span>
<span class="r-out co"><span class="r-pr">#></span> [24,] 1053 1053</span>
<span class="r-out co"><span class="r-pr">#></span> [25,] 1091 1091</span>
<span class="r-out co"><span class="r-pr">#></span> [26,] 1183 1183</span>
<span class="r-out co"><span class="r-pr">#></span> [27,] 1244 1244</span>
<span class="r-out co"><span class="r-pr">#></span> [28,] 1264 1264</span>
<span class="r-out co"><span class="r-pr">#></span> [29,] 1294 1294</span>
<span class="r-out co"><span class="r-pr">#></span> [30,] 1570 1570</span>
<span class="r-out co"><span class="r-pr">#></span> [31,] 1689 1689</span>
<span class="r-out co"><span class="r-pr">#></span> [32,] 1704 1704</span>
<span class="r-out co"><span class="r-pr">#></span> [33,] 1818 1818</span>
<span class="r-out co"><span class="r-pr">#></span> [34,] 1830 1830</span>
<span class="r-out co"><span class="r-pr">#></span> [35,] 1953 1953</span>
<span class="r-out co"><span class="r-pr">#></span> [36,] 2087 2087</span>
<span class="r-out co"><span class="r-pr">#></span> [37,] 2112 2112</span>
<span class="r-out co"><span class="r-pr">#></span> [38,] 2165 2165</span>
<span class="r-out co"><span class="r-pr">#></span> [39,] 2189 2189</span>
<span class="r-out co"><span class="r-pr">#></span> [40,] 2207 2207</span>
<span class="r-out co"><span class="r-pr">#></span> [41,] 2295 2295</span>
<span class="r-out co"><span class="r-pr">#></span> [42,] 2346 2346</span>
<span class="r-out co"><span class="r-pr">#></span> [43,] 2451 2451</span>
<span class="r-out co"><span class="r-pr">#></span> [44,] 2498 2498</span>
<span class="r-out co"><span class="r-pr">#></span> [45,] 2520 2520</span>
<span class="r-out co"><span class="r-pr">#></span> [46,] 2641 2641</span>
<span class="r-out co"><span class="r-pr">#></span> [47,] 2785 2785</span>
<span class="r-out co"><span class="r-pr">#></span> [48,] 2843 2843</span>
<span class="r-out co"><span class="r-pr">#></span> [49,] 2875 2875</span>
<span class="r-out co"><span class="r-pr">#></span> [50,] 2892 2892</span>
<span class="r-out co"><span class="r-pr">#></span> [51,] 2920 2920</span>
<span class="r-out co"><span class="r-pr">#></span> [52,] 2929 2929</span>
<span class="r-out co"><span class="r-pr">#></span> [53,] 2984 2984</span>
<span class="r-out co"><span class="r-pr">#></span> [54,] 3008 3008</span>
<span class="r-out co"><span class="r-pr">#></span> [55,] 3026 3026</span>
<span class="r-out co"><span class="r-pr">#></span> [56,] 3053 3053</span>
<span class="r-out co"><span class="r-pr">#></span> [57,] 3072 3072</span>
<span class="r-out co"><span class="r-pr">#></span> [58,] 3095 3095</span>
<span class="r-out co"><span class="r-pr">#></span> [59,] 3144 3144</span>
<span class="r-out co"><span class="r-pr">#></span> [60,] 3152 3152</span>
<span class="r-out co"><span class="r-pr">#></span> [61,] 3183 3183</span>
<span class="r-out co"><span class="r-pr">#></span> [62,] 3211 3211</span>
<span class="r-out co"><span class="r-pr">#></span> [63,] 3252 3252</span>
<span class="r-out co"><span class="r-pr">#></span> [64,] 3314 3314</span>
<span class="r-out co"><span class="r-pr">#></span> [65,] 3319 3319</span>
<span class="r-out co"><span class="r-pr">#></span> [66,] 3368 3368</span>
<span class="r-out co"><span class="r-pr">#></span> [67,] 3412 3412</span>
<span class="r-out co"><span class="r-pr">#></span> [68,] 3463 3463</span>
<span class="r-out co"><span class="r-pr">#></span> [69,] 3468 3468</span>
<span class="r-out co"><span class="r-pr">#></span> [70,] 3517 3517</span>
<span class="r-out co"><span class="r-pr">#></span> [71,] 3585 3585</span>
<span class="r-out co"><span class="r-pr">#></span> [72,] 3611 3611</span>
<span class="r-out co"><span class="r-pr">#></span> [73,] 3645 3645</span>
<span class="r-out co"><span class="r-pr">#></span> [74,] 3710 3710</span>
<span class="r-out co"><span class="r-pr">#></span> [75,] 3749 3749</span>
<span class="r-out co"><span class="r-pr">#></span> [76,] 3785 3785</span>
<span class="r-out co"><span class="r-pr">#></span> [77,] 3835 3835</span>
<span class="r-out co"><span class="r-pr">#></span> [78,] 3999 3999</span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">cqp_query</span><span class="op">(</span>corpus <span class="op">=</span> <span class="st">"REUTERS"</span>, query <span class="op">=</span> <span class="st">'"crude" "oil";'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> <pointer: 0x6000011da3a0></span>
<span class="r-in"><span><span class="fu">cqp_subcorpus_size</span><span class="op">(</span><span class="st">"REUTERS"</span>, subcorpus <span class="op">=</span> <span class="st">"QUERY"</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] 12</span>
<span class="r-in"><span><span class="fu">cqp_dump_subcorpus</span><span class="op">(</span><span class="st">"REUTERS"</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [,1] [,2]</span>
<span class="r-out co"><span class="r-pr">#></span> [1,] 14 15</span>
<span class="r-out co"><span class="r-pr">#></span> [2,] 56 57</span>
<span class="r-out co"><span class="r-pr">#></span> [3,] 548 549</span>
<span class="r-out co"><span class="r-pr">#></span> [4,] 584 585</span>
<span class="r-out co"><span class="r-pr">#></span> [5,] 607 608</span>
<span class="r-out co"><span class="r-pr">#></span> [6,] 2497 2498</span>
<span class="r-out co"><span class="r-pr">#></span> [7,] 2842 2843</span>
<span class="r-out co"><span class="r-pr">#></span> [8,] 2891 2892</span>
<span class="r-out co"><span class="r-pr">#></span> [9,] 2928 2929</span>
<span class="r-out co"><span class="r-pr">#></span> [10,] 3644 3645</span>
<span class="r-out co"><span class="r-pr">#></span> [11,] 3709 3710</span>
<span class="r-out co"><span class="r-pr">#></span> [12,] 3998 3999</span>
</code></pre></div>
</div>
</div>
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
<nav id="toc" data-toggle="toc" class="sticky-top"><h2 data-toc-skip>Contents</h2>
</nav></div>
</div>
<footer><div class="copyright">
<p></p><p>Developed by Andreas Blaette, Bernard Desgraupes, Sylvain Loiseau.</p>
</div>
<div class="pkgdown">
<p></p><p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.0.6.</p>
</div>
</footer></div>
</body></html>