Difference between revisions of "Addon:Ancestor Fill Report"

From Gramps
(Created page with "{{Third-party plugin}} {{man note|All sample reports|that are shown are created using Gramps ''Example.gramps'' file}} The {{man label|Ancestor Fill}} report – a helpfu...")
 
(Usage)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Third-party plugin}}
+
{{Third-party addon}}
 +
<!--
 
{{man note|All sample reports|that are shown are created using Gramps ''[[Example.gramps]]'' file}}
 
{{man note|All sample reports|that are shown are created using Gramps ''[[Example.gramps]]'' file}}
 +
-->
  
 
The {{man label|Ancestor Fill}} report – a helpful genealogy report focused on improving data quality in your family history research. This report identifies gaps in a person's pedigree, showing where you need to "fill in missing ancestors" to create a more complete family tree.
 
The {{man label|Ancestor Fill}} report – a helpful genealogy report focused on improving data quality in your family history research. This report identifies gaps in a person's pedigree, showing where you need to "fill in missing ancestors" to create a more complete family tree.
  
This text report provides statistics for a specified number of generations of ancestors, indicating the number of individuals found and the completeness percentage. By highlighting incomplete generations, the report helps to prioritize efforts and generate more complete pedigrees.
+
This text report provides statistics for a specified number of generations of ancestors related by birth, indicating the number of individuals found and the completeness percentage. By highlighting incomplete generations, the report helps to prioritize efforts and generate more complete pedigrees.
  
 
==Usage==
 
