Differences

This shows you the differences between two versions of the page.

Link to this comparison view

details:rtree [2015/11/19 12:37] (current)
Line 1: Line 1:
 +====== Learn about: The 'R-Tree' (Relationship Tree) ======
 +
 +'R-Tree' is short for 'Relationship Tree'. 
 +
 +===== Access the R-Tree from the Entity Index =====
 +You can open the R-Tree for a record [[menu:entityindex#to_open_the_r-tree_for_a_record_from_the_entity_index|from the Entity Index]]:
 +  * Open the EI <Ctrl+E>
 +  * Select the record
 +  * Click the <Open in R-Tree> button 
 +
 +===== 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. 
 +
 +{{:r3snaps:r-treework_1.png?500|}}
 +
 +===== 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.
 +
 +{{:r3snaps:r-treework_2.png?500|}}
 +
 +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
 +
 +===== 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:
 +
 +  - Click on the heading of the entity
 +    - <Ctrl+R>
 +  - Right-click on the heading of the entity
 +    - Select <R-Tree this>
 +  - Double-click on the heading of the entity
 +    - Select the <R-Tree> button at the bottom of the record
 +
 +===== Digging in an R-Tree =====
 +To see more links to your chosen record, you can dig deeper in 4 ways:
 +
 +==== 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
 +
 +{{:r3snaps:r-treework_3.png?500|}}
 +
 +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
 +
 +{{:r3snaps:r-treework_8.png?500|}}
 +
 +    * Click on the Plus sign and see links that are one level deeper for that heading
 +
 +{{:r3snaps:r-treework_4.png?500|}}
 +
 +==== 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
 +
 +{{:r3snaps:r-treework_5.png?500|}}
 +
 +  * 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)
 +
 +==== 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>
 +
 +{{:r3snaps:r-treework_9.png?500|}}
 +
 +  * If the heading has links then those that are one level deeper will display
 +
 +==== 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:
 +
 +{{:r3snaps:r-treework_2.png?500|}}
 +
 +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.
 +
 +{{:r3snaps:r-treework_4.png?500|}}
 +
 +===== 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:
 +
 +{{:r3snaps:r-treework_10.png?500|}}
 +
 +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.
 +
 +===== 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:
 +
 +{{:r3snaps:r-treework_6.png?500|}}
 +
 +Here, I removed the 'Short URI' column:
 +
 +{{:r3snaps:r-treework_2.png?500|}}
 +
 +The display returns to the default setting, the next time you open an R-Tree.
 +
 +===== 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.
 +
 +{{:details:bigplus.png?150|}}
 +
 +The reason for this different behavior is to try to prevent the
 +inadvertent deletion of an entire entity index.
 +
 +
 +===== 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
 +
 +===== 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
 +
 +----
 +
 +<!--
 +
 +To make 'linking' work in RIMMF, we created something called the RLD table (RIMMF Linking Data), which consists of little more than a list of every record and all of the other records that it links to:
 +
 +{{:details:rld.png|}}
 +
 +This type of table fits in very nicely with the RDBMS approach that we used beneath the surface in RIMMF, and allows very quick access to the data needed to generate the menus used in linking, and in the R-Tree. 
 +
 +However, the table was based on the assumption that only links will be of interest--as opposed to data entered directly into Authorized Access Points; and as we have seeen above, not every 'access point' will be a link.
 +
 +Second, one constraint that we applied to the RLD was that one record will only link to another record once. This logic was based on the thinking that, since in RDA, everything is separated into entities, a record for something like a work should only link to a record for something like a person once. But we forgot to account for the concept of repeated relationship designators, and thus, the design falls a bit short in this case also.
 +
 +Its probably worth noting in this context, that //the R-Tree is based completely on the RLD//; any data not found in the RLD will not appear in the relationship tree.
 +
 +-->
  
details/rtree.txt ยท Last modified: 2015/11/19 12:37 (external edit)
Back to top
CC Attribution-Noncommercial-Share Alike 3.0 Unported
Driven by DokuWiki Recent changes RSS feed