# Mapping from FrameNet2 semantic roles into the semantic roles defined
# in O'Hara and Wiebe (2007), combining roles from FrameNet, Treebank, Conceputal
# Graphs.
#    http://www.cs.nmsu.edu/~tomohara/cl-prep-article
#
# Format:
#    <Framenet-role><TAB><combined-role><TAB>'# '<comments>
#
#------------------------------------------------------------------------
# These roles are similar in spirit to the high-level roles used by Gildea and Jurafsky (2002)
# in testing the use of abstract roles rather than the specific FrameNet
# ones.
#    Gildea, Daniel and Daniel Jurafsky (2002), "Automatic Labeling of
#    Semantic Roles", Computational Linguistics 28(3):245-288.
# However, there are about 30 roles instead of 18.
#
# NOTES:
# - The combined roles are specified via CG-style abbreviations to
#   facilitate comparisons with the CG mapping file (framenet-to-CG.mapping).
# - The purpose of this mapping is to support preposition disambiguation
#   for differential extraction, so PP interpretations of roles is
#   given priority over NP (e.g., see next note on Sound).
# - The mapping ignores the frame context, therefore in case of
#   ambiguous mappings (e.g., Prot), the FE associated with PP's
#   will be used (or the most common case if more than one).
#   For example, Sound used with PP's refers to specialization of
#   sound so is mapped into characteristic rather than theme.
# - n/a indicates that the mapping is not possible (eg, for Other role).
# - Comments indicate which mappings are questionable with degree indicated
#   by number of question marks (eg, "matter instead???").
#------------------------------------------------------------------------
# CAVEATS:
# - Currently only roles occuring more than 50 times have been mapped
#   (top 166 of 634 roles occurring with prepositions).
# - This was based on revised earlier mapping for FrameNet1, so some of
#   the comments might be obsolete.
#------------------------------------------------------------------------
# TODO:
# - Avoid mappings to Resource and other generic roles.
# - Include FE descriptions from preposition-fe.info at end of file.
# - Review PRODUCT mappings since 'for' and 'by' usages not intuitive.
#------------------------------------------------------------------------
# Tom O'Hara
# Summer 2007
#------------------------------------------------------------------------
# Src	Target	Comments
action	CONTEXT
activity	CONTEXT
address	CONTEXT	# (metaphorical) place in a system of communication
addressee	RCPT	# addressee => recipient
affected_party	THME
affliction	CONTEXT	# injury, pain or disease experienced by the Patient
## AgBP	INST	# agent's body part => means; tag as 'n/a' due to different with/in usages???
agent	AGNT	# agent >= agent
## Agt_1	AGNT	# primary agent
## Agt_2	ACCM	# secondary agent => Accompaniment; use Goal instead?
## Agt_s	AGNT	# plural agents => agent; use THME instead (as with Place_s)?
## Appr	THME	# appraisal => theme
area	AREA	# area => area
arguer2	ACCM
arguers	ACCM
attachment	AREA	# larger body part to which the Body_mark is attached
attribute	CHRC	# feature of an Entity which is under discussion
author	AGNT	# person who produced a particular Text
## Asp	MANR	# aspect (for aspectual particles) => matter instead???; ex: droned [on] at length
behavior	CONTEXT	# behaviour to context; ex: absurdity [of all artistic activity]
body_part	AREA	# body-part => area; use Immanent instead?
bodypart_of_agent	AREA
buyer	RCPT	# buyer => recipient; agent not used since to-clauses not agentive
category	CAT	# category => category
cause	CAUSE	# cause => cause; use initiator instead??
cause_of_shine	CAUSE
## Causer	CAUSE	# causer => cause; use initiator instead??
characterization	CHRC	# characterization => Characteristic; use Description??
## CnP	THME	# cargo + passenger => theme
## Cntrl	THME	# controllee => theme
charges	CONTEXT
circumstances	CONTEXT
clothing	CHRC
co_participant	ACCM
cognizer	AGNT	# cognizer => agent
communicator	AGNT	# communicator => agent
## Comp	ACCM	# company (of people) => accompaniment
competition	CONTEXT
components	PART
connector	PATH
container_possessor	LOC	# location that the Locale is a part of.
containing_event	CONTEXT
content	CONTEXT	# content => context
contents	PART	# stuff that is present/absent in the Container
correlate	PATH	# use TIME? directional path (or ordered collection of values) that the (dependent) Attribute is measured against.  Note that normally, the Correlate is simply (forward-directional) time
cotheme	THME
## Copy	PRODUCT	# copy => product
## Creat	AGNT	# creator => agent
criteria	MANR	# criterion => manner; use Chrc? as with item; ex: symbolised [in different ways]; segmented [by sex]
degree	MANR	# degree => manner; ex: shook me [to my roots]
depictive	MANR	# state of a participant in the event; use CHRC?
## Dep-Und	MANR	# depictive-undergoer => manner
descriptor	CHRC	# characteristic or description 
determinant	CONTEXT	# open question that determines the Outcome.
difference	DEGREE	# distance between the orginial value and the final value
dimension	CHRC	# dimension or aspect
direction	DIR	# direction => direction
donor	AGNT
duration	DUR
ego	AGNT
emotion	CHRC	# use manner instead?
## Dist	DIST	# distance => distance; use PATH instead???
## Driv	AGNT	# driver => agent
## Emo	CHRC	# emotion => characteristic
employer	AGNT
enabled_situation	CONTEXT
entities	THME
entity	THME	# entity => theme
entity_2	THME
evaluee	THME	# evaluee => theme; use PTNT instead??
evidence	RESOURC	#  evidence => resource; ex: from experience
event	CONTEXT	#  event => context; use LOC instead??
## Evty	THME	# eventuality => theme
experiencer	EXPR	# experiencer => experiencer
expressor	AREA	# expressor (body part) => area
feature	CHRC	
figure	CONTEXT
final_value	GOAL
focal_participant	THME	# entity that the Experiencer wishes to be affected by some Event
## FEv	PERIOD	# focal event(?) => point-in-time
## FT	TIME	# focal time(?) => point-in-time
## Foc	RCPT	# focus => recipient (since animate)
goods	RESOURC	# goods => resource
goal	GOAL	# goal => goal
goal_area	AREA
ground	CONTEXT	# Ground => Context
group	ACCM	# people standing in a semi-permanent relationship together
## Hlr	AGNT	# healer => agent
hypothetical_event	CONTEXT	# state of affairs or occurrence whose likelihood is assessed
impactee	THME
internal_cause	CAUSE	# internal cause => cause
indicated	THME
individuals	ACCM	# entities that come together to form an Aggregate
information	RESOURC
## Inf	CONTEXT	# inference => context
ingestibles	THME
initial_value	SOURCE
institution	AGNT	# institution => agent???
instrument	INST
intended_goal	GOAL
intended_perceiver	EXPR
## Int	DUR	# interval => duration???
## Intlc_1	AGNT	# primary interlocator
interlocutor_2	ACCM	# secondary interlocator_2 => accompaniment
interlocutors	AGNT	# interlocators => agent; use origin or source instead?
intermediary	AGNT
## Inv	PRODUCT	# invention => product; use RSLT instead?
issue	CONTEXT	# issue => context; use CHRC instead??
item	CAT	# Item (categorized) => Category; use Description?? or THME??
item_2	CAT	# Item (categorized) => Category; use Description?? or THME??
## Itm	CAT	# (affected) item => category; use THME??; ex: expansion [of the education system]
## Judge	AGNT	# judge => agent
## Jur	POSS	# ex: captain [of a blazing tanker]
jurisdiction	AREA	# geographical area within which the Judicial_body has authority
killer	AGNT
knowledge	RESOURC
leader	AGNT	# leader => agent
## Ldr_O	RCPT	# old leader => recipient (Cyc maleficiary)
liquid	MED	# fluid or gas that permeates the Item
location	LOC	# location => location
location_of_perceiver	LOC	# location-of-perceiver => location
## Loc-Src	LOC	# location-of-source => location
locus	LOC	# locus => location
manner	MANR	# manner => manner
mass	THME	# A substance that is being quantified
material	RESOURC	# (intellectual) material => resource; use MATR instead?
means	MEANS	# Means => means
measurement	DEGREE
medium	MED	# medium => medium
## Mns	MEANS	# means => means
message	THME	# message => theme
mode_of_transportation	MED
money	RESOURC
name	THME	# identifies the linguistic expression used to refer to Entities
new	THME	# person or thing that the Agent sets to fill a Role
## Null	n/a	# null (frame element) unmapped
noisy_event	CONTEXT	      # event during which sound is produced
norm	CONTEXT	#  rules or Norms that ought to guide a person's behavior
obstruction	INST	# entity which blocks the Eclipsed entity from view
offender	THME
opponent	ACCM
origin	SOURCE	# origin => source
## Orig	SOURCE	# original => source
part_2	PART	# second of two Parts
partner_2	ACCM
partners	ACCM
## Other	n/a	# other unmapped due to diverse usages; use Participant instead?
## Parts	RSLT	# parts => result
## Pat	RCPT	# patient => recipient; use theme instead?
path	PATH	# path => path
percept	CHRC	# percept => characteristic; use Essence instead??
## Perc-Agt	EXPR	# active perceiver => experiencer
## Perc-Pass	EXPR	# passive perceiver => experiencer
performance	CONTEXT
perpetrator	AGNT
persistent_characteristic	CHRC
## Pers	THME	# (described) person => agent
phenomenon	THME	# phenomenon => theme; use essence or characteristic instead??
## Phen-1	THME	# primary phenomena => theme
phenomenon_2	THME	# secondary phenomena => theme
## Phen-pl	THME	# plural phenomena => theme
place	LOC	# place => location
place_of_employment	CONTEXT
## Place_1	SOURCE	# primary place => source; use source instead?
## Place_2	GOAL	# secondary place => goal; use product instead?
## Place_s	THME	# plural place => theme
position	LOC	# position (?) => location
## Prac	CONTEXT	# practice (skill area) => context; use CHRC instead?
## Prd	PERIOD	# period (of time) => time interval
possession	RESOURC
possessor	THME
practice	MANR
problem	CONTEXT	# predicament or mystery that is resolved
process	CONTEXT	# Name of the event which is brought to an end
production	PRODUCT	# final product put out by the off-stage
## Prop	THME	# proposition => theme
protagonist	EXPR	# person (or people) whose mental state changes
## Prot_1	AGNT	# primary protagonist => agent
## Prot_2	AGNT	# secondary protagonist => agent
## Prot_s	AGNT	# protagonists => agent
## Prop	RESOURC	# proposition => resource; use theme instead?
purpose	GOAL	# Purpose => goal; ex: devised [for girls]
## Pymt	THME	# Payment => patient; use amount instead??
## Pyr	RCPT	# payer => recipient
## Qual	CHRC	# quality => characteristic
## REv	PERIOD	# Reference Event(?) => point-in-time??
## RT	TIME	# Reference Time(?) => point-in-time
## Rate	AMT	# rate => amount
recipient	RCPT	# recipient => recipient
reason	CAUSE	# reason => cause
relative_location	LOC
resource	RESOURC	# resource => resource
responsible_party	AGNT
result	GOAL	# Result of the Event
## Road	PATH	# road => path
role	CONTEXT	# role => context; use effect intead?
self_mover	AGNT	# self-mover to agent; used mostly for by-agentives but some entirely different sense (eg, clambered [up] onto the floor
## Size-I	AMT	# result size to amount; use Product instead?
## Size-R	AMT	# initial size to amount; use Source instead?
## Slctr	AGNT	# selector => agent
seller	SOURCE	# seller => source; use agent instead??
side_2	ACCM	# One of two participants in a hostile encounter
sides	ACCM
skill	RESOURC	# talent or ability to do things with one's hand or body
sought_entity	THME
sound_source	RESOURC	# entity which emits a sound
## Spd	MANR	# speed => manner
speaker	AGNT	# speaker => agent
source	SOURCE	# ex: profits [from its phone busines]
speed	MANR
## Src-p	SOURCE	# ex: clatter [of hoofs]
## Src_1	SOURCE	# primary source of perceived phenomena => source; ex: smell [of the garlic]; use Chrc? (since often just specialization of sound type)
## Src_2	GOAL	# ?DEST or ?LOC or ?INST; ex: iron clanged [against steel]
stimulus	RESOURC	# event which brings about the emotion in the Experiencer
## State	CONTEXT	# state => context; use Essence or CHRC instead??
stuff	THME	# volume is being measured
subject	CAT	# area of knowledge or skill which is taught 
subregion	AREA
substance	THME
support	MEANS	# support => means
theme	THME	# theme => theme
## Theme_1	THME
## Theme_2	THME
## Themes	THME
text	RESOURC	# entity that contains linguistic information
time	TIME	# Time => point-in-time
topic	CAT	# topic => category
trigger	CAUSE	# trigger => INST?? or Resource?? instead
## Trtm	MEANS	# treatment => means
type	CAT	# denotes sub-type
undertaking	CONTEXT	# activity in which the entity participates.
use	GOAL	# purpose for which the entity is intended
value	CHRC	# quantity or other characterization of the entity's state
## Unit	AMT	# unit (of measure) => amount
## Veh	MED	# vehicle => medium (abstract channel); vehicle => instrument instead??
victim	THME	# being or entity that is injured
#
whole	PRODUCT	# whole => product; use RSLT instead?
#