TreeEditor

Help Annotating with TreeEditor for Arabic

Using the mouse:

To add a node label: first highlight the region, then click on the button for the node label you want to add.

To add a function tag: first highlight the node, then click on the function you want to add to that node.

To create a trace: click left on the moved node and click right where you want the trace to go, then click on the 'Trace' button. There are several points to note about creating traces:

• You must trace from a node (such as WHNP), NOT from a bare word (such as 'which' or 'mA').
• For subject traces, "click right where you want the trace to go" means to click right on the verb itself that the subject trace should follow (or on the -PRD node that the subject trace should precede).
• For all other traces, "click right where you want the trace to go" means to click right on the word, node, or punctuation mark that the trace should follow.
• Note that not all traces are the same! Each of the different empty categories has a different meaning, so be sure that the one you want is the one that is created. (In particular, note that * (pro-drop subject and passive trace) and *T* (Wh-movement and topicalization) are different empty categories.) For the most part, the tool will automatically create the correct empty category for you, but you will need to fix it manually if something goes wrong. To do this, click left on the trace itself (not its node label) and then click on the "Emp W" button to cycle through the empty words until you get to the one you need.
• Right Node Raising is a special type of tracing, and the tool works a bit differently for it. To create the *RNR* traces, click left on the raised constituent and click right where you want the first *RNR* trace to go. This will create an *ICH* trace, but that's OK. Now, click left again on the raised constituent and click right where the second *RNR* trace should go. This will change both traces to *RNR* and mark the raised constituent and both traces with the same index, exactly as it should be.
• The tool should correctly co-index all traces. Please keep an eye on the indices, though, and let Ann or Hubert know if something doesn't look right.

To co-index a constituent with an empty element: click left on the full constituent and click right on the node label of the empty element, then click the "Coref" button. Note that coreference may be shown only when at least one of the constituents is an empty element, and it is not always shown even then (refer to the relevant sections of the guidelines for information on what kinds of coreference we show).

To collapse or expand a node, click on the little box with the arrow head next to the node label. Arrow head pointing to the right = node collapsed. Arrow head pointing down = node expanded.

What will the other buttons in the tool do?

TreeEditor Buttons
Button	What it does
Prev	Go to the previous sentence
Font	Cycle through different font sizes
Save	Save the file -- use this button rather than the file menu option in order to keep keyboard shortcuts available!
Next	Go to the next sentence
S, NP, VP, PP, SBAR, SBARQ, SQ, SINV, LST, NX, PRN, PRT, QP, ADJP, ADVP, FRAG, WHNP, WHPP, WHADJP, WHADVP, CONJP, INTJ, NAC, RRC, UCP, X	Insert node with this label over the highlighted region in the tree
SBJ, TPC, PRD, PRP, CLR, LOC, DIR, MNR, TMP, ADV, LGS, NOM, DTV, VOC, BNF, EXT, CLF, HLN, TTL	Insert this function tag on the highlighted node
Up	Move the selected region, node or word "up" or in one direction
Down	Move the selected region, node or word "down" or in the other direction
Undo	Undo the last action. Note that some actions that seem simple (such as Trace) actually consist of several steps, which may be undone one at a time.
Redo	Redo the last action. Note that some actions that seem simple (such as Trace) actually consist of several steps, which may be undone and redone one at a time.
OpenAll	Open all collapsed tree nodes in the current sentence
ReAll	Redo all changes to the tree -- back to the state of the tree before UnAll
UnAll	Undo all changes to the tree -- back to the initial state of the current tree
Trace	Create a trace -- this should create the right type of trace in most cases, but the trace may need to be adjusted in some less common cases. Source and destination must be selected first with left and right mouse buttons.
Gap	Co-index constituents in a template gapping construction. Source and destination must be selected first with left and right mouse buttons.
Coref	Co-index a full constituent with an empty category. Source and destination must be selected first with left and right mouse buttons.
Print	Print the selected node in bracketed list format to the window the tool is running from. To get the entire sentence, highlight the top S or Paragraph.
NP *	Insert an empty noun phrase (pro-drop subject, most commonly). Precedes if VP is selected, follows otherwise.
Emp W	Cylces through the available empty categories if an empty category token (not dominating node) is selected
WHN 0	Inserts (WHNP 0) -- or, if S node is selected, inserts preceding (WHNP 0) and SBAR containing both the WHNP and the S
Rm tag	Removes the selected node label
Rm func	Removes the function tag from the selected node label
Rm Empty	Removes the selected empty element, including its node if the node label is selected
Rm Coref	Removes the coreference number from the selected node label -- be sure to remove all related coreference numbers!

