Use Find Text -- Collocation TAPoRware Tool in Your Web Page

You can add a text field and a button in your web page to get the collocates of the pattern you entered in that page by call TAPoRware cgi script.

<table style="border: solid gray 1pt"><tr><td>

<form method="post" name="htmlForm" enctype="multipart/form-data" target="_blank" action="http://taporware.mcmaster.ca/~taporware/cgi-bin/prototype/hfindtext.cgi" onsubmit="document.htmlForm.htmlurl.value=document.location.href">

<input type="hidden" name="source" value="url" />

<input type="hidden" name="htmlurl" />

<input type="hidden" name="freetext" value="yes"/>

Pattern: <input type="text" name="find_patt" />

<input type="hidden" name="context" value="1" />

<input type="hidden" name="conLeng" value="5" />

<input type="hidden" name="finddisp" value="1" />

<input type="hidden" name="sorting" value="3" />

<input type="hidden" name="taporface" value="same" />

<input type="submit" name="doIt" value="Get Collocate of the Page" />

</form>

</td></tr></table>

REST Service Interface

Taporware Rest service uses plain text HTTP protocol so that you can submit your request use either POST or GET method.

• Service URI: http://tapor1-dev.mcmaster.ca/~restserv/html/collocates.
• Parameters:
  • htmlInput -- any HTML text
  • htmlTag -- any valid HTML tag in your submitted HTML text
  • pattern -- Unix styled pattern you want to find in the text
  • context -- value can be 1/2/3/4 which corresponding to Words/Lines/Sentences/Paragraphs respectively
  • contextlength -- number of words/lines/sentences/paragraphs before and after the specified context
  • sorting -- sorting criteria. The values are 1/2/3 and corresponding to Co-occurring words By frequency/Alphabetically/By z-score respectively
  • outFormat -- output format. The values are 1/2/3/4 and corresponding to HTML/XML tree/XML text in HTML/Tab delimited text

• Enter a valid html tag or tag list separated by comma, default is "body"
• Enter a word or pattern in the corresponding text field by check the related radio button

• Select the collocates sorting criteria

• • htmlTag -- any html element (tag) name or multiple html element name separated by comma

• • context -- value can be 1/2/3 which corresponding to Words/Lines/Sentences respectively

• Endpoint URL: http://taporware.mcmaster.ca:9982
• Service URI: http://taporware.mcmaster.ca/~taporware/webservice

Predefined Parameter Values in Tool Bar

• Source: the page the user is currently in.
• Element: body or set by site owner
• Context: words
• Context length: 5
• Sorting: co-occurring words by frequency
• Display format: HTML

Term Definition

• collocation: a sequence of words or terms which co-occur more often than would be expected by chance.
• pattern: A sequence of characters used either with regular expression notation or for path name expansion, as a means of selecting various character strings or path names, respectively. Values are matched against patterns to see if they should be included/excluded. In patterns "*" matches any string, "?" matches any single character.
• context: the text that occurs before and after a piece of text (or a pattern in this case).

• Obtain HTML string by URL or from user's local disk
• Obtain text contained by user specified tags
• Find user specified word/pattern along with user specified context -- concordance
• If user selects "sorting by z-score", perform span word counting and total words counting, and then calculate the values of z-score
• Otherwise, sort and count the words of the concordance text
• Generate output of the collocates of the concordance text

• Enter a valid URL in the URL field or enter a local upload html text
• Enter a valid html tag or tag list seperated by comma, default is "body"
• Enter word or pattern in the corresponding text field by check the related radio button
• Select the context of concordance and the length of context
• Select the collocates sorting critieia
• Select output format
• If you want the results displayed in the same window with taporware interface, uncheck the check box - "Open results in new window"
• Finally, click the "Submit" button

• URL: http://taporware.mcmaster.ca/cgi-bin/prototype/hcollocation.cgi

Here are the parameters:

• Endpoint URL: http://strange.mcmaster.ca:9982
• Service URI: http://strange.mcmaster.ca/~taporware/webservice
• Service Method: find_Collocation_HTML
• parameters:
  • htmlInput -- any html string
  • htmlTag -- any html element (tag) name or multple html element name separated by comma
  • pattern -- unix styled pattern or regular expression
  • context -- value can be 1/2/3 which coresponding to Words/Lines/Sentences respectively
  • contextLength -- length of context
  • sorting -- values can be 1/2/3 corresponding to co-occurrence words by frequency/alphabetically/z-score
  • outFormat -- values are same as parameter "finddisp" in the CGI interface above

Find Text — Collocation

Description

History

Pseudocode

Ways of Using

CGI Interface

Web Service Interface

Known Bugs

To Do

-- MattPatey - 13 Oct 2005