15,091
edits
Changes
no edit summary
{{#vardefine:chapter|14}}
{{#vardefine:figure|0}}
[[File:MenuOverview-Tools-5052.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}}
"{{man menu|Tools >...}}" Menubar - Tools Overview]]
This chapter describes the various {{man label|Tools}} available in Gramps.
== Tools ==
[[File:ToolbarIcon-OpenTheToolsDialog-5052.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Toolbar Icon for "Open the tools dialog"]]
The tools can be accessed by choosing the menu {{man menu|Tools ->''Tool Section'' ->''Particular Tool''}} .
=== Tool Selection dialog ===
[[File:ToolSelection-dialog-example-5052.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tool Selection - dialog - example showing "Find Possible Duplicate PeopleCheck and Repair Database" information(and "Debug" tools selection)]]
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 categories and 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]]
This tool compares events across the selected group of people.
Once the report finishes the {{man label|Name and title extraction tool}} dialog results window will be shown.
{{-}}
Once completed the {{man label|Gender statistics rebuilt}} result dialog will be shown.
{{man warn|Rebuild Gender Statistics needed after converting database|Issue {{bug|11314}} notes that gender statistics are swapped after database conversion to SQLite. If your gender guessing is suggesting the opposite gender for particular given names, use the Rebuilt Gender Statistics tool to fix the guessing.}}
See [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.
{{-}}
====<u>Media Manager</u>====
[[File:Introduction-page-MediaManager-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Introduction - page for "Gramps Media Manager" - Tool wizard]]
=====Convert paths from relative to absolute=====
[[File:ConvertPathsFromRelativeToAbsolute-FinalConfirmation-page-MediaManager-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 'Convert paths from relative to absolute':"Final Confirmation" page for "Gramps Media Manager" - Tool wizard - example]]
This tool allows converting relative media paths to the absolute ones. It does this by prepending the {{man label|Base media path for relative media paths:}} as given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#GeneralFamily_Tree.27s_Media_path|Edit > Preferences > General Family Tree's Media path]] tab}} section, or if that is not set, it prepends the default [[Gramps_5.2_Wiki_Manual_-_User_Directory|User's Directory]].
* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
=====Convert paths from absolute to relative=====
[[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 to the given base path in the setting {{man label|Base media path for relative media paths:}} as from given in the {{man label|Family Tree}} tab of {{man menu|Edit->Preferences}} in the {{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#GeneralFamily_Tree.27s_Media_path|Edit > Preferences > General Family Tree's Media path]] tab}} section, or if that is not set, the user's directory is used. A relative path allows to tie connects the file location to a the base media path that can change be changed according to your needs.
* [https://en.wikipedia.org/wiki/Path_(computing)#Absolute_and_relative_paths Absolute and relative paths], From Wikipedia.
[[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 tool will list people who are not 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_Gramps_5.2_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...}}.
[[File:RelationshipTo-dialog-RelationshipCalculator-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Relationship to '...' " - dialog - showing results for "Relationship Calculator" Tool]]
You can use this tool via menu {{man menu|Tools->➡ Utilities->▶ Relationship Calculator...}}.
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 a relationship exists. The exact relationship will be shown in the lower panel ... along the with the common ancesors of ancestors in that's reported relationship. Only blood relationships will display (except for husband-wife and step relationships). Note that "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 ''{{man label|Max generations for relationships'' }} value in the [[Gramps_5.2_Wiki_Manual_-_Settings#GeneralLimits|GeneralLimits]] tab under the {{man menu|Edit->➡ Preferences...}} menu. Moved from the [[Gramps_5.1_Wiki_Manual_-_Settings#General|5.1 General]] tab {{New|5.2}} (The default of 15 generations will report a 12th great-grandparent relationship but not their parentsthe 13th great-grandparents. The active person is counted as one of the generations. So, self generation plus parent plus grandparents are the other 3 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.
=====Verify the Data tab pages=====
Select the criteria you want to run the tool with from the following tabs. If you are OK with the criteria click the {{man button|Run}} button (or hit the {{man key press|Alt|R}} keybinding) and you will be presented with a {{man label|[[Gramps_5.2_Wiki_Manual_-_Tools#Data_Verification_Results_window|Data Verification Results]]}} window.
======General======
=====Data Verification Results window=====
[[File:DataVerificationResults-window-example-5052.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Data Verification Results window.]]
After you run the tool you will be presented with the {{man label|Data Verification Results}} window.
*:The warning showed 'late marriage': checking the data: male person °1738 female person °1756 : marriage X 1804 [Gregorian Calendar] : Everything seemed to be OK: so they (re)married at the age of 66 and 48 years! The warning showed up because the '''General criteria''' was set to '''60'''.
=====See Also=====* Development discussion on Gramps community support Discourse forum:: [https://gramps.discourse.group/t/interest-in-enhancing-verify-py/4075/23 Interest in enhancing verify.py]
{{man tip|Difference between {{man label|Verify the Data}} tool and the [[Gramps_5.2_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and Repair Database tool]] |The Check and Repair Database tool detects inconsistencies in the database structure. The {{man label|Verify the Data}} tool, however, is detecting the records that do not satisfy your particular criteria.}}
{{-}}
This test tool will create many people showing all different date variants as birth. The death date is created by parsing the result of the date displayer for the birth date. This way you can ensure that dates printed can be parsed back in correctly.
{{-}}
[[File:GenderStatisticsTool-dialog-DumpGenderStatistics-Tool-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Gender Statistics tool" dialog results example - for "Dump Gender Statistics" - Tool]]
Will dump the statistics for the gender guessing from based on the persons first name.{{stub}} See [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gender|Gender]] entry.
{{-}}
The {{man label|[[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference#Undo_history_warning|Undo history warning]]}} dialog will be shown and you can either {{man button|Stop}} or {{man button|Proceed with the tool}}.
{{-}}
This tool generates sources and citations for each source in order to populate the database for testing with significant numbers of sources and citations.
{{-}}