Difference between revisions of "Addon:AncestorsMap"

From Gramps
Jump to: navigation, search
m (Errata)
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Languages|AncestorsMap}}
 
{{Languages|AncestorsMap}}
This [[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Geography_Category|Geography Category]] add-on view mode plots tagged pins on a Map at the Places associated with Ancestors of the [[Gramps_Glossary#home_person|Home Person]]. 
 
 
{{Third-party plugin}}
 
{{Third-party plugin}}
{{man warn|View omits Places without coordinates|Note that, as all [[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Geography_Category|Geography View]] modes, ONLY the Places with a defined [[Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Longitude & Latitude]] will be plotted.}}
+
{{man warn|View does not display places without coordinates|Note that, like all {{icon|geog}}[[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Geography_Category|Geography View]] modes, ONLY the Places with a defined [[Gramps_{{Version manual}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Longitude & Latitude]] will be plotted.}}
 
[[File:GeographyViewAncestorsMap-51.png|thumb|right|450px|Ancestors Map Geography view]]
 
[[File:GeographyViewAncestorsMap-51.png|thumb|right|450px|Ancestors Map Geography view]]
 +
This {{icon|geog}}[[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Geography_Category|Geography Category]] addon view mode plots tagged pins on a Map at the Places associated with Ancestors of the [[Gramps_Glossary#home_person|Home Person]]. 
 +
 
'''Ancestors Map''' is an interactive {{icon|ance}} {{man label|Geography}} category view addon that overlays pins for certain known Places on downloaded Map tiles.  
 
'''Ancestors Map''' is an interactive {{icon|ance}} {{man label|Geography}} category view addon that overlays pins for certain known Places on downloaded Map tiles.  
  
 
== Usage ==
 
== Usage ==
Change the designated [[Gramps_Glossary#home_person|Home Person]] before changing to the [[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Geography_Category|Geography]] Category view to map the Event Places associated with a different Person's Ancestors.
+
Navigate the [[Gramps_Glossary#active_person|Active Person]] selection before changing to the [[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#Geography_Category|Geography]] Category view to map the Event Places associated with a different Person's Ancestors.
 +
 
 +
An interaction in the 1.0.3 version of the Add-on 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.
  
 
There are 4 pin types:<br>
 
There are 4 pin types:<br>
<small>''Still looking for correct pins. The maps us 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>
  
 
::{|class="wikitable"
 
::{|class="wikitable"
Line 35: Line 38:
  
 
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.
 +
 +
==&#x2699; Configuration Options==
 +
[[File:ConfigureGeography-the-map-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Geography - "The map" tab]]The Ancestors Map has 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]].
 +
{{-}}
  
 
== Troubleshooting ==  
 
== Troubleshooting ==  
  
You can set up a multi-stage of filter that show only Places for Ancestors & configure the Places view to show the Longitude & Latitude. This will tell you how many of Ancestor related Places will be omitted from being map plotted.
+
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.
 +
 
 +
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.
 +
 
 +
You can set up a [[Example_filters|multi-stage of filter]] that shows only Places for Ancestors & [[Gramps_{{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:
 
For this multi-stage custom filter, create the following Cascade of custom filters:
  
# Person custom Filter "ActivePerson" using the "Active Person" add-on rule. (New incredibly useful add-on Rule. It makes Filters MUCH more dynamic. Thanks Paul!)
+
# Create a Person custom Filter "ActivePerson" using the "Active Person" add-on 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 where "At least one rule must apply". Otherwise, the Events & Places of the Active Person might be omitted}
+
# Person custom Filter "ActiveAncestors" using [[Gramps_{{Version manual}}_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_{{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''
# Places custom Filter "ActiveAncestorEvents" using General filter "Events of persons matching the <person filter>"; person filter=ActiveAncestors
+
# Events custom Filter "ActiveAncestorEvents" using [[Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Events_Category_2|Events General filter]] "Events of persons matching the <person filter>"; person filter=ActiveAncestors
# Places custom Filter "ActiveAncestorEventPlaces" using General filter "Places of events matching the <event filter>"; event filter=ActiveAncestorEvents
+
# Places custom Filter "ActiveAncestorEventPlaces" using [[Gramps_{{Version manual}}_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 built this using a Person custom filter set to the built-in Default Person (a.k.a. [[Gramps_Glossary#home_person|Home Person]]) General rule. That would more directly correspond to this add-on Geography view mode.<br><br>But a custom Filter using the "Active Person" add-on Person General rule is much more flexible. It stays synchronized to the Person being edited instead of continually resetting the Home Person designation or editting a rule that had been preset to a specific PersonID.<br><br>'' Download and use the incredibly useful add-on 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   
 
Shared by Serge Noiraud   
 +
== Errata ==
 +
Bug Report {{Bug|0011681}}: [Ancestors Map] view mode re-initializing
 +
incorrectly (1.0.3 Add-on version)
 
<!--
 
<!--
From the {{icon|ance}} {{man label|Charts}} category view select the '''Quilt Chart''' icon or select {{man menu|View > Quilt Chart}} from the menu.
 
== See also ==
 
*Feature documentation:[[Start_with_Genealogy|Start with Genealogy]]
 
 
*[[Gramps_Glossary#active_person|Active Person]] Gramps Glossary definition
 
 
*based on the [https://sourceforge.net/p/gramps/mailman/gramps-users/ Gramps-users] archived threads:
 
:[https://sourceforge.net/p/gramps/mailman/message/36617953/ The Group As name override]
 
:[https://sourceforge.net/p/gramps/mailman/search/?q=%22unify+similar+surmanes+%3F%3F%22&mail_list=all unify similar surmanes [sic] thread]
 
:[https://sourceforge.net/p/gramps/mailman/search/?q=%22Group+As+name%22 threads with "Group As name"]
 
 
 
{{DEFAULTSORT:How do I...new category location|noreplace}}
 
[[Category:Tutorial]]
 
[[Category:WikiContributors]]
 
[[Category:How do I...]]
 
 
 
<div style="background:lightcyan">
 
 
 
Paste the raw '''[[:Category:Tutorials|Tutorials]]''' outline for the '''[[:Category:How_do_I...|How Do I...]]''' article above the '''See also''' section. This might start with pasting in a copy of a useful thread from one of the Gramps maillists.
 
 
 
Saving this file as a 'work in progress' will insert the code behind this reference template. (Preview only show the results, not the markup formatting control.) You can use the appended special formatting example template to pre-populate a virtual Copy&amp;Paste clipboard.  Snip pieces to paste special formatting to enhance the outline.
 
 
----
 
 
Adding a ''feature documentation'' link pointing to the introduction of the interface element in the wiki will relieve you of the burden explaining how to find the feature.
 
 
Finding a ''[[Gramps_Glossary|Gramps Glossary]] term'' to link may be easier than choosing the best introductory section in the wiki. Glossary entries have a brief description and may already have the introductory text and practical tutorial linked.
 
 
Since most of these ''How do I...'' tutorials are likely to have been prompted by a MailList discussion, a set of example 'See also' link are included for reference.
 
 
Pointing the ''maillist archived thread'' link to the original message that inspired the tutorial give proper credit for the idea &amp; reveals the background discussion.
 
 
Pointing another link to a good search phrase for the archive allows similar discussions to be explored.
 
 
----
 
 
Once the tutorial Preview is satisfactory, save a revision of the document. Then clean out the virtual Copy&amp;Paste clipboard cluttering up your tutorial and save a final revision.
 
 
 
To remove the virtual Copy&amp;Paste clipboard, simply delete everything from the beginning of this section to the bottom of the document. It is all disposable.
 
 
If the Copy&amp;Paste clipboard is needed again, simply paste the following line at the end of the Edit box, Save a revision, &amp; edit again.(Previewing isn't enough... a revision must be saved.)
 
<pre>  {{subst:Template:How_do_I}}</pre>
 
Other wiki [[:Category:Templates|Templates]] can be used as virtual Copy&amp;Paste clipboards in the same way.
 
 
 
</div>
 
[[Write_a_%22How_Do_I...%22_Article|Writing a 'How do I...' article.]]
 
<pre>
 
{{subst:Gramps_{{Version manual}}_Wiki_Manual_-_Preface}}
 
{{subst:WikiContributorRecruiting}
 
</pre>
 
----
 
 
== (Section) ==
 
Stub, english (''default'')
 
{{Stub}}
 
 
{{Stub|fr}}
 
Stub, french
 
 
=== Embeddable Snippets (Subsection) ===
 
Icons
 
:Dashboard: {{icon|gram}}
 
:People People: {{icon|peop}}
 
:Relationships: {{icon|rela}}
 
:Family Families: {{icon|fami}}
 
:Ancestry Charts: {{icon|ance}}
 
:Events Events: {{icon|even}}
 
:Places Places: {{icon|plac}}
 
:Geography Geography: {{icon|geog}}
 
:Sources (v3.4.x) Sources: {{icon|sour34}}
 
:Citations Citations: {{icon|cite}}
 
:Repositories Repositories: {{icon|repo}}
 
:Media Media: {{icon|medi}}
 
:Notes Notes: {{icon|note}}
 
:[[Template:Icon/doc|more of the standard icons]]
 
==== [[Help:Formatting|Text formatting]] (Level 2 Subsection) ====
 
''italic'', '''bold''', '''''bold & italic'''''
 
===== [[Help:Images|Images]] (Level 3 Subsection) =====
 
[[File:ChartsCategory-desendantfan-fullcircle-9gen-default-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} A screenshot caption]]
 
[[Image:Gramps-logo.png|Logo]]
 
 
*[[Screenshots|Screenshots]]
 
*[[Special:PrefixIndex|Templates]]
 
====== Annotations of User Activities  (Level 4 Subsection) ======
 
  
 
*<pre>Commands you type at the command line</pre>
 
*<pre>Commands you type at the command line</pre>
Line 159: Line 87:
 
*{{checkbox|1|Checked}} - [[Template:Checkbox|Selected Checkbox]] &#x2611; template
 
*{{checkbox|1|Checked}} - [[Template:Checkbox|Selected Checkbox]] &#x2611; template
 
*{{checkbox|0|Unchecked}} - Checkbox that is &#x274f; unselected
 
*{{checkbox|0|Unchecked}} - Checkbox that is &#x274f; unselected
 
== Boxed annotations ==
 
{{man tip| 1=Title of Tip |2=Tips text.}}
 
{{man note|Example Note |Notes text.}}
 
{{man warn|1=WarningTitle/Heading |2=warning text }}</onlyinclude>
 
 
-->
 
-->
  
 
+
[[Category:Addons]]
[[Category:Developers/General]]
 
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Tools]]
 
[[Category:Tools]]

Revision as of 15:59, 28 April 2020

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.

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

Note that, like all GeographyGeography View modes, ONLY the Places with a defined Longitude & Latitude will be plotted.

Ancestors Map Geography view

This GeographyGeography Category addon view mode plots tagged pins on a Map at the Places associated with Ancestors of the Home Person.

Ancestors Map is an interactive Charts Geography category view addon that overlays pins for certain known Places on downloaded Map tiles.

Usage

Navigate the Active Person selection before changing to the Geography Category view to map the Event Places associated with a different Person's Ancestors.

An interaction in the 1.0.3 version of the Add-on 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.

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 Options

Fig. .1 Configure Geography - "The map" tab

The Ancestors Map has 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 finicky work. This is most easily done 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 & 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" add-on Person General rule.
  2. 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
  3. Events custom Filter "ActiveAncestorEvents" using Events General filter "Events of persons matching the <person filter>"; person filter=ActiveAncestors
  4. Places custom Filter "ActiveAncestorEventPlaces" using 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 add-on Geography view mode.

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

Download and use the incredibly useful add-on 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

Errata

Bug Report 0011681: [Ancestors Map] view mode re-initializing incorrectly (1.0.3 Add-on version)