Use Visual Collocates TAPoRware Tool in Your Web Page

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

Here is the code that you can cut and paste to your web pages:

<form method="post" name="htmlForm" enctype="multipart/form-data" target="_blank" action="http://taporware.mcmaster.ca/~taporware/cgi-bin/prototype/bviscollocator_new.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"/>

<input type="hidden" name="tagtext" value="body" />

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="sorting" value="3" />

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

<input type="submit" name="doIt" value="Visual Collocates" />

</form>

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/viscollocate.
• 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
  • glasgow -- true/false. If true, the glasgow stop words will be excluded
  • 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

Ways of Using

• Enter a valid URL in the URL field or enter a local path to upload source text
• Enter a valid html or xml tag (multiple tags list separated by comma) if the text format is html or xml default is "body"
• Enter a word or pattern in the corresponding text field
• Check the "Exclude Glasgow Stop Words" checkbox if you don't want the Glasgow stop words
• Select the context of concordance and the length of context
• Select the collocates sorting criteria
• 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

CGI Interface

If you want to use this tool from your web site, here is the CGI Interface: (Note: If you want to upload local html text to the tool, you need to use attribute name/value pair: enctype="multipart/form-data" within the form tag)

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

Here are the parameters:

Web Service Interface

Taporware provides web services to any non-benefit organizations. here is the taporware web services information:

• Endpoint URL: http://taporware.mcmaster.ca:9982
• Service URI: http://taporware.mcmaster.ca/~taporware/webservice
• Service Method: visual_collocates_HTML
• parameters:
  • htmlInput -- any text string, if the text is in xml or html format, all tags will be stripped
  • htmlTag -- any xml or html element (tag) name or multiple xml or html element name separated by comma if the source text is in the xml or html format
  • pattern -- unix styled pattern or regular expression
  • glasgow -- a boolean ("true" by default) to indicate if Glasgow stop words being excluded
  • context -- value can be 1/2/3 which corresponding 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

Try It

Try it!

TOC: No TOC in "Main.TAPoRwareVisualCollocator"

* This tool requires the JRE (v1.4.2 and up) in order to work properly.

Pseudocode

• extract text from website or local file
• load up applet, passing text and parameters from form
• get initial collocates and create graph data using the results
  • build SOAP message and send to TAPoRwareHTMLCollocation
  • process results, decoding from base64 if necessary
• set up graph visualization and initialize it using the graph data
  • add listeners for various user actions: adding new collocates, deleting collocates, sticking/unsticking nodes

Responsibility

Visual Collocator

Try It

Description

Known Bugs

• close and re-open the browser
• open the Java console and push x to clear the classloader cache

-- AndrewMacdonald - 05 May 2006