Changes

Jump to: navigation, search

Gramps 5.1 Wiki Manual - Tools

4,378 bytes added, 17 January
no edit summary
{{man index|Gramps 5.1 Wiki Manual - Reports|Gramps 5.1 Wiki Manual - Settings|5.1}}
{{languages|Gramps_5.1_Wiki_Manual_-_Tools}}
{{#vardefine:chapter|1214}}
{{#vardefine:figure|0}}
[[File:MenuOverview-Tools-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}
[[File:ToolSelection-dialog-example-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - example showing "Find Possible Duplicate People" information]]
The {{man label|Tool Selection}} dialog allows you to browse the complete selection of available tools along with their brief descriptions when invoked by clicking the {{man button|Open the tools dialog}} icon on the toolbar from any of the categoriesand use the {{man button|▶}} arrows to expand the listings.
{{-}}
===<u>Compare Individual Events</u>===
 
[[File:CompareIndividualEvents-EventComparisonFilterSelection-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Compare Individual Events" - "Event comparison filter selection" - dialog]]
{{stub}}
This tool compares events across the selected group of people.
===<u>Extract Place Data from a Place Title</u>===
{{man warn|No longer part of Gramps you can download this This tool from the has been moved to [[Third-party_Addons|third party addons<br>See: ]]!|when the Place Hierarchy was first added to Gramps, every user needed a tool to [[Addon:Extract Place Data from a Place Title]]. Now that that a Hierarchy of Places is well established, the tool is needed infrequently. So installation has been made optional.}}
===<u>Find Possible Duplicate People</u>===
[[File:FindPossibleDuplicatePeople-dialog-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Find Possible Duplicate People - dialog - default]]
This The '''Find Possible Duplicate People''' tool searches the entire Tree database, looking for the entries that may represent the same person.
You can access this tool via the menu {{man menu|Tool->Family Tree Processing->Find Possible Duplicate People...}}.
The {{man label|Find Possible Duplicate People}} dialog will be shown and you can adjust the following options:
*{{man label|Match Threshold}} : choose between '''Low'''(default), Medium and High from the drop down menu. (Note:{{man note|How is the quality of match measured?|2=This calculates a chance the chances (or 'odds') of matching on a quality scale labeled as a floating point numberlow, medium and high. For each piece of information that matches corresponds, the quality of the chance match is considered to be marginally increased. If The closer the particular pieces of data correlate, the larger the increase. When the chance is greater than the threshold selected '''Match Threshold''' then a match is will reported. The thresholds are Low=0.25, Medium=1.0 and High=2.0. So , with the filtering threshold set to High less , fewer matches are expected.)}}
{{man label|Options}}
If there where changes to the capitalization of any names you will be presented with the {{man label|Capitalization changes}} results window. The window shows a list of the family names that Gramps can convert to (according to Gramps) correct capitalization (please check that it is correct for you.). In the {{man label|Capitalization changes}} results window list the following columns are available:
* {{checkbox|1}} {{man label|Select}} - Check or uncheck these on a "by name bases " basis if you choose not to accept the recommendation (checkbox checked by default)
* {{man label|Original Name}} - The name as currently recorded.
* {{man label|Capitalization Change}} - The name with change if applied.
{{-}}
You can also install the "[[Addon:Fix Capitalization of Given Names]]" tool Addon that once installed works almost identically to this tool but works for "Given Names"
{{-}}
You can select this via menu {{man menu|Tools > Family Tree Processing > Merge Citations...}} .
 
{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. It is recommended that you please stop here and backup your database; so that you can revert the process of running this tool.}}
The '''Undo history warning''' will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
[[File:ReferenceMapsRebuilt-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Reference maps rebuilt" - result dialog for "Rebuild Reference Maps" tool]]
This tool rebuilds reference map tables (. This drives the list of ''References'' items on in editors).
You can use this tool via menu {{man menu|Tools->&#x27a1; Family Tree Repair->&#x25B6; Rebuild Reference Maps...}}.
Once completed the {{man label|Reference maps rebuilt}} result dialog will be shown.
====See also====
* This rebuild is also performed as part of the {{man menu|Tools &#x27a1; Family Tree Repair &#x25B6; [[Gramps_5.1_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}
This tool rebuilds secondary indices.
You can use this tool via menu {{man menu|Tools->&#x27a1; Family Tree Repair->&#x25B6; Rebuild Secondary Indexes...}}.
Once completed the {{man label|Secondary indexes rebuilt}} result dialog will be shown.
 
The {{man menu|Rebuild Secondary indexes...}} re-constructs the secondary tables in the Tree db. These tables include things like gender statistics (Given Name versus gender) to allow guessing the gender of names as they are entered, surnames (for faster lookup of possible surname and to make the person tree view work), the various IDs for objects (to facilitate lookup by ID), place enclosure tables, to make the place tree view work, and a few others.
 
In theory, these tables are kept constantly up-to-date when anything changes. So rebuilding the Reference Maps and Secondary Indices should not be necessary. But, especially early on in the Gramps history, bugs sometimes interfered with updates completing correctly. So the tools remain available... &lsquo;just in case&rsquo;.
====See also====
* This rebuild is also performed as part of the {{man menu|Tools &#x27a1; Family Tree Repair &#x25B6; [[Gramps_5.1_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}
Select the {{man button|Find}} button to run the report, and once completed the results if any will show in the bottom section of the {{man label|Unused Objects}} dialog with the following columns shown:
* {{man label|Mark}} Select the row if you want to delete the object (checkbox unchecked by default)
* {{man label|}} - Icon representing the type of object.
* {{man label|ID}} - Gramps internal name for the object.
* [[Gramps_5.1_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]] -
* [[Gramps_5.1_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data]] -
 
 
===<u>Clean input data</u>===
<!-- need to rename link in tool to match menu option (then remove section title below-->
====<u>Remove leading and trailing spaces</u>====
 
[[File:CleanInputData-dialog-tool-example-dialog-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clean input data]]
{{stub}}
 
Tool to suppress leading and trailing spaces.  The tool searches for place names with leading or/and trailing spaces. It also looks in the first name and surname.
 
You can access it from the menu {{man menu|Tools > Utilities > Clean input data...}}
 
See also:
* [https://github.com/gramps-project/gramps/pull/783 New tool to suppress leading and trailing spaces.] - (added in Gramps 5.1.0)
===<u>Find database loop</u>===
This tool allows converting relative media paths to the absolute ones. It does this by prepending the {{man label|Base path for relative media paths:}} as given in the [[Gramps_5.1_Wiki_Manual_-_Settings#General|Edit > Preferences > General ]] tab, or if that is not set, it prepends the default [[Gramps_5.1_Wiki_Manual_-_User_Directory|User's Directory]].
 
 
* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}
[[File:ConvertPathsFromAbsoluteToRelative-FinalConfirmation-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from absolute to relative':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]
This tool allows converting absolute media paths to a relative path. The relative path is relative viz-a-viz to the given base path in the setting {{man label|Base path for relative media paths:}} as given in from the [[Gramps_5.1_Wiki_Manual_-_Settings#General|Edit > Preferences> General ]] tab, or if that is not set, the user's directoryis used. A relative path allows to tie the file location to a base path that can change to your needs. * [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.* [https://desktop.arcgis.com/en/arcmap/latest/tools/supplement/pathnames-explained-absolute-relative-unc-and-url.htm Absolute, relative, UNC, and URL paths] ArcMap help.
{{-}}
[[File:NotRelatedTo-dialog-NotRelated-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}. "Not related to '...'" - dialog - showing results for "Not Related" Tool]]
This report tool will find list people who are not related connected to the selected active person. Connections may include linked in a chain of [[References|references]] or linkages created with the [[Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|link editor in Notes]].
You can use this tool via menu {{man menu|Tools->Utilities->Not Related...}}.
From the ''Name'' column you can use the {{man button|right arrow}} button and {{man button|down arrow}} buttons to collapse or expand the grouped ''Name'' list. Double clicking on a person will bring up the {{man label|person edit}} dialog or {{man label|family edit}} dialog.
If you select a person , you can use the {{man label|Tag}} text field(you can fill in whatever custom tag name you want to use) or use the drop down list to choose an existing tag eg TODO, NotRelated. Use the {{man button|Apply}} to add the selected tag to the person(s). This tag will then show up in the ''Tags'' column.
{{-}}
Selecting the Relationship Calculator tool will open a list filtered to all people connected, '''but not necessarily related''', to the [[Gramps_Glossary#active_person|Active Person]]. To calculate relationship to different person, close the window, make that person Active and select the tool from the menu again.
Select the individual from the filtered list to report if an a relationship exists. The exact relationship will be shown in the lower panel along the the common ancesors of that's reported relationship. Only blood relationships will display (except for husband-wife relationships). Note "in-law" relationships are not displayed.
The filtered list will grouped and alphabetically sorted by surname. (Regardless of whether the View menu setting of the Person category has been set to '''Grouped'''.) The list columns cannot be re-sorted.
The degree of separation (generation distance) that will be recognized is controlled by the the ''Max generations for relationships'' value in the [[Gramps_5.1_Wiki_Manual_-_Settings#General|General]] tab under the {{man menu|Edit->Preferences...}} menu. (The default of 15 generations will report a 12th great-grandparent relationship but not their parents. The active person is counted as one of the generations.)
Essentially, any two people are directly related by blood if they have an ancestor in common. One of these individuals may actually be an ancestor of the other - such as a great grandparent. Even in the cases of aunts and uncles, you still can calculate the relationship by searching for the common ancestor. In this case, the father or mother of the aunt or uncle will be a grandparent to the nephew or niece.
A full text list of all blood relations and their spouses can be viewed using a [[Gramps 5.1 Wiki Manual - Reports - part 6#Kinship Report|Kinship Report]].
====See also:====<!--* The '''[[Gramps_5.1_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]'''-->* The '''Relationship to home person''' [[Gramps_5.1_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar* '''Relation to Home Person''' [[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].* The '''[[Addon:Deep_Connections_Gramplet|Deep Connections]] ''' gramplet : If this third party add-on is installed, it will list the intervening generations to through the sibling offspring of a common ancestor but . (But it does not list the common ancestorsancestor or if both person a connected through the same spouse. It ) The Gramplet also lists details the indirect relationships.
{{-}}
* {{man label|Maximum age for an unmarried person}}: 99
The first check box: {{man label|Estimate missing or inexact dates}} causes the tool to accept a baptism date if a birth date is not known, and to accept a burial date if a death date is not known. In addition, starting in Gramps version 3.3, it It also causes the tool to accept "inexact" dates (i.e., any "legal" Gramps date which is not a fully-specified one (with an explicit day and month and year)).
The second check box: {{man label|Identify invalid dates}} will check if the dates are invalid.
== Debug ==
{{man warn|{{man menu|Warning do not use the '''Debug''' tools on your working Family Tree}}|{{man menu|Always create a new empty Family Tree or a copy of your exiting existing Family Tree for testing.}}<br>The tools available in this advanced menu are used for testing only.}}
[[File:MenuOverview-Tools-debug-menu-shown-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "{{man menu|Tools >Debug>...}}" Menubar - Tools - Debug menu Overview]]
[[Category:Documentation]]
[[Category:Tools]]
[[Category:Plugins]]
1,438
edits

Navigation menu