Learn about: The 'R-Tree' (Relationship Tree)

'R-Tree' is short for 'Relationship Tree'.

Back To Top

Access the R-Tree from the Entity Index

You can open the R-Tree for a record from the Entity Index:

  • Open the EI <Ctrl+E>
  • Select the record
  • Click the <Open in R-Tree> button

Back To Top

Access the R-Tree from a Record

You can open the R-Tree for a record from the record itself:

  • With a record open
  • Click the <R-Tree> button in the bottom-right corner of the form.

Back To Top

How the R-Tree Works

The R-Tree opens with your chosen entity at the top, and all of the links to that entity, and links to those links shown in a 'tree' structure below.

In the snap above you see:

  • At the top: the Authorized Access Point (AAP) for the Work record (where you started)
  • Then, links to:
    • the AAP for the linked Expression record
    • the AAP for the two linked Author records

Back To Top

Switching to a new R-Tree

I you want to switch to an R-Tree for a different entity, you can do it 3 ways:

  1. Click on the heading of the entity
    1. <Ctrl+R>
  2. Right-click on the heading of the entity
    1. Select <R-Tree this>
  3. Double-click on the heading of the entity
    1. Select the <R-Tree> button at the bottom of the record

Back To Top

Digging in an R-Tree

To see more links to your chosen record, you can dig deeper in 4 ways:

Back To Top

Dig using the plus signs

If a heading in an R-Tree has a Plus sign (as in the AAP for the Expression record in the snap, above):

  • Click on the Plus sign
    • This will display one level deeper for that link

If heading does not have a plus sign, but the <Dig> button (on the bottom-right of the R-Tree) displays either 'Dig' in bold, or a number, then:

  • Click the <Dig> button
    • This will display a Plus sign for any link that has further links

  • Click on the Plus sign and see links that are one level deeper for that heading

Back To Top

Dig using right-click

Whether or not a heading in an R-Tree shows a Plus sign, you can try to dig deeper using the context menu:

  • Right-click on any text in the row for your heading

  • Select <Dig this>
    • If the heading has links then those that are one level deeper will display
  • Right-click also adds the option to 'RTree this' (not shown in our screenshot), which means that a new RTree will be generated with the right-clicked heading at the top (as if you opened the entity records for that heading and pressed the RTree button)

Back To Top

Dig using <Ctrl+D> to Dig This

Whether or not a heading in an R-Tree shows a Plus sign, you can try to dig deeper using the <Ctrl+D>:

  • Select the heading you would like to Dig
  • Hit <Ctrl+D>

  • If the heading has links then those that are one level deeper will display

Back To Top

Dig using the <Dig> button

You can use the <Dig> button, at the bottom left of the R-Tree screen, to expose all possible links to the heading at the top of the R-Tree:

Once you click that button, its label changes from “Dig” to a number that represents the 'level' of the dig, and RIMMF 'digs' one level deeper in the relationship tree and adds more rows to the display.

Every time 'Dig' is pressed, the program moves down one level and retrieves all relationships for all rows at that level.

When there are no more relationships to discover, the <Dig> button disables itself.

Back To Top

The De-dupe Option

In the examples above, we show what displays when you have the 'De-dupe' option turned on. If you want to see every link in every record displayed, even if it has already been displayed, you can turn off this option and get something like this:

The 'De-dupe' option prevents an entry from appearing more than once in the R-Tree, which results in a much neater display. Running the R-Tree with dedupe disabled will result in a more complete picture; but for records with large numbers of linking elements, this complete-ness can quickly become a bit too much.

So we will leave it for you to decide which approach you prefer.

Back To Top

Adjusting the Columns that Display

You can add or remove columns in the R-Tree by clicking on the Column control button, to the left of the Relationship heading:

Here, I removed the 'Short URI' column:

The display returns to the default setting, the next time you open an R-Tree.

Back To Top

Selecting Headings

To select a heading from an R-Tree display, individually:

  • Click on the checkbox to the far right of the heading for each record that you would like to select

To select all of the records shown in an open R-Tree:

If the Delete button is not visible at the bottom–

  • Click on the checked checkbox in the Header row
  • Un-check any of the headings you do not wish to select

If the Delete button is visible at the bottom, the checkbox in the column header has a different behavior. In this case, clicking the checkbox in the header selects only visible rows.

Collapsed rows (those hidden beneath '+' glyphs) will not be selected. To check these items they must be visible, so you will have to either 'Dig' them out, or use the individual '+' buttons to expand them, or, in later versions of RIMMF, use the big '+' button at the bottom of the form to expand everything.

The reason for this different behavior is to try to prevent the inadvertent deletion of an entire entity index.

Back To Top

The Close Selected Option

If you have a lot of records open, and would like to quickly close one or more of those records that are included in an open R-Tree:

  • Select the records:
    • Click on the checkbox to the far right of the heading for each record that you would like to close
  • Click the <Close selected> button

Back To Top

The Export Option

If you would like to export the record(s) for one or more of the headings shown in an open R-Tree:

  • Select the records:
    • Click on the checkbox to the far right of the heading for each record that you would like to close
  • Click the down arrow beside the <Export> button
    • Select an Export Format
    • Click the <Export> button
  • Enter a filename, or accept the one provided
  • Click <OK>
  • Find the file on your Desktop

details/rtree.txt · Last modified: 2015/11/19 12:37 by richard
Back to top
CC Attribution-Noncommercial-Share Alike 3.0 Unported
Driven by DokuWiki Recent changes RSS feed