Difference between revisions of "Gramps 4.1 Wiki Manual - Reports - part 6"

From Gramps
Jump to: navigation, search
m (Report Options)
(Common options: phrasing)
Line 20: Line 20:
 
Common options for text reports are the filename of the output, the format of the output, selected style, page size and orientation. For HTML reports, there is no page information. Instead, HTML options include the choice of the HTML template, either available in Gramps or a custom template defined by you. Optionally, the reports can be immediately opened with the default application.
 
Common options for text reports are the filename of the output, the format of the output, selected style, page size and orientation. For HTML reports, there is no page information. Instead, HTML options include the choice of the HTML template, either available in Gramps or a custom template defined by you. Optionally, the reports can be immediately opened with the default application.
  
{{man tip|Tip|The options used in reports are persistent: each report remembers its options used last time.}}
+
{{man tip|Tip|The options used in reports are persistent: eg: each report remembers the options previously used.}}
  
 
The options which are specific to a given report will be described directly in that report's entry and on [[Plugins_Command_Line|Command line references]].
 
The options which are specific to a given report will be described directly in that report's entry and on [[Plugins_Command_Line|Command line references]].

Revision as of 01:43, 22 July 2015

Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions


Previous Index Next




This sections describes the different text reports available in Gramps.

Back to Index of Reports.

Text Reports

Text reports represent the desired information as formatted text. Most of the options are common among text reports, therefore they will be described here under Common options.

Common options

Common options for text reports are the filename of the output, the format of the output, selected style, page size and orientation. For HTML reports, there is no page information. Instead, HTML options include the choice of the HTML template, either available in Gramps or a custom template defined by you. Optionally, the reports can be immediately opened with the default application.

Tango-Dialog-information.png
Tip

The options used in reports are persistent: eg: each report remembers the options previously used.


The options which are specific to a given report will be described directly in that report's entry and on Command line references.

For each report there is a screen with on the top part tabs (like Paper Options...) and on the bottom part the Document Options. The number of tabs varies with the report.

Paper options

With the Paper Options you can change :

  • Paper format (Size, Width, Height and Orientation)
  • Margins (Left, Right, Top and Bottom)

and whether to use metric values or not (in. or cm.).

Document Options

  • Output Format: choose the output format:
    • HTML
    • LaTex
    • Open Document Text
    • PDF document
    • Plain Text
    • Print...
    • RTF document

With the checkbox you can indicate to open the made document your default viewer.

  • Filename: default value is /home/<username>report.txt.
  • Style: default default style . With the Style Editor... you can add Document Styles.

Ahnentafel Report

Fig. 11.6.1 Ahnentafel Report Result
Fig. 11.6.2 Ahnentafel Report Options


This report lists the Active Person and his or her ancestors along with their vital data.

The people are numbered in a special way which is an established standard called Ahnentafel.

The Active Person is given number 1. His or her father and mother have numbers 2 and 3, respectively.

This rule holds for every person while going back in generations: father's parents are numbered 4 and 5, and mother's parents are numbered 6 and 7, fathers always numbered with even and mothers with odd numbers.

Therefore, for any person having number N in this tree, the numbers of father and mother are 2N and 2N+1, respectively.

   person = n
   father = 2n
   mother = 2n+1

Each entry will consist of a single paragraph, and should contain the following contents:

  • Person number.
  • Person's name.
  • Birth Information, if available.
  • Death Information, if available.
  • Burial Information, if available

See also common options

Report Options

  • Center Person: the center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Generations: The number of generations to include in the report. Default : 10 generations
    • Check Box: Page break between generations: Whether to start a new page after each generation.
    • Check Box: Add linebreak after each name: Indicates if a line break should follow the name.
  • Translation: The translation to be used for the report. Language selector

Birthday and Anniversary Report

This report gives the same information as a calender report but in text format.

Fig. 11.6.3 Birthday and Anniversary Report - options
Fig. 11.6.4 Birthday and Anniversary Report - first page of HTML output


See also common options

Text Options

You can fill in any text in the following text fields:

  • Title Text : default: Birthday an Anniversary Report
  • Text Area 1: default: My Birthday Report
  • Text Area 2: default: Produced with Gramps
  • Text Area 3: default: http://gramps-project.org/

Report Options

  • Year of report: fill in the year. Defaults to current Year.
  • Filter: choose between
    • Entire Database (Default)
    • Descendants of active person
    • Descendant families of active person
    • Ancestors of active person
    • People with common ancestor with active person
    • any custom made filter
  • Center Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Country for holidays: Select the country to see associated holidays.
  • First day of week: Select the first day of the week for the report. Default: Monday
  • Birthday surname: Select married women's displayed surname.
    • Wives use their own surname (Default)
    • Wives use husband's surname (from first family listed)
    • Wives use husband's surname (from last family listed)
  • Checkboxes:
    • Include only living people: include or not living persons in the calendar
    • Include birthdays: include or not birthdays in the calendar
    • Include anniversaries: include or not anniversaries in the calendar
    • Include relationships to center person (Note: Slower to create report)
  • Translation: The translation to be used for the report. Language selector

Complete Individual Report

This report provides individual summaries similar to that of the Individual Summary report (Gramps 2.0.x).

Fig. 11.6.5 Complete Individual Report - default options
Fig. 11.6.6 Complete Individual Report - sample HTML output


See also common options

Report Options

The advantage of this report is the specific filter option. Depending on the filter choice (Active Person only, his or her descendants, his or her ancestors, or entire database), the report may contain from one to many individual summaries. Another option for this report is the inclusion of source information when listing events.

  • Filter: choose between
    • Entire Database (Default)
    • Descendants of active person
    • Descendant families of active person
    • Ancestors of active person
    • People with common ancestor with active person
  • Filter Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Checkboxes:
    • List events chronologically
    • Page break before end notes
    • Include Source Information
    • Include source notes
    • Include Photo/Images from Gallery
    • Include Gramps ID
  • Translation: The translation to be used for the report. Language selector

Sections

  • Event groups: Checkboxes: check if separate section is required.
    • Family
    • Religious
    • Vocational
    • Academic
    • Travel
    • Legal
    • Residence
    • Other
    • Custom


Descendant Report

This report presents the descendants of the Active Person with a brief description in indented style.

Fig. 11.6.7 Descendant Report - default options
Fig. 11.6.8 Descendant Report - sample HTML output


See also common options

Report Options

The only specific option concerns the number of forward generations to consider.

  • Center Person: the center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Numbering system: The numbering system to be used.
    • Simple numbering
    • de Villiers/Pama numbering
    • Meurgey de Tupigny numbering
  • Generations: The number of generations to include in the report. Default : 10 generations
    • Check Box: Show marriage info: Whether to show marriage information in the report.
    • Check Box: Show divorce info: Whether to show divorce information in the report.
    • Check Box: Show duplicate trees: Whether to show duplicate Family Trees information in the report.
  • Translation: The translation to be used for the report. Language selector



Detailed Ancestral Report

This report covers in detail the ancestors of the active person, including a range of vital data as well as marriages, following Sosa-Stradonitz/Ahnentafel numbering. It shares many of its properties with the Detailed Descendant Report (see below).

Fig. 11.6.9 Detailed Ancestral Report - default options
Fig. 11.6.10 Detailed Ancestral Report - sample HTML output


See also common options

Report Options

The report is structured with the Ahnentafel standard numbering.

  • Center Person: the center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Generations: The number of generations to include in the report. Default : 10 generations
    • Check Box: Page break between generations: Whether to start a new page after each generation.
    • Check Box: Page break before end notes: whether to start a new page before end notes
  • Translation: The translation to be used for the report. Language selector

Content

Checkboxes:

  • Use callname for common name: whether to use the call name as the first name.
  • Use full dates instead of only the year: whether to use full dates instead of year.
  • List children: whether to list children.
  • Compute death age: whether to compute a person's age at death.
  • Omit duplicate ancestors: whether to omit duplicate ancestors.
  • Use complete sentences: whether to use complete sentences or succinct language.
  • Add descendant reference in child list: whether to add descendant references in child list.

Include

Checkboxes:

  • Include note
  • Include attributes
  • Include Photo/Images from Gallery
  • Include alternative names
  • Include events
  • Include addresses
  • Include sources
  • Include source notes

Missing Information

Checkboxes:

  • Replace missing places with ___
  • Replace missing dates with ___


Detailed Descendant Report

This report covers in detail the descendants of the active person by generation, following the genealogical tradition of textual descendant reports by generation. It aims to provide all important features expected to be found in these classic descendency formats and has received influence from various sources. The Gramps team considers as one of its objectives the viability of this report's adoption by professional genealogical institutions worldwide. As a consequence this is a highly customizeable report.

The report includes a range of vital information, marriages and (optionally) notes and spouses' information. Among the numerous options are the number of forward generations to consider, whether to compute ages, the text-style between complete-sentenced and succinct, and whether to include images. The report utilizes Henry-style numbering by default, and offers d'Aboville-style numbering and Register-style numbering as options.

Fig. 11.6.11 Detailed Descendant Report
Fig. 11.6.12 Detailed Descendant Report


If you are a professional or amateur genealogist and feel that this report lacks something in order to be usable by yourself or institution, feel free to submit a feature request at http://bugs.gramps-project.org.

See also common options


Report Options

  • Center Person: the center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Numbering system: the numbering system to be used.
    • Henry numbering (default)
    • d'Aboville numbering
    • Record (Modified Register) numbering
  • Generations: The number of generations to include in the report. Default : 10 generations
    • Check Box: Page break between generations: Whether to start a new page after each generation.
    • Check Box: Page break before end notes: whether to start a new page before end notes
  • Translation: The translation to be used for the report. Language selector

Content

Checkboxes:

  • Use callname for common name: whether to use the call name as the first name.
  • Use full dates instead of only the year: whether to use full dates instead of year.
  • List children: whether to list children.
  • Compute death age: whether to compute a person's age at death.
  • Omit duplicate ancestors: whether to omit duplicate ancestors.
  • Use complete sentences: whether to use complete sentences or succinct language.
  • Add descendant reference in child list: whether to add descendant references in child list.

Include

Checkboxes:

  • Include notes
  • Include attributes
  • Include Photo/Images from Gallery
  • Include alternative names
  • Include events
  • Include addresses
  • Include sources
  • Include sources notes
  • Include spouses
  • Include sign of succession ('+') in child-list
  • Include path to start-person

Missing Information

Checkboxes:

  • Replace missing places with ___
  • Replace missing dates with ___


End of Line Report

This provides a list of a person's last known ancestors with the pedigree line, ordered by generations.

Fig. 11.6.13 End of Line Report - default options
Fig. 11.6.14 End of Line Report - sample HTML output


See also common options

Report Options

  • Center Person: the center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Translation: The translation to be used for the report. Language selector

Family Group Report

This creates a family group report, showing information on a set of parents and their children.

Fig. 11.6.15 Family Group Report - default options
Fig. 11.6.16 Family Group Report - sample HTML output


See also common options

Report Options

  • Center Family: The center family for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Recursive: Create reports for all descendants of this family.
  • Translation: The translation to be used for the report. Language selector

Include

Check Boxes:

  • Generation numbers(recursive only): Whether to include the generation on each.
  • Parent Events: Whether to include events for parents.
  • Parent Addresses: Whether to include addresses for parents.
  • {{man label|Parent Notes: Whether to include notes for parents.
  • Parent Attributes: Whether to include attributes.
  • Alternate Parent Names: Whether to include alternate name.
  • Parent Marriage: Whether to include marriage information for parent.
  • Dates of Relatives: Whether to include dates for relatives.
  • Children Marriages: Whether to include marriage information for children.

Missing Information

  • Print fields for missing: Whether to include fields for missing information.

Specific options

Specific options: the spouse (available only if the Person has more than one spouse).


Kinship Report

This provides the kinship of selected person according to level search (height, down generations) set by user.

Fig. 11.6.17 Kinship Report - default options
Fig. 11.6.18 Kinship Report - sample HTML output


See also common options

Report Options

  • Center Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Max Descendant Generations: The maximum number of descendant generations.
  • Max Ancestor Generations: The maximum number of ancestor generations.
  • Include spouses: Whether to include spouses.
  • Include cousins: Whether to include cousins.
  • Include aunts/uncles/nephews/nieces: Whether to include aunts/uncles/nephews/nieces.
  • Translation: The translation to be used for the report. Language selector


Tag Report

This lists primary objects (person, family, notes) who match the selected tag. (This report was previously called the "marker report" in Gramps 3.2.)

Fig. 11.6.19 Kinship Report - default options
Fig. 11.6.20 Tag Report - sample HTML output for the complete tag


See also common options

Report Options

  • Tag: Select the tag to use for the report.
  • Translation: The translation to be used for the report. Language selector


Number of Ancestors

This report displays the number of ancestors of the active person.

Fig. 11.6.21 Number of Ancestors Report - default options
Fig. 11.6.22 Number of Ancestors Report - sample HTML output


Just choose a person and click on the menu Reports-->Text Reports-->Number of Ancestors Report....

See also common options

The report

The report shows the following details:

generation 1 has 1 individual : 100% : this is the person you started with
generation 2 has 2 individuals : 100% : both parents are known
.....
generation 8 has 35 individuals : 27.34 % this means from the (2**7) 128 possible ancestors in generation 8 - 27% are known.

Total ancestors in generation 2 to .. is also given in numbers and percentages.

With the Close button you close the window and this report.

Report Options

  • Center Person: The center person for the report.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Translation: The translation to be used for the report. Language selector

Place Report

Produces a report according to places selected by the user.

It will list related person and event to the selected place.

Fig. 11.6.23 Place Report - default options
Fig. 11.6.24 Place Report - sample HTML output


See also common options


Report Options

  • Select using filter: Select places using a filter.
  • Name Format: Select the format to display the names. Choose from Default / Surname, Given Suffix / Given Surname Suffix / Given / Main Surnames, Given Patronymic Suffix / SURNAME, Given (Common)
  • Select places individually: List of places to report on.
  • Center on: If report is event or person centered.
    • Check Box: Include private data: Whether to include private data.
  • Translation: The translation to be used for the report. Language selector

Records Report

The Records report shows a number of interesting records (mostly age related) in your database, like oldest living person, youngest mother, etc.

Fig. 11.6.25 Records Report - default options
Fig. 11.6.26 Records Report - sample HTML output


See also common options

Report Options

Selection of the records to print is possible, and a reasonable list of "positive records" is preselected (most people would regard, for example, a long marriage as a positive record, while an early divorce would rather be seen as a negative record).


  • Filter: choose between
    • Entire Database (Default)
    • Descendants of active person
    • Descendant families of active person
    • Ancestors of active person
    • People with common ancestor with active person
  • Filter Person: The center person for the report.
  • Number of ranks to display: default: 3
  • Use call name:
    • Don't use call name
    • Replace first names with call name
    • underline call name in first names / add call name to first name
  • Footer text: default = empty field
  • Translation: The translation to be used for the report. Language selector


Gnome-important.png
Caveats

If the option to underline the call name is selected, the report uses <u>...</u> to achieve this. This only works with CairoDoc based output (direct printing, PDF export) and HTML output.


Database Summary Report

This report displays the overall statistics concerning number of individuals of each gender, various incomplete entries statistics, as well as family and media statistics.

You can run this report via the menu Report-->Text Reports-->Database Summary Report....

Fig. 11.6.27 Database Summary Report - default options
Fig. 11.6.28 Database Summary Report - sample HTML output


See also common options

The report

Shows a break down of the following information for the open Family tree

The numbers in the different categories are shown

  • Individuals:
    • Number of individuals:
    • Males:
    • Females:
    • Individuals with unknown gender:
    • Incomplete names:
    • Individuals missing birth dates:
    • Disconnected individuals:
    • Unique surnames:
    • Individuals with media objects:
  • Family information:
    • Number of families:
  • Media Objects:
    • Number of unique media objects:
    • Total size of media objects: in MB(megabytes)
  • Missing Media Objects: this will show the file names of any missing media object.

The information given in this report is the same as in the Statistics Gramplet

Report Options

  • Translation: The translation to be used for the report. Language selector

Back to Index of Reports.


Previous Index Next