16,736
edits
Changes
From Gramps
m
Text replacement - "5.2" to "6.0"
{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools}}
{{#vardefine:chapter|14}}
{{#vardefine:figure|0}}
The tools can be accessed by choosing the menu {{man menu|Tools ->''Tool Section'' ->''Particular Tool''}} .
Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Tool_Selection_dialog|Tool Selection]]}} dialog invoked by clicking the {{man button|Open the tools dialog}} icon on the toolbar from any of the categories.
{{-}}
{{man note|Additional Tools |Gramps allows you to install even more tools. This system is controlled by the [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Plugin_Manager|'''Plugin Manager''']]. For additional tools see [[6.0 Addons|'''Addons''']].}}
== Tool Selection dialog ==
[[File:DatabaseOwnerEditor-dialog-example-context-menu-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Database Owner Editor" - dialog - showing context menu]]
This tool modifies any existing [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Settings#Researcher|Researcher Information]].
Select the menu {{man menu|Tools->Family Tree Processing->Edit Database Owner Information...}}. This brings up the {{man label|Database Owner Editor}} window, where you can fill in the needed info.
===<u>Extract Event Description</u>===
{{man note|Note|The name format in the Event's Description field depends on the defined name format in {{man menu|Edit->Preferences->Display->[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Settings#Display|Name format]]}}}}
[[File:ModificationsMade-window-example-50.png|right|thumb|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Extract Event Description's - Modifications Made - window - example result]]
You can access this tool via the menu {{man menu|Tools->Family Tree Processing->Extract Information from Names....}}
The {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_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}}.
[[File:ExtractInformationFromNames-DefaultPrefixAndConnectorSettings-dialog-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Default prefix and connector settings" - dialog for the "Extract Information from Names" Tool]]
{{man label|Options}}
*{{checkbox|1}} {{man label|Use [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Gramplets#SoundEx_Gramplet|soundex]] codes}} for matching possible duplicate people. (checkbox checked by default)
The following buttons are present: {{man button|Help}} brings you to this page, {{man button|Cancel}} to stop processing and an {{man button|OK}} button to start processing the data.
You can either double-click on the selected row or select the {{man button|Compare}} button to check the details.
Three buttons are present: {{man button|Help}} brings you to this page, a {{man button|Close}} to close the window which returns you to the {{man label|Find Possible Duplicate People}} window and a {{man button|Compare}} button to which brings up the {{man label|Merge People}} window which was explained in detail in the [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_3#Merge_People|Merge People]] Dialog. Here you can select with the radio buttons one of the persons and eventually use the {{man button|OK}} button to merge the data if you find the two persons are duplicates.
Selecting the {{man button|Cancel}} button brings you back to the {{man label|Potential Merges}} result list window.
Select {{man button|OK}} to run the tool and once complete it will report back the total with the {{man label|Number of merges done}} result dialog.
{{-}}
See also the [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Citations|Merge Citations]] option available from the Citations Category list view
{{-}}
See also:
* [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]
===<u>Reorder Gramps ID</u>===
The 'Actual' column shows an example of the current ID. The 'Quantity' column show the number of objects.
The 'Format' column can be used to change the ID format for each object type. Note that the format consists of a prefix, the '%04d' and suffix. There MUST be at least a prefix or a suffix, both are allowed. It is recommended to keep these relatively short. The '%04d' defines the length of the numeric portion of the ID, the '4' can be changed, anything from '3' (allowing numbers from 000-999) to '9' (000000000-999999999) is allowed. Changes made here are the same as made in the menu {{man menu|Edit->Preferences...}} and then select the '''[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]''' tab. The 'Format' label is actually a button that can be used to reset all the formats to the last used value.
The 'Change' column contains checkboxes for each object type. If this is checked, the IDs for that object will be replaced with new IDs of the 'Format' style, unless 'Keep' is also checked. If there is no check, the ID formats are NOT updated, but the number field within the format is renumbered. The 'Change' label is actually a button that can be used to toggle all of the check boxes at once.
Events appearing on the Event tab on a Person or Family Editor are not sorted in any particular order other than the order that the events were added. The reason for not enforcing any particular ordering, particularly ordering by date, is to allow for the situation where an event was known to have happened but the exact chronology is not. Importing or merging data from an external source can lead to extra events being added to, but out of sequence with, the existing set of events of a person or family.
Events can be manually re-ordered by [http://en.wikipedia.org/wiki/Drag-and-drop ''drag & drop''] or by use of the re-order buttons on the {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Events]]}} tab. Either way, an event can be moved up or down in the list of events and Gramps will remember the new order when the changes are saved. The new ordering will be used wherever events are shown elsewhere in Gramps, such as on a report.
The order of all events on a tab can also be changed by clicking a column title. For example, clicking the 'Date' column header will sort all the events in date order. However this way of sorting events is temporary and changes to the event order are not preserved when the window is closed.
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 ➡ Family Tree Repair ▶ [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}
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... ‘just in case’.
====See also====
* This rebuild is also performed as part of the {{man menu|Tools ➡ Family Tree Repair ▶ [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Check_and_Repair_Database|Check and repair database...]]}}
{{-}}
This section contains tools allowing you to perform a simple operation on a portion of data. The results can be saved in your database, but they will not modify your existing data. The following utilities are currently available in Gramps:
* [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Find_database_loop|Find database loop]] - * [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Media_Manager|Media Manager]] - * [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Not_Related|Not Related]] - * [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]] - * [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Verify_the_Data|Verify the Data]] -
From the '''Selection''' page window select from one the four options the actions you want to take and then select the {{man button|Next}} button:
* {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Replace_substrings_in_the_path|Replace substrings in the path]]}} (default)* {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}* {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}* {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Add_images_not_included_in_database|Add images not included in database]]}}
{{-}}
[[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 path for relative media paths:}} as given in the [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Settings#General|Edit > Preferences > General ]] tab, or if that is not set, it prepends the default [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_User_Directory|User's Directory]].
[[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 path for relative media paths:}} as from the [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Settings#General|Edit > Preferences > General ]] tab, or if that is not set, the user's directory is 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.
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 ''Max generations for relationships'' value in the [[Gramps_5Gramps_6.2_Wiki_Manual_0_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.
====See also:====
<!--
* The '''[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]'''
-->
* The '''Relationship to home person''' [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar* '''Relation to Home Person''' [[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
* The '''[[Addon:Deep_Connections_Gramplet|Deep Connections]]''' gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or if both person a connected through the same spouse.) The Gramplet also details the indirect relationships.
{{-}}
====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 {{man key press|Alt|R}} and you will be presented with a {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools#Data_Verification_Results_window|Data Verification Results]]}} window.
Depending on your criteria and your data a list will be shown. Some possibilities of findings are listed below. But there are others.
*: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'''.
{{man tip|Difference between {{man label|Verify the Data}} tool and the [[Gramps_5Gramps_6.2_Wiki_Manual_0_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.}}
{{-}}
[[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]]
When the python <code>-O</code> optimise flag is not turned on, an additional {{man menu|Debug}} entry appears in the {{man menu|[[Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools|Tools]]}} menu.
See [[Gramps_5Gramps_6.2 0 Wiki Manual - Command Line#Python options|Command Line: Python options]]
{{-}}
===Check Localized Date Displayer and Parser===
The testcase generator will generate some persons and families that have broken links in the database or data that is in conflict to a relation.
The {{man label|[[Gramps_5Gramps_6.2_Wiki_Manual_0_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}}.
{{stub}}
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Reports|Gramps 6.0 Wiki Manual - Settings|6.0}}
{{languages|Gramps_5Gramps_6.2_Wiki_Manual_0_Wiki_Manual_-_Tools}}
{{grampsmanualcopyright}}
