Difference between revisions of "Addon:AncestorsMap"
From Gramps
(→Usage) |
m |
||
| (28 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{Languages|AncestorsMap}} | + | {{Languages|Addon:AncestorsMap}} |
{{Third-party addon}} | {{Third-party addon}} | ||
| − | {{man warn|View does not display places without coordinates|Note that, like all {{icon|geog}}[[Gramps_{{ | + | {{man warn|View does not display places without coordinates|Note that, like all {{icon|geog}}[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category|Geography View]] modes, ONLY the Places with a defined [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Longitude & Latitude]] will be plotted.}} |
| − | [[File: | + | [[File:GeographyView-GeoAncestor-AncestorsMap-example-60.png|thumb|right|450px|Ancestors Map ('''GeoAncestor''') Geography view]] |
| − | + | {{man label|Ancestors Map}} ('''GeoAncestor''') is an interactive {{icon|geog}}{{man label|[[Gramps_{{man version}}_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 [[Gramps_Glossary#home_person|Home Person]]. | |
| − | |||
| − | |||
== Usage == | == Usage == | ||
| − | + | Before using the view, navigate to the [[Gramps_Glossary#active_person|Active Person]] you want use with the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category|Geography]] Category view to map the Event Places associated with a different Person's Ancestors. | |
| − | + | === Map Pins === | |
| + | There are 4 pin types: | ||
| − | |||
| − | |||
<small>''Still looking for correct pins. This map use left-handed versions of the normally right-handed magnifying glass.''</small> | <small>''Still looking for correct pins. This map use left-handed versions of the normally right-handed magnifying glass.''</small> | ||
| Line 40: | Line 37: | ||
Right-click on a map pin to reveal a pop-up menu listing the Events & People at that Place. | Right-click on a map pin to reveal a pop-up menu listing the Events & People at that Place. | ||
| − | == | + | ==Configuration== |
| − | + | The {{man label|Ancestors Map}} addon has '''no specific options''' but does share the standard [[Gramps_{{man version}}_Wiki_Manual_-_Categories#The_configuration|Map configuration]] options. | |
See the Geography view [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Usage|introduction to using maps]]. | See the Geography view [[Gramps_{{man version}}_Wiki_Manual_-_Categories#Usage|introduction to using maps]]. | ||
| Line 48: | Line 45: | ||
== 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 | + | 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]]. | + | The objective is to find the Places of Events of Ancestors of the [[Gramps_Glossary#home_person|Home Person]]. Which is 4 stages of filtering and installing the "Active Person" addon filter. |
| − | You can set up a [[Example_filters|multi-stage of filter]] that shows only Places for Ancestors & [[Gramps_{{ | + | You can set up a [[Example_filters|multi-stage of filter]] that shows only Places for Ancestors & [[Gramps_{{man version}}_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: | For this multi-stage custom filter, create the following Cascade of custom filters: | ||
# Create a Person custom Filter "ActivePerson" using the "Active Person" addon Person General rule. | # Create a Person custom Filter "ActivePerson" using the "Active Person" addon Person General rule. | ||
| − | # Person custom Filter "ActiveAncestors" using [[Gramps_{{ | + | # Person custom Filter "ActiveAncestors" using [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Ancestral_filters|Ancestral filter]] "Ancestors of <filter> match"; filter=ActivePerson <br>''You might add a 2nd rule to include the Active Person and then select the "[[Gramps_{{man version}}_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'' |
| − | # Events custom Filter "ActiveAncestorEvents" using [[Gramps_{{ | + | # Events custom Filter "ActiveAncestorEvents" using [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Events_Category_2|Events General filter]] "Events of persons matching the <person filter>"; person filter=ActiveAncestors |
| − | # Places custom Filter "ActiveAncestorEventPlaces" using [[Gramps_{{ | + | # Places custom Filter "ActiveAncestorEventPlaces" using [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Places_Category_2|Places General filter]] "Places of events matching the <event filter>"; event filter=ActiveAncestorEvents |
| − | {{man tip| 1=Making Filters that are more reusable|2=You could | + | {{man tip| 1=Making Filters that are more reusable|2=You could build this using a Person custom filter set to the builtin Default Person (a.k.a. [[Gramps_Glossary#home_person|Home Person]]) General rule. That would more directly correspond to this addon Geography view mode.<br><br>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.<br><br>'' 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 == | == Credits == | ||
| − | Shared by Serge Noiraud on GitHub [https://github.com/gramps-project/addons-source/tree/maintenance/ | + | Shared by Serge Noiraud on GitHub [https://github.com/gramps-project/addons-source/tree/maintenance/gramps60/GeoAncestor GeoAncestor] addon |
| − | == | + | == Issues == |
| − | |||
* {{Bug|0011681}}: [Ancestors Map] view mode re-initializing incorrectly (1.0.3 Addon version) | * {{Bug|0011681}}: [Ancestors Map] view mode re-initializing incorrectly (1.0.3 Addon version) | ||
* {{Bug|0013241}}: [Geography view] Pin size difference between places with different number of events too large when there is only 1-2 events. | * {{Bug|0013241}}: [Geography view] Pin size difference between places with different number of events too large when there is only 1-2 events. | ||
* [https://gramps-project.org/bugs/view.php?id=12497#c63377 Map Pin upgrades] in {{Bug|0012497}}: Development of a distinctive Gramps icon theme stencil | * [https://gramps-project.org/bugs/view.php?id=12497#c63377 Map Pin upgrades] in {{Bug|0012497}}: Development of a distinctive Gramps icon theme stencil | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
[[Category:Addons]] | [[Category:Addons]] | ||
[[Category:Plugins]] | [[Category:Plugins]] | ||
[[Category:Tools]] | [[Category:Tools]] | ||
Latest revision as of 06:17, 1 November 2025
|
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. |
|
View does not display places without coordinates Note that, like all |
Ancestors Map (GeoAncestor) is an interactive 
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 Geography Category view to map the Event Places associated with a different Person's Ancestors.
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 
Zoom-in Magnifying glass Places with Birth Events 
Zoom-out Magnifying glass Places with Death Events 
Magnifying glass pins with an X Places with Marriage Events 
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. Which is 4 stages of filtering and installing the "Active Person" addon filter.
You can set up a multi-stage of filter that shows only Places for Ancestors & 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:
- Create a Person custom Filter "ActivePerson" using the "Active Person" addon Person General rule.
- Person custom Filter "ActiveAncestors" using Ancestral filter "Ancestors of <filter> match"; filter=ActivePerson
You might add a 2nd rule to include the Active Person and then select the "At least one rule must apply" option. Otherwise, the Events & Places of the Active Person might be omitted - Events custom Filter "ActiveAncestorEvents" using Events General filter "Events of persons matching the <person filter>"; person filter=ActiveAncestors
- Places custom Filter "ActiveAncestorEventPlaces" using Places General filter "Places of events matching the <event filter>"; event filter=ActiveAncestorEvents
|
Making Filters that are more reusable You could build this using a Person custom filter set to the builtin Default Person (a.k.a. Home Person) General rule. That would more directly correspond to this addon Geography view mode. |
Credits
Shared by Serge Noiraud on GitHub GeoAncestor addon
Issues
- 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
