This chapter describes the various tools available in GRAMPS.
GRAMPS tools allow you to perform various types of analysis of your genealogical data. Typically, the tools do not produce output in form of printouts or files. Instead, they produce screen output immediately available for the researcher. However, when appropriate, you can save the results of running a tool into a file. Tools present one of the major strengths of GRAMPS compared to the most genealogical software.
The tools can be accessed through the menu by choosing ''' Tools ->Tool Section ->Particular Tool ''' . Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a '''Tool Selection''' dialog invoked by clicking the {{man button|Tools}} icon on the toolbar.
{{grampsmanualcopyright}}
{{languages}}
== Tools == GRAMPS tools allow you to perform various types of analysis of your genealogical data. Typically, the tools do not produce output in form of printouts or files. Instead, they produce screen output immediately available for the researcher. However, when appropriate, you can save the results of running a tool into a file. Tools present one of the major strengths of GRAMPS compared to the most genealogical software. The tools can be accessed through the menu by choosing ''' Tools ->Tool Section ->Particular Tool ''' . Alternatively, you can browse the complete selection of available tools along with their brief descriptions in a '''Tool Selection''' dialog invoked by clicking the {{man button|Tools}} icon on the toolbar.=== Analysis and Exploration ===
This section contains tools which analyze and explore the database, but do not alter it. The following analysis and exploration tools are currently available in GRAMPS:
==== Compare individual events =Individual Events ===
This tool compares events across the selected group of people. The people for this comparison are chosen with the use of custom filters. The custom filters can be created in the Custom Filter Editor (see ''tools-util-cfe'' ) that can be invoked by clicking the '''{{man button|Custom Filter Editor''' }} button. The resulting table produced by this tool can be saved as a spreadsheet.
==== Interactive descendant browser =Descendant Browser ===
This tool builds a tree with the Active Person being the root. Children branch from their parents in the usual manner. Use this tool for a quick glance of a person's descendants.
{{man tip|1=Tip |2=Double-clicking on tree node will bring up the {{man label|Edit Person}} dialog allowing to view or modify the personal data.}}
=== Database Processing ===
This section contains tools which may modify your database. The tools from this section are used mostly for finding and correcting errors in the data. The following database processing tools are currently available in GRAMPS:
{{man note|1=Note |2=The modifications will only be performed upon your explicit consent, except for the automatic fixes performed by {{man label|Check and repair Database}} tool.}}
=== Calculate Estimated Dates ===
=== Edit Database Owner Information ===
=== Extract Information from Names ===
*This tool searches the entire database and attempts to extract titles and nicknames that may be embedded in a person's {{man label|Given name}} field. If any information could be extracted, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to. === Find Possible Duplicate People... === This tool searches the entire database, looking for the entries that may represent the same person. === Fix Capitalization of Family Names... === This tool searches the entire database and attempts to fix the capitalization of family names. The aim is to have conventional capitalization: capital first letter and lower case for the rest of the family name. If deviations from this rule are detected, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to. === Rename Event Types === This tool allows all the events of a certain name to be renamed to a new name. === Reorder GRAMPS ID === This tool reorders the GRAMPS IDs according to the defaults of GRAMPS. == Database Repair == === Check and repair database: === This tool checks the database for integrity problems, fixing the problems it can. Specifically, the tool is checking for:
Broken family links. These are the cases when a person's record refers to a family while the family's record does not refer to that person, and vice versa.
Parent relationship. This checks all families to ensure that father and mother are not mixed up. The check is also made that parents have different gender. If they have common gender then their relationship is renamed to "Partners".
*Extract information from names: This tool searches the entire database and attempts to extract titles and nicknames that may be embedded in a person's {{man label|Given name}} field=== Rebuild Reference Maps === === Rebuild Secondary Indices === === Remove Unused Objects. If any information could be extracted, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to.===
*Find possible duplicate people: This tool searches the entire database, looking for the entries that may represent the same person.
*Fix capitalization of family names: This tool searches the entire database and attempts to fix the capitalization of family names. The aim is to have conventional capitalization: capital first letter and lower case for the rest of the family name. If deviations from this rule are detected, the candidates for fixing will be presented in the table. You may then decide which to repair as suggested and which not to.
*Rename personal event types: This tool allows all the events of a certain name to be renamed to a new name.== Debug ==
*Reorder GRAMPS IDs: This tool reorders the GRAMPS IDs according to the defaults of GRAMPS=== Python Evaluation window... ===
=== Database Repair Reload Plugins ===
=== Debug Show uncollected Objects ===
=== Utilities ===
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:
=== Generate SoundEx codes ===
This utility generates SoundEx codes for the names of people in the database. Please visit the NARA Soundex Indexing page to learn more about Soundex Indexing System.
=== Media Manager... ===
=== Relationship calculator ===
This utility calculates and displays the relationship of any person to the Active Person.
=== Verify the Data... ===
This utility allows you to verify the database based on the set of criteria specified by you.
{{man tip| Difference between Verify tool and previously described Check tool |The Check tool detects inconsistencies in the database structure. The Verify tool, however, is detecting the records that do not satisfy your particular criteria.}}
For example, you may want to make sure that nobody in your database had children at the age of 98. Based on common sense, such a record would indicate an error. However, it is not a consistency error in the database. Besides, someone might have a child at the age of 98 (although this rarely happens). The Verify tool will display everything that violates your criteria so that you can check whether the record is erroneous or not. The ultimate decision is yours.
Custom Filter Editor
[[Image:cfe-df.png|right|thumb|150px|Fig.3.x Define filter]]
Other tools
*Generate SoundEx codes: This utility generates SoundEx codes for the names of people in the database. Please visit the NARA Soundex Indexing page to learn more about Soundex Indexing System.
*Relationship calculator: This utility calculates and displays the relationship of any person to the Active Person.
*Verify the database: This utility allows you to verify the database based on the set of criteria specified by you.
{{man tip| Difference between Verify tool and previously described Check tool |The Check tool detects inconsistencies in the database structure. The Verify tool, however, is detecting the records that do not satisfy your particular criteria.}}
For example, you may want to make sure that nobody in your database had children at the age of 98. Based on common sense, such a record would indicate an error. However, it is not a consistency error in the database. Besides, someone might have a child at the age of 98 (although this rarely happens). The Verify tool will display everything that violates your criteria so that you can check whether the record is erroneous or not. The ultimate decision is yours.
{{man index|Gramps 3.0 Wiki Manual - Reports|Gramps 3.0 Wiki Manual - Settings}}
