Difference between revisions of "Addon:AncestorsMap"

From Gramps
(Usage)
(Troubleshooting)
Line 47: Line 47:
 
== Troubleshooting ==  
 
== Troubleshooting ==  
  
Places of Ancestor Events that do not appear as pins on the map are probably missing the correct GPS longitude and/or longitude. Determining which Places are missing and need correction can be finicky work. This is most easily done with custom filters... but it takes multiple stages.
+
Places of Ancestor Events that do not appear as pins on the map are probably missing the correct GPS longitude and/or longitude. Determining which Places are missing and need correction can be resolved easily with custom filters... but it takes multiple stages.
  
 
The objective is to find the Places of Events of Ancestors of the [[Gramps_Glossary#home_person|Home Person]]. That's 4 stages of filtering.
 
The objective is to find the Places of Events of Ancestors of the [[Gramps_Glossary#home_person|Home Person]]. That's 4 stages of filtering.

Revision as of 03:33, 20 May 2025

Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any 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.

Gnome-important.png
View does not display places without coordinates

Note that, like all Geography[[Gramps_Template:Version manual_Wiki_Manual_-_Categories#Geography_Category|Geography View]] modes, ONLY the Places with a defined [[Gramps_Template:Version manual_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Longitude & Latitude]] will be plotted.

Ancestors Map Geography view

Ancestors Map is an interactive Geography[[Gramps_Template:Version manual_Wiki_Manual_-_Categories#Geography_Category|Geography]] category addon view mode that plots tagged pins on a Map at the Places associated with Ancestors of the Home Person.

Usage

Before using the view, navigate to the Active Person you want use with the [[Gramps_Template:Version manual_Wiki_Manual_-_Categories#Geography_Category|Geography]] Category view to map the Event Places associated with a different Person's Ancestors.

Gnome-important.png
An interaction in the older 1.0.3 version of the Addon with the Relationship view

may cause the Map to fail to focus on a new Active Person.
Use the Person View or Bookmarks to navigate this selection to a different person. (Note: Current 2025 version 1.0.13)

Map Pins

There are 4 pin types:

Still looking for correct pins. This map use left-handed versions of the normally right-handed magnifying glass.

Pin Description Place types
Gramps-zoom-in.png Zoom-in Magnifying glass Places with Birth Events
Gramps-zoom-out.png Zoom-out Magnifying glass Places with Death Events
Gramps-zoom-best-fit.png Magnifying glass pins with an X Places with Marriage Events
Gramps-geo-mainmap.png Green Push pins Places with multiple Event types

Right-click on a map pin to reveal a pop-up menu listing the Events & People at that Place.

Configuration

The Ancestors Map addon has no specific options but does share the standard Map configuration options.

See the Geography view introduction to using maps.

Troubleshooting

Places of Ancestor Events that do not appear as pins on the map are probably missing the correct GPS longitude and/or longitude. Determining which Places are missing and need correction can be resolved easily with custom filters... but it takes multiple stages.

The objective is to find the Places of Events of Ancestors of the Home Person. That's 4 stages of filtering.

You can set up a multi-stage of filter that shows only Places for Ancestors & [[Gramps_Template:Version manual_Wiki_Manual_-_Categories#.E2.9A.99_Configuration_Options|configure the Places Category view]] to show the Longitude & Latitude columns. This will tell you how many of Ancestor related Places will be omitted from being plotted on the map.

For this multi-stage custom filter, create the following Cascade of custom filters:

  1. Create a Person custom Filter "ActivePerson" using the "Active Person" addon Person General rule.
  2. Person custom Filter "ActiveAncestors" using [[Gramps_Template:Version manual_Wiki_Manual_-_Filters#Ancestral_filters|Ancestral filter]] "Ancestors of <filter> match"; filter=ActivePerson
    You might add a 2nd rule to include the Active Person and then select the "[[Gramps_Template:Version manual_Wiki_Manual_-_Filters#Define_Filter_dialog#multiple_rule_options|At least one rule must apply]]" option. Otherwise, the Events & Places of the Active Person might be omitted
  3. Events custom Filter "ActiveAncestorEvents" using [[Gramps_Template:Version manual_Wiki_Manual_-_Filters#Events_Category_2|Events General filter]] "Events of persons matching the <person filter>"; person filter=ActiveAncestors
  4. Places custom Filter "ActiveAncestorEventPlaces" using [[Gramps_Template:Version manual_Wiki_Manual_-_Filters#Places_Category_2|Places General filter]] "Places of events matching the <event filter>"; event filter=ActiveAncestorEvents
Tango-Dialog-information.png
Making Filters that are more reusable

You could built this using a Person custom filter set to the built-in Default Person (a.k.a. Home Person) General rule. That would more directly correspond to this addon Geography view mode.

But a custom Filter using the "Active Person" addon Person General rule is much more flexible. It stays synchronized to the Person being edited instead of continually resetting the Home Person designation or editing a rule that had been preset to a specific PersonID.

Download and use the incredibly useful addon Person General Rule that was created in early 2020. It replaces the awkward PersonID based rules and makes Custom Filters MUCH more dynamic. Thanks Paul!


Credits

Shared by Serge Noiraud on GitHub GeoAncestor addon

Issues

Issues on MantisBT:

  • 0011681: [Ancestors Map] view mode re-initializing incorrectly (1.0.3 Addon version)
  • 0013241: [Geography view] Pin size difference between places with different number of events too large when there is only 1-2 events.
  • Map Pin upgrades in 0012497: Development of a distinctive Gramps icon theme stencil