Difference between revisions of "Addon:Calculate Estimated Dates"

From Gramps
Jump to: navigation, search
m (found it duhh! it is a Addon tool)
m (fixed the Language issue, turns out the template is looking for lower case version of Language name eg "Fr" > "fr")
(67 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{languages|Calculate_Estimated_Dates}}
+
{{languages|Addon:Calculate Estimated Dates}}
 +
{{Third-party plugin}}
 +
[[File:CalculateEstimatedDates-addon-Help-tab-defaults-51.png|right|thumb|300px|Calculate Estimated Dates - Help( tab ) Initial window on start.]]
 +
The {{man label|Calculate Estimated Dates}} tool Addon is used to add and remove birth and death events for people that are missing these events.
  
{{out of date|can not find this on the menu. duhh! it is a Addon tool}}
+
== Usage ==
  
The '''Calculate Estimated Dates''' tool is used to add and remove birth and death events for people that are missing these events.
+
You can select the tool via the menu {{man menu|Tools->Family Tree Processing-->Calculate Estimated Dates...}} this brings up a {{man label|Undo history warning}} window:
  
Select the tool via the menu {{man menu|Tools->Family Tree Processing-->Calculate Estimated Dates...}} this brings up a {{man label|Undo history warning}} window:
+
{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}  
  
{{man warn|Undo history|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}}  
+
You then choose {{man button|Stop}} or {{man button|Proceed with the tool}}.
 +
 
 +
=== Help ===
 +
 
 +
[[File:CalculateEstimatedDates-addon-Help-tab-defaults-51.png|right|thumb|450px|Calculate Estimated Dates - Help( tab ) Initial window on start.]]
 +
 
 +
You will be presented with the '''Calculate Estimated Dates''' tool window. This window initially has two tabs:
 +
* {{man label|[[Addon:Calculate Estimated Dates#Options|Options]]}} tab and the
 +
* {{man label|[[Addon:Calculate Estimated Dates#Help|Help]]}} tab that is displayed with the following instructions.
  
You then choose {{man button|Stop}} or {{man button|Proceed}}.
+
To use
  
You will be presented with the '''Calculate Estimated Dates''' tool window. This window has three tabs.
+
# Go to the {{man label|[[Addon:Calculate Estimated Dates#Options|Options]]}} tab
 +
# Check the [ ] Remove option to remove previous estimates
 +
# Select the ''Add date options'' to date events with or without dates
 +
# Click on {{man button|Execute}}
 +
# {{man label|[[Addon:Calculate Estimated Dates#Select|Select]]}} the people with which to add events
 +
# Click on {{man button|Add Selected Events}} button to create
  
{{out of date|gramps 3.3 only has 2 tabs for me (it has three tabs after you have clicked on proceed) / need to update image}}
+
{{-}}
  
[[Image:Calcestdates_32.png|right|thumb|450px|Fig. 1. Calculate Estimated Dates]]
+
{{man note|Note|If you decide to make an event permanent, remove it from the Source. Otherwise, it will get removed the next time you automatically remove these events.}}
  
*Options:
+
{{man note|Note|You may have to run the tool repeatedly (without removing previous events) to add all of the events possible.}}
  
**Filter: in the drop down menu you can select which portion of the database will be processed: you can also select the '''entire database''', '''Descendants''' of the Active Person, '''Descendant families''' of the Active Person, '''Ancestors''' of the Active Person, '''People with common ancestor''' with the Active Person, or any '''custom filter''' (see custom made filters).
+
=== Select ===
 +
[[File:CalculateEstimatedDates-addon-Select-tab-example-50.png|right|thumb|550px|Calculate Estimated Dates - Select( tab - showing processed results)]]
  
**Filter Person: the Active Person is listed in this field, but click on the {{man button|Select a different person}} will bring up a {{man label|Select a person for the report}} window. This window shows a list of people you can choose from. Use the {{man button|down}} arrow or the {{man button|>}} arrow to expand and collapse the nodes. In the table you will see for which persons no birth or death date is available.
+
On the {{man label|Select}} tab you will see the processed results if any.  
  
In the left hand side lower corner there is a {{man label|Show all}} tick box. Clicking on this button will show all people in the database.
+
You can individually select the checkbox(s) beside the people or {{man label|Select All}} and then click on {{man button|Add Selected Events}} button to create the new events shown.
  
**Source text: in this {{man label|text field}} you can fill in the text that will be used in the source reference. Default value is: ''Calculated Date Estimates''.
+
{{-}}
  
Four tick boxes are available:
+
=== Options ===
 +
Select the '''Options''' tab
  
** Remove previously added dates
+
[[File:CalculateEstimatedDates-addon-Options-tab-defaults-50.png|right|thumb|450px|Calculate Estimated Dates - Options( tab - defaults)]]
** Add estimated birth dates
 
** Add estimated death dates
 
  
*Config:
+
*{{man label|Filter:}} in the drop down menu you can select which portion of the database will be processed: you can also select the
 +
** '''Entire database'''(default)
 +
** '''Descendants''' of the Active Person
 +
** '''Descendant families''' of the Active Person
 +
** '''Ancestors''' of the Active Person
 +
** '''People with common ancestor''' with the Active Person
 +
** or any '''custom filter''' (see custom made filters).
 +
*{{man label|Filter Person:}} the Active Person is listed in this field, and is changeable for all filters except the '''Entire database'''filter. To change the Filter person click on the {{man button|Select a different person}} icon to bring up a {{man label|Select a person for the report}} window.
  
** Maximum age:
+
: The '''Select a person for the report''' window shows a list of people you can choose from. Use the {{man button|down}} arrow or the {{man button|>}} arrow to expand and collapse the nodes. In the table you will see for which persons no birth or death date is available. On the lower left hand side corner there is a {{man label|Show all}} tick box, that when selected will show all people in the database.
** Maximum sibling age difference:
 
** Average years between generations:
 
** Estimated Dates types
 
  
==To use==
+
*{{man label|Source text:}} in this {{man label|text field}} you can fill in the text that will be used in the source reference. Default value is: ''Calculated Date Estimates''.
[[Image:Calcestdates_tab.png|right|thumb|450px|Fig. 2. User choice list]]
+
**Remove previously added events, notes, and source: Check box (unchecked by default)
 +
*{{man label|Birth:}} drop down list.
 +
**Do not add birth events (default)
 +
**Add birth events without dates
 +
**Add birth events with dates
 +
*{{man label|Death:}}
 +
**Do not add death events (default)
 +
**Add death events without dates
 +
**Add death events with dates
 +
*{{man label|Maximum age:}} '''110'''(default)
 +
*{{man label|Maximum sibling age difference:}} '''20'''(default)
 +
*{{man label|Average years between generations:}} '''20'''(default)
 +
*{{man label|Estimated Dates:}}
 +
**Approximate(about):(default)
 +
**Extremes(after and before)
  
# Go to the {{man label|Options}} tab
+
==See also==
# Check the [ ] Remove option to remove previous estimates
+
* [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Dates]] for Date settings used for calculation operations to determine if a person is probably alive.
# Select the ''Add date options'' to date events with or without dates
+
* [https://www.familysearch.org/help/salesforce/viewArticle?urlname=Do-not-know-exact-birth-date-or-death-date&%3Blang=en&cid=bl-fsmdr-9169 I don't know the exact date to enter into Family Tree] - If you do not know an exact date, you can either enter as much of the date as you know or estimate a year based on other information., - FamilySearch.org
# Click on {{man button|Execute}}
+
* [https://www.newyorkfamilyhistory.org/blog/estimating-dates-and-ages-genealogical-writing Estimating dates and ages in genealogical writing],  New York Genealogical & Biographical Society
# Select the people with which to add events
 
# Click on {{man button|Add Selected Events}} button to create
 
  
{{-}}
+
== Issues ==
 +
* No {{man button|Help}} button.
 +
* {{bug|2241}} Calculate Estimated Dates function needs improvement in selecting which dates fields to estimate
 +
* {{bug|2243}} Calculate Estimated Dates keyed on birth and Life Expectancy Table lookup
 +
* {{bug|7448}} Calculation of estimated ranges - not very good
 +
* {{bug|7898}} Crash during "Calculated Estimated Dates" gramplet
 +
* {{bug|9147}} Add Option to not Calculate Estimated Dates for baptisms and burials
  
{{man note|Note|If you decide to make an event permanent, remove it from the Source. Otherwise, it will get removed the next time you automatically remove these events.}}
+
{{man note|Note that {{man label|Calculate Estimated Dates}} was originally builtin/part of Gramps 3.1|see [[Gramps_3.1_Wiki_Manual_-_Tools#Calculate_Estimated_Dates]]}}
  
{{man note|Note|You may have to run the tool repeatedly (without removing previous events) to add all of the events possible.}}
 
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Tools]]
 
[[Category:Tools]]

Revision as of 03:37, 19 March 2022

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

Calculate Estimated Dates - Help( tab ) Initial window on start.

The Calculate Estimated Dates tool Addon is used to add and remove birth and death events for people that are missing these events.

Usage

You can select the tool via the menu Tools->Family Tree Processing-->Calculate Estimated Dates... this brings up a Undo history warning window:

Gnome-important.png
Undo history

Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.

You then choose Stop or Proceed with the tool.

Help

Calculate Estimated Dates - Help( tab ) Initial window on start.

You will be presented with the Calculate Estimated Dates tool window. This window initially has two tabs:

  • Options tab and the
  • Help tab that is displayed with the following instructions.

To use

  1. Go to the Options tab
  2. Check the [ ] Remove option to remove previous estimates
  3. Select the Add date options to date events with or without dates
  4. Click on Execute
  5. Select the people with which to add events
  6. Click on Add Selected Events button to create


Gramps-notes.png
Note

If you decide to make an event permanent, remove it from the Source. Otherwise, it will get removed the next time you automatically remove these events.

Gramps-notes.png
Note

You may have to run the tool repeatedly (without removing previous events) to add all of the events possible.

Select

Calculate Estimated Dates - Select( tab - showing processed results)

On the Select tab you will see the processed results if any.

You can individually select the checkbox(s) beside the people or Select All and then click on Add Selected Events button to create the new events shown.


Options

Select the Options tab

Calculate Estimated Dates - Options( tab - defaults)
  • Filter: in the drop down menu you can select which portion of the database will be processed: you can also select the
    • Entire database(default)
    • Descendants of the Active Person
    • Descendant families of the Active Person
    • Ancestors of the Active Person
    • People with common ancestor with the Active Person
    • or any custom filter (see custom made filters).
  • Filter Person: the Active Person is listed in this field, and is changeable for all filters except the Entire databasefilter. To change the Filter person click on the Select a different person icon to bring up a Select a person for the report window.
The Select a person for the report window shows a list of people you can choose from. Use the down arrow or the > arrow to expand and collapse the nodes. In the table you will see for which persons no birth or death date is available. On the lower left hand side corner there is a Show all tick box, that when selected will show all people in the database.
  • Source text: in this text field you can fill in the text that will be used in the source reference. Default value is: Calculated Date Estimates.
    • Remove previously added events, notes, and source: Check box (unchecked by default)
  • Birth: drop down list.
    • Do not add birth events (default)
    • Add birth events without dates
    • Add birth events with dates
  • Death:
    • Do not add death events (default)
    • Add death events without dates
    • Add death events with dates
  • Maximum age: 110(default)
  • Maximum sibling age difference: 20(default)
  • Average years between generations: 20(default)
  • Estimated Dates:
    • Approximate(about):(default)
    • Extremes(after and before)

See also

Issues

  • No Help button.
  • 2241 Calculate Estimated Dates function needs improvement in selecting which dates fields to estimate
  • 2243 Calculate Estimated Dates keyed on birth and Life Expectancy Table lookup
  • 7448 Calculation of estimated ranges - not very good
  • 7898 Crash during "Calculated Estimated Dates" gramplet
  • 9147 Add Option to not Calculate Estimated Dates for baptisms and burials
Gramps-notes.png
Note that Calculate Estimated Dates was originally builtin/part of Gramps 3.1

see Gramps_3.1_Wiki_Manual_-_Tools#Calculate_Estimated_Dates