Difference between revisions of "Descendant B Report"

From Gramps
Jump to: navigation, search
m
Line 97: Line 97:
 
Save the file to:
 
Save the file to:
 
linux: local install: place in ~/.gramps/plugins
 
linux: local install: place in ~/.gramps/plugins
 +
 +
== New future features ==
 +
*Thinking of adding notes to the report as seen in 'Reports -> Graphs -> Family Lines Graph' and scroll all the way to the far right of the options.
 +
*Maybe adding a border around the report.
 +
*any others that you can think of?
  
 
== Author / Terms ==
 
== Author / Terms ==

Revision as of 04:16, 9 November 2008

Sample Cousin chart

A double graphical descendant report showing (when given a center family):

  1. a descendant report of the center family's father's parents.
    1. This report shows that Grandmom (on the fathers side) had a second marriage. Sorry no half uncles or cousins here.
  2. a descendant report of the center family (joining above and below).
    1. Arrows point to the center family's father (on top) and mother (below).
  3. a descendant report of the center family's mother's parents (Mom's family is much smaller than dads).

Starting the Report

Once installed, You will find the plugin under 'Reports -> Graphical Report -> Cousin Tree'

Report Options

As this is a plugin report, the standard 'Paper Options' will apply.

Style

For this report there is one more style option; Title. The report title can be sized individually and defaults to seven sizes larger than the standard font size. If there are lots of children under the center family, you may need to make a new style with a smaller font size so the report title isn't too long.

Personal

Center children of Family
This will be the center family for the report.
Generations
the parents of dad and mom will always be shown
1 - Show the parents and siblings of the parents only
2 - (default) Show children of the above. Cousins will be shown with this option
3 - Children of the above (Grandchildren of the parents)
etc
Personal Display Format
How individuals will be displayed. This also includes spouses.
Bold direct descendants
Whether direct descendants of the parents, parents (grandparents) will be bolded.
This does not include half or step children
Compress Personal Display Format
If a line is blank because the information is not available, do not print that line.
example, if a line show 'd. $d $D', this line will not be printed if the person is still alive or no information is given for death.

Spouse

Level of spouses
0 - Do not show any spouses of direct children
1 - show spouses of the above
2 - show spouses of the above (spouses of spouses)
etc
Indent Spouses
if selected, spouses will be indented a little from their spouses. Spouses of Spouses will be indented a little bit further, etc.
Include Marriage information
like the Personal Display Format, how do you wish to format Marriage information for the parents of a family.

Replace

make a line for each replacements that you wish to make like replace this/with this This is useful for very long entries. An example birth place would be 'room 2, maternity ward, some hospital, this county, that state, United States of America' Also abbreviating countries and other things helps, cut down the width of a report. This is very useful so scaling the report and excessive white space can be cut down.

Print

Scale report to fit
Do not scale report. This option works great with the 'One Page Report' option.
Scale report to fit page width only. This option works great for Kinko's 36" wide roll printer (also select the 'One Page Report' option). Also use this option to make 1Xn page reports.
Scale report to fit the size of the page. With this option the 'One Page Report' option is useles.
One page report
Scale up or down the size of the page (whether verticaly or both vertically and horizontally) to fit the natural size of the report. Note that this WILL most likely make irregular page sizes. Great for Emailing to relatives and Kinkos can size to print too.
Include Report Title
If the center family has children the report will show 'Cousin Chart for ' and list the children
If not the parents names will be listed.
Print Page Numbers
Page numbers will be printed on the lower right hand corner of the report.
Include Blank Pages
on multiple page reports, if nothing is on a page, specify to print the page anyway.

Advanced Thoughts

Know the page size you want to print to first.
This is actually very important. There are lots of different things you can do.
If you are printing at home you know what you can print on. If you are printing somewhere else (I use Kinkos a bit), know what they can print on (and how much). example, my Kinkos has a 36 inch wide printer. The paper is on a roll so height is not an issue. So if the report is too long, use the replace option to get it down. then use the scale to width and one page option.
Also don't rule out Landscape. I've made quite a few legal paper reports that were landscape, and fitted to width. Makes an easy report to put together, either taped or bound one page after the other.
Make a new style
A new style will allow you to play with the report title. Changing the font size will change the width and height. No duh. But if there are LOTS of kids the title can be much wider than the report and that creates a problem. In this case you can scale down the title font size to make the two widths match up better. Also if there is only one or two children, you may want a larger title (if you have the height to do so)
Generations / Indent Spouses / Replace
This is more than likely the width of your report. Using replace option correctly can give a better report and maybe room to get in another generation
Compress Personal Display
Do you want every line printed all of the time so people can write on it? Or remove blank lines to really shrink up the height of a report.
Replace text
The size of all of the columns is set to the longest line. Really it is the widest as length does not stipulate width (the letter 'i' is much shorter than the letter 'W"). So changing/abbreviating the widest line will shrink ALL of the columns.
Scale report to fit page width only
When using this option, first check the natural size of the report (one page report with no scaling). If the width of the report is wider than the page width, look into using the replace option first. This will get the natural report width closer to the width of the page that you want to print on, and as such, the font size used will not decrease as much. Thus the readability will increase.

Download / Install

You can download the beta version for Gramps 3.0.x: You find it at [working on it]

There is NOT a working version for Gramps 2.2.5+. If you modify this report to work here, plese let me know.

Save the file to: linux: local install: place in ~/.gramps/plugins

New future features

  • Thinking of adding notes to the report as seen in 'Reports -> Graphs -> Family Lines Graph' and scroll all the way to the far right of the options.
  • Maybe adding a border around the report.
  • any others that you can think of?

Author / Terms

As per the end of Cousin.py:

   translated_name = _("Cousin Tree"),
   status = _("Beta"),
   author_name = "Craig J. Anderson",
   author_email = "[email protected]",
   description = _("Produces a graphical cousin tree"),

Status shows Beta (Should be Stable). I am still find little errors (as of 11/8/08). This is a report. It does NOT write. It is read only. But it still reads YOUR data. So: DO NOT TEST NEW PLUGINS WITH YOUR RESEARCH DATA. EXPORT DATA FIRST TO HAVE A BACKUP, THEN RUN THE TOOL

But I do wish to have this report incorporated as a standard graphical report. I am still not responsible for any loss/damage when using this report. If any happens, tell me. There is no way it can happen (other than power outage, power spike, etc) and I'd like to know. Still not responsible though.  :)

As per the top of Cousin.py:

# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.

I used this only because Descendant.py (which this was based) used it.

Please contact me at the above with any comments, questions, testing, criticism, opinions, yadda, yadda, yadda. I'm an equal opportunity ignorer (kidding).

Comments / Thanks

I have already used this report for many upon many family members. And I love this report a LOT and super anxious to share it with the world. And I am also in the process of looking for code improvements, clean up, etc. I would like to release this report to you all for testing, criticism, opinions, yadda, yadda, yadda.

I would like to thank: (as shown in DescendTree.py)

# Copyright (C) 2000-2007  Donald N. Allingham
# Copyright (C) 2007-2008  Brian G. Matherly

and everyone else that had a hand in this code for their wonderful work. This report is 80% new code but is/was STRONGLY based on their code. And I still use this code for reference.