To close the file, click on "File" to pull down the menu and then click "Quit". Please save regularly using the "Save" button rather than the save option in the File menu! Due to a bug in the programming language, all keyboard shortcuts are disabled once you click on the "File" menu, so if you plan to use keyboard shortcuts you want to save the the button not the menu option.

Using keyboard shortcuts:

Note: this section may need to be updated for the current version of the tool! Go ahead and try them out, if you like -- let me know if they don't work... --AB

For node labels: first select the region, then type enough of the node label's letters to make it the first label in the list, then hit the space bar to insert it in the tree. The "Information on action" window will display the list of potential labels. The first one on the list is the one that will be inserted when you hit the space bar. For example, "S" brings up a list of potential labels, but plain S is the first one on the list, so you can type s-space to insert an S node. However, if you want an ADJP, you need to type adj-space.

For function tags: first select the node, then hit the space bar, then type enough of the tag's letters to make it the first in the list, then hit the space bar again to insert the tag. The "Information on action" window will dispay a hyphen "-" when you hit space the first time, then the list of potential tags as you type letters. The first one on the list is the one that will be inserted when you hit the space bar the second time.

The node label and function tag keyboard shortcuts can be typed one right after the other. For example, to get NP-SBJ with the keyboard, type n-space-space-s-space.

To cancel something in the "Information on action" window, press the Esc key.

Some of the more complex actions also have keyboard shortcuts:

TreeEditor Keyboard Shortcuts
Shortcut	Button	What it does
letters	tag buttons, as labeled	node lables or tags, see above
space	(unnecessary if using buttons on the screen)	insert label or initiate function tag, see above
F1	Up	Move the selected region, node or word "up"
F2	Down	Move the selected region, node or word "down"
F3	NP *	Insert an empty noun phrase (pro-drop subject, most commonly). Precedes if VP is selected, follows otherwise.
F4	Trace	Create a trace -- this should create the right type of trace in most cases, but the trace may need to be adjusted in some less common cases. Source and destination must be selected first with left and right mouse buttons.
F5	Emp W	Cylces through the available empty categories if an empty category token (not dominating node) is selected
F6	Coref	Co-index a full constituent with an empty category. Source and destination must be selected first with left and right mouse buttons.
F7	Redo	Redo the last action. Note that some actions that seem simple (such as Trace) actually consist of several steps, which will be undone and redone one at a time.
F8	Undo	Undo the last action. Note that some actions that seem simple (such as Trace) actually consist of several steps, which will be undone one at a time.
F9	Rm tag	Removes the selected node label
F10	Rm func	Removes the function tag from the selected node label
F11	Rm Empty	Removes the selected empty element, including its node if the node label is selected
F12	Rm Coref	Removes the coreference number from the selected node label -- be sure to remove all related coreference numbers!
Page Up	vertical scroll bar	pages up
Page Down	vertical scroll bar	pages down
Esc	(must use keyboard; no on-screen button)	cancels the tag that is active in the "Information on action" window

Please save regularly using the "Save" button rather than the save option in the File menu! Due to a bug in the programming language, all keyboard shortcuts are disabled once you click on the "File" menu, so if you plan to use keyboard shortcuts you want to save the the button not the menu option.