==Usage==
[[File:Addon-AncestorFill_ReportOptions.png|thumb|450px|People tab options]] <!--[[File:AncestorFill.jpeg|right|thumb|450px|Ancestor Fill Report - example]] -->
+
[[File:Addon-AncestorFill_ReportOptions.png|thumb|450px|Ancestor Fill Report - Report Options tab - With option '''Display theoretical''' enabled]] <!--[[File:AncestorFill.jpeg|right|thumb|450px|Ancestor Fill Report - example]] -->
After installation of the add-on, you can access the report from the following menu {{man menu|Report &#x27a1; Text Reports &#x25B6; AncestorFill}} or from the Reports dialog, opened by icon in the Toolbar.  
+
Accessed from the following menu {{man menu|Report &#x27a1; Text Reports &#x25B6; AncestorFill...}}.
  
The Reports dialog is recommended during exploration. It has the added clarity of a brief text description of the Report.
+
The Reports dialog displays brief tooltip text descriptions of each option of the Report.
  
 +
<!--
 
From the reports {{man label|People}} tab select the {{man label|Ancestor}} and {{man label|Descendent}} using the {{man button|Select a different person}} buttons.
 
From the reports {{man label|People}} tab select the {{man label|Ancestor}} and {{man label|Descendent}} using the {{man button|Select a different person}} buttons.
 +
-->
  
 
==Example output==
 
==Example output==
 +
 +
Default option '''Display theoretical''' disabled:
  
 
<pre>
 
<pre>
Line 43: Line 49:
  
  
Theoretical
+
With option '''Display theoretical''' enabled:
 +
 
 
<pre>
 
<pre>
 
                 AncestorFill for Garner, Eugene Stanley
 
                 AncestorFill for Garner, Eugene Stanley
Line 65: Line 72:
 
Pedigree Collapse 0.0000%
 
Pedigree Collapse 0.0000%
 
</pre>
 
</pre>
 
+
<!--
 
Notice that even though the example data of Gramps does not offer a possibility to display this, the report makes no distinction between the male and female line. So a hypothetical output such as the one below is also proper:
 
Notice that even though the example data of Gramps does not offer a possibility to display this, the report makes no distinction between the male and female line. So a hypothetical output such as the one below is also proper:
 
+
-->
<pre>
 
                    '''Lines of Descendency from Smith, Ingeman to Nielsen, Augusta'''
 
 
 
'''1. line:'''
 
 
 
1. Smith, Ingeman m. Ericsdotter, Marta
 
2. Smith, Martin m. Jefferson, Elna
 
3. Smith, Martin m. Hansdotter, Kerstina
 
4. Smith, Margareth m. Green, Hans Gustaf
 
5. Green, Peter Lloyd m. Jones, Elisabeth
 
6. Green, Anna Maria m. Nielsen, Edwin
 
7. Nielsen, Augusta
 
 
 
'''2. line:'''
 
 
 
(...)
 
</pre>
 
 
 
  
 
== Development ideas ==
 
== Development ideas ==
 +
<!--
 
* Add option for including events, birth, death and marriage.
 
* Add option for including events, birth, death and marriage.
 
* Add option to include sources.  
 
* Add option to include sources.  
  
 
* Outdated original code [[File:Lines-of-descendency.tar.gz]] from 2009-10-23
 
* Outdated original code [[File:Lines-of-descendency.tar.gz]] from 2009-10-23
 
+
-->
 
== Issues ==
 
== Issues ==
* Help button goes to https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Lines_of_Descendency_Report
+
* Help button goes to [[Gramps_{{man version}}_Wiki_Manual_-_Reports#AncestorFill]]
 +
* Discourse support forum : [https://gramps.discourse.group/t/ancestorfill-report-addon-division-by-zero-error/3677 Division by zero error and non-birth parents]
  
 +
== See Also ==
 +
* [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Pedigree|Pedigree Gramplet]]
 +
* [[Addon:PedigreeChart|Addon:Pedigree Chart]] Graphical Report
 +
* [[Addon:TimelinePedigreeView|Addon:Timeline Pedigree]] Charts view mode
 +
* [[Addon:HtreePedigreeView|Addon:H-Tree Pedigree]] Charts view mode
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Reports]]
 
[[Category:Reports]]

Latest revision as of 05:53, 25 September 2025

Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker.
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.

The Ancestor Fill report – a helpful genealogy report focused on improving data quality in your family history research. This report identifies gaps in a person's pedigree, showing where you need to "fill in missing ancestors" to create a more complete family tree.

This text report provides statistics for a specified number of generations of ancestors related by birth, indicating the number of individuals found and the completeness percentage. By highlighting incomplete generations, the report helps to prioritize efforts and generate more complete pedigrees.

Usage

Ancestor Fill Report - Report Options tab - With option Display theoretical enabled

Accessed from the following menu Report ➡ Text Reports ▶ AncestorFill....

The Reports dialog displays brief tooltip text descriptions of each option of the Report.


Example output

Default option Display theoretical disabled:

                AncestorFill for Garner, Eugene Stanley

Generation 0
Number of Ancestors found 1
Percent of Ancestors found 100.00%
Number of single Ancestors found 1
Pedigree Collapse 0.0000%

Generation 1
Number of Ancestors found 2
Percent of Ancestors found 100.00%
Number of single Ancestors found 2
Pedigree Collapse 0.0000%

Generation 2
Number of Ancestors found 2
Percent of Ancestors found 50.00%
Number of single Ancestors found 2
Pedigree Collapse 0.0000%

Total Number of Ancestors found 4
Total Number of single Ancestors found 4
Pedigree Collapse 0.0000%


With option Display theoretical enabled:

                AncestorFill for Garner, Eugene Stanley

Generation 1
Number of Ancestors found 2
Number of theoretical Ancestors 2
Percent of Ancestors found 100.00%
Number of single Ancestors found 2
Pedigree Collapse 0.0000%

Generation 2
Number of Ancestors found 2
Number of theoretical Ancestors 4
Percent of Ancestors found 50.00%
Number of single Ancestors found 2
Pedigree Collapse 0.0000%

Total Number of Ancestors found 4
Total Number of single Ancestors found 4
Pedigree Collapse 0.0000%

Development ideas

Issues

See Also