AMR Editor Manual

Version 0.9 (Sept. 17, 2012)

Quick links:   top   —   add, add-ne   —   replace   —   delete   —   move   —   undo, redo   —   load, save   —   check   —   template activation   —   FAQ   —   QuickRef   —   Release Notes

Examples

Terminology

Commands

    top
Pre-command state Command Comment
top   <concept> Add a new top level AMR with concept concept
 empty AMR top say Add top level AMR with concept say
 (s / say) top kill Add another top level AMR with concept kill
top   <variable> Move an existing sub-AMR to the top.
    add, add-ne
Pre-command state Command Comment
  <head-variable>   <role>   <arg> Under head-variable, add an argument arg with role
<head-variable>   <role>   <ne-type>   <name> Under head-variable, add a named entity of type ne-type with role and name
 (k / kill) k :ARG0 man
 (k / kill
        :ARG0 (m / man))
m :age 24
 (k / kill
        :ARG0 (m / man
              :age 24))
k :ARG1 person John F. Kennedy Short-cut to add named entity resulting in complex sub-structure.
 (k / kill
        :ARG0 (m / man
              :age 24)
        :ARG1 (p / person))
p :name name John F. Kennedy
  or
p :name John F. Kennedy
Short-cut to add a name when its head-concept/type already exists.
Both commands on the left do the same thing.
 (i / insist) i :ARG0 concept.i To express "I insist", prefix concept by concept. to identify it as a concept (as opposed to the variable i).
 (i / insist) i :ARG0 !I An alternative prefix is !. It also overwrites any rules on what a concept must look like (such as capitalization).
    replace     Generally easier to use template-based method for changing things.
Pre-command state Command Comment
replace concept at  <variable>   with  <new-concept>
replace string at  <variable>   <role>    with  <new-string>
replace role at  <variable>   <old-role>   <arg>   with  <new-role> arg can be a variable, concept, or a string (incl. numbers)
 (k / kill
        :ARG0 (m / man 
              :age 42))
replace concept at k with murder Replaces kill with murder
replace string at m :age with 24 Replaces 42 with 24
replace role at k :ARG0 m with :agent Replaces :ARG0 with :agent
rc  <variable>  <new-concept>
rc  <old-concept>  <new-concept>
replace concept
rr  <role>  <new-role>
rr  <head-variable> <role>  <new-role>
rr  <head-variable> <role> <variable>  <new-role>
rr  <role> <variable>  <new-role>
replace role
rs  <old-string>  <new-string>
rs  <role> <old-variable>  <new-string>
rs  <variable> <role>  <new-string>
replace string (incl. numbers)
rv  <head-variable> <role> <old-variable>  <new-variable>
replace (secondary) variable
    delete     generally easier to use template-based method for deleting things
Pre-command state Command Comment
delete top level   <variable>
delete   <head-variable>   <role>   <arg> arg can be a variable, concept, or a string (incl. numbers)
delete amr Delete entire AMR including its props.
Alternatives: delete all, del all, del amr
delete dummies Delete any top-level dummy-element(s).
Alternatives: delete dummy, dd
 (k / kill
        :ARG0 (m / man
              :age 24))
delete m :age 24 Deletes   :age 24
 (k / kill
        :ARG0 (m / man))
delete top level k Deletes the entire AMR for (k / kill :ARG0 (m / man)).
del  <variable>
del  <concept>
del  <role> <variable>
del  <head-variable> <role> <variable>
delete (sub-) AMR
    move
Pre-command state Command Comment
move   <variable>   to   <head-variable>   [<role>] Can move entire trees.
move   <variable>   to top Move a tree to the top level.
 (k / kill
        :ARG0 (m / man))
 (s / say
        :ARG0 (h / he))
move k to s :ARG1
  or
s :ARG1 k-
The killing becomes the :ARG1 (topic) of the saying.
The alternative is based on the add-command s :ARG1 k plus the minus-sign (-) to specify that "k" should be moved to this place (removing it from its original position).
top m Move "m" to the top level. Same as move m to top
    undo, redo
Pre-command state Command Comment
undo Undo last operation.
u Shortcut for undo.
redo Redo last undo operation.

Template Activation

Templates can be invoked in two ways:

  1. by clicking on the blue boxes
  2. by typing a keyword (plus <Enter>) in the text command line:
    • type new to activate the new template
    • type add to activate the add template
    • type add-ne or ne to activate the add-ne template
    • type replace or r to activate the replace template
    • type delete or d to activate the delete template
    • type move or m or mv to activate the move template
    • type load to activate the load template
    • type save to activate the save template
    • type help or h to activate the help template
    • typing undo or u or redo will perform that action and also activate the undo/redo box at the right top

Load and Save

You can save and load to either a special location at ISI or from and to your own computer. The latter is somewhat browser-dependent, because, partly for security reasons, different browsers allow different types of access and APIs (application programming interfaces). We generally recommend the use of Firefox or Chrome.

Three ways to load an AMR:

  1. Load local AMR file   to load an AMR from your (= local) computer. File access API best supported by current versions of Google Chrome, Mozilla Firefox, and Opera. MS Internet Explorer does not yet support the FILE API, so the AMR Editor tool uses ActiveXObject on IE, which works, but might require the user to set some internet options to allow this use (script will tell user what to do). Not supported by Safari.
  2. Load AMR at ISI   to load from a special location at ISI (/nfs/web/isi.edu/cgi-bin/div3/mt/save-amr/username/). Provide a user name such as ulf or guest, which will select a specific sub-directory. As for the filename, you can either directly specify it (without path or suffix), or you can leave it blank and click on "Load file at ISI" in which case it will show you a list of available files for the subdirectory specified by username. This includes the option to select older versions. On the new page "Select file to be loaded", click on the file you would like to load, which will automatically fill in the "File to be loaded" text field. Confirm by clicking "Load".
    Advantage: This load method is browser-independent. Possible disadvantage: You leave the original AMR Editor page and will loose your edit history (incl. possibility to undo).
  3. Direct AMR Entry   You can paste in an AMR into the text area under "Direct AMR Entry" and then confirm by clicking on the "load direct AMR" button below.
The AMR Editor tool will try to correct any ill-formed AMRs. This includes missing parentheses, overused variable names and more. In case it needs to delete, add or change any parts of the input AMR to make it well-formed, it will pop up a window showing these modications in color and tooltip explanations. Use the AMR Editor to make any further edits.

Similarly three ways to save an AMR:

  1. Save AMR locally   to save on your (= local) computer. Again, different browsers offer different type of support. Many browsers will download the AMR file to a default download directory, e.g. "C:\Documents and Settings\user\My Documents\Downloads" on Windows. Browsers then typcially offer to open the downloaded file, which you can then save to a more permanent location. Not supported by MS Internet Explorer. (For IE, use save option 3, Save AMR using AMR popup, instead.)
  2. Save AMR at ISI   will save the file at the above-mentioned special location at ISI. If there is already an older version with the same filename, the system will not overwrite, but keep all versions accessible.
    Advantage: This save method is browser-independent. Possible disadvantage: You leave the original AMR Editor page and will loose your edit history (incl. possibility to undo).
  3. Save AMR using AMR popup   This will pop up a new window containing the AMR. Many browsers will allow you to save from the popped-up window to a file. A notable exception is Google Chrome. You can also use this window to copy and paste as needed (all browsers).

Check

The check operation includes: