Gramps 3.1 Wiki Manual - Reports

From Gramps
Revision as of 16:20, 5 October 2009 by Erikdr (talk | contribs)
Jump to: navigation, search

This section describes all the different reports available in GRAMPS.


Previous Index Next


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



  1. Generating Reports
  2. Substitution Values
  3. Books
  4. Graphical Reports
  5. Graphs
  6. Text Reports
  7. Web Pages and Quick Reports


Common Options

  • pid: The center person for the filter (ex: Smith, Edwin Michael)
  • filter: Determines what people are included in the report
  1. Entire Database
  2. Descendants of Smith, Edwin Michael
  3. Descendant Families of Smith, Edwin Michael
  4. Ancestors of Smith, Edwin Michael
  5. People with common ancestor with Smith, Edwin Michael


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 only once, at the end of this section.

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: each report remembers its options used last time.


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

The following text reports are currently available in GRAMPS:

Ahnentafel Report

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


Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

Fig. 8.31 Report Options
  • Center Person: the center person for the report.
  • 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.
  • Check Box: Compress Tree: whether or not compress the tree.
Fig. 8.32 Ahnentafel Report Result


Birthday and Anniversary Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

Fig. 8.34 Report Options

Final Result:

Fig. 8.33 Birthday Report Result


Complete Individual Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

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.

Descendant Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

Fig. 8.35 Descendant Report

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

Example Result:



Detailed Ancestral Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

Fig. 8.36 Detailed Ancestral Report

The report is structured with the Ahnentafel standard numbering. Specific options: number of backward generations to consider, whether to include siblings, whether to include notes, as well as a variety of options regarding the exact contents to present.

Example Result:



Detailed Descendant Report

This report covers in detail the descendants of the active person, following the genealogical tradition of textual descendant reports. It aims to provide all important features expected to be found in the 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.

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

Fig. 8.37 Detailed Descendant 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 Register-style numbering as an option.

If you are a professional genealogist and feel that this report lacks something in order to be usable by your institution, feel free to submit a feature request at http://bugs.gramps-project.org. That goes also for amateur genealogists with improvement ideas of course.

Example Result:



End of Line Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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



Family Group Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

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



Kinship Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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



Marker Report

This lists primary objets (person, family, notes) who match the selected marker.

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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



Number of Ancestors

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

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

The report

Fig. 8.38 Number of Ancestors


The window will show up listing the 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.


Place Report

Produces a report according to places selected by the user. It will list related person and event to the selected place.

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Records Report

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

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

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).

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.


Summary of the Database

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-->Summary of the database....

Paper options

With the Paper Options you can change :

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

and whether to use metric values or not.

Document Options

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

With the checkbox you can indicate to open the made document with OpenOffice.org Word Processor or a Document Viewer (PDF file).

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

Report Options

Fig. 8.39 Summary
  • Individuals: the numbers in the different categories are shown
    • Number of individuals:
    • Males:
    • Females:
    • Individuals with unknown gender:
    • Individuals with incomplete names:
    • Individuals missing birth dates:
    • Disconnected individuals:
  • Family information:
    • number of families:
    • Unique surnames:
  • Media Objects:
    • Individuals with Media Objects:
    • Total number of media object references:
    • Number of unique media objects:
    • Total size of media objects: in bytes
  • Missing Media Objects: this will show the full path and file names of any missing media object.

The information given in this report is the same as in the Statistics_Gramplet



Previous Index Next