Difference between revisions of "Addon:Calculate Estimated Dates"

From Gramps
Jump to: navigation, search
m (fixed the Language issue, turns out the template is looking for lower case version of Language name eg "Fr" > "fr")
(45 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{languages|Calculate_Estimated_Dates}}
+
{{languages|Addon:Calculate Estimated Dates}}
 
{{Third-party plugin}}
 
{{Third-party plugin}}
__TOC__
+
[[File:CalculateEstimatedDates-addon-Help-tab-defaults-51.png|right|thumb|300px|Calculate Estimated Dates - Help( tab ) Initial window on start.]]
The '''Calculate Estimated Dates''' Addon tool is used to add and remove birth and death events for people that are missing these events.
+
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.
  
Once this Addon has been install 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:
+
== Usage ==
 +
 
 +
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:
  
 
{{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.}}  
Line 10: Line 12:
 
You then choose {{man button|Stop}} or {{man button|Proceed with the tool}}.
 
You then choose {{man button|Stop}} or {{man button|Proceed with the tool}}.
  
== Usage ==
+
=== 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.
 +
 
 +
To use
 +
 
 +
# 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
 +
 
 +
{{-}}
 +
 
 +
{{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|You may have to run the tool repeatedly (without removing previous events) to add all of the events possible.}}
 +
 
 +
=== Select ===
 +
[[File:CalculateEstimatedDates-addon-Select-tab-example-50.png|right|thumb|550px|Calculate Estimated Dates - Select( tab - showing processed results)]]
 +
 
 +
On the {{man label|Select}} tab you will see the processed results if any.
 +
 
 +
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.
  
You will be presented with the '''Calculate Estimated Dates''' tool window. This window initially has two tabs and the '''[[Calculate_Estimated_Dates#To_use |Help]]''' tab is displayed with instructions.
+
{{-}}
  
 
=== Options ===
 
=== Options ===
Line 47: Line 77:
 
**Extremes(after and before)
 
**Extremes(after and before)
  
==To use==
+
==See also==
[[File:CalculateEstimatedDates-addon-Select-tab-example-50.png|right|thumb|450px|Calculate Estimated Dates - Select( tab - showing processed results)]]
+
* [[Gramps_{{man version}}_Wiki_Manual_-_Settings#Dates]] for Date settings used for calculation operations to determine if a person is probably alive.
 
+
* [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
# Go to the {{man label|Options}} tab
+
* [https://www.newyorkfamilyhistory.org/blog/estimating-dates-and-ages-genealogical-writing Estimating dates and ages in genealogical writing],  New York Genealogical & Biographical Society
# 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}}
 
# 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