<CensusTables>

The <CensusTables> option is used to select individuals for whom census tables will be generated. Census tables provide an easy way to view all of the census information for a selected individual's ancestors in a single table, making it easy, at a glance, to determine which records are missing, where they are likely to be found and possible migration patterns. Census tables are only created if the selected individual has ancestors who were possibly living during the range of years specified by the <CensusYears> option; only applicable ancestors will be included in the table. When no <CensusYears> are defined, which is the default state, Gigatrees5 will determine the census years to be considered by automatically detecting both GEDCOM census records, and GEDCOM residence records whose referenced sources mention the phrase "Census" in the source title.

Census tables are composed of rows showing every applicable ancestor and columns showing every configured census year. The <Skip> option can be used to discard table entries for selected individuals for a selected number of years. This is useful for removing missing and unknown entries from a table for years where a selected individual did not live in a location holding censuses during the period the configured <CensusYears>. For each census record found, a location code is placed in the table cell associated with the record's ancestor and year. Location codes are extracted from the database specified by the <LocationFile> option, which is set by default. If no location code is found, an 'X' is used. If the person has no census record for one of the census years, an "m" is displayed, and if the year does not apply to an individual, a "-" is used. If no census event was found for an ancestor whose living status cannot be determined, a question mark "?" will be displayed to indicate that the event is missing and that their living status is unknown. The location code is hyperlinked to the applicable source page if found.

Gigatrees5 supports an (optional) value for an individual's census event that can be set using the standard GEDCOM cause field ( CAUS ). The values are Named, Given and Counted. The names are translatable. A value of Named indicates that both a person's given and surname are provided in the census record as would be true for the male heads-of-household and children in more recent years. When set, the location code will be shown in bold. A value of Given indicates that only a person's given name is provided such as would be true of a woman whose maiden name is not provided. When set, the location code will be underlined. A name type of Counted indicates that a person is counted in the census, but no name is provided, such as would be true of early U.S. Federal census records that only provide head counts for family members and slaves (let's not forget who we are!). When set, the location code will be shown in italics.

Gigatrees5 also supports an (optional) census type. The value can be set using the standard GEDCOM census record description field ( TYPE ). When present, Gigatrees5 will substitute the claim text located in timelines and event lists with the text provided in that field.

Gigatrees:
<Ids> [ ]A semicolon-delimited list of individual's names and record ids. The individual name should be unique in your database. All individual name fields will be searched.
<CensusYears> [ ]A comma-delimited list of census years to consider. An empty list, which is the default state, will determine the census years to be considered automatically.
<Skip> This element is a wrapper element to indicate the beginning of a new option to setup the years for which a selected individual will not be considered.
<Id> [ ]This is the individual name or record id of the member of the <Ids> defined above to be considered. The individual name should be unique in your database. All individual name fields will be searched.
<Years> [ ]A comma-delimited list of census years to not consider for the selected <Id>.
Example:

In this example, census tables will be created for two individuals. Four census years will be considered, and a different year is skipped for each of the individuals.

<CensusTables>

<Ids> I1; Henry Cooper </Ids>

<CensusYears> 1905, 1911, 1921, 1930 </CensusYears>

<Skip>
<Id> I1 </Id>
<Years> 1905 </Years>
</Skip>

<Skip>
<Id> Henry Cooper </Id>
<Years> 1930 </Years>
</Skip>

</CensusTables>