Count Descendants

Count Descendants
Count Descendants
Summary	Counts the descendants of a person, and prints tables of descendant counts by generations, occurrence of surnames by generation, and several others.
Validation
Mod Updated	23 Sep 2023
	TNG 15.0
	TNG 14.0
Download stats
Author(s)	Robin Richmond
Homepage	Robin Richmond's Genealogy Database
Mod Support	My Mod Support form
Contact Developer	My Mod Support form
Latest Mod	14.0.0.12g
Min TNG V	10
Max TNG V	15.0
Files modified	Modifies the TNG inner menu of descend.php, descendvert.php, descendtext.php, desctracker.php, register.php, tngrobots.php, plus English pedconfig_help.php; Installs rrcount_descendants.php
Related Mods	TextPlus Charts
Notes	There are Czeck, Danish, Dutch, German, Norwegian, and Spanish translations

TNG version:

14.0

The Count Descendants "chart" is very similar to the Tables chart that was introduced with TNGv14. (In fact, the mod from which the new native chart was derived was itself a derivation of Count Descendants. But because features were added to Count Descendants after the Tables chart spun off, the Count Descendant chart is not a strict subset of the new Tables charts. So, Here's my plan:

For now, the Count Descendants mod still installs the Count Descendants chart, which will sit next to the "Table" chart on the Inner Menu of the Person Profile and various chart programs. o charts are not completely redundant.*
Soon, I hope, I will modify Count Descendants (or create another spinoff) to add the distinct Count Descendants features as ']'optional features in the Tables chart.

- Robin Richmond 3 Feb 2023

Purpose of the Mod

To implement a new "chart" that breaks out the counts of person's descendants and spouses by generation. It also reports the number of descendants in each generation who are living, and the birth year range for each generation, like this:

		All			Living			Descendants Birth Year Range
		Descendants	Spouses	Total	Descendants	Spouses	Total	Descendants Birth Year Range
0	This person	1	1	2	0	0	0	1703 - 1703
1	Children	15	4	19	0	0	0	1730 - 1757
2	Grandchildren	3	2	5	0	0	0	1764 - 1767
3	Great grandchildren	11	7	18	0	0	0	1785 - 1808

The chart also displays surname clouds and lists surnames and counts by generation. There are separate tables and clouds for descendants and spouses. Here's the beginning of a descendants table. again, for descendants and spouses separately, e.g.

Generations:	8	9	10	Total
ALLARD		2		2
ANDERSON		2		2
ANDREWS			1	1
BAASO	3	2		5

Special Cases

Descendants and their spouses can appear more than once in a descendancy (e.g. when cousins marry). The native TNG descendant charts ignore that possibility and will thus list all of their descendants twice. But the Count Descendants chart recognized those duplicates so it can count each person only once (mostly...you'll see)

The people who initiate a duplication (i.e. not their descendants) are listed below the primary result tables. The conditions that cause duplications are

Marriages between cousins; When cousins (of any degree) marry, their descendants are displayed twice by the native TNG descendant charts, but the Count Descendants program counts the descendants only once.
- Cousins who marry are counted both as a descendant and as a spouse in the main descendant count table. To determine the number of unique people in the table, you can subtract the count of "Marriages between cousins" from the grand total in the main descendant count table.
Descendants who are adopted by other descendants. This can occur two ways:
1. Descendant Chris and Chris' spouse Terry have a child named Robin. (Whaterver happens to Terry), Chris marries again, and Chris's second spouse adopts Robin.
2. (For whatever reason) Alex is adopted by another descendant.
Spouses who married more than one descendant, e.g. Descendant Ashley married Franc*s, and when Ashley dies, Franc*s married Ashley's sibling Tracy. Ashley will be counted twice if we aren't paying attention.

Mod Options

None. This mod does add a selection list choice to the initial descendant chart field at Admin>>Setup>>Chart Settings>>Descendancy Chart. This allows the Count Descendant chart to be the default descendant chart.

Related Mods

This mod coordinates with TextPlus Charts in two distinct ways.
1. Inner menu links:v14.0.0.12d
  - The Count Descendants chart program installed by this mod contains an innermenu link to the Text+ Descendant chart. That link is displayed only if the TextPlus Charts mod is installed.
  - Similarly, the Text+ Descendant Chart installed by TextPlus Charts contains a link to the Count Descendants chart, and that link is displayed only if the this mod (Count Descendants is installed.
2. Both mods add options to the "Initial Display" selection box in the "Descendancy Chart" section of the Admin>>Settings>>Char Settings form - but that's not where they coordinate. Both mods also add a help button next to the Initial Display field, and coordinate so that only one button is visible and that button always brings up the Charts help file at the point where both mods add notes.
Male Female and Parent Lines - The Count Descendants mod adds inner menu links to the "Male Lines" and "Female Lines" charts if Male Female and Parent Lines has been installed.

Compatibility

No conflicts that I know of.

Installation

This mod's language strings are defined, distributed and files in its mod subfolder rather than in its .cfg file. TNG programs affected by this mod then load language strings from those mod subfolder files rather than from cust_text.php files. This non-standard technique for handling language strings has several advantages, including that

It loads language strings only into the pages that need them rather than into all TNG pages, and
It simplifies the process of defining and editing translations.

This non-standard technique should be invisible to you unless you want to define a translation or override any of this mod's string values.
Read more about this technique, the simplified translation process, and the procedure for defining site-specific overrides to its language strings.

Files Installed

The program rrcount_descendants.php.

[Show Standard Installation Process]

Requirements

A working TNG installation.
An installed current version of the Mod Manager.
You should backup files listed in the panel on the right.

Procedure

Remove and delete previous version of this mod.
Backup the files updated by this mod. They are listed in the panel at the upper right.
Download the .zip file, Extract its .cfg file to the mods folder.
Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

Try using the Mod Manager Remove capability
Contact me through My Mod Support form.

[Hide Details]

Visualizations

This mod creates a new program, so there is no 'Before' visualization.

1. A screenshot of the main results table Compared to the native chart programs, this program moves the "Generations" selection box to a second line in the "inner menu", and replaces it with a "Chart Types" label. The information icon next to the "Chart Types" label comes from the Chart Types Help mod, and pops up a description of each of the descendant charts The number of generations that has been selected for display in the chart is 10. Because there are more than 10 generations of Kuykendall descendants. the message "There are more descendants" is displayed just below the results table. The two checkboxes in the second line of the Innermenu hide and display the two sets of table column shown inside the purple box. The count of two living descendants in generation 8 (where the birth year range is 1835-1904) reveals data errors. You should be able to find them by search for living people born before the last year shown in that row. Descendants who marry a cousin are counted as both a descendant and as a spouse - and are counted and listed with the heading "Marriages between cousins". The actual number of descendants is the Total outlined in red (1266) minus the number of "Marriages between cousins" (5; also outlined in red), or 1261. Each count and "Show Them" button below the results table is shown only if there are records that match that condition.

2. Some details from the counts below the results table The first two "Show them" buttons have been clicked. Note that "Descendants who married cousins" always come in pairs.

3. More details from the counts below the results table This screenclip shows the descendant surname cloud (with 79 names), and a portion of the pop-up panel that results from clicking on the name "HUTCHESON". The fact that some names are capitalized and some are not is juts an artifact of the TNG site from which this screenshot was generated, where the surnames of the owner's direct ancestors are capitalized.

4. AFTER: A portion of the table showing Surname Counts by Generation

This table can also be sorted by the count of people with each surname.
5. AFTER: Admin>>Setup>>Chart Settings options form You can see the new option "Count", and the help icon. When you mouse over the help icon, the text "New Option(s)" is displayed.

Inner Menu Links

As noted above, this mod places a link to the Descendant Count program in the Inner Menu of all of the native Descendant Chart programs. But it handles the generations count differently from the native programs:

Innermenu links to other descendant charts: The native TNG Descendant Charts all pass their Generation count to any other native Descendant Charts when the second chart program is invoked from the first chart program's Innermenu. But since the Count Descendants chart can quickly print more generations than most charts, the generation count specified in the Count Descendants chart is not always passed to the other program in its Innermenu:
- - It passes the TNG system value "Initial Descendant Generations" ($pedigree['initdescgens']; typically equal to 4) to the PDF chart and the two variants of descend.php (Standard and Compact).
  - It passes its generation count to the remaining native charts (text, register), etc.), but only if its generation count is no more than the TNG system variable for the maximum number of descendant generations ($pedigree['maxdesc']; usually equal to 12).
  - It passes its generation count in full to the "Male Lines" and "Female Lines" charts (from Male Female and Parent Lines) and the TextPlus Descendant chart (from TextPlus Charts) -- if they are installed.

Language Strings

language1

Revision History

Mod Version	TNG Version	Date	Note
v14.0.0.12g	14.0-14.0.3	28 Sep 2023	Executes $flags['tabs'] = $tngconfig['tabs']; conditionally to accommodate TNGv14.0.1
v14.0.0.12d	14.0	20 Mar 2023	No functional changes - updated for TNGv14 and added some language strings.
v13.0.0.12b2	13.0-13.0.1	7Jan2021	Language updates for Danish and Spanish. Fixed capitalization of accented characters in UTF-8 surnames Added inner menu links to and from the descendant vertical chart, which is (at least relatively) new to TNG
v13.0.0.12b	13	6Oct2020	Upgraded to TNGv13 by accommodating new new isset() and empty() function calls. Fixed the primary descendant counts table, which was showing counts for "self", but wasn't putting that label in the table.
v12.0.0.12a	12.0 - 12.3	10May2020	The table of Surname counts by generation can now be sorted by the count. Internal changes include: The language strings now provide more flexibility for languages that use different ways to identify the descendant generations. The language strings have been moved from cust_text.php files to files inside the mod subfolder.
v12.0.0.10a	12.0 - 12.0.2+	9Nov2018	Counts of living people (by generation) have been added in new columns in the table of descendant. The range of descendants' birth years (by generation) has been added in a new column in the table of descendant counts. The strategy for passing the number of generations processed by Count Descendants to the other Descendant Inner Menu programs has changed, as described in the Notes section above. The phrase "Descendant Count for" has been added to the name in the page title, and the page heading. (The short-lived version 10 didn't display the new column headings correctly in all templates.)
v12.0.0.9a	12.0 - 12.0.2+	25 Oct 2018	Added surname clouds and a breakdown of descendant surname clouds by generation. Also replaced my little blue information icon style with the new image that was distributed with TNGv12. (See the last visualization above.) The mod is now fully compatible with TNGv12, and, as described above, coordinates more closely with TextPlus Charts v15.
v10.1.0.7c	10.1 - 11.1.2+	25 Jan 2018	Again, no functional changes; just removed the second line of cust_text.php target location strings for compatibility with anticipated changes in TNGv12.

Mod Version	TNG Version	Date	Note
v10.1.0.7b	10.1 - 11.1.2+	11 Jun 2017	No real function changes; just changed the font size of the help button and hyperlink on the Admin>>Options>Charts screen.
v7a	10.1+	10 May 2017	No real function changes Followed Roger Mitchell's suggestion to add borders to the results table. Added a mod Parameter that can suppress the border & heading styling. Eliminated the language .cfg file by moving the German and Dutch strings to this file. Show Mod Names is now optional, and a style class was defined in an embedded style sheet to remove a dependency on Blue Info Button
Count Descendants v6	10.0 - 10.0.3	25 May 2015	Moved the "Count" innermenu link from before the "PDF" link to the end of the inner menu, to avoid conflicts with a new mod. Added a right-justified footer that displays the program name and version number. For the TNGv10 variant only, fixed the database calls that were broken in v5 of the mod. [[Media:count_descendants-languages_v10.0.0.5.zip\|Download Modv6 for TNGv10.0]
Languages v5	10.0 - 10.1.1	25 May 2015	Small changes to German translation; added HTML entities to German non-UTF8.
Count Descendants v5	10.0 - 10.1.1	1 May 2015	Martin Pannier found two HTML typos that caused the copyright footer to be mispositioned.
v4a & languages file	10.0 - 10.1.1	30 Apr 2015	- The base mod with English strings is unchanged. - The Danish, German, and Dutch translations are in a separate file.
v4	10.0 - 10.1.1	18 Apr 2015	- A new, more understandable (and more translatable) way of displaying special counts below the table of descendant counts, - Handles Danish terminology that counts great*(n)grandparents differently, - Adds the option in Administration >> Setup >> Charts to allow Count Descendants to be the default descendants chart, and - Torben Devantie added Danish translations
v3	10.0 - 10.1.1	15 Apr 2015	Eliminated the duplicates caused when cousins marry each other, and displays other duplicates.
v2	10.0 - 10.1.1	12Apr2015	Bernard Wortelboer added Dutch translations and caught some untranslated strings.
v1	10.0 - 10.1	4Apr2015	Initial Release [Hide Older Versions]