Provided by: wordnet-sense-index_3.0-23ubuntu1_all bug

NAME

       index.sense, sense.idx - WordNet's sense index

DESCRIPTION

       The  WordNet  sense  index  provides  an alternate method for accessing
       synsets and word senses in the  WordNet  database.   It  is  useful  to
       applications  that  retrieve  synsets or other information related to a
       specific sense in WordNet, rather than all the  senses  of  a  word  or
       collocation.  It can also be used with tools like grep and Perl to find
       all senses of a word in one  or  more  parts  of  speech.   A  specific
       WordNet  sense,  encoded  as  a sense_key, can be used as an index into
       this file to obtain its WordNet sense number, the database byte  offset
       of the synset containing the sense, and the number of times it has been
       tagged in the semantic concordance texts.

       Concatenating the lemma and lex_sense fields of a  semantically  tagged
       word  (represented  in  a <wf ... > attribute/value pair) in a semantic
       concordance file, using % as the concatenation character,  creates  the
       sense_key for that sense, which can in turn be used to search the sense
       index file.

       A sense_key is the best way to represent a sense in semantic tagging or
       other systems that refer to WordNet senses.  sense_keys are independent
       of  WordNet  sense  numbers  and  synset_offsets,  which  vary  between
       versions  of  the database.  Using the sense index and a sense_key, the
       corresponding synset (via the synset_offset) and WordNet  sense  number
       can  easily be obtained.  A mapping from noun sense_keys in WordNet 1.6
       to corresponding 2.0 sense_keys is provided with version  2.0,  and  is
       described in sensemap(5WN).

       See wndb(5WN) for a thorough discussion of the WordNet database files.

   File Format
       The  sense  index  file lists all of the senses in the WordNet database
       with each line representing one sense.  The  file  is  in  alphabetical
       order,  fields  are separated by one space, and each line is terminated
       with a newline character.

       Each line is of the form:

              sense_key  synset_offset  sense_number  tag_cnt

       sense_key is an encoding of the word sense.  Programs can  construct  a
       sense  key  in  this  format and use it as a binary search key into the
       sense index file.  The format of a sense_key is described below.

       synset_offset is the byte offset that the synset containing  the  sense
       is  found  at  in the database "data" file corresponding to the part of
       speech encoded in the sense_key.  synset_offset is an  8  digit,  zero-
       filled  decimal integer, and can be used with fseek(3) to read a synset
       from the data file.   When  passed  to  the  WordNet  library  function
       read_synset()  along  with  the  syntactic  category,  a data structure
       containing the parsed synset is returned.

       sense_number is a decimal integer indicating the sense  number  of  the
       word,  within  the  part of speech encoded in sense_key, in the WordNet
       database.  See wndb(5WN) for information about how  sense  numbers  are
       assigned.

       tag_cnt  represents  the decimal number of times the sense is tagged in
       various semantic concordance texts.  A tag_cnt of 0 indicates that  the
       sense has not been semantically tagged.

   Sense Key Encoding
       A sense_key is represented as:

              lemma%lex_sense

       where lex_sense is encoded as:

              ss_type:lex_filenum:lex_id:head_word:head_id

       lemma  is  the  ASCII  text  of the word or collocation as found in the
       WordNet database index file corresponding to pos.  lemma  is  in  lower
       case,  and  collocations are formed by joining individual words with an
       underscore (_) character.

       ss_type is a one digit decimal integer representing the synset type for
       the  sense.   See  Synset  Type  below  for  a  listing  of the numbers
       corresponding to each synset type.

       lex_filenum is a two digit decimal integer representing the name of the
       lexicographer   file   containing   the  synset  for  the  sense.   See
       lexnames(5WN) for the  list  of  lexicographer  file  names  and  their
       corresponding numbers.

       lex_id  is  a two digit decimal integer that, when appended onto lemma,
       uniquely identifies  a  sense  within  a  lexicographer  file.   lex_id
       numbers usually start with 00, and are incremented as additional senses
       of the  word  are  added  to  the  same  file,  although  there  is  no
       requirement  that  the  numbers  be consecutive or begin with 00.  Note
       that a value of 00 is the default, and  therefore  is  not  present  in
       lexicographer files.  Only non-default lex_id values must be explicitly
       assigned in lexicographer files.  See wninput(5WN) for  information  on
       the format of lexicographer files.

       head_word  is  only  present  if the sense is in an adjective satellite
       synset.  It is the lemma of the first  word  of  the  satellite's  head
       synset.

       head_id  is  a  two  digit  decimal  integer  that,  when appended onto
       head_word,  uniquely  identifies  the  sense  of  head_word  within   a
       lexicographer  file, as described for lex_id.  There is a value in this
       field only if head_word is present.

   Synset Type
       The synset type is encoded as follows:

              1    NOUN
              2    VERB
              3    ADJECTIVE
              4    ADVERB
              5    ADJECTIVE SATELLITE

NOTES

       For non-satellite senses the  head_word  and  head_id  fields  have  no
       values, however the field separator character (:) is present.

ENVIRONMENT VARIABLES (UNIX)

       WNHOME              Base    directory    for   WordNet.    Default   is
                           /usr/local/WordNet-3.0.

       WNSEARCHDIR         Directory in which the WordNet  database  has  been
                           installed.  Default is WNHOME/dict.

REGISTRY (WINDOWS)

       HKEY_LOCAL_MACHINE\SOFTWARE\WordNet\3.0\WNHome
                           Base    directory    for   WordNet.    Default   is
                           C:\Program Files\WordNet\3.0.

FILES

       index.sense         sense index

SEE ALSO

       binsrch(3WN),     wnsearch(3WN),      lexnames(5WN),      wnintro(5WN),
       sensemap(5WN), wndb(5WN), wninput(5WN).