Difference between revisions of "Gramps 5.0 Wiki Manual - Categories"

From Gramps
Jump to: navigation, search
(Can we change the marker's color ?)
m (Clear stub template from locked old user manual page in support of https://gramps.discourse.group/t/gramps-5-1-wiki-manual-stub-eradication/2938)
 
(163 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{man index|Gramps 5.0 Wiki Manual - Main Window|Gramps 5.0 Wiki Manual - Manage Family Trees|5.0}}
 
{{man index|Gramps 5.0 Wiki Manual - Main Window|Gramps 5.0 Wiki Manual - Manage Family Trees|5.0}}
 
{{languages|Gramps 5.0 Wiki Manual - Categories}}
 
{{languages|Gramps 5.0 Wiki Manual - Categories}}
 
 
{{#vardefine:chapter|4}}
 
{{#vardefine:chapter|4}}
 
{{#vardefine:figure|0}}
 
{{#vardefine:figure|0}}
 
+
[https://en.wikipedia.org/wiki/Genealogy#Types_of_information Genealogical information] is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.
Genealogical information is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.
 
  
 
== Categories of the Navigator ==
 
== Categories of the Navigator ==
Line 51: Line 49:
 
== Dashboard Category ==
 
== Dashboard Category ==
  
[[File:DashboardCategoryView-example-42.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category view]]
+
[[File:DashboardCategoryView-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category view]]
  
This contains the {{icon|gram}} '''Dashboard''', which shows a number of widgets, called Gramplets, that can help you in your research. Two Gramplets are shown by default on start-up (the Welcome and Top Surname Gramplets). By right-clicking on the Gramplet View, a popup menu is shown that list the possible Gramplets you may add and use.  
+
This contains the {{icon|gram}} '''Dashboard''', which shows a number of widgets, called [[Gramps_5.0_Wiki_Manual_-_Gramplets#What_is_a_Gramplet|Gramplets]], that can help you in your research. Two Gramplets are shown by default on start-up (the [[Gramps_5.0_Wiki_Manual_-_Gramplets#Welcome|Welcome]] and [[Gramps_5.0_Wiki_Manual_-_Gramplets#Top_Surnames|Top Surname]] Gramplets). When you have an open Family Tree you can by using the context menu (right-clicking) on an empty area of the Dashboard View, to see a popup menu to "{{man menu|Add a gramplet}}" that shows a list of the possible Gramplets you may add and use.
  
 
*{{man label|Age Stats}} Gramplet - list age span statistics in a number of graphs
 
*{{man label|Age Stats}} Gramplet - list age span statistics in a number of graphs
Line 95: Line 93:
 
===Tree View - Grouped People===
 
===Tree View - Grouped People===
  
[[File:People-tree-view-grouped-people-42.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - Tree View - Grouped People]]
+
[[File:People-tree-view-grouped-people-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - Tree View - Grouped People]]
  
 
People are grouped according to their family names. To the left of each family name is typically either an arrow or some other type of indicator (eg: ''+''). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.
 
People are grouped according to their family names. To the left of each family name is typically either an arrow or some other type of indicator (eg: ''+''). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.
Line 102: Line 100:
  
 
{{-}}
 
{{-}}
 +
 
===Tree View - People List View===
 
===Tree View - People List View===
  
[[File:People-tree-view-people-list-view-42.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - Tree View - People List View]]
+
[[File:People-tree-view-people-list-view-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - Tree View - People List View]]
  
 
List of all the people in the database, sorted by first column which by default is the <code>Name</code> column.
 
List of all the people in the database, sorted by first column which by default is the <code>Name</code> column.
Line 147: Line 146:
 
== Relationships Category ==
 
== Relationships Category ==
  
[[File:Relationships-category-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view]]
+
[[File:Relationships-category-view-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view]]
  
 
The Relationships Category shows the default {{man label|Relationships Category view}} which displays all the relationships of the Active Person (the selected person). Specifically, it shows the parents, siblings, spouses, and children of that person.
 
The Relationships Category shows the default {{man label|Relationships Category view}} which displays all the relationships of the Active Person (the selected person). Specifically, it shows the parents, siblings, spouses, and children of that person.
Line 170: Line 169:
 
====Active Person====
 
====Active Person====
  
* At the top of the screen, name, ID, birth, and death information, as well as the calculated age of the Active Person is displayed.  
+
* At the top of the screen, name, {{man label|ID}}, {{man label|Birth}}, and {{man label|Death}} information, as well as the calculated age of the Active Person is displayed.  You may highlight and copy the {{man label|Birth}} and {{man label|Death}} text fields.
  
 
* On the right hand side a photo of the person if available, will be shown. This photo shows the first image available in the {{man label|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]]}} tab of this person (if any exist). You can click on the photo to open it in the default picture viewer.
 
* On the right hand side a photo of the person if available, will be shown. This photo shows the first image available in the {{man label|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]]}} tab of this person (if any exist). You can click on the photo to open it in the default picture viewer.
  
 
* Next to the person's name is a symbol indicating gender, and an {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button. Clicking the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button will allow you to edit all of the person's individual information in the {{man label|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog.
 
* Next to the person's name is a symbol indicating gender, and an {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button. Clicking the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button will allow you to edit all of the person's individual information in the {{man label|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog.
 +
 +
* See also: [[Gramps_5.0_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Setting the Active Person]]
  
 
====Parents====
 
====Parents====
Line 186: Line 187:
 
{{man warn|Warning|If you are not careful, it is possible to create multiple families with the same parents. This is rarely what the user wants to do. If you attempt to add a new family that has the same parents as an existing family, Gramps will issue a warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the {{man button|Select}} button to select the existing family.}}
 
{{man warn|Warning|If you are not careful, it is possible to create multiple families with the same parents. This is rarely what the user wants to do. If you attempt to add a new family that has the same parents as an existing family, Gramps will issue a warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the {{man button|Select}} button to select the existing family.}}
 
=====Select Family selector=====
 
=====Select Family selector=====
[[File:Select-family_42.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Family - selector]]
+
[[File:SelectFamily-SelectorDialog-example-50.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Family - selector dialog example]]
  
 
The {{man label|Select Family}} selector dialog allows you to link to an already existing Family.
 
The {{man label|Select Family}} selector dialog allows you to link to an already existing Family.
 +
 +
The following columns are shown: ID(default sort for list), Father, Mother, Last Change.
  
 
You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
 
You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
 
* '''ID contains''' (default)
 
* '''ID contains''' (default)
{{stub}}
+
* ''ID does not contain''
 +
* ''Father contains''
 +
* ''Father does not contain''
 +
* ''Mother contains''
 +
* ''Mother does not contain''
 +
* ''Last Change contains''
 +
* ''Last Change does not contain''
 +
 
 +
 
 
{{-}}
 
{{-}}
 +
 
=====Siblings=====
 
=====Siblings=====
  
Line 221: Line 233:
  
 
======Reorder Relationships dialog======  
 
======Reorder Relationships dialog======  
Select either the menu {{man menu|Edit > Reorder}} or the {{man button|Change order of parents families}} icon button to display the {{man label|Reorder Relationships}} dialog that will allow you to reorder the families. This option will only be enabled if more than one set of parents or more than one set of spouses exists for the Active Person.
+
{{man note|This option will only be enabled|if more than one set of parents or more than one set of spouses exists for the Active Person.}}
 +
 
 +
[[File:ReorderRelationships-dialog-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Reorder Relationships - dialog - example]]
 +
 
 +
When more than one set of parents or more than one set of spouses exists for the Active Person.
  
[[File:Reorder-relationships-dialog-42.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Reorder Relationships]]
+
Select one of the following:
 +
* the menu {{man menu|Edit > Reorder}}
 +
* or the {{man button|Change order of parents and families}} toolbar icon button
 +
* or the {{man button|Reorder Parents}} icon near the {{man label|Parents:}} label
 +
* or the {{man button|Reorder Families}} icon near the {{man label|Family:}} label
 +
to display the {{man label|Reorder Relationships}} dialog that will allow you to reorder:
 +
* the parents order in the top section {{man label|Parent relationships}} using the up/down arrow buttons.
 +
* or families order in the bottom section {{man label|Family relationships}} using the up/down arrow buttons.
 
{{-}}
 
{{-}}
  
Line 233: Line 256:
 
====Configuration====
 
====Configuration====
  
[[Image:ConfigureRelationshipsView-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Content (tab)]]
+
[[File:ConfigureRelationshipsView-content-tab-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Content (tab)]]
  
 
You can control how much information is displayed by using the {{man menu|View -> Configure...}} menu or click on the toolbar {{man button|Configure the active view...}} button.
 
You can control how much information is displayed by using the {{man menu|View -> Configure...}} menu or click on the toolbar {{man button|Configure the active view...}} button.
Line 241: Line 264:
 
** {{checkbox|1}} {{man label|Show Details}} (checkbox checked by default) show or hide the birth and death information (All except the Active person)
 
** {{checkbox|1}} {{man label|Show Details}} (checkbox checked by default) show or hide the birth and death information (All except the Active person)
 
** {{checkbox|1}} {{man label|Show Siblings}} (checkbox checked by default) show or hide siblings.
 
** {{checkbox|1}} {{man label|Show Siblings}} (checkbox checked by default) show or hide siblings.
 +
{{-}}
 +
[[File:ConfigureRelationshipsView-layout-tab-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Layout (tab)]]
 +
 
*On the {{man label|Layout}} tab
 
*On the {{man label|Layout}} tab
 
** {{checkbox|1}} {{man label|Use shading}} (checkbox checked by default)
 
** {{checkbox|1}} {{man label|Use shading}} (checkbox checked by default)
Line 258: Line 284:
 
{{man warn| {{man button|Remove}} button |Unlike the Relationships Category, clicking the {{man button|Remove}} button in this view will remove the family from the database. All people will remain, but all relationships between the people in the family will be removed.}}
 
{{man warn| {{man button|Remove}} button |Unlike the Relationships Category, clicking the {{man button|Remove}} button in this view will remove the family from the database. All people will remain, but all relationships between the people in the family will be removed.}}
  
[[File:Families-category-list-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families Category - (List) View]]
+
[[File:Families-category-list-view-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families Category - (List) View]]
  
 
In the {{man label|Families Category}} the {{man label|Families List view}} displays a list of all families in the database(see Fig. {{#var:chapter}}.{{#var:figure}}). From this view, you may {{man button|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Add a new Family]]}}, {{man button|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Edit the selected family]]}}, {{man button|Delete the selected family}}, {{man button|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Families|Merge the selected (2) families]]}} from the list, or {{man button|Tag the selected rows}}. The default display lists the <code>ID, Father, Mother, Relationship and Marriage Date</code>. If you configure the active view you can, hide existing columns, show additional columns like <code>Private, Tags, Last Changed</code>, or rearrange the column order.  
 
In the {{man label|Families Category}} the {{man label|Families List view}} displays a list of all families in the database(see Fig. {{#var:chapter}}.{{#var:figure}}). From this view, you may {{man button|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Add a new Family]]}}, {{man button|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Edit the selected family]]}}, {{man button|Delete the selected family}}, {{man button|[[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Families|Merge the selected (2) families]]}} from the list, or {{man button|Tag the selected rows}}. The default display lists the <code>ID, Father, Mother, Relationship and Marriage Date</code>. If you configure the active view you can, hide existing columns, show additional columns like <code>Private, Tags, Last Changed</code>, or rearrange the column order.  
Line 304: Line 330:
  
 
== Charts Category ==
 
== Charts Category ==
{{stub}}
+
 
 
{{man tip|Want more Chart Views?|Installation of additional downloadable addons contain extra views. See [[Third-party Addons]]}}
 
{{man tip|Want more Chart Views?|Installation of additional downloadable addons contain extra views. See [[Third-party Addons]]}}
  
 
The Charts Category shows several graphical representations of the ancestry or descendants of the active person.  
 
The Charts Category shows several graphical representations of the ancestry or descendants of the active person.  
  
By default Gramps shows the {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#Pedigree_View|Pedigree]]}} View. With the {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#Fan_Chart_View|Fan Chart]]}} View and {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#Descendant_Fan_View|Descendant Fan]]}} chart View being selectable from the toolbar or menu via {{man menu|View > '''Name of Chart View'''}}
+
By default Gramps shows the {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#Pedigree_View|Pedigree]]}} View. With the {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#Fan_Chart_View|Fan Chart]]}} View and {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#Descendant_Fan_View|Descendant Fan]]}} chart View and {{man button|[[Gramps_5.0_Wiki_Manual_-_Categories#2-Way_Fan_View|2-Way Fan]]}} chart view being selectable from the toolbar or menu via {{man menu|View > '''Name of Chart View'''}}
  
 
=== Pedigree View===
 
=== Pedigree View===
  
[[File:ChartsView-pedigreeview1-horizontal-right-standard-5gen-default-41.png|left|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 1 (Default) horizontal to right]]
+
[[File:ChartsCategory-pedigreeview1-horizontal-right-standard-5gen-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 1 (Default) Tree direction:horizontal to right]]
[[File:ChartsView-pedigreeview2-horizontal-left-standard-5gen-41.png|left|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 2 - horizontal to left]]
 
[[File:ChartsView-pedigreeview3-vertical-up-standard-3gen-41.png|left|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 3 - vertical and up]]
 
[[File:ChartsView-pedigreeview4-vertical-down-standard-3gen-41.png|left|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 4 - vertical and down]]
 
  
[[File:ChartsView-pedigreeview1-configure-dialog-default-41.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Pedigree view layout]]
+
The {{man label|Pedigree}} View shows up to nine generations in the form of a chart, depending on the size of the window you may need to use the scroll bars to see parts of the chart.
  
[[Image:ChartsViewPedigreeViewChildrenMenu-40.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Children menu]]
+
Each person is indicated by a box labeled with his or her name, birth information (indicated by an asterisk * sign), death information (indicated by a plus + sign), a black stripe across the top left corner of the box is shown if the person is deceased (or determined by Gramps to be no longer alive) and optionally the primary image will be displayed if available.
  
The Pedigree View shows up to five generations, depending on the size of the window. Each person is indicated by a box labeled with his or her name, birth information (indicated by an asterisk * sign), death information (indicated by a plus + sign), a black stripe across the top left corner of the box if the person is deceased (or determined by Gramps to be no longer alive) and optionally an image if available. Two lines branch from each box. The top one shows the person's father and the bottom one the mother. Solid lines represent birth relations, while dashed lines represent non-birth relations such as adoption, step-parenthood, guardianship, etc.
+
Two lines branch from each person box. The top line leads to the person's father and the bottom line leads to the mother. Solid lines represent the biological birth type relationship, while dashed lines represent non-birth relationships such as adoption, step-parenthood, guardianship, etc.
  
To the left of the Active Person is a left arrow button. If the Active Person has children, clicking this button expands a list of the Active Person's children. Selecting one of the children makes that child the Active Person.
+
The left arrow {{man button|Jump to child...}} button beside the Active Person is a only selectable if the Active Person has children, clicking this button expands to show a list of the Active Person's children. Selecting one of the children makes that child the Active Person for the chart.
  
The appearance of the children's names in the menu differentiates the dead ends of the tree from the continuing branches.
+
<!--??-->The appearance of the children's names in the menu differentiates the dead ends of the tree from the continuing branches.
  
 
Children who have children themselves appear in the menu in the boldface and italic type, while children without children (dead ends) appear in a regular font. If the Active Person has only one child, no menu will be displayed (since there is only one choice) and the child will become the Active Person when the arrow button is clicked.
 
Children who have children themselves appear in the menu in the boldface and italic type, while children without children (dead ends) appear in a regular font. If the Active Person has only one child, no menu will be displayed (since there is only one choice) and the child will become the Active Person when the arrow button is clicked.
  
The right-hand side of the window shows two right arrow buttons. When the top button is clicked, the Father of the Active Person becomes the Active Person. When the bottom button is clicked, the Mother of the Active Person becomes the Active Person.
+
The right-hand side of the window shows two right arrow buttons. When the top button {{man button|Jump to father}} is clicked, the Father of the Active Person becomes the Active Person. When the bottom button {{man button|Jump to mother}} is clicked, the Mother of the Active Person becomes the Active Person.
  
[[Image:ChartsViewPedigreeViewPersonContextMenu-40.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Personal context menu]]
+
{{-}}
 +
[[File:ChartsCategory-PedigreeView-PersonContextMenu-showing-Children-example-50.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Person context menu showing Children]]
  
Right-clicking on any person's box in the Pedigree View will bring up the "context menu".
+
Right-clicking on any person's box in the Pedigree View will bring up the Person "context menu".
  
Among other useful items, the context menu has sub-menus listing {{man label|Spouses}} , {{man label|Siblings}} , {{man label|Children}} , and {{man label|Parents}} of that person.
+
Among other useful items, the context menu has sub-menus listing {{man label|Spouses}} , {{man label|Siblings}} , {{man label|Children}} , {{man label|Parents}} and {{man label|Related}} of that person.
  
 
"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.
 
"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.
  
{{man tip|Screencasts|You can see videos for [[Media:Add_family_from_pedigree_view_Gramps_3.2.5.ogg|adding]] or [[Media:Edit family from pedigree view Gramps 3.2.5.ogg|editing]] a family (parents, children, siblings) from Pedigree View. Both videos show Gramps 3.2.5 so the current version of Gramps may be slightly different.}}
+
{{-}}
 +
 
 +
==== Configure the active view ====
 +
 
 +
[[File:ChartsCategory-PedigreeView-ConfigureCharts-dialog-default-50.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Pedigree View - Configure the active view - dialog - showing Defaults on Layout tab]]
 +
 
 +
The {{man label|Layout}} tab has the following option available:
 +
* {{checkbox|1}} {{man label|Show images}} (checked by default)
 +
* {{checkbox|1}} {{man label|Show marriage data}} (checked by default)
 +
* {{checkbox|1}} {{man label|Show unknown people}} (checked by default)
 +
* {{checkbox|0}} {{man label|Show tags}} (unchecked by default)
 +
* {{man label|Tree style:}}
 +
** '''Standard'''(default)
 +
** Compact
 +
** Expanded
 +
* {{man label|Tree direction:}}
 +
** Vertical (↑)
 +
** Vertical (↓)
 +
** '''Horizontal (→)'''(default)
 +
** Horizontal (←)
 +
* {{man label|Tree size:}} slider range 2 to 9. Set to <code>5</code>(by default)
 +
 
 +
[[File:ChartsCategory-pedigreeview2-horizontal-left-standard-5gen-50.png|left|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 2 - Tree direction:horizontal to left]]
 +
[[File:ChartsCategory-pedigreeview2-vertical-up-standard-5gen-50.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 3 - Tree direction:vertical and up]]
 +
[[File:ChartsCategory-pedigreeview2-vertical-down-standard-5gen-50.png|left|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 4 - Tree direction:vertical and down]]
  
 
{{-}}
 
{{-}}
Line 346: Line 394:
 
=== Fan Chart View ===
 
=== Fan Chart View ===
  
[[File:ChartsView-fanchart-fullcircle-9gen-default-41.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart View - full circle]]
+
[[File:ChartsCategory-fanchartview-fullcircle-9gen-default-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart View - full circle]]
  
This view shows the ancestry but as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person. A second click brings the chart back to the original form. Right click brings up a context menu like in the pedigree view, allowing to navigate to other people.  
+
The {{man label|Fan Chart}} view shows the active persons ancestry as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person. A second click brings the chart back to the original form. Right click brings up a context menu like in the pedigree view, allowing to navigate to other people.  
  
 
This view enables to see large ancestries in a more compact manner, and to see very quickly which parts of an ancestry need further research.  
 
This view enables to see large ancestries in a more compact manner, and to see very quickly which parts of an ancestry need further research.  
Line 354: Line 402:
 
You can rotate the view by click and drag outside the fan chart. You can move the view by click and drag inside the inner (white) region.
 
You can rotate the view by click and drag outside the fan chart. You can move the view by click and drag inside the inner (white) region.
  
#The view can be a circle, a halfcircle or a quadrant of a circle. The last are always attached to the bottom or side of the view
+
#The view can be a circle, a halfcircle or a quadrant of a circle. The latter are always attached to the bottom or side of the view
#Children of the center person are shown with a nice children ring at the center
+
#Children of the center person are shown within the ring at the center
 
#Drag and drop people to the center to change the active person
 
#Drag and drop people to the center to change the active person
 
#Color options
 
#Color options
:# Colors of the boxes based on the age of the people
+
## Colors of the boxes based on the age of the people
:# Colors of the boxes depending on the time period the person lived in
+
## Colors of the boxes depending on the time period the person lived in
:# White, classic, gender based, and user defined colors
+
## White, classic, gender based, and user defined colors
 
# Filtering: use the person filter in the sidebar to quickly obtain insight in the people shown. For example: which people have birth events, who has the attribute ''blue eyes'', ... . Filtered results have bold font, the ones that don’t satisfy the filter are shown transparent
 
# Filtering: use the person filter in the sidebar to quickly obtain insight in the people shown. For example: which people have birth events, who has the attribute ''blue eyes'', ... . Filtered results have bold font, the ones that don’t satisfy the filter are shown transparent
 
#Show up to 11 generations in the view.
 
#Show up to 11 generations in the view.
 
#Print the view from the toolbar. The view as you see it (after rotating, expanding, changing color) can via the print button be printed or saved as svg (to edit further in Inkscape and view in eg Firefox), pdf or ps.
 
#Print the view from the toolbar. The view as you see it (after rotating, expanding, changing color) can via the print button be printed or saved as svg (to edit further in Inkscape and view in eg Firefox), pdf or ps.
#The font used can be selected and becomes automatically smaller to fit the boxes. On a dark color, the font is white, otherwise black
+
#The font used can be selected and automatically adjust to fit within the boxes. On a darker background, the font is white, and vice versa.
  
 
To understand all, [https://plus.google.com/u/0/115195430424417504730/posts/QrXM4z9JxrG watch the screencast]
 
To understand all, [https://plus.google.com/u/0/115195430424417504730/posts/QrXM4z9JxrG watch the screencast]
 +
 +
See also: [[Gramps_5.0_Wiki_Manual_-_Gramplets#Fan_Chart|Fan Chart Gramplet]]
 +
{{-}}
 +
==== Configure the active view ====
 +
 +
[[File:ChartsCategory-FanChartView-ConfigureCharts-dialog-default-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Fan Chart View - Configure the active view - dialog - showing Defaults Defaults on Layout tab]]
  
 
{{-}}
 
{{-}}
Line 372: Line 426:
 
=== Descendant Fan View ===
 
=== Descendant Fan View ===
  
[[File:ChartsView-desendantfan-fullcircle-9gen-default-41.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Fan Chart View - full circle]]
+
[[File:ChartsCategory-desendantfan-fullcircle-9gen-default-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Fan Chart View - full circle]]
{{stub}}
+
 
 +
 
 +
View showing the active person's direct descendants as a fan chart.
 +
 
 
* [https://gramps-project.org/2012/09/descendant-fanchart/ Descendant Fan View]
 
* [https://gramps-project.org/2012/09/descendant-fanchart/ Descendant Fan View]
 +
 +
* See also: [[Gramps_5.0_Wiki_Manual_-_Gramplets#Descendant_Fan_Chart|Descendant Fan Chart Gramplet]]
 +
 +
{{-}}
 +
==== Configure the active view ====
 +
 +
[[File:ChartsCategory-DescendantFanChartView-ConfigureCharts-dialog-default-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Descendant Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab]]
 +
 +
{{-}}
 +
 +
=== 2-Way Fan View ===
 +
 +
[[File:ChartsCategory-2wayfan-fullcircle-ances4gen-descen4gen-default-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 2-Way Fan Chart View - 4 Generations of Ancestors (Top) / 4 Generations of Descendants (bottom)]]
 +
 +
 +
 +
* See also: [[Gramps_5.0_Wiki_Manual_-_Gramplets#2-Way_Fan_Chart|2-Way Fan Chart Gramplet]]
 +
 +
* [https://github.com/gramps-project/gramps/pull/222 Feature: Gep-030 FanChart2Way]
 +
{{-}}
 +
==== Configure the active view ====
 +
 +
[[File:ChartsCategory-2-WayFanChartView-ConfigureCharts-dialog-default-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - 2-Way Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab]]
  
 
{{-}}
 
{{-}}
 +
 
===Charts Category Bottombar tabs===
 
===Charts Category Bottombar tabs===
  
Line 392: Line 473:
  
 
== Events Category ==
 
== Events Category ==
 
+
The {{man label|Events Category}} shows the {{man label|Events View}} that lists the all the events recorded in the Family Tree. Events can be shared between multiple people and multiple families.
[[File:Events-category-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Category View - sidebar and bottombar hidden]]
 
 
 
The {{man label|Events View}} lists the all the events recorded in the database. Events can be shared between multiple people and multiple families.
 
  
 
See also:
 
See also:
Line 401: Line 479:
 
{{-}}
 
{{-}}
 
===Events View===
 
===Events View===
 +
[[File:EventsCategory-EventsListView-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Category - Events (List) View - example]]
  
 
From the {{man label|Events View}} list the following columns are available for display:  {{man label|Description}} , {{man label|ID}} , {{man label|Type}} , {{man label|Main Participants}} , {{man label|Date}} , {{man label|Place}} and {{man label|Last Changed}}.
 
From the {{man label|Events View}} list the following columns are available for display:  {{man label|Description}} , {{man label|ID}} , {{man label|Type}} , {{man label|Main Participants}} , {{man label|Date}} , {{man label|Place}} and {{man label|Last Changed}}.
Line 444: Line 523:
 
{{-}}
 
{{-}}
 
===Places List View===
 
===Places List View===
{{stub}}
+
[[File:PlacesCategory-PlaceListView-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - Place (List) View - example]]
[[File:Places-category-place-list-view-42.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - Place (List) View - sidebar and bottombar hidden]]
 
  
The Place List View on the other hand just shows all the places in one long list.
+
The Place List View shows all the places in one long list.
 
{{-}}
 
{{-}}
 +
 
===Places Tree View===
 
===Places Tree View===
{{stub}}
+
[[File:PlacesCategory-PlaceTreeView-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Tree View - example]]
[[Image:PlacesCategory-PlaceTreeView-41.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Tree View]]
 
  
The Place Tree View groups the places in a hierarchy: country, county, ... .
+
The Place Tree View groups the places in a hierarchy: country, county, ... etc
  
 
{{-}}
 
{{-}}
 +
 
===Map Service===
 
===Map Service===
If a place has been highlighted, you may select the {{man button|Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ...}} button to attempt to display the place in a web browser.
+
{{man note|This feature is limited|And may not always produce the results you desire.}}
  
Your default web browser should open, attempting to use either the longitude and latitude coordinates or the place name to display the location using the Maps provider web site. Different map services might have different requirements for the location description.
+
[[File:PlacesCategory-AttemptToSeeSelectedLocation-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - "Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ..." button - example]]
 +
 
 +
If a place has been highlighted, you may display the place in a web browser by selecting the {{man button|Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ...}}  button.
 +
 
 +
Your default web browser should open, attempting to use either the recorded coordinates (longitude and latitude) or the place name to display the location using the Maps provider web site. Different map services might have different requirements for the location description.
 +
 
 +
{{-}}
 +
[[File:PlacesCategory-MapServices-list-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - "Select a Map Service" button - showing list of options]]
  
 
From the {{man button|Select a Map Service}} drop down list you can choose the map service you want to use from the following three options:
 
From the {{man button|Select a Map Service}} drop down list you can choose the map service you want to use from the following three options:
* EniroMaps - Valid for places within Sweden and Denmark, only if longitude and latitude are available, otherwise uses city and country, or uses description of the place.
 
* GoogleMaps - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
 
 
* '''OpenStreetMap'''(default) - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
 
* '''OpenStreetMap'''(default) - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
 +
* ''EniroMaps'' - Valid for places within Sweden and Denmark, only if longitude and latitude are available, otherwise uses city and country, or uses description of the place.
 +
* ''GoogleMaps'' - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
  
{{man note|This feature is limited|And may not always produce the results you desire.}}
 
 
{{-}}
 
{{-}}
 +
See also:
 +
* [[Map_Services|Map Services - Google Earth]] - addon allows you to use Google Earth.
  
 
===Places Category Bottombar tabs===
 
===Places Category Bottombar tabs===
Line 507: Line 594:
 
{{man tip|Note|The Geography category is only present if the prerequisite program <code>[[Gramps_5.0_Wiki_Manual_-_Categories#Prerequisites_to_see_the_geography_view|OsmGpsMap]]</code> is present that Gramps can use.}}
 
{{man tip|Note|The Geography category is only present if the prerequisite program <code>[[Gramps_5.0_Wiki_Manual_-_Categories#Prerequisites_to_see_the_geography_view|OsmGpsMap]]</code> is present that Gramps can use.}}
  
[[File:Geography-category-all-known-places-view-42.png|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geography Category - "All known Places" View - sidebar and bottombar hidden]]
+
[[File:GeographyCategory-GeoPlacesView-AllKnownPlaces-openstreemap-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
  
 
The {{man label|Geography Category}} shows place event data visually on a map. It contains many Geographic Views, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap, Google maps ...).
 
The {{man label|Geography Category}} shows place event data visually on a map. It contains many Geographic Views, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap, Google maps ...).
Line 532: Line 619:
 
** The only thing to do is for each place or area you want to use without an internet connection is to select them, zoom into these places. You'll be able to use them again without connection.
 
** The only thing to do is for each place or area you want to use without an internet connection is to select them, zoom into these places. You'll be able to use them again without connection.
  
{{man warn|BE CAREFUL|it can takes gigabytes. If you use several maps, you need to have this same gigabytes size multiply by the number of map used.}}
+
{{man warn|BE CAREFUL|The {{man label|Geography Category}} views may use many [https://en.wikipedia.org/wiki/Gigabyte Gigabytes] of storage space on your computer. If you use several maps, you need to have this same gigabytes size multiply by the number of map used.}}
  
 
==== The different views ====
 
==== The different views ====
===== All known places for one person =====
+
===== All known places =====
[[File:gramps-person-11.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The person]]
 
  
This view show all places visited by one person during that persons life.
+
[[File:GeographyCategory-GeoPlacesView-AllKnownPlaces-openstreemap-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
 +
 
 +
This view show all places with coordinates in the database.
  
This view is not connected to filters. It only depend on the active person and the history.
+
from Gramps 4.2.2, for performances reason, by default, the view show only the place related to the places history or the filtered places.
 +
If you really want to see all places, you need to select the popup menu from the context menu [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] and select "show all places".
 +
{{-}}
 +
[[File:GeographyCategory-AllKnownPlaces-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man label|The places marker color}} tab for the "All known Places" GeoPlaces View - Configure the active view]]
  
If you want to use the animate functionality, click on the right button of the mouse. You'll get a popup menu.
+
;Configure the active view: {{man label|The places marker color}} tab
From the menu popup, you can select 'animate' to see the life way of the current person:
+
The configuration menu tab for has the following options:
  
If the active person has several related events, you can see a virtual move between those markers. The move is related to years or distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year.
+
The {{man label|All known Places}} view is the only Geography view that allows you to change the color used for the place type markers.
{{-}}
 
[[File:gramps-configuration-2.png|right|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The animation]]
 
  
In the configuration menu {{man label|The animation parameters}} tab, you can change the following:
+
The colors are green for the following map renders:
#A slider to set the {{man label|Animation speed in milliseconds(big value means slower:)}} (default: ''100'')
+
* Openstreetmap
#A slider to set the {{man label|How many steps between two markers when we are on large move?:}} (default: ''20'')
+
* Maps for free
#A slider to set the {{man label|The minimum latitude/longitude to select large move. The value is in tenth of degree.}} (default: ''5'')
+
* Opencyclemap and Public transport.
  
{{-}}
+
All other marker renders are red.
====== All known places for one person with graphical information (KML files) ======
 
  
[[File:gramps-person-kml.png|left|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} One person with 3 KML files]]
+
Click on the {{man button|Configure the active view}} button on the toolbar.
  
If you added KML files in the media tab for one event, this view will show one path or one surface for each KML file.
+
Then click on the {{man label|The places marker color}} tab.
  
In the following example, you see 3 KML files :
+
For each type of place, you can select and choose a color. The default color is green "#008b00"
* The farm for the birth of this person.
 
* The path used to go to school (school event).
 
* The limits of the parish or municipality (baptism event).
 
  
{{man tip|What is a KML file ?|[https://en.wikipedia.org/wiki/Keyhole_Markup_Language Keyhole Markup Language]}}
+
See also:
 +
* [[Gramps_5.0_Wiki_Manual_-_Categories#Can_we_change_the_marker.27s_color_.3F|Can we change the marker color?]]
 
{{-}}
 
{{-}}
  
===== All known places for one family =====
+
===== All known places for one Family =====
  
[[File:gramps-family-10.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The family]]
+
[[File:GeographyCategory-AllKnownPlacesForOneFamily-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known places for one Family" GeoFamily View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
  
 
This view show all places visited by all family members during their lives.
 
This view show all places visited by all family members during their lives.
  
 
This view is not connected to filters. It only depend on the active family and the history.
 
This view is not connected to filters. It only depend on the active family and the history.
 +
{{-}}
 +
;Configure the active view: {{man label|Specific parameters}} tab
 +
The configuration menu tab for this view has no additional options.
 +
{{-}}
  
You have no extra option in the configuration menu.
 
{{-}}
 
 
===== Have they been able to meet ? =====
 
===== Have they been able to meet ? =====
  
[[File:gramps-person-meeting-9.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Persons meeting?]]
+
[[File:GeographyCategory-HaveTheyBeenAbleToMeet-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Have they been able to meet ?" GeoClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
  
 
This view is used to show if two persons were able to meet during their life.
 
This view is used to show if two persons were able to meet during their life.
Line 595: Line 683:
 
This value is defined in tenth of degree.
 
This value is defined in tenth of degree.
  
[[File:gramps-configuration-3.png|right|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The selection]]
 
 
{{-}}
 
{{-}}
===== Have these two families been able to meet ? =====
+
[[File:GeographyCategory-HaveTheyBeenAbleToMeet-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The selection parameters" tab for the "Have they been able to meet ?" GeoClose View - Configure the active view]]
 +
 
 +
;Configure the active view: {{man label|The selection parameters}} tab
 +
See the configuration menu tab for additional options.
 +
{{-}}
 +
 
 +
===== All places related to Events =====
 +
 
 +
[[File:GeographyCategory-AllPlacesRelatedToEvents-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All places related to Events" GeoEvents View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
 +
 
 +
This view is used to show all places related to events.
 +
It can take some time to show when we have many events.
  
[[File:gramps-family-meeting-8.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families meeting?]]
+
from Gramps 4.2.2, for performances reason, by default, the view show only the place related to the events history or the filtered events.
 +
If you really want to see all events, you need to select the popup menu from the context menu [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] and select "show all events".
 +
{{-}}
 +
;Configure the active view: {{man label|Specific parameters}} tab
 +
The configuration menu tab for this view has no additional options.
 +
{{-}}
  
This view is used to show if two families were able to meet during their life.
+
===== All known places for one Person =====
 +
[[File:GeographyCategory-AllKnownPlacesForOnePerson-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known places for one Person" GeoPerson View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
  
You must select one reference family :
+
This view show all places visited by one person during that persons life.
#From the menu popup : Choose the reference family
 
#From the toolbar
 
  
When the reference family is active, you'll see all its member's life way.
+
This view is not connected to filters. It only depend on the active person and the history.
For each known place with coordinates, you'll see a circle or an oval depending on the longitude.
 
  
The circle radius can be tuned in the configuration view.
+
If you want to use the animate functionality, click on the [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse. You'll get a popup menu.
This value is defined in tenth of degree.
+
From the menu popup, you can select 'animate' to see the life way of the current person:
  
[[File:gramps-configuration-3.png|right|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The selection]]
+
If the active person has several related events, you can see a virtual move between those markers. The move is related to years or distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year.
 
{{-}}
 
{{-}}
===== All displacements for one person and their descendants =====
+
[[File:GeographyCategory-AllKnownPlacesForOnePerson-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The animation parameters" tab for the "All known places for one Person" GeoPerson View - Configure the active view]]
  
[[File:gramps-geomoves-5.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Moves]]
+
;Configure the active view: {{man label|The animation parameters}} tab
 +
See the configuration menu tab for the following options you can change:
 +
*A slider to set the {{man label|Animation speed in milliseconds(big value means slower:)}} (default: ''100'')
 +
*A slider to set the {{man label|How many steps between two markers when we are on large move?:}} (default: ''20'')
 +
*A slider to set the {{man label|The minimum latitude/longitude to select large move. The value is in tenth of degree.}} (default: ''5'')
 +
{{-}}
 +
====== All known places for one person with graphical information (KML files) ======
  
This view is used to show all descendant's life ways.
+
[[File:gramps-person-kml.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} One person with 3 KML files]]
  
They are displayed by generation.
+
If you added KML files in the media tab for one event, this view will show one path or one surface for each KML file.
You can change the delay between the generation display in the view configuration.
 
  
This view is not connected to filters. It only depend on the active person and the history.
+
In the following example, you see 3 KML files :
 +
* The farm for the birth of this person.
 +
* The path used to go to school (school event).
 +
* The limits of the parish or municipality (baptism event).
  
In the configuration menu for {{man label|The parameters for moves}} tab, you can change:
+
See [[Gramps_5.0_Wiki_Manual_-_Categories#Adding_places_from_KML_files|Adding places from KML files]]
#A slider to set {{man label|The maximum number of generations.}} to show. (default: ''20'')
 
#A slider to set the {{man label|Time in milliseconds between drawing two generations.}} (default: ''500'')
 
  
[[File:gramps-configuration-4.png|right|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Parameters for moves]]
+
{{man tip|What is a KML file ?|See the article [https://en.wikipedia.org/wiki/Keyhole_Markup_Language Keyhole Markup Language] From Wikipedia, the free encyclopedia}}
 
{{-}}
 
{{-}}
  
===== All places related to events =====
+
===== Every residence or move for a person and any descendants =====
  
[[File:gramps-events-7.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events]]
+
[[File:GeographyCategory-EveryResidenceOrMoveForAPersonAndAnyDescendants-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Every residence or move for a person and any descendants" GeoMoves View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
  
This view is used to show all places related to events.
+
This view is used to show all descendant's life ways.
It can take some time to show when we have many events.
+
 
 +
They are displayed by generation.
 +
You can change the delay between the generation display in the view configuration.
  
from 5.0.2, for performances reason, by default, the view show only the place related to the events history or the filtered events.
+
This view is not connected to filters. It only depend on the active person and the history.
If you really want to see all events, you need to select the popup menu from the right button and select "show all events".
+
{{-}}
 +
[[File:GeographyCategory-EveryResidenceOrMoveForAPersonAndAnyDescendants-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The parameters for moves" tab for the "Every residence or move for a person and any descendants" GeoMoves View - Configure the active view]]
  
You have no extra option in the configuration menu.
+
;Configure the active view: {{man label|The parameters for moves}} tab
 +
See the configuration menu tab for the following options you can change:
 +
*A slider to set {{man label|The maximum number of generations.}} to show. (default: ''20'')
 +
*A slider to set the {{man label|Time in milliseconds between drawing two generations.}} (default: ''500'')
 
{{-}}
 
{{-}}
  
===== All known places =====
+
===== Have these two families been able to meet ? =====
  
[[File:gramps-places-6.png|left|300px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places]]
+
[[File:GeographyCategory-HaveTheseTwoFamiliesBeenAbleToMeet-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Have these two families been able to meet ?" GeoFamClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]
  
This view show all places with coordinates in the database.
+
This view is used to show if two families were able to meet during their life.
 +
 
 +
You must select one reference family :
 +
* From the menu popup : Choose the reference family
 +
* From the toolbar
  
from 5.0.2, for performances reason, by default, the view show only the place related to the places history or the filtered places.
+
When the reference family is active, you'll see all its member's life way.
If you really want to see all places, you need to select the popup menu from the right button and select "show all places".
+
For each known place with coordinates, you'll see a circle or an oval depending on the longitude.
  
You have no extra option in the configuration menu.
+
The circle radius can be tuned in the configuration view.
 +
This value is defined in tenth of degree.
 +
{{-}}
 +
[[File:GeographyCategory-HaveTheseTwoFamiliesBeenAbleToMeet-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The selection parameters" tab for the "Have these two families been able to meet ?" GeoFamClose View - Configure the active view]]
 +
 
 +
;Configure the active view: {{man label|The selection parameters}} tab
 +
See the configuration menu tab for additional options.
 
{{-}}
 
{{-}}
  
Line 663: Line 786:
  
 
=====All views=====
 
=====All views=====
[[File:gramps-configuration-1.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The map]]
+
[[File:ConfigureGeography-the-map-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Geography - "The map" tab]]
  
On the {{man label|The map}} tab
+
{{man label|The map}} tab contains options common to all Geography views:
# {{man label|Where to save the tiles of the tiles for offline mode.}} (default is ''<code>$HOME/.gramps/maps</code>''). If required you can change the directory where map tile files are stored on your computer. {{man menu|Be careful, it can take several gigabytes, and if on a metered internet connection may result in a monetary cost to you.}}.
+
* {{man label|Where to save the tiles of the tiles for offline mode.:}} (default is ''<code>$HOME/.gramps/maps</code>''). If required you can change the directory where map tile files are stored on your computer. {{man menu|Be careful, it can take several gigabytes, and if on a metered internet connection may result in a monetary cost to you.}}.
# A slider for {{man label|Zoom used when centering:}} (default: ''12''). The zoom level for when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used.
+
** {{man button|Select tile cache directory for offline mode}} button
# A slider for {{man label|The maximum number of places to show:}} (default: ''5000''). Reducing this number for faster map drawing but with less life ways.
+
* A slider for {{man label|Zoom used when centering:}} (default: ''12''). The zoom level for when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used.
#{{checkbox|1}} {{man label|Use keypad for shortcuts: Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard.}} - checkbox selected by default.
+
* A slider for {{man label|The maximum number of places to show:}} (default: ''5000''). Reducing this number for faster map drawing but with less life ways.
 +
* {{checkbox|1}} {{man label|Use keypad for shortcuts: Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard.}} - checkbox selected by default.
  
 
{{-}}
 
{{-}}
Line 675: Line 799:
 
=====Specific views=====
 
=====Specific views=====
 
See the description of the view.
 
See the description of the view.
 +
 
====How to zoom and move around the map ?====
 
====How to zoom and move around the map ?====
 
=====Zoom in and Zoom out the map=====
 
=====Zoom in and Zoom out the map=====
 
To zoom, you can use :
 
To zoom, you can use :
# The +/- buttons on the top left of the map
+
* The +/- buttons on the top left of the map
# The scroll mouse.
+
* The scroll mouse.
# The "+" or "-" key on the keypad (default).
+
* The "+" or "-" key on the keypad (default).
  
 
You can replace the numeric keypad by the alpha numeric keyboard in the configuration view.
 
You can replace the numeric keypad by the alpha numeric keyboard in the configuration view.
Line 686: Line 811:
 
=====Move around the map=====
 
=====Move around the map=====
 
To move around the map, you can :
 
To move around the map, you can :
# Click on the map, then drag it.
+
* Click on the map, then drag it.
# Use the arrows.
+
* Use the arrows.
  
 
====The mouse actions on the map====
 
====The mouse actions on the map====
Line 707: Line 832:
 
=====button 3 ( right button )=====
 
=====button 3 ( right button )=====
 
Only one usage for this button.
 
Only one usage for this button.
# show the menu popup.
+
* show the [https://en.wikipedia.org/wiki/Context_menu context menu popup].
  
 
=====The mouse over a marker=====
 
=====The mouse over a marker=====
Line 713: Line 838:
  
 
====The menu popup====
 
====The menu popup====
From this menu, you have the following functions available for views :
+
From this context menu, you have the following functions available for views :
#hide or show the crosshair
+
*hide or show the crosshair
#lock or unlock the zoom
+
*lock or unlock the zoom
#change the default map (provider)
+
*change the default map (provider)
#add a place and link a place at the mouse position
+
*add a place and link a place at the mouse position
#add a place from kml file
+
*add a place from kml file
#center the map at the mouse position.
+
*center the map at the mouse position.
#center the map depending on a place from sub menu.
+
*center the map depending on a place from sub menu.
#remove all tiles already uploaded for the current provider
+
*remove all tiles already uploaded for the current provider
#"show all places" or "show all events" for the "all known places" view or "all places related to events" view.
+
*"show all places" or "show all events" for the "all known places" view or "all places related to events" view.
  
 
====Click on a marker====
 
====Click on a marker====
Line 735: Line 860:
  
 
====Adding or Linking to a place====
 
====Adding or Linking to a place====
For this, click on the right button of the mouse, you'll get a popup menu.
+
For this, click on the [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a popup menu.
 
In this menu, you can select {{man label|Add place}} or {{man label|Link place}}
 
In this menu, you can select {{man label|Add place}} or {{man label|Link place}}
  
Line 746: Line 871:
 
====Adding places from KML files====
 
====Adding places from KML files====
  
For this, click on the right button of the mouse, you'll get a popup menu.
+
For this, click on the [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a context popup menu.
 +
 
 
In this menu, you can select {{man label|Add place from KML}}
 
In this menu, you can select {{man label|Add place from KML}}
  
You will get a file chooser. Select the file you want to add.
+
You will get the {{man label|Select a kml file used to add places}} file chooser dialog. Select the file you want to add.
 +
 
 
If you have several places in the same KML file, you will get one place editor for each place. Be careful.
 
If you have several places in the same KML file, you will get one place editor for each place. Be careful.
  
Line 755: Line 882:
 
Several map providers are available in Gramps.
 
Several map providers are available in Gramps.
  
Click on the right button of the mouse, you'll get a popup menu.
+
Click on the [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a popup menu.
  
 
In the bottom of this menu, you can select a new provider.
 
In the bottom of this menu, you can select a new provider.
  
 
The following providers are available :
 
The following providers are available :
# OpenStreetMap (default) : The advantage of [http://www.openstreetmap.org/ OpenStreetMap] is that it is a free project, so you can update the maps yourself with missing information via their website.
+
* '''OpenStreetMap''' (default) : The advantage of [http://www.openstreetmap.org/ OpenStreetMap] is that it is a free project, so you can update the maps yourself with missing information via their website.
# Maps For Free
+
* Maps For Free
# OpenCycleMap
+
* OpenCycleMap
# Public Transport
+
* Public Transport
# Google street
+
* Google street
# Google sat
+
* Google sat
# Google hybrid
+
* Google hybrid
# Virtualearth street
+
* Virtualearth street
# Virtualearth sat
+
* Virtualearth sat
# Virtualearth hybrid
+
* Virtualearth hybrid
 
{{man tip|Some maps are not free, please read the map provider ''Terms of Service'' :|
 
{{man tip|Some maps are not free, please read the map provider ''Terms of Service'' :|
 
[https://www.google.com/intl/en_ALL/help/terms_maps.html Google street],  
 
[https://www.google.com/intl/en_ALL/help/terms_maps.html Google street],  
Line 781: Line 908:
  
 
====Can we change the marker's color ?====
 
====Can we change the marker's color ?====
We can't do that except for the "All known Places" view. The marker's colors are hard coded in Gramps.
 
 
The colors are green for the following renderers:
 
* Openstreetmap
 
* Maps for free
 
* Opencyclemap and Public transport.
 
 
All other marker renderers are red.
 
 
For the "All known Places" view, you can choose different colors depending on the place type.
 
 
Click on the {{man button|Configure the active view}} button on the toolbar.
 
 
Then click on the {{man button|The places marker color}} tab.
 
 
For each type of place, you can select and choose a color. The default color is green "#008b00"
 
  
[[File:gramps-configure-color-1.png|right|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The color selection for markers]]
+
Only the {{man label|[[Gramps_5.0_Wiki_Manual_-_Categories#All_known_places|All known Places]]}} view supports changing the place type markers colors all the other views are hard coded in Gramps.
 
{{-}}
 
{{-}}
  
 
====How to get/remove the crosshair ?====
 
====How to get/remove the crosshair ?====
 
It can be useful to have the crosshair visible to see the center of the map.
 
It can be useful to have the crosshair visible to see the center of the map.
This functionality is available with the right button of the mouse. you'll get a popup menu.
+
This functionality is available with the [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse. you'll get a popup menu.
 
Select Add or Remove cross hair.
 
Select Add or Remove cross hair.
 
This is useful to add or link places to the correct latitude-longitude coordinates
 
This is useful to add or link places to the correct latitude-longitude coordinates
Line 810: Line 921:
 
When we change the map ( person to family, ... ), the zoom is recalculated.
 
When we change the map ( person to family, ... ), the zoom is recalculated.
 
It can be useful in some case to keep the same zoom and position when we change the map provider.
 
It can be useful in some case to keep the same zoom and position when we change the map provider.
For this, click on the right button of the mouse, you'll get a popup menu.
+
For this, click on the [[Gramps_5.0_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a popup menu.
 
In this menu, you can select lock or unlock zoom and position.
 
In this menu, you can select lock or unlock zoom and position.
  
 
===Prerequisites to see the geography view===
 
===Prerequisites to see the geography view===
For Gramps 4.x, you need to install osmgpsmap version 1.0 and above and the associated gir package.
+
For Gramps 5.x, you need to install [http://nzjrs.github.io/osm-gps-map/ osmgpsmap] version 1.0 and above and the associated gir package.
  
 
For example on ubuntu, you must have:
 
For example on ubuntu, you must have:
Line 820: Line 931:
  
 
===Possible problems===
 
===Possible problems===
#No view : do you have <code>osmgpsmap</code> installed ? (''<code>gramps -v</code>'' from the command line may help you)
+
*No view : do you have <code>osmgpsmap</code> installed ? (''<code>gramps -v</code>'' from the command line may help you)
#No tiles : do you have an internet connection active ?
+
*No tiles : do you have an internet connection active ?
#No tiles for one provider : if other providers are OK, file a bug
+
*No tiles for one provider : if other providers are OK, file a bug
#Missing tiles : you have no internet connection and it's the first time you try to show the current place.
+
*Missing tiles : you have no internet connection and it's the first time you try to show the current place.
#Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)
+
*Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)
#Other : [[Using_the_bug_tracker|Report a bug]]
+
*Other : [[Using_the_bug_tracker|Report a bug]]
  
 
===Geography Category Bottombar tabs===
 
===Geography Category Bottombar tabs===
Line 847: Line 958:
 
== Sources Category ==
 
== Sources Category ==
  
The {{man label|Sources Category}} shows two views ({{man label|Citation Tree}} View and {{man label|Sources List}} View) that list the sources of certain information stored in the database.
+
The {{man label|Sources Category}} shows two views ({{man label|Citation Tree}} View and {{man label|Sources List}} View) that list the sources of certain information stored in the family tree.
  
 
Sources can include various documents (birth, death, and marriage certificates, etc.), books, films, journals, private diaries, - nearly anything that can provide genealogical evidence. Gramps gives you the option to provide a citation to a source for each event you record (births, deaths, marriages, etc.). The Sources View lists the {{man label|Title}} , {{man label|ID}} , and {{man label|Author}} of the source, as well as any {{man label|Publication}} information that may be associated with it.
 
Sources can include various documents (birth, death, and marriage certificates, etc.), books, films, journals, private diaries, - nearly anything that can provide genealogical evidence. Gramps gives you the option to provide a citation to a source for each event you record (births, deaths, marriages, etc.). The Sources View lists the {{man label|Title}} , {{man label|ID}} , and {{man label|Author}} of the source, as well as any {{man label|Publication}} information that may be associated with it.
Line 854: Line 965:
  
 
Clicking once sorts in ascending order, clicking again sorts in descending order. The {{man label|Column Editor}} dialog can be used to add, remove and rearrange the displayed columns.
 
Clicking once sorts in ascending order, clicking again sorts in descending order. The {{man label|Column Editor}} dialog can be used to add, remove and rearrange the displayed columns.
 +
 +
<!-- link properly to editing/creating a source-->
 +
* See [[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|Editing information about sources]]
 
{{-}}
 
{{-}}
 
===Citation Tree View===
 
===Citation Tree View===
{{stub}}
+
[[File:SourcesCategory-CitationTreeView-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources Category - Citation Tree - View]]
[[File:Sources-category-citation-tree-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources Category - Citation Tree - View - sidebar and bottombar hidden]]
 
  
 
The default (Citation Tree View) shows all the sources, and for each it allows the user to see the Citations associated with that source by clicking on the disclosure triangle.
 
The default (Citation Tree View) shows all the sources, and for each it allows the user to see the Citations associated with that source by clicking on the disclosure triangle.
Line 863: Line 976:
  
 
===Sources List View===
 
===Sources List View===
{{stub}}
+
[[File:SourcesCategory-SourcesListView-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources Category - (List) View]]
[[File:Sources-category-list-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources Category - (List) View - sidebar and bottombar hidden]]
 
  
The alternative view only shows the Sources.
+
The alternative view only shows the Sources as a list.
 
{{-}}
 
{{-}}
  
Line 899: Line 1,011:
 
===Citations List View===
 
===Citations List View===
  
[[File:Citations-category-list-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Citations Category - (List) View - sidebar and bottombar hidden]]
+
[[File:CitationsCategory-CitationsListView-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Citations Category - Citations (List) View - example]]
  
 
The Citations List View shows the {{man label|Volume/Page}} , {{man label|ID}} , and {{man label|Date}} of the citation, as well as any {{man label|Confidence}} in the evidence.
 
The Citations List View shows the {{man label|Volume/Page}} , {{man label|ID}} , and {{man label|Date}} of the citation, as well as any {{man label|Confidence}} in the evidence.
Line 908: Line 1,020:
  
 
{{-}}
 
{{-}}
 +
 
===Citations Category Bottombar tabs===
 
===Citations Category Bottombar tabs===
  
Line 935: Line 1,048:
 
{{-}}
 
{{-}}
 
===Repository List View===
 
===Repository List View===
{{stub}}
 
[[File:Repositories-category-list-view-42.png|450px|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repositories view]]
 
  
 +
[[File:RepositoriesCategory-RepositoriesListView-example-50.png|450px|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repositories (list) view - example]]
 +
 +
This view shows a list of all recorded repositories.
 
{{-}}
 
{{-}}
  
Line 971: Line 1,085:
 
===Media List View===
 
===Media List View===
  
[[File:Media-category-list-view-42.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Category - (List) View - sidebar hidden]]
+
[[File:MediaCategory-MediaListView-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Category - Media (List) View - example]]
  
 
The Media List View shows the following columns for the list {{man label|Name}} , {{man label|ID}} , {{man label|Type}}, {{man label|Path}} and {{man label|Date}} of the Media Object.
 
The Media List View shows the following columns for the list {{man label|Name}} , {{man label|ID}} , {{man label|Type}}, {{man label|Path}} and {{man label|Date}} of the Media Object.
Line 977: Line 1,091:
 
The {{man label|Column Editor}} dialog may be used to rearrange the displayed columns, which obey usual sorting rules.  
 
The {{man label|Column Editor}} dialog may be used to rearrange the displayed columns, which obey usual sorting rules.  
 
{{-}}
 
{{-}}
 +
 
===Media Category Bottombar tabs===
 
===Media Category Bottombar tabs===
  
Line 984: Line 1,099:
 
In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.
 
In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.
  
See [[Gramps_5.0_Wiki_Manual_-_Gramplets#Preview|Preview]] Gramplet
+
See [[Gramps_5.0_Wiki_Manual_-_Gramplets#Media_Preview|Media Preview]] Gramplet
 
{{-}}
 
{{-}}
 
====Citations====
 
====Citations====
Line 1,010: Line 1,125:
  
 
== Notes Category ==
 
== Notes Category ==
 
[[File:Notes-category-list-view-42.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes view]]
 
  
 
The {{man label|Notes Category}} shows the Notes List View, which list text note (either pure text or preformated), as stored in the other objects.
 
The {{man label|Notes Category}} shows the Notes List View, which list text note (either pure text or preformated), as stored in the other objects.
  
 +
See also:
 +
* [[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Editing information about notes]]
 +
{{-}}
 
===Notes List View===
 
===Notes List View===
 +
 +
[[File:NotesCategory-NotesListView-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes Category - Notes (List) view]]
  
 
The Notes List View shows a list of text notes.
 
The Notes List View shows a list of text notes.
  
The functionality of the notes View is similar to the other views. The view lists all {{man label|Notes}} stored in the {{man label|Family Tree}}.  
+
The functionality of the notes View is similar to the other views. The view lists all {{man label|Notes}} stored in the Family Tree.  
  
 
Using the menu {{man menu|View ->Configure View...}} you open the {{man label|Column Editor}} and you can change the displayed columns. The possibilities are {{man label|Preview}}, {{man label|ID}}, {{man label|Type}}, {{man label|Private}}, {{man label|Tags}} and {{man label|Last Changed}}.
 
Using the menu {{man menu|View ->Configure View...}} you open the {{man label|Column Editor}} and you can change the displayed columns. The possibilities are {{man label|Preview}}, {{man label|ID}}, {{man label|Type}}, {{man label|Private}}, {{man label|Tags}} and {{man label|Last Changed}}.
Line 1,027: Line 1,145:
 
Double-clicking on a Note in the list will bring up a window where you can edit the Note. You can change fonts, font color and background color. A spellchecker is available for ''English'' and your local language.
 
Double-clicking on a Note in the list will bring up a window where you can edit the Note. You can change fonts, font color and background color. A spellchecker is available for ''English'' and your local language.
 
{{-}}
 
{{-}}
 +
 
===Notes Category Bottombar tabs===
 
===Notes Category Bottombar tabs===
  
Line 1,040: Line 1,159:
 
====Filter====
 
====Filter====
 
See [[Gramps_5.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
 
See [[Gramps_5.0_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
 +
 
{{-}}
 
{{-}}
 
 
{{man index|Gramps 5.0 Wiki Manual - Main Window|Gramps 5.0 Wiki Manual - Manage Family Trees|5.0}}
 
{{man index|Gramps 5.0 Wiki Manual - Main Window|Gramps 5.0 Wiki Manual - Manage Family Trees|5.0}}
 
 
{{languages|Gramps 5.0 Wiki Manual - Categories}}
 
{{languages|Gramps 5.0 Wiki Manual - Categories}}
 
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 23:46, 27 October 2022

Previous Index Next


Genealogical information is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.

Contents

Categories of the Navigator

The different Categories of the Navigator: The navigator is located at the left of the window and allows selection of the different categories.

  • Dashboard Dashboard: Displays different general purpose Gramplets, small widgets that can help in your genealogical research.
  • People People: Displays the people in the family tree without their connections. This Category contains the PeopleListView and the PeopleTreeView.
  • Relationships Relationships: Shows the relationships between the Active Person and other people in a textual way. This includes parents, spouses, and children.
  • Family Families: Shows the families in the family tree.
  • Charts Charts: Displays graphical trees for the selected person.
  • Events Events: Displays the events in the family tree.
  • Places Places: Displays the places in the family tree.
  • Geography Geography: Displays data of your family tree on a map.
  • Sources (v3.4.x) Sources: Displays the sources in the family tree.
  • Citations Citations: Displays the citations in the family tree.
  • Repositories Repositories: Displays the repositories in the family tree.
  • Media Media: Displays the media objects in the family tree.
  • Notes Notes: Displays the notes in the family tree.

The categories can contain several ways of presenting the data. Each specific way is called a View. For example:

  • Categories
    • View (1)
    • View (2)

For each category you have a number of ways to switch between Views:

  1. by selecting the relevant icon from the toolbar
  2. from the menu View > ...
  3. Via keyboard shortcuts See the shortcuts for Changes the view to view number 0/1/2/../9 in this view category

The following sections provide a brief description of each category and the view's within.

Dashboard Category

Fig. 4.1 Dashboard Category view

This contains the Dashboard Dashboard, which shows a number of widgets, called Gramplets, that can help you in your research. Two Gramplets are shown by default on start-up (the Welcome and Top Surname Gramplets). When you have an open Family Tree you can by using the context menu (right-clicking) on an empty area of the Dashboard View, to see a popup menu to "Add a gramplet" that shows a list of the possible Gramplets you may add and use.

  • Age Stats Gramplet - list age span statistics in a number of graphs
  • Age on Date Gramplet - list the people alive and their ages on a particular date
  • Calendar Gramplet - see people's events on a particular date, or in a month in the past
  • FAQ
  • Given Name Cloud Gramplet - most popular given names
  • Quick View - run a Quick View on the current person
  • Records Gramplet - see world's records of your data
  • Session Log Gramplet - keep track of what you have done, and what records you have visited
  • SoundEx Generator
  • Statistics Gramplet - see stats on the database
  • Surname Cloud Gramplet - most popular surnames as a "text cloud"
  • To Do Gramplet - a notepad to keep tabs on your research
  • Top Surnames Gramplet - top 10 most popular surnames
  • Welcome Gramplet - a Gramps welcome message
  • What's Next Gramplet - what needs to be done next

In addition, there are a number of Third party Gramplets that you can easily install and use. These include:

  • Headline News Gramplet - current, breaking news from Gramps
  • Data Entry Gramplet - edit active person's name, birth date and place, death date and place, and add people
  • Python Gramplet - a Python shell
  • FAQ Gramplet - frequently asked questions
  • Note Gramplet - see and edit active person's primary Person Note

and many others. See Third-party Addons for more details.

For more detailed information on using the installed Gramplets, see Gramplets.

People Category

In the People Category the People List view or Grouped People(default) views display a list of all people in the database. From this view, you may add, edit, remove, or merge people. Each view (List or Grouped) display several columns of information about each person by default the following columns are shown Name, ID, Gender, Birth Date, Death Date and by configuring the active view you may show/hide or change the order of additional columns from the following selection Birth Place, Death Place, Spouse, Number of Parents, Number of Marriages, Number of Children, Number of To Do Notes, Private, Tags, Last Changed.

See also

Gramps-notes.png
For Information displayed in the columns

Some of the column selection types require that the event being shown has the Role type of Primary eg Birth and Death Dates. This is set via the Event Reference Editor dialog's General tab.


Tree View - Grouped People

Fig. 4.2 People Category - Tree View - Grouped People

People are grouped according to their family names. To the left of each family name is typically either an arrow or some other type of indicator (eg: +). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.

Gramps-notes.png
Configure the view limitation

For the Group view the first column "Name" cannot be changed as the view is based on showing grouped surnames.


Tree View - People List View

Fig. 4.3 People Category - Tree View - People List View

List of all the people in the database, sorted by first column which by default is the Name column.


People Category Bottombar tabs

Both Tree Views (Grouped People/People List View) share the following Bottombar tabs.

Details

See Details Gramplet

Gallery

See Gallery Gramplet

Events

See Events Gramplet

Children

See Children Gramplet

Citations

See Citations Gramplet

Notes

See Notes Gramplet

Attributes

See Attributes Gramplet

References

See References Gramplet

People Category Sidebar tabs

Both Tree Views (Grouped People/People List View) share the following Sidebar tab by default.

Filter

See Filter Gramplet

Relationships Category

Fig. 4.4 Relationships Category view

The Relationships Category shows the default Relationships Category view which displays all the relationships of the Active Person (the selected person). Specifically, it shows the parents, siblings, spouses, and children of that person.

The Relationships Category is designed to allow for quick navigation. You can quickly change the Active Person simply by clicking the name of any person listed on the page. Each name is actually a hypertext link, similar to a web page.

The name of the Active Person is in bold style. Other names are shown either with or without bold and italic emphasis depending on whether certain relationships exist for the named person. For a person listed as a parent or spouse of the Active Person, the name is emphasized if that person has a parent family. For a person listed as a sibling or child of the Active Person, the name is emphasized if that person has children.

Dates are normally in regular style, and in italic style if the displayed event is a fallback event, i.e., a substitute event for another missing event. That may be christening event for birth event, burial event for death event, etc.

Relationships Category view

For the Relationships Category views via the menu or toolbar you may select:

  • Edit>Edit... or the Edit the active person icon - opens the Person Edit dialog
  • Edit>Add New Parents... or the Add a new set of parents icon - to create a new family with the Active Person listed as a child.
  • Edit>Add Existing Parents... or the Add person as child to and existing family icon - which opens the Select Family selector allowing you to choose from a list of existing families, and then add the person as a child to that family.
  • Edit>Add Partner... or the Add a new family with person as parent icon -
  • Edit>Reorder... or the Change order of parents families icon - to open the Reorder Relationships dialog

The following sections are available:

Active Person

  • At the top of the screen, name, ID, Birth, and Death information, as well as the calculated age of the Active Person is displayed. You may highlight and copy the Birth and Death text fields.
  • On the right hand side a photo of the person if available, will be shown. This photo shows the first image available in the Gallery tab of this person (if any exist). You can click on the photo to open it in the default picture viewer.
  • Next to the person's name is a symbol indicating gender, and an Gramps-notes.pngEdit button. Clicking the Gramps-notes.pngEdit button will allow you to edit all of the person's individual information in the Edit Person dialog.

Parents

The Parents section, displays the families in which the person is a child. Since it is possible for a person to have multiple sets of parents, it is possible to have several Parents sections.

You may edit an existing parents by selecting the Gramps-notes.pngEdit button next to the parents. If you select the - button next to a set of parents, then the Active Person will be removed as a child from the parents. This button does not delete the parents' relationship.

See the Configure Relationships section to configure what details to show or hide etc...

Gnome-important.png
Warning

If you are not careful, it is possible to create multiple families with the same parents. This is rarely what the user wants to do. If you attempt to add a new family that has the same parents as an existing family, Gramps will issue a warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the Select button to select the existing family.

Select Family selector
Fig. 4.5 Select Family - selector dialog example

The Select Family selector dialog allows you to link to an already existing Family.

The following columns are shown: ID(default sort for list), Father, Mother, Last Change.

You may use the Find button to filter the list based on one of the options from the drop down list:

  • ID contains (default)
  • ID does not contain
  • Father contains
  • Father does not contain
  • Mother contains
  • Mother does not contain
  • Last Change contains
  • Last Change does not contain



Siblings

The Sibling section show the active persons brothers and sisters.



Family

Similar to the Parents section is the Family section, which displays families where the Active Person is a parent. Because it is possible to have multiple families, it is possible to have multiple Family sections. Each family section displays the spouse and any children.

Gramps-notes.png
Spouse

We use the term spouse for sake of simplicity. However, please note that spouse may in fact be a domestic partner, a partner in a civil union, or various other similar relationships between two people. Spouse relationships are not required to be only between a male and female.

You may add a family by selecting the Add Spouse button in the toolbar. This will create a new family with the Active Person listed as a father or mother.

Selecting the Gramps-notes.pngEdit button next to the spouse will allow you to edit the displayed family. Clicking the - button will remove the person from the displayed family.


Gnome-important.png
Removing a person from a family

Removing a person from a family does not delete the family. The person is removed as the father or mother, and any other relationships in the family continue to exist.

Gramps-notes.png
Note

We use the terms father and mother for the sake of simplicity. Even if there are no children in a family, the father and mother terminology is still used. In the case of male/male or female/female relationships, the father and mother labels should be considered to be convenience labels.


Select the Change order of parents families button to display the Reorder Relationships dialog that will allow you to reorder the families.

Reorder Relationships dialog
Gramps-notes.png
This option will only be enabled

if more than one set of parents or more than one set of spouses exists for the Active Person.

Fig. 4.6 Reorder Relationships - dialog - example

When more than one set of parents or more than one set of spouses exists for the Active Person.

Select one of the following:

  • the menu Edit > Reorder
  • or the Change order of parents and families toolbar icon button
  • or the Reorder Parents icon near the Parents: label
  • or the Reorder Families icon near the Family: label

to display the Reorder Relationships dialog that will allow you to reorder:

  • the parents order in the top section Parent relationships using the up/down arrow buttons.
  • or families order in the bottom section Family relationships using the up/down arrow buttons.


Children

The Active persons children.

Configuration

Fig. 4.7 Configure Relationships Category - Content (tab)

You can control how much information is displayed by using the View -> Configure... menu or click on the toolbar Configure the active view... button.

The following options are available:

  • On the Content tab
    • Show Details (checkbox checked by default) show or hide the birth and death information (All except the Active person)
    • Show Siblings (checkbox checked by default) show or hide siblings.


Fig. 4.8 Configure Relationships Category - Layout (tab)
  • On the Layout tab
    • Use shading (checkbox checked by default)
    • Display edit buttons (checkbox checked by default) - show or hide the Gramps-notes.pngEdit button shown next to each person.
    • View links as website links (checkbox unchecked by default)


Relationships Category Bottombar tabs

The Relationships Category view by default displays no Gramplets in the Bottombar tab. You may add them as required.

Relationships Category Sidebar tabs

The Relationships Category view by default displays no Gramplets in the Sidebar tab. You may add them as required.

Families Category

Gnome-important.png
Remove button

Unlike the Relationships Category, clicking the Remove button in this view will remove the family from the database. All people will remain, but all relationships between the people in the family will be removed.

Fig. 4.9 Families Category - (List) View

In the Families Category the Families List view displays a list of all families in the database(see Fig. 4.9). From this view, you may Add a new Family, Edit the selected family, Delete the selected family, Merge the selected (2) families from the list, or Tag the selected rows. The default display lists the ID, Father, Mother, Relationship and Marriage Date. If you configure the active view you can, hide existing columns, show additional columns like Private, Tags, Last Changed, or rearrange the column order.

If you can also right-click on a family and from the context menu, select "Make Mother Active Person" or "Make Father Active Person"

See also

Gramps-notes.png
Children cannot be displayed on the screen in this list view.

The children can be viewed in the associated Children tab in the bottombar or sidebar and Family Editor's Children tab.


Families Category Bottombar tabs

The Families Category shows the following Bottombar tabs as default.

Gallery

See Gallery Gramplet

Events

See Events Gramplet

Children

See Children Gramplet

Citations

See Citations Gramplet

Notes

See Notes Gramplet

Attributes

See Attributes Gramplet

References

See References Gramplet

Families Category Sidebar tabs

The Families Category shows the following Sidebar tabs as default.

Filter

See Filter Gramplet

Charts Category

Tango-Dialog-information.png
Want more Chart Views?

Installation of additional downloadable addons contain extra views. See Third-party Addons


The Charts Category shows several graphical representations of the ancestry or descendants of the active person.

By default Gramps shows the Pedigree View. With the Fan Chart View and Descendant Fan chart View and 2-Way Fan chart view being selectable from the toolbar or menu via View > Name of Chart View

Pedigree View

Fig. 4.10 Pedigree view 1 (Default) Tree direction:horizontal to right

The Pedigree View shows up to nine generations in the form of a chart, depending on the size of the window you may need to use the scroll bars to see parts of the chart.

Each person is indicated by a box labeled with his or her name, birth information (indicated by an asterisk * sign), death information (indicated by a plus + sign), a black stripe across the top left corner of the box is shown if the person is deceased (or determined by Gramps to be no longer alive) and optionally the primary image will be displayed if available.

Two lines branch from each person box. The top line leads to the person's father and the bottom line leads to the mother. Solid lines represent the biological birth type relationship, while dashed lines represent non-birth relationships such as adoption, step-parenthood, guardianship, etc.

The left arrow Jump to child... button beside the Active Person is a only selectable if the Active Person has children, clicking this button expands to show a list of the Active Person's children. Selecting one of the children makes that child the Active Person for the chart.

The appearance of the children's names in the menu differentiates the dead ends of the tree from the continuing branches.

Children who have children themselves appear in the menu in the boldface and italic type, while children without children (dead ends) appear in a regular font. If the Active Person has only one child, no menu will be displayed (since there is only one choice) and the child will become the Active Person when the arrow button is clicked.

The right-hand side of the window shows two right arrow buttons. When the top button Jump to father is clicked, the Father of the Active Person becomes the Active Person. When the bottom button Jump to mother is clicked, the Mother of the Active Person becomes the Active Person.


Fig. 4.11 Person context menu showing Children

Right-clicking on any person's box in the Pedigree View will bring up the Person "context menu".

Among other useful items, the context menu has sub-menus listing Spouses , Siblings , Children , Parents and Related of that person.

"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.


Configure the active view

Fig. 4.12 Charts Category - Pedigree View - Configure the active view - dialog - showing Defaults on Layout tab

The Layout tab has the following option available:

  • Show images (checked by default)
  • Show marriage data (checked by default)
  • Show unknown people (checked by default)
  • Show tags (unchecked by default)
  • Tree style:
    • Standard(default)
    • Compact
    • Expanded
  • Tree direction:
    • Vertical (↑)
    • Vertical (↓)
    • Horizontal (→)(default)
    • Horizontal (←)
  • Tree size: slider range 2 to 9. Set to 5(by default)
Fig. 4.13 Pedigree view 2 - Tree direction:horizontal to left
Fig. 4.14 Pedigree view 3 - Tree direction:vertical and up
Fig. 4.15 Pedigree view 4 - Tree direction:vertical and down


Fan Chart View

Fig. 4.16 Fan Chart View - full circle

The Fan Chart view shows the active persons ancestry as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person. A second click brings the chart back to the original form. Right click brings up a context menu like in the pedigree view, allowing to navigate to other people.

This view enables to see large ancestries in a more compact manner, and to see very quickly which parts of an ancestry need further research.

You can rotate the view by click and drag outside the fan chart. You can move the view by click and drag inside the inner (white) region.

  1. The view can be a circle, a halfcircle or a quadrant of a circle. The latter are always attached to the bottom or side of the view
  2. Children of the center person are shown within the ring at the center
  3. Drag and drop people to the center to change the active person
  4. Color options
    1. Colors of the boxes based on the age of the people
    2. Colors of the boxes depending on the time period the person lived in
    3. White, classic, gender based, and user defined colors
  5. Filtering: use the person filter in the sidebar to quickly obtain insight in the people shown. For example: which people have birth events, who has the attribute blue eyes, ... . Filtered results have bold font, the ones that don’t satisfy the filter are shown transparent
  6. Show up to 11 generations in the view.
  7. Print the view from the toolbar. The view as you see it (after rotating, expanding, changing color) can via the print button be printed or saved as svg (to edit further in Inkscape and view in eg Firefox), pdf or ps.
  8. The font used can be selected and automatically adjust to fit within the boxes. On a darker background, the font is white, and vice versa.

To understand all, watch the screencast

See also: Fan Chart Gramplet

Configure the active view

Fig. 4.17 Charts Category - Fan Chart View - Configure the active view - dialog - showing Defaults Defaults on Layout tab


Descendant Fan View

Fig. 4.18 Descendant Fan Chart View - full circle


View showing the active person's direct descendants as a fan chart.


Configure the active view

Fig. 4.19 Charts Category - Descendant Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab


2-Way Fan View

Fig. 4.20 2-Way Fan Chart View - 4 Generations of Ancestors (Top) / 4 Generations of Descendants (bottom)



Configure the active view

Fig. 4.21 Charts Category - 2-Way Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab


Charts Category Bottombar tabs

The Charts Category by default displays no Gramplets in the Bottombar tab. You may add them as required.

Charts Category Sidebar tabs

The Charts Category shows the following Sidebar tabs.

Filter

Only the Fan Chart View and Descendant Fan View have a Filter shown by default.

See Filter Gramplet

Events Category

The Events Category shows the Events View that lists the all the events recorded in the Family Tree. Events can be shared between multiple people and multiple families.

See also:


Events View

Fig. 4.22 Events Category - Events (List) View - example

From the Events View list the following columns are available for display: Description , ID , Type , Main Participants , Date , Place and Last Changed.

The default view displays the Description , ID , Type , Date and Place of the event. The Column Editor dialog can be used to add, remove and rearrange the displayed columns. This can be accessed from the Configure View... button on the toolbar.

The list of Events can be sorted in the usual manner, by clicking on the column heading. Clicking once sorts in ascending order, clicking again sorts in descending order.

Gnome-important.png
Use meaningful event descriptions

Because events can be shared, you should take the extra time to give each event a unique and meaningful description. This will help you find the correct event when you share events.


Events Category Bottombar tabs

The Events Category shows the following Bottombar tabs.

Gallery

See Gallery Gramplet

Citations

See Citations Gramplet

Notes

See Notes Gramplet

Attributes

See Attributes Gramplet

References

See References Gramplet

Events Category Sidebar tabs

The Events Category shows the following Sidebar tabs.

Filter

See Filter Gramplet

Places Category

The Places Category holds two views that show places grouped or ungrouped. Each view lists the geographical places in which the events of the database took place. These could be places of birth, death, and marriages of people, as well as their home, employment, education addresses, or any other conceivable reference to the geographical location. The Places View lists the places' Name , Title , ID , Type , Code , Latitude , Longitude , Private , Tags , and Last Changed . All of these columns can be used for sorting by clicking on a column heading.

Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog may be used to add, remove and rearrange the displayed columns.

Places List View

Fig. 4.23 Places Category - Place (List) View - example

The Place List View shows all the places in one long list.

Places Tree View

Fig. 4.24 Places Tree View - example

The Place Tree View groups the places in a hierarchy: country, county, ... etc


Map Service

Gramps-notes.png
This feature is limited

And may not always produce the results you desire.

Fig. 4.25 Places Category - "Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ..." button - example

If a place has been highlighted, you may display the place in a web browser by selecting the Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ... button.

Your default web browser should open, attempting to use either the recorded coordinates (longitude and latitude) or the place name to display the location using the Maps provider web site. Different map services might have different requirements for the location description.


Fig. 4.26 Places Category - "Select a Map Service" button - showing list of options

From the Select a Map Service drop down list you can choose the map service you want to use from the following three options:

  • OpenStreetMap(default) - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
  • EniroMaps - Valid for places within Sweden and Denmark, only if longitude and latitude are available, otherwise uses city and country, or uses description of the place.
  • GoogleMaps - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.


See also:

Places Category Bottombar tabs

The Places Category shows the following Bottombar tabs.

Details

See Details Gramplet

Location

See Locations Gramplet

Gallery

See Gallery Gramplet

Events

See Events Gramplet

Citations

See Citations Gramplet

Notes

See Notes Gramplet

References

See References Gramplet

Places Category Sidebar tabs

The Places Category shows the following Sidebar tabs.

Filter

See Filter Gramplet

Geography Category

Tango-Dialog-information.png
Note

The Geography category is only present if the prerequisite program OsmGpsMap is present that Gramps can use.


Fig. 4.27 "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

The Geography Category shows place event data visually on a map. It contains many Geographic Views, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap, Google maps ...).

The following Geographic Views are available:

  • Show all places in your family tree
  • Show all places connected to the active person
  • Show all places connected to the active family
  • Show all places connected to all events
  • Show all places connected to a filtered selection of events
  • Show if two people have been able to meet
  • Show if two families have been able to meet
  • Show all displacements or moves for one person and their descendants

These views are accessible via the buttons on the toolbar. To filter on places or events, activate the filter sidebar via the menu View->Filter Sidebar

To have these Geographic views work correctly, you need:

  • To have events related to places.
  • These places must have coordinates : latitude and longitude.
  • If one place has no coordinates, it will never appear on the map.
  • If you have an active internet connection, for all moves on the map, all zoom ... all tile maps are saved.
    • When you are without an internet connection, all tile maps are cached from the previous session and can be used.
    • So, the map can be used without an internet connection and all already visited places can be shown again.
    • The only thing to do is for each place or area you want to use without an internet connection is to select them, zoom into these places. You'll be able to use them again without connection.
Gnome-important.png
BE CAREFUL

The Geography Category views may use many Gigabytes of storage space on your computer. If you use several maps, you need to have this same gigabytes size multiply by the number of map used.

The different views

All known places
Fig. 4.28 "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view show all places with coordinates in the database.

from Gramps 4.2.2, for performances reason, by default, the view show only the place related to the places history or the filtered places. If you really want to see all places, you need to select the popup menu from the context menu right button and select "show all places".

Fig. 4.29 The places marker color tab for the "All known Places" GeoPlaces View - Configure the active view
Configure the active view
The places marker color tab

The configuration menu tab for has the following options:

The All known Places view is the only Geography view that allows you to change the color used for the place type markers.

The colors are green for the following map renders:

  • Openstreetmap
  • Maps for free
  • Opencyclemap and Public transport.

All other marker renders are red.

Click on the Configure the active view button on the toolbar.

Then click on the The places marker color tab.

For each type of place, you can select and choose a color. The default color is green "#008b00"

See also:


All known places for one Family
Fig. 4.30 "All known places for one Family" GeoFamily View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view show all places visited by all family members during their lives.

This view is not connected to filters. It only depend on the active family and the history.

Configure the active view
Specific parameters tab

The configuration menu tab for this view has no additional options.

Have they been able to meet ?
Fig. 4.31 "Have they been able to meet ?" GeoClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view is used to show if two persons were able to meet during their life.

You must select one reference person :

  1. From the menu popup : Choose the reference person
  2. From the toolbar

When the reference person is active, you'll see its life way. For each known place with coordinates, you'll see a circle or an oval depending on the longitude.

The circle radius can be tuned in the configuration view. This value is defined in tenth of degree.


Fig. 4.32 "The selection parameters" tab for the "Have they been able to meet ?" GeoClose View - Configure the active view
Configure the active view
The selection parameters tab

See the configuration menu tab for additional options.

All places related to Events
Fig. 4.33 "All places related to Events" GeoEvents View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view is used to show all places related to events. It can take some time to show when we have many events.

from Gramps 4.2.2, for performances reason, by default, the view show only the place related to the events history or the filtered events. If you really want to see all events, you need to select the popup menu from the context menu right button and select "show all events".

Configure the active view
Specific parameters tab

The configuration menu tab for this view has no additional options.

All known places for one Person
Fig. 4.34 "All known places for one Person" GeoPerson View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view show all places visited by one person during that persons life.

This view is not connected to filters. It only depend on the active person and the history.

If you want to use the animate functionality, click on the right button of the mouse. You'll get a popup menu. From the menu popup, you can select 'animate' to see the life way of the current person:

If the active person has several related events, you can see a virtual move between those markers. The move is related to years or distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year.

Fig. 4.35 "The animation parameters" tab for the "All known places for one Person" GeoPerson View - Configure the active view
Configure the active view
The animation parameters tab

See the configuration menu tab for the following options you can change:

  • A slider to set the Animation speed in milliseconds(big value means slower:) (default: 100)
  • A slider to set the How many steps between two markers when we are on large move?: (default: 20)
  • A slider to set the The minimum latitude/longitude to select large move. The value is in tenth of degree. (default: 5)


All known places for one person with graphical information (KML files)
Fig. 4.36 One person with 3 KML files

If you added KML files in the media tab for one event, this view will show one path or one surface for each KML file.

In the following example, you see 3 KML files :

  • The farm for the birth of this person.
  • The path used to go to school (school event).
  • The limits of the parish or municipality (baptism event).

See Adding places from KML files

Tango-Dialog-information.png
What is a KML file ?

See the article Keyhole Markup Language From Wikipedia, the free encyclopedia


Every residence or move for a person and any descendants
Fig. 4.37 "Every residence or move for a person and any descendants" GeoMoves View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view is used to show all descendant's life ways.

They are displayed by generation. You can change the delay between the generation display in the view configuration.

This view is not connected to filters. It only depend on the active person and the history.

Fig. 4.38 "The parameters for moves" tab for the "Every residence or move for a person and any descendants" GeoMoves View - Configure the active view
Configure the active view
The parameters for moves tab

See the configuration menu tab for the following options you can change:

  • A slider to set The maximum number of generations. to show. (default: 20)
  • A slider to set the Time in milliseconds between drawing two generations. (default: 500)


Have these two families been able to meet ?
Fig. 4.39 "Have these two families been able to meet ?" GeoFamClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden

This view is used to show if two families were able to meet during their life.

You must select one reference family :

  • From the menu popup : Choose the reference family
  • From the toolbar

When the reference family is active, you'll see all its member's life way. For each known place with coordinates, you'll see a circle or an oval depending on the longitude.

The circle radius can be tuned in the configuration view. This value is defined in tenth of degree.

Fig. 4.40 "The selection parameters" tab for the "Have these two families been able to meet ?" GeoFamClose View - Configure the active view
Configure the active view
The selection parameters tab

See the configuration menu tab for additional options.

Usage

The configuration

Via the toolbar Configure View... button (or via the menu View)

All views
Fig. 4.41 Configure Geography - "The map" tab

The map tab contains options common to all Geography views:

  • Where to save the tiles of the tiles for offline mode.: (default is $HOME/.gramps/maps). If required you can change the directory where map tile files are stored on your computer. Be careful, it can take several gigabytes, and if on a metered internet connection may result in a monetary cost to you..
    • Select tile cache directory for offline mode button
  • A slider for Zoom used when centering: (default: 12). The zoom level for when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used.
  • A slider for The maximum number of places to show: (default: 5000). Reducing this number for faster map drawing but with less life ways.
  • Use keypad for shortcuts: Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard. - checkbox selected by default.


Specific views

See the description of the view.

How to zoom and move around the map ?

Zoom in and Zoom out the map

To zoom, you can use :

  • The +/- buttons on the top left of the map
  • The scroll mouse.
  • The "+" or "-" key on the keypad (default).

You can replace the numeric keypad by the alpha numeric keyboard in the configuration view.

Move around the map

To move around the map, you can :

  • Click on the map, then drag it.
  • Use the arrows.

The mouse actions on the map

The right button below is for one right handed person. This will be the left button for one left handed person.

button 1 ( left button )

You have two usages for the button 1 :

  1. The marker selection.
  2. Valid the region selection
button 2 ( middle button )

The only usage for this button is to select an area on the map.

  1. when pressed : start the region selection
  2. when released, end the region selection.

You must use the button 1 to validate the selected region when finished.

button 3 ( right button )

Only one usage for this button.

The mouse over a marker

When the mouse is placed over one marker, we display the place name in the status bar.

The menu popup

From this context menu, you have the following functions available for views :

  • hide or show the crosshair
  • lock or unlock the zoom
  • change the default map (provider)
  • add a place and link a place at the mouse position
  • add a place from kml file
  • center the map at the mouse position.
  • center the map depending on a place from sub menu.
  • remove all tiles already uploaded for the current provider
  • "show all places" or "show all events" for the "all known places" view or "all places related to events" view.

Click on a marker

We have two cases :

  1. events : For each event, we can edit this event or center the map on this place.
  2. places : For each place, we can edit this place or center the map on this place.

When centering the map, the zoom used is defined in the geography preferences.

We may have several markers in the click area depending on the zoom. In this case, We show for each marker all related events and/or places. We obtain a mix between the two cases described above.

Adding or Linking to a place

For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select Add place or Link place

When you add a place or try to link a place to the position of the mouse, you'll get a place selection in a region. You'll see on the map a circle in which you may choose markers place names. You can adjust the circle size with the cursor. Depending on the diameter of this circle, a list is created. If the place has already some filled fields, you'll see these values in a green color row. If you agree, you double click on this row. if you don't agree, you can choose another row.

Another way to set latitude and longitude :

Adding places from KML files

For this, click on the right button of the mouse, you'll get a context popup menu.

In this menu, you can select Add place from KML

You will get the Select a kml file used to add places file chooser dialog. Select the file you want to add.

If you have several places in the same KML file, you will get one place editor for each place. Be careful.

How to change the map provider ?

Several map providers are available in Gramps.

Click on the right button of the mouse, you'll get a popup menu.

In the bottom of this menu, you can select a new provider.

The following providers are available :

  • OpenStreetMap (default) : The advantage of OpenStreetMap is that it is a free project, so you can update the maps yourself with missing information via their website.
  • Maps For Free
  • OpenCycleMap
  • Public Transport
  • Google street
  • Google sat
  • Google hybrid
  • Virtualearth street
  • Virtualearth sat
  • Virtualearth hybrid
Tango-Dialog-information.png
Some maps are not free, please read the map provider Terms of Service :

Google street, Google sat, Google hybrid, Virtualearth street, Virtualearth sat, and Virtualearth hybrid

Note that Virtualearth is now Bing maps


Can we change the marker's color ?

Only the All known Places view supports changing the place type markers colors all the other views are hard coded in Gramps.

How to get/remove the crosshair ?

It can be useful to have the crosshair visible to see the center of the map. This functionality is available with the right button of the mouse. you'll get a popup menu. Select Add or Remove cross hair. This is useful to add or link places to the correct latitude-longitude coordinates

How to lock/unlock the map ?

When we change the map ( person to family, ... ), the zoom is recalculated. It can be useful in some case to keep the same zoom and position when we change the map provider. For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select lock or unlock zoom and position.

Prerequisites to see the geography view

For Gramps 5.x, you need to install osmgpsmap version 1.0 and above and the associated gir package.

For example on ubuntu, you must have: gir1.2-osmgpsmap-1.0 and libosmgpsmap-1.0-0

Possible problems

  • No view : do you have osmgpsmap installed ? (gramps -v from the command line may help you)
  • No tiles : do you have an internet connection active ?
  • No tiles for one provider : if other providers are OK, file a bug
  • Missing tiles : you have no internet connection and it's the first time you try to show the current place.
  • Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)
  • Other : Report a bug

Geography Category Bottombar tabs

The Geography Category by default displays no Gramplets in the Bottombar tab. You may add them as required.


Geography Category Sidebar tabs

The Geography Category shows the following Sidebar tabs.


Filter

The filter type may change depending on the view selected.

See Filter Gramplet

Sources Category

The Sources Category shows two views (Citation Tree View and Sources List View) that list the sources of certain information stored in the family tree.

Sources can include various documents (birth, death, and marriage certificates, etc.), books, films, journals, private diaries, - nearly anything that can provide genealogical evidence. Gramps gives you the option to provide a citation to a source for each event you record (births, deaths, marriages, etc.). The Sources View lists the Title , ID , and Author of the source, as well as any Publication information that may be associated with it.

The list of Sources can be sorted by clicking on a column heading.

Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog can be used to add, remove and rearrange the displayed columns.


Citation Tree View

Fig. 4.42 Sources Category - Citation Tree - View

The default (Citation Tree View) shows all the sources, and for each it allows the user to see the Citations associated with that source by clicking on the disclosure triangle.

Sources List View

Fig. 4.43 Sources Category - (List) View

The alternative view only shows the Sources as a list.

Sources Category Bottombar tabs

The Sources Category shows the following Bottombar tabs.

Gallery

See Gallery Gramplet

Notes

See Notes Gramplet

References

See References Gramplet

Sources Category Sidebar tabs

The Sources Category shows the following Sidebar tabs.

Filter

See Filter Gramplet

Citations Category

The Citations Category shows the Citation list View that show the citations for certain information stored in the family tree.

Citations specify which parts of a source are relevant to the information in the database. For example, a Source may be a book, and the citation may be a particular page in the book. Gramps gives you the option to provide a citation for each event you record (births, deaths, marriages, etc.).


Citations List View

Fig. 4.44 Citations Category - Citations (List) View - example

The Citations List View shows the Volume/Page , ID , and Date of the citation, as well as any Confidence in the evidence.

The list of Citations can be sorted by clicking on a column heading.

Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog can be used to add, remove and rearrange the displayed columns.


Citations Category Bottombar tabs

The Citations Category shows the following Bottombar tabs.

Gallery

See Gallery Gramplet

Notes

See Notes Gramplet

References

See References Gramplet

Citations Category Sidebar tabs

The Citations Category shows the following Sidebar tabs.

Filter

See Filter Gramplet

Repositories Category

The Repositories Category shows the Repository List View. A repository can be thought of as a collection of sources. Each source in the family tree may be a reference to a repository (such as a library) in which it belongs.


Repository List View

Fig. 4.45 Repositories (list) view - example

This view shows a list of all recorded repositories.

Repository Category Bottombar tabs

The Repository Category shows the following Bottombar tabs.

Details

See Details Gramplet

Notes

See Notes Gramplet

References

See References Gramplet

Repository Category Sidebar tabs

The Repository Category shows the following Sidebar tabs.

Filter

See Filter Gramplet

Media Category

The Media Category shows the Media List View, which list the Media Objects stored in the family tree.

Media Objects are technically any files that relate somehow to the stored genealogical data.

Most frequently, these are images, audio files, animation files, etc.

Media List View

Fig. 4.46 Media Category - Media (List) View - example

The Media List View shows the following columns for the list Name , ID , Type, Path and Date of the Media Object.

The Column Editor dialog may be used to rearrange the displayed columns, which obey usual sorting rules.

Media Category Bottombar tabs

The Media Category shows the following Bottombar tabs.

Preview

In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.

See Media Preview Gramplet

Citations

See Citations Gramplet

Notes

See Notes Gramplet

Attributes

See Attributes Gramplet

Image Metadata

See Image Metadata Gramplet

References

See References Gramplet

Media Category Sidebar tabs

The Media Category shows the following Sidebar tabs.

Filter

See Filter Gramplet

Notes Category

The Notes Category shows the Notes List View, which list text note (either pure text or preformated), as stored in the other objects.

See also:


Notes List View

Fig. 4.47 Notes Category - Notes (List) view

The Notes List View shows a list of text notes.

The functionality of the notes View is similar to the other views. The view lists all Notes stored in the Family Tree.

Using the menu View ->Configure View... you open the Column Editor and you can change the displayed columns. The possibilities are Preview, ID, Type, Private, Tags and Last Changed.

The Type can be (amongst others): Event Note, Address Note,Source text, Place Note

Double-clicking on a Note in the list will bring up a window where you can edit the Note. You can change fonts, font color and background color. A spellchecker is available for English and your local language.

Notes Category Bottombar tabs

The Notes Category shows the following Bottombar tabs.

References

See References Gramplet

Notes Category Sidebar tabs

The Notes Category shows the following Sidebar tabs.

Filter

See Filter Gramplet


Previous Index Next
Